部署企业级项目管理系统（蝉道）

禅道下载

进入禅道官网https://www.zentao.net，选择适用的版本进行安装，我这里下载的是“开源版11.6

官方开源版使用手册：https://www.zentao.net/book/zentaopmshelp/40.html

注：Linux一键安装包必须直接解压到/opt目录下.

禅道安装

将安装包直接解压到/opt目录下，不要解压到别的目录再拷贝到/opt/，因为这样会导致文件的所有者和读写权限改变，也不要解压后把整个目录777权限。

可以使用命令：

[root@localhost ~]# tar -zxvf ZenTaoPMS.11.6.stable.zbox_64.tar.gz -C /opt/

管理命令

[root@localhost ~]# /opt/zbox/zbox start # 命令开启Apache和MySQL
[root@localhost ~]# /opt/zbox/zbox stop # 命令停止Apache和MySQL
[root@localhost ~]# /opt/zbox/zbox restart # 命令重启Apache和MySQL

我这里因为服务器上已经安装了Apache和MySQL，避免端口冲突，所以启动时用命令 /opt/zbox/zbox start -ap 8888 -mp 3307 指定了Apache和MySQL的端口，如下图：
我这里因为服务器上已经安装了Apache和MySQL，避免端口冲突，所以启动时用命令 /opt/zbox/zbox start -ap 8888 -mp 3307 指定了Apache和MySQL的端口，如下图：
可以使用/opt/zbox/zbox -h命令来获取关于zbox命令的帮助
其中-ap参数可以修改Apache的端口，-mp参数可以修改MySQL的端口
顺便将Apache端口加入防火墙

[root@localhost ~]# firewall-cmd --zone=public --add-port=8888/tcp --permanent
[root@localhost ~]# firewall-cmd --reload

浏览器访问

浏览器访问 http://ip:apache端口，点击“开源版”，进入到禅道登录界面，输入默认用户名 admin，密码123456，进入后修改密码。
进入后的首页如下图：
到此处，说明禅道已经搭建完成，可以进行一系列新建产品和项目，包括分配任务。

访问禅道数据库

1、网页登录数据库

禅道数据库管理用的是adminer，但是为了安全，访问 adminer 的时候需要身份验证，需要运行 /opt/zbox/auth/adduser.sh 来添加用户(先 cd /opt/zbox/auth/ 然后执行 ./adduser.sh )。

2、设置登录账号密码

设置的 Account 是 root，Password 是 123456，这里添加的用户名和密码是自定义的。

3、登录数据库

网页访问 http://禅道服务的 ip:apache端口，点击“数据库管理”
输入刚运行 addusers.sh 设置的用户名和密码。

4、连接数据库

系统：默认选择MySQL
服务器：127.0.0.1:mysql端口，前面开启服务时，mysql端口启用的是3307。那么就填写 127.0.0.1:3307（服务器以实际部署的ip为准）
用户名：root
密码：123456
数据库：zentao
点击“登录”后，进入数据库管理界面，如下图：

5、命令行连接数据库

登录数据库：

[root@localhost ~]# /opt/zbox/bin/mysql -u root -P mysql端口 -p （比如：/opt/zbox/bin/mysql -u root -P 3307 -p）

导入数据库：

[root@localhost ~]# /opt/zbox/bin/mysql -u root -P mysql端口 -p 要导入的库名 < XXXX.sql （比如：/opt/zbox/bin/mysql -u root -P 3307 -p zentao < zentao.sql）

设置禅道开机自动启动

CentOS7 系统服务脚本目录 /usr/lib/systemd/
有系统（system）和用户（user）之分，如需要开机没有登陆情况下就能运行的程序，存在系统服务（system）里，即 lib/systemd/system/，反之，用户登录后才能运行的程序，存在用户（user）里，服务以.service结尾。
下面以zentao开机运行为例：

1、建立服务文件

[root@localhost ~]# vim /lib/systemd/system/zentao.service
[Unit]
Description=zentao
After=network.target
[Service]
Type=forking
ExecStart=/opt/zbox/zbox start
ExecReload=/opt/zbox/zbox restart
ExecStop=/opt/zbox/zbox stop
PrivateTmp=true[Install]
WantedBy=multi-user.target[Unit]: 服务的说明
Description:描述服务
After:描述服务类别[Service]服务运行参数的设置
Type=forking是后台运行的形式
ExecStart为服务的具体运行命令
ExecReload为重启命令
ExecStop为停止命令
PrivateTmp=True表示给服务分配独立的临时空间
注意：[Service]的启动、重启、停止命令全部要求使用绝对路径
[Install]服务安装的相关设置，可设置为多用户

2、设置开机自启动

[root@localhost ~]# systemctl daemon-reload
[root@localhost ~]# systemctl enable zentao

3、其他命令

# 启动zentao服务
[root@localhost ~]# systemctl start zentao
# 设置开机自启动
[root@localhost ~]# systemctl enable zentao
# 停止开机自启动
[root@localhost ~]# systemctl disable zentao
# 查看服务当前状态
[root@localhost ~]# systemctl status zentao
# 重新启动服务
[root@localhost ~]# systemctl restart zentao
# 查看所有已启动的服务
[root@localhost ~]# systemctl list-units --type=service | grep running

4、重启服务器测试

[root@localhost ~]# ps aux | grep zbox

使用禅道进行项目管理

建立部门结构

简介：禅道安装成功之后，管理员的第一件要做的事情就是设置部门结构。禅道安装成功之后，管理员的第一件要做的事情就是设置部门结构。

1、维护部门结构

以管理员身份登录；
进入组织–用户视图；
点击维护部门；(或者直接点击二级导航里的“部门”。)
在部门维护页面，维护公司的组织结构即可。

2、维护子部门

点击部门名称，即可添加该部门的下级部门（子部门）。

下级部门添加成功后，即可在部门机构里查看到。

添加一个用户帐号

简介：部门创建之后，下一步的操作就是往系统中添加用户。部门创建之后，下一步的操作就是往系统中添加用户。步骤如下：

进组织视图
选择用户列表
然后选择“添加用户”，即可进入添加用户页面。
用户添加完之后，即可将其关联到某一个分组中。

注意点：

从4.0版本开始增加了职位字段，在添加帐号的时候可以选择对应的职位。职位会影响到指派列表的顺序，比如创建bug的时候，默认会把研发职位的同学放在前面。职位还会影响到我的地盘里面内容的排列顺序。比如产品经理角色的人登录之后，我的地盘首先会显示我的需求，而研发的同学登录之后，会看到我的任务。
用户的权限都是通过分组来获得的，因此为用户指定了一个职位之后，还需要将其关联到一个分组中。
其中源代码提交帐号是subversion或者其他源代码管理系统中对应的用户，如果没有启用 subversion集成功能，可以留空。

批量维护帐号

简介：禅道可以批量添加和编辑用户。从4.0版本开始，我们提供了批量添加帐号的功能，可以很方便的批量创建帐号。

使用管理员登录禅道系统，进入“组织”页面。
选择“用户”，然后选择右侧的“批量添加用户”

除了批量添加用户，还可以在用户列表页面选择用户，进行批量编辑。

设置分组，建立权限体系

简介：用户创建之后，下一步的操作就是创建分组，设置权限。

在禅道中，用户权限都是通过分组来获得的。所以在完成部门结构划分之后，就应该建立用户分组，并为其分配权限。有的朋友可能会问，用户分组和部门结构有什么区别？我们来解释下这个问题。

部门结构是公司从组织角度来讲的一个划分，它决定了公司内部人员的上下级汇报关系。而禅道里面的用户分组则主要用来区分用户权限。二者之间并没有必然的关系。比如用户A属于产品部，用户B属于研发部，但他们都有提交bug的权限。

1、创建分组

使用管理员登录禅道，进入组织视图。
选择权限分组，进入分组的列表页面
点击新增分组，即可创建分组。
在这个分组列表页面，还可以对某一个分组进行权限的维护、成员维护、或者复制。

2、维护权限

1.管理员身份登录

2.进入组织视图

3.点击”权限分组“，进入权限分组列表页面。

4.选择某一个分组，点击“权限维护”，即可维护该分组的权限。

5.进入权限列表页面，点击某一个模块名后面的复选框，可以全选该模块下面的所有权限，或者全部取消选择。还可以查看某一个版本新增的权限列表，即下图的红框位置。

6.禅道7.2.stable版本开始，还提供视图维护权限。可以设置某个分组仅能查看某个产品或者项目等。

7.限制访问框里填写了相关内容，就是表示该分组仅有权限访问限制访问框里的内容。

以下图为例：

允许访问视图：全选的话，那么禅道导航栏里的主菜单（产品、项目、测试、文档、统计、组织、后台）都显示。不勾选，导航栏就不显示，也无权限访问。

允许访问产品：下图允许访问产品为禅道项目管理软件，那么该权限分组的用户只能访问禅道项目管理软件这个产品，别的产品都没权限访问。

允许访问项目：与允许访问产品的设置是一样的。

8.禅道9.6.2.版本，新增了受限操作权限分组。

组织–权限–受限用户分组，维护分组成员时，属于该分组的用户在禅道里 只能编辑与自己相关的 需求、任务、bug等 ，不能新增需求、任务、bug等。

注：与自己相关的内容，包含指派给、已完成、已取消、已关闭、最后编辑，不包含抄送给的内容。如果该用户之前不是受限用户，现在是受限用户。那么之前由他创建需求，任务，bug等，他都还有相关的操作权限。

比较适用于公司新来员工的权限设置，怕其不熟悉公司业务而导致误操作。

此外在项目–团队–团队管理里，也增加了针对某个项目设置受限用户的功能。

如果某个团队成员设置为该项目的受限用户，那么该团队成员只能编辑该项目里与自己相关的任务、需求、bug等。

注意：

1)组织–权限-- 受限用户分组，设置的受限操作，是针对禅道整个系统的使用受限。

2)项目–团队–团队管理里，设置的受限用户，是只针对某一个项目的受限操作，其他项目不受影响。

3)如果该用户之前不是受限用户，现在是受限用户。那么之前由他创建的与该项目相关的需求，任务，bug等，他都还有相关的操作权限。

权限维护的注意事项：

1)一个用户在多个权限分组里，其在禅道里的权限取的是各个权限分组里权限的合集。

2)要访问到一个Bug，必须同时拥有Bug所在产品，项目的访问权限和Bug详情的权限。

3)产品/项目还可以通过访问控制来设置查看权限。产品/项目–概况里，编辑访问控制：默认设置，私有产品/项目，自定义白名单来调整产品/项目的查看权限。

4)禅道里权限分配比较灵活，可以根据实际需要做调整。

5)没必要过于的纠结权限的分配，禅道里每个操作都会记录，在详情页的历史记录可以查看到。

3、维护成员

管理员身份登录
进入组织视图中的权限分组。
点击”成员维护“，进入用户维护页面。

使用禅道来进行项目任务管理

简介：禅道简使用方式就是单纯的项目任务管理，创建项目，分解任务。

也许您刚刚看到禅道的界面，心里说，哇，这么多功能。是不是有些复杂了？我们想说的是，禅道的定位不是那种简单的任务管理软件，而是专业的协同管理软件。研发类的项目管理本身具有其复杂性，所以禅道提供的都是必备的功能。但这并不意味着您必须按照禅道的流程来使用，完全可以按照自己的实际情况来使用禅道。下面让我们来看下使用禅道的简单方式。

1、创建项目

添加新项目的入口有多个，进入项目视图，可以在左侧1.5级导航的下拉菜单中直接点击“添加项目”。或者在项目主页的项目总览区块中点击“添加项目”。

在项目添加的页面中，设置项目名称、代号、起止时间、可用工作日、团队名称、和项目描述等字段。其中关联产品是可以为空，也可以多选。

2、设置团队

点击保存按钮，会提示项目创建成功，然后可以选择设置团队。或者从项目视图中的团队菜单，也可以进行项目的团队管理。

在维护项目团队的时候，需要选择都是哪些用户可以参与到这个项目中，同时需要设置这个用户在本项目中的角色（角色可以随便设置，比如风清扬，冬瓜一号等）。可用工作日和可用工时每天需要仔细设置。通常来讲，一个人不可能每天8小时投入，也不可能一星期七天连续投入。设置完毕之后，系统会自动计算这个项目总得可用工时。

3、分解任务

设置了团队之后，下一步操作就是创建任务。

在创建任务的时候，指派给是从项目团队成员中读取。
姓名列表中的首字母可以用来快速筛选用户。
任务的优先级、预计工时（单位小时）都需要进行设置。
如果需要设置任务必须在某一个时间点截止，可以设置截止日期。
可以上传附件。

4、管理任务

任务分解完毕之后，每个人就非常清楚自己做什么事情。所以项目启动之后，对于项目团队的成员来讲，他要做的事情就是更新任务的进度和状态。

任务的列表：在任务的列表页面，可以看到系统中所有的任务列表，可以通过各种标签方便的进行筛选。点击某一个任务的名称进入详情页面。

任务的详情页面：在任务的详情页面可以看到任务的详细信息，包括历次的修改记录等信息。同时也给出了各种操作的按钮。

开始任务：开始某一个任务的时候，可以设置已经消耗的时间和预计剩余的时间。单位都是工时。

更新任务工时：点击操作栏里的“工时”按钮，通过更新工时消耗，来管理任务执行进度。

完成任务：完成任务的时候，需要设置下已经消耗的时间。

关闭任务：任务完成之后，点击操作栏里的“关闭”按钮，将该任务关闭，这个任务就结束了。

上述就是使用禅道来进行简单的项目和任务管理，怎么样？还是很简单的吧。下面让我们来看下只使用禅道来进行bug的跟踪管理。

只使用禅道来做bug管理

简介：本文讲述如何使用禅道来进行bug的跟踪和管理。

上篇文章讲述了禅道的简使用方法之一，只使用禅道来进行项目任务管理。禅道的测试功能也可以独立出来单独使用。这种方式很适合于测试团队使用。禅道里面的bug基本流程是：测试人员提出bug -> 开发人员解决bug -> 测试人员验证关闭。下面我们来演示下具体的使用方法。

1、创建产品

使用 bug管理功能之前，需要先创建产品。禅道里面设计的理念是bug主要附属在产品概念下面的，后面我们会详细讲述产品和项目之间的关系。添加产品的入口有多个，可以在产品视图中的1.5级导航下拉菜单中直接点击“添加产品”。也可以在所有产品页面点击右侧的“添加产品”按钮。

新增产品的时候，需要设置产品的名称、代码，几个负责人信息。

2、提出bug

有了产品之后，我们就可以来创建bug了。

在创建bug的时候，必填的字段是：影响版本，bug标题，所属模块。
所属项目，相关产品，需求可以忽略。
创建bug的时候，可以直接指派给某一个人员去处理。如果不清楚的话，可以保留为空。

3、处理bug

当一个bug指派给某一位研发人员之后，他可以来确认、解决这个bug。在对bug进行处理之前，需要先要找到需要自己处理的bug。禅道提供了各种各样的检索方式，比如指派给我，可以列出所有需要我处理的bug。

**确认bug：**确认该bug确实存在后，可以将其指派给某人，并指定bug类型、优先级、备注、抄送等。

**解决bug：**当bug修复解决后，点击解决，指定解决方案、日期、版本，并可将其再指派给测试人员。

**关闭bug：**当研发人员解决了bug之后，bug会重新指派到bug的创建者头上。这时候测试人员可以来验证这个bug是否已经修复。如果验证通过，则可以关闭该bug。（bug列表页和详情页中都有“关闭”按钮。）

**编辑bug：**对bug进行编辑操作。

**复制bug：**复制创建当前bug，在此基础上再做改动，避免重新创建的麻烦。

只使用禅道来进行产品管理

简介：对于产品经理来讲，禅道可以作为一个非常好用的需求管理工具。

前面两篇文章讲述的禅道的简流程，是分别站在研发团队、测试团队角度展开的。研发团队可以使用禅道来做基本的任务跟踪管理，测试团队可以使用禅道来进行缺陷的跟踪管理。那么如果您是一位产品经理，您肯定要问了，禅道能不能用来当作需求管理工具呢？答案当然是Yes!

禅道系统中提供了完整的需求管理流程，这其中包括需求的创建，需求的变更，需求的评审等。下面让我们来看下。

1、创建产品。

创建需求的前提当然是要有产品，这和bug的处理是一样的。新增产品的时候，需要设置产品的名称、代码，几个负责人信息。

2、创建需求。

有了产品之后，就可以来创建需求了。

需求的创建页面

创建需求的时候，可以选择需求的来源。
需求的标题、描述和验证标准是需求的主要的三个元素，应该认真清晰的进行填写。
在创建需求的时候，可以指定需求的优先级、预计工时等字段。
创建需求的时候可以选择由谁来进行评审，这样创建的需求状态是草稿状态。如果勾选了”不需要评审“，则是激活状态。

3、变更需求。

禅道专门提供了需求的变更流程。凡是对需求标题、描述、验证标准和附件的修改，都应该走变更流程。变更之后的需求状态为变更中。

4、评审需求。

4.1 通过需求的详情页面查看变更前后的变化

4.2 评审需求，给出评审结果

评审结果可以选择确认通过，撤销变更，有待明确或者拒绝。

个人使用禅道来做事务跟踪管理

**简介：**对于普通的个人用户来讲，禅道也可以用作事务管理工具。

禅道设计的目标是团队协作工具，但其实个人使用禅道也可以派上很大的用场。笔者在开发禅道过程中，从2009年10月开始，用禅道来管理禅道本身的项目管理，那时候禅道的开发团队只有笔者光杆司令一人，后来和朋友们聊起，戏称一个人的项目管理。