安装 - 升级

From Dolibarr ERP CRM Wiki
Jump to navigation Jump to search


返回
用户手册
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 7.1.0+ 和数据库服务 (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"