安装 - 升级

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"