Dolibarr ERP CRM Wiki

安裝 - 升級


返回
用戶手冊
File Doc user.png

返回
首頁
File Doc dev.png

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


安裝 Dolibarr

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

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

  使用DoliWamp (Windows作業系統 .exe 安裝包)

- 條件: Windows

- 級別: 無經驗用戶

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

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

這是安裝DoliWamp的步驟：

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

為此，請參閱頁面 Sourceforge mirror

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

  使用 DoliDeb (Debian 或者 Ubuntu作業系統 .deb 安裝包)

- 條件: Linux Ubuntu 作業系統

- 級別: 無經驗用戶

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

  使用 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) ，並且不用具備計算機知識。

  使用 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) 是否正確安裝。

  警告, 檢查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的現有安裝從舊版本升級到新版本的過程。過程是相同的，無論你正在運行哪個版本和升級到哪個版本，但是將根據你第一次安裝的分配/作業系統而有所不同。升級時應使用相同的方法。

  使用 DoliWamp (Windows作業系統 .exe 安裝包)

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

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

  使用 DoliDeb (Debian 或者 Ubuntu作業系統 .deb 安裝包)

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

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

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

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

  使用 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.

設置

見 設置.

Retrieved from "https://wiki.dolibarr.org/index.php?title=安装_-_升级&oldid=56983"