禅道安装配置与部署

一、 部署

准备好环境，使用一键安装包（Linux）的方式部署。

1、下载

禅道软件下载地址：https://www.zentao.net/downloads.html ，选择开源版最新版本。

2、将安装包解压到/opt 目录下

cd/opt

wget https://www.zentao.net/dl/zentao/[版本]/ZenTaoPMS.[版本].zbox_64.tar.gz

tar xvzf ZenTaoPMS.[版本].zbox_64.tar.gz

注：①不要解压到别的目录再拷贝到/opt/，因为这样会导致文件的所有者和读写权限改变

②不要解压后把整个目录 777 权限

3、Apache 和 Mysql 常用命令

启动所有服务：/opt/zbox/zbox start

停止所有服务：/opt/zbox/zbox stop

重启所有服务：/opt/zbox/zbox restart

查看服务状态：/opt/zbox/zbox status

通过配置检查服务状态：/opt/zbox/zbox check 【18.10 版本支持】

注：如果需要开机自动启动，可以把 /opt/zbox/zbox restart 加到操作系统的自启目录

4、访问和登录禅道

启动 Apache 和 MySQL 服务后，浏览器直接访问 http://禅道服务器 ip:apache 端口 即

可访问和登录禅道。

注：①如果网页无法访问，请先关闭禅道所在电脑的防火墙和 selinux 再刷新网页访问试一

    下②使用云服务器请注意在安全组中开放 apache 使用端口

        ③禅道默认管理员帐号是 admin，密码 123456

5、其他参数

如果不加任何参数执行 /opt/zbox/zbox 会打印输出命令可用参数：

Usage: ./zbox {start|stop|status|check} [--aport=8080] [--mport=3307]

--aport 参数 可以修改 Apache 的端口

--mport 参数 可以修改 Mysql 的端口

例如：apache 端口改为 8080，mysql 端口改为 3307 命令：

/opt/zbox/zbox --aport 8080 --mport 3307 start

6、访问数据库

6.1、网页登录数据库

禅道数据库管理用的是 adminer，但是为了安全，访问 adminer 的时候需要身份验

证，需要运行 /opt/zbox/auth/adduser.sh 来添加用户，如下命令：

# 进入脚本目录

cd /opt/zbox/auth

# 执行添加用户的脚本

bash adduser.sh

This tool is used to add user to access adminer

Account: admin # 输入用户名

Password: # 输入密码

Adding password for user admin

打开浏览器，输入 http://禅道服务的 ip:apache 端口 点击“数据库管理”， 弹窗验证时

输入运行 addusers.sh 添加的用户名和密码，进入网页登录页面：

系 统：默认选择 MySQL

务器：127.0.0.1:MySQL 端口 （MySQL 端口启用的是 3307，那么就填写

127.0.0.1:3307。注意：ip 只能写 127.0.0.1）

用户名：root（禅道默认的数据库用户名是XXXX）

密 码：XXXX（禅道默认的数据库密码是 XXXX）

数据库：zentao

6.2、Navicat 链接数据库

在连接中选择 MariaDB，填入信息与上面一致，即可使用 Navicat 管理数据

7、配置文件

一键安装包首次启动时，会在根目录创建一个 .env 文件，这个文件中保存了一些初

始配置，你可以根据情况更改这些配置，以下是关于配置的说明：

# Apache 主机地址，如果用外部 Web 服务，需要手动修改，18.10 版本新增

export APACHE_HOST=127.0.0.1

# Aapche 端口号，通过--aport 参数修改

export APACHE_PORT=80

# MySQL 主机地址，如果用外部 MySQL，需要手动修改，18.10 版本新增

export MYSQL_HOST=127.0.0.1

# MySQL 端口号，通过--mport 参数修改

export MYSQL_PORT=3306

# MySQL 密码，如果手动更改后，需要修改这个配置

export MYSQL_PASS=XXX

# 服务的默认用户，不要修改

export DEFAULT_USER="nobody"

# 服务的默认用户组，不要修改

export DEFAULT_GROUP="nogroup"

# 是否启用内置 MySQL 服务，18.10 版本新增

export MYSQL_SERVICE=enabled# 是否启用内置 Apache 服务，18.10 版本新增

export APACHE_SERVICE=enabled

# 是否启用内置 XXD 服务，18.10 版本新增

export XXD_SERVICE=enabled

# 是否启用内置 Roadrunner 服务，18.10 版本新增

export ROADRUNNER_SERVICE=enabled

# 设置 PATH 变量

export PATH=$PATH:/opt/zbox/bin

注：如果在.env 中开启（enabled）或者禁用（disabled）了某些服务，需要通过

/opt/zbox/zbox check 使配置立即生效

二、禅道升级

升级是为了保留旧版本中的数据，所以升级前一定要做好数据备份，以免升级过程中

出现意外导致数据丢失。

1、源码包

下载新的源码包（ZIP 格式）。注意，不是.tar.gz 的集成运行环境，如果下载这个，会造成

数据被覆盖

2、覆盖文件

解压缩后得到 zentaopms 文件夹，将 zentaopms/下面的所有文件复制到

/opt/zbox/app/zentao/下面，覆盖同名文件：

sudo cp -rf zentaopms/* /opt/zbox/app/zentao/

3、访问页面

访问 http:/[ip 地址]/zentao/upgrade.php，按照页面提示进行升级：注：不要解压缩成/opt/zbox/app/zentao/zentao。不要将原来的程序移走，再解压缩新

的版本，注意是覆盖！