安裝 - 升級

From Dolibarr ERP CRM Wiki
Jump to navigation Jump to search
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.


返回
用戶手冊
File Doc user.png

返回
首頁
File Doc dev.png

下面的文檔描述了在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.

設置

見 設置.

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