安装 - 升级


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

设置

设置.