1 基础知识

1.1 软件的介绍

– 禅道是一款专业的研发项目管理软件
– 禅道完整覆盖研发项目管理的核心流程

1.2 软件的功能

– 产品管理，包括产品、需求、计划、发布、路线图等功能。
– 项目管理，包括项目、任务、团队、版本、燃尽图等功能。
– 质量管理，包括bug、测试用例、测试任务、测试结果等功能。
– 文档管理，包括产品文档库、项目文档库、自定义文档库等功能。
– 事务管理，包括todo管理，我的任务、我的Bug、我的需求、我的项目等个人事务管理功能。
– 组织管理，包括部门、用户、分组、权限等功能。
– 统计功能，丰富的统计表。
– 搜索功能，强大的搜索，帮助您找到相应的数据。
– 扩展机制，几乎可以对禅道的任何地方进行扩展。
– api机制，所见皆API，方便与其他系统集成。

1.3 软件的特点

– 注重实效
– 功能完备丰富
– 操作简介高效
– 界面美观大方
– 搜索功能强大
– 统计报表丰富多样
– 软件架构合理
– 扩展灵活
– 提供可调用的完善API

1.4 软件的版本

– 企业版
– 专业版
– 开源版

2 最佳实践

2.1 系统信息

IP Addresses = 10.168.0.80
hostname = zentao.cmdschool.org
OS = centos 8.1 x86_64

2.2 安装前的准备

2.2.1 安装常用的软件包

dnf -y install vim

2.2.2 安装常用的软件包

dnf -y install unzip

2.3 配置HTTP服务

2.3.1 安装软件包

dnf -y install httpd

2.3.2 启动服务并配置自启动

systemctl start httpd.service
systemctl enable httpd.service

另外，其他操作请参阅如下命令，

systemctl stop httpd.service
systemctl restart httpd.service
systemctl status httpd.service

2.3.3 开启程序所需的端口

firewall-cmd --permanent --add-service http --add-service https
firewall-cmd --reload
firewall-cmd --list-all

2.3.4 关闭SELinux

sed -i 's/SELINUX=enforcing/SELINUX=disabled/g' /etc/selinux/config
setenforce 0

2.3.5 配置服务测试页

echo zentao.cmdschool.org > /var/www/html/index.html

2.3.6 命令行或浏览器测试

curl http://10.168.0.80/

可见如下显示，

zentao.cmdschool.org

另外，可使用浏览器访问如下URL可得到同样的结果，
http://10.168.0.80/

2.4 配置PHP

2.4.1 安装软件包

dnf -y install php php-pdo php-gd php-mbstring php-mysqlnd php-ldap php-json

2.4.2 重启服务加载PHP模块

systemctl restart httpd.service

另外，便于你理解，请使用如下命令确认PHP模块的位置，

find /usr/ -name libphp\*.so

可见如下显示：

/usr/lib64/httpd/modules/libphp7.so

然后使用如下命令确认PHP加载模块的配置文件位置以及配置，

grep -R "libphp7.so" /etc/httpd/ 2> /dev/null | grep LoadModule

可见如下显示，

/etc/httpd/conf.modules.d/15-php.conf:    LoadModule php7_module modules/libphp7.so

注：所以重启的目的是加载“/etc/httpd/conf.modules.d/15-php.conf”的配置

2.4.3 创建PHP测试页

echo '<?php phpinfo();?>'  >  /var/www/html/phpinfo.php

2.4.4 浏览器测试

http://10.168.0.80/phpinfo.php
可见如下显示，

2.5 安装数据库

2.5.1 安装软件包

dnf -y install mariadb mariadb-server 

2.5.2 启动服务并配置自启动

systemctl start mariadb.service
systemctl enable mariadb.service

另外，其他操作请参阅如下命令，

systemctl stop mariadb.service
systemctl restart mariadb.service
systemctl status mariadb.service

2.5.3 初始化数据库

mysql_secure_installation

向导如下，

[...]
Enter current password for root (enter for none):
[...]
Set root password? [Y/n] y
New password:
Re-enter new password:
[...]
Remove anonymous users? [Y/n] y
[...]
Disallow root login remotely? [Y/n] n
[...]
Remove test database and access to it? [Y/n] y
[...]
Reload privilege tables now? [Y/n] y
[...]

2.5.4 测试数据库登录

mysql -uroot -p

2.5.5 创建应用所需的数据库

create database zentao character set utf8;
grant all privileges on zentao.* to "zentao"@"localhost" identified by "zentaopwd";

2.6 部署软件包

2.6.1 创建项目目录

cd ~
mkdir /var/www/zentao.cmdschool.org

2.6.2 下载软件包

cd ~
wget -c wget https://liquidtelecom.dl.sourceforge.net/project/zentao/12.0/ZenTaoALM.12.0.stable.int.zip

另外，其他版本请从以下链接下载，
https://sourceforge.net/projects/zentao/files/

2.6.3 解压软件包

cd ~
unzip ZenTaoALM.12.0.stable.int.zip

2.6.4 部署软件包

cd ~
mv zentaoalm/* /var/www/zentao.cmdschool.org/

2.6.5 创建虚拟服务器配置文件

vim /etc/httpd/conf.d/zentao.cmdschool.org.conf

加入如下配置，

<VirtualHost *:80>
DocumentRoot /var/www/zentao.cmdschool.org/www
ServerName zentao.cmdschool.org
</VirtualHost>

<Directory /var/www/zentao.cmdschool.org/www>
Require all granted
</Directory>

2.6.6 重载服务使配置生效

systemctl reload httpd.service

2.6.7 客户端测试

notepad \Windows\System32\drivers\etc\hosts

加入如下配置，

10.168.0.80 zentao.cmdschool.org

以上设置仅用于测试，生产环境请使用DNS，设置完成后，可使用以下链接运行安装向导，

如上图所示，
单击【开始安装】进入下一步设置，

如上图所示，
直接单击【下一步】进入下一步设置，

如上图所示，
直接单击【下一步】进入下一步设置，

如上图所示，
填写之前步骤创建的数据库和密码
“数据库名”填写“zentao”
“数据库密码”填写“zentaopwd”
单击【保存】进入下一步设置，

如上图所示，
核对前面步骤提供的参数
单击【下一步】进入下一步设置，

如上图所示，
填入“公司的名称”，例如“cmdschool”
填入“管理员账号”，例如“admin”
填入“管理员密码”，例如“adminpwd”
单击【保存】进入安装成功页面，

如上图所示，
单击【登录禅道管理系统】进入管理页面，

2.7 配置https

2.7.1 安装ssl模块

cd ~
dnf -y install mod_ssl

可见如下配置和模块，

ls /etc/httpd/conf.modules.d/00-ssl.conf
ls /etc/httpd/modules/mod_ssl.so

2.7.2 清理本地虚拟主机https

cp /etc/httpd/conf.d/ssl.conf /etc/httpd/conf.d/ssl.conf.default
vim /etc/httpd/conf.d/ssl.conf

删除如下代码段，

##
## SSL Virtual Host Context
##

<VirtualHost _default_:443>
[...]
</VirtualHost>

2.7.3 增加所需的虚拟主机

vim /etc/httpd/conf.d/dn2cmdschool.org_443.conf

加入如下配置，

<VirtualHost *:443>
    SSLEngine on
    SSLProtocol all -SSLv2
    SSLCipherSuite DEFAULT:!EXP:!SSLv2:!DES:!IDEA:!SEED:+3DES
    SSLCertificateFile /etc/httpd/2_www.cmdschool.org.cer
    SSLCertificateKeyFile /etc/httpd/3_www.cmdschool.org.key
    SSLCertificateChainFile /etc/httpd/1_root_bundle.cer
	
    DocumentRoot /var/www/zentao.cmdschool.org/www
    ServerName zentao.cmdschool.org
</VirtualHost>

<Directory /var/www/zentao.cmdschool.org/www>
    Require all granted
</Directory>

以上需要你行上传证书文件，配置完成后，我们建议你使用如下命令测试配置，

httpd -t

另外，该配置需要你重载服务使配置生效，

systemctl reload httpd

参阅文档
=================

安装文档
————-
https://www.zentao.net/book/zentaopmshelp/360.html
https://www.zentao.pm/book/zentaomanual/free-open-source-project-management-software-package-15.html
https://www.zentao.pm/book/zentaomanual/free-open-source-project-management-software-zentao-8.html

下载链接
————–
https://www.zentao.pm/dynamics/free-scrum-tool-code-review-repo-management-zt120stable-374.html
https://www.zentao.pm/download.html

官方网站
————–
https://www.zentao.pm
https://www.zentao.net