安裝 - 升級

From Dolibarr ERP CRM Wiki
Jump to navigation Jump to search

下面的文檔描述了在Windows、Mac OS或類似UNIX的平台上安裝或升級Dolibarr的過程。


安裝 Dolibarr

本章描述了首次安裝Dolibarr的不同可用方法(從最簡單到手動)。升級請參閱下一章。

在您專用的計算機/服務器上

Logo windows.png 使用DoliWamp (Windows操作系統 .exe 安裝包)

- 條件: Windows

- 級別: 無經驗用戶

這個過程只適用於Windows用戶,並且推薦給沒有計算機知識的用戶。 如果你正在試用Apache、PHP和MySQL安裝,下一章對你來說更好。

無論如何,如果您是新手用戶並運行Windows,則可以使用DoliWamp。DoliWamp是Windows的專用Dolibarr發行版。 此版本允許您在Windows下以所有先決條件進行安裝(Apache、MySQL、PHP),並且不用具備計算機知識。

這是安裝DoliWamp的步驟:

  • 下載最後Dolibarr版本的Windows DoliWamp。

為此,請參閱頁面 Sourceforge mirror

  • 運行下載.exe並按照說明操作。

Logo ubuntu.png 使用 DoliDeb (Debian 或者 Ubuntu操作系統 .deb 安裝包)

- 條件: Linux Ubuntu 操作系統

- 級別: 無經驗用戶

此過程僅適用於Ubuntu或Debian Linux用戶,並推薦給沒有計算機知識的用戶。 如果你正在試用Apache、PHP和MySQL安裝,「標準安裝包」章節對你來說更好。 但是,如果您是新手用戶,運行Ubuntu,您可以使用DoliDeb. DoliDeb是特別版的Dolibarr專為Debian或Ubuntu。 此版本允許您在Ubuntu下以所有先決條件進行安裝(Apache, Mysql, PHP) ,並且不用具備計算機知識。

Logo rpm.png 使用 DoliRpm (Fedora, Redhat, Mandriva, Mageia 或 OpenSuse系統 .rpm 安裝包)

- 條件: Linux Fedora, Redhat, Mandriva, Mageia 或 OpenSuse 系統

- 級別: 無經驗用戶

此過程僅適用於 Fedora, Redhat, Mandriva, Mageia 或 OpenSuse Linux 用戶並且推薦給沒有計算機知識的用戶。 如果你正在試用 Apache, PHP and Mysql 安裝, 下一章 「標準安裝包」 章節對你來說更好。但是,如果您是新手用戶,運行 Fedora 或 Redhat, 您可以使用 DoliRpm. DoliRpm 是特別版的 Dolibarr 專為 Fedora, Redhat 或 Mandriva. 此版本允許您在這些系統下以所有先決條件進行安裝(Apache, Mysql, PHP) ,並且不用具備計算機知識。

Gnu.png 使用 Dolibarr (標準 .zip)

- 條件: Apache, PHP 和一個數據庫服務 (MySQL 或者 PostgreSQL) 已經正確運行,用包名及密碼已知

- 級別: 少量的Web和數據庫管理知識

此過程了在GNU/Linux系統上的手動安裝和推薦安裝。 (Debian, Mandriva, ...), 它也可以用於其他操作系統,僅有微小變化。 您可以遵循本教程安裝任何Dolibarr版本 >= 2.0.0

  • 檢查是否正確安裝了Apache, PHP 5.6.0+ (requires functions like DateTimeZone.getOffset, php-intl) 和數據庫服務 (MySQL 5.1+ 或者 PostGreSQL) (使用您的版本的安裝包管理器在服務器上檢查已安裝的安裝包列表). 如有未安裝,請先安裝(使用最新版本).
  • 檢查服務器的主根或管理員用戶/密碼對是否已知的,並且工作正常。如果這個根或管理員用戶/密碼不知道,因為尚未定義,請閱讀以下章節。否則繼續進行下一步:

對 Linux 用戶, 如果您安裝了MySQL服務器,管理員用戶是 root。如果根密碼尚未設置,則必須運行以下命令來初始化密碼:

mysql

進入Mysql界面, 運行SQL命令修改根密碼:

grant all privileges on *.* to root@'localhost' identified by 'newrootpass' with grant option;

然後鍵入\q退出界面。

若要檢查新用戶/密碼對的連接是否有效,請啟動命令

mysql -u root -p

鍵入密碼newrootpass 然後 \q 退出,如果鏈接成功

對 Linux 用戶, 若你安裝了 PostgreSQL 服務, 必須運行以下命令初始化管理員用戶和密碼。 為此,在文件中添加以下行/etc/postgresql/x.x/main/pg_hba.conf (替換 x.x 用 你的 postgres 版本)

local   all         dolibarrowner    md5

此外,注釋此行

#local   all         all                               ident

這一行確保了系統登錄用於連接到數據庫(它將登錄的Web服務器運行),是相同的數據庫帳戶(這決不是這樣)。

然後從根shell發出命令

sudo -s -u postgres
createuser dolibarrowner
psql -h localhost -d template1 -c "alter user dolibarrowner with password 'dolibarrownerpass'"
exit
sudo /etc/init.d/postgresql restart

可以使用命令測試與此用戶的連接。

psql -d postgres -U dolibarrowner -W

並鍵入您的「dolibarrownerpass」作為密碼,如果連接正確,請退出。


  • 進入安裝Dolibarr(為Web服務器定義的Web根目錄)的目錄
  1. 對於Debian和Ubuntu來說,它一般是:/VAR/WWW(更新版本:/VAR/WWW/HTML)
  2. 對於 Mandriva, RedHat, Fedora: /var/www/html
  3. 對於 Suse: /srv/www/htdocs
$ cd /var/www
or
$ cd /var/www/html
  • 獲取最後一個穩定版本的應用程序文件
$ wget http://www.dolibarr.org/files/dolibarr.zip
  • 解壓縮檔案
$ unzip dolibarr.zip
  • 將目錄Dolibarr-X.Y.Z重命名為Dolibarr,使其具有不依賴於版本的目錄名(用源代碼替換X.Y.Z)
$ mv dolibarr-x.y.z dolibarr
  • 將「Dolibarr」目錄的權限和所有者更改為Web服務器運行的組(對於Debian是 'www-data' ,對於Redhat、MulDrVA、FEDORA是'apache')。
$ chmod -R 755 /var/www/dolibarr
$ chown -R www-data.www-data /var/www/dolibarr
or
$ chmod -R 755 /var/www/html/dolibarr
$ chown -R apache.apache /var/www/html/dolibarr
  • 對於Fedora,由於SELinux通常是啟用的,運行下面的命令也是可行的,以便使「dolibarr」目錄符合SELinux要求(否則您可能會得到相當多的警報):
$ semanage fcontext -a -t httpd_sys_rw_content_t '/var/www/html/dolibarr(/.*)?'
$ restorecon -R -v '/var/www/html/dolibarr'
  • 作為根用戶,創建目錄dolibarr/htdocs/conf,創建一個名為conf.php的空配置文件進行設置,作為所有者,Web服務器用戶(例如對於Debian是 'www-data' ,對於Redhat、MulDrVA、FEDORA是'apache')。這是必需的,因為Web服務器將不得不在安裝過程中讀寫該文件。
$ cd dolibarr ; touch htdocs/conf/conf.php ; chown www-data htdocs/conf/conf.php

注: 對於 Ubuntu 不需要 htdocs, 你只需建立 dolibarr 根目錄,然後將 /var/www/dolibarr 中所有文件及目錄拷貝至其中,然後從瀏覽器中鍵入<MyIP>/dolibarr/index.php (請參閱本討論,作為本附錄的參考。 [1])

  • 作為根用戶,創建一個目錄,用於保存由Dolibarr生成和存儲的所有文件(PDF發票、上傳圖像、……),這個目錄必須是Web服務器(例如對於Debian是 'www-data' ,對於Redhat、MulDrVA、FEDORA是'apache')。

Web服務器必須對該目錄具有寫入權限。建議使用您的網頁目錄之外的其他目錄,例如- "/var/lib/dolibarr/documents"

$ mkdir -p /var/lib/dolibarr/documents ; chown www-data /var/lib/dolibarr/documents
  • 現在調用你的瀏覽器指向主頁
http://127.0.0.1/dolibarr/htdocs/

或者如果您沒有創建HTDOCS目錄

http://127.0.0.1/dolibarr/
  • 遵循安裝步驟的指令直到安裝過程結束。
  • 出於安全原因,我們建議,一旦安裝完成,就創建一個文件install.lock到只有root用戶可以刪除的Dolibarr文檔目錄中。這將再次鎖定安裝進程的調用(您必須刪除此文件以進行升級)。

如果沒有這樣做,Dolibarr將顯示一個警告,一旦管理員管理員登錄。

$ touch /var/lib/dolibarr/documents/install.lock; chmod go-w /var/lib/dolibarr/documents;

在共享的Web虛擬服務器(受限制訪問)上

無法提供一個通用文檔來將Dolibarr安裝在特定的Web託管提供商上,因為這取決於服務器的提供商。

在大多數情況下,使用下面的流程對大多數供應商來說是有效的:

- 條件: Apache 服務器, PHP 和一個數據庫 (MySQL or PostgreSQL) 已正確安裝及運行,可用的用戶名/密碼 (一個新的數據庫或根服務器) 。

- 級別: 少許網絡/數據庫知識,會使用FTP軟件上傳文件到服務器。

  • 檢查你的 Apache 服務器, PHP 和數據庫 (MySQL or PostGreSQL) 是否正確安裝。

Warning.png 警告, 檢查PHP服務器和數據庫服務器的字符編碼是否相同(推薦UTF8)。

  • 檢查服務器的主根或管理用戶/密碼對是已知的,並且工作正常。如果不知道,請向網站託管提供商諮詢。
  • 將HTDOCS目錄中的所有內容上傳到您的Web根目錄,使用二進制模式的FTP軟件上傳。
  • 在Dolibarr目錄中創建一個名為「documents」的目錄,用於保存由Dolibarr生成和存儲的所有文檔(PDF發票、圖像、……)。Web服務器必須對該目錄具有寫入權限。您可以用FTP客戶端設置權限。
  • 現在調用你的瀏覽器指向主頁 index.php
  • 遵循安裝步驟的指令直到安裝過程結束。
  • 出於安全原因,我們建議,一旦安裝完成,就創建一個文件install.lock到只有root用戶可以刪除的Dolibarr文檔目錄中。這將再次鎖定安裝進程的調用(您必須刪除此文件以進行升級)。

如果沒有這樣做,Dolibarr將顯示一個警告,一旦管理員管理員登錄。

關於SaaS或雲網絡託管提供商

Dolibarr還提供了許多「準備使用」的SaaS或雲平台/服務,提供預裝的版本。

參見 Cloud Solutions.

Dolibarr也可以手動安裝在支持PHP和MySQL的所有雲平台上。

參見 Cloud Solutions.

升級 Dolibarr

本章描述了將Dolibarr的現有安裝從舊版本升級到新版本的過程。過程是相同的,無論你正在運行哪個版本和升級到哪個版本,但是將根據你第一次安裝的分配/操作系統而有所不同。升級時應使用相同的方法。

Logo windows.png 使用 DoliWamp (Windows操作系統 .exe 安裝包)

  • 首先備份當前安裝
  • 下載新的 .exe 安裝包DoliWamp.
  • 運行下載好的 .exe 文件,在不改變任何默認值的情況下執行步驟。這會升級你所有的文件。
  • 在執行結束時,您的瀏覽器將啟動一個頁面,要求您運行數據庫的升級。根據您的情況選擇升級。

如果有超過一個版本遲了,瀏覽器中的頁面將循環重新啟動升級嚮導,按需運行升級過程,版本接版本,直到您到達新安裝的版本。

Logo ubuntu.png 使用 DoliDeb (Debian 或者 Ubuntu操作系統 .deb 安裝包)

  • 首先備份當前安裝
  • 使用Debian /Ubuntu包升級的過程與安裝過程相同(見前面章節),因此安裝包一樣簡單。

你也可以閱讀頁面 Dolibarr for Ubuntu or Debian.

Logo rpm.png 使用 DoliRpm (Fedora, Redhat, Mandriva, Mageia 或 OpenSuse操作系統 .rpm 安裝包)

  • 首先備份當前安裝
  • 使用RPM包進行升級的過程與安裝過程相同,所以安裝程序包(見前面章節)很簡單。

Gnu.png 使用 Dolibarr (標準 .zip 安裝包)

這是使用標準分發手動升級時使用的教程。

  • 首先備份當前安裝
  • 進入Dolibarr安裝目錄 (可能是網站根目錄, 如 /var/www 在 Debian)
$ cd /var/www
  • 取得最新版本的安裝包
$ wget https://www.dolibarr.org/files/dolibarr.zip
  • 解壓安裝包
$ unzip dolibarr.zip
  • 複製所有新提取的文件 (the one uncompressed into directory dolibarr-x.y.z) 至老版本的Dolibarr目錄中。將會覆蓋舊文件而不必逐一刪除當前版本的舊文件 (象 conf.php 文件或非官方安裝的補充模塊).
$ cp -r dolibarr-x.y.z/* dolibarr
  • 如果沒有錯誤,現在可以刪除源文件的目錄
$ rm -fr dolibarr-x.y.z
  • 現在在瀏覽器中打開你的Dolibarr。它應該自動打開 install/

並在建議菜單中選擇「Update」。

注: 如果要編寫數據庫升級過程(以避免Web瀏覽器升級過程),可以從命令行運行3個升級過程:

$ cd htdocs/install
$ php upgrade.php oldx.oldy.oldz x.y.z > output.html
$ php upgrade2.php oldx.oldy.oldz x.y.z > output2.html
$ php step5.php oldx.oldy.oldz x.y.z > output3.html

注: z 必為 "0" 因為只有主要版本有遷移腳本才能運行。


返回碼若成功為0,失敗為1 (若失敗, 查看 output.html 或 output2.html).

注: 如果您有一個消息告訴安裝過程被文件鎖定,請刪除存儲在Dolibarr根目錄中的文件install.lock。

  • 出於安全原因,我們建議,一旦安裝完成,就創建一個文件install.lock到只有root用戶可以刪除的Dolibarr文檔目錄中。這將再次鎖定安裝進程的調用(您必須刪除此文件以進行升級)。

如果沒有這樣做,Dolibarr將顯示一個警告,一旦管理員管理員登錄。

$ echo > documents/install.lock
$ chmod 444 documents/install.lock

設置LDAP 連接

若使用 LDAP: 見 Install and configure OpenLDAP.

導入外部數據

Mass imports.

設置

設置.


--Roger-QQ12464313 04:46, 27 June 2018 (UTC)