今日目标

能够掌握禅道的安装及运行
能够掌握禅道的组成结构
能够掌握禅道的基本使用流程
能够掌握禅道创建分组和用户
能够掌握Bug管理
能够掌握文档管理

一、禅道介绍

禅道官网：www.zentao.net

禅道是一款开源项目管理软件。它集产品管理、项目管理、质量管理、文档管理、组织管理和事务管理于一体，是一款专业的研发项目管理软件，完整覆盖了研发项目管理的核心流程。禅道将产品、项目、测试这三者的概念明确分开，产品人员、开发团队、测试人员，这三者分立，互相配合，又互相制约，通过需求、任务、bug来进行交相互动，最终通过项目拿到合格的产品。

禅道是一个非常好用的项目管理平台，很多大企业都在使用。今天我们讲如何在Linux上搭建开源版的禅道！

二、禅道安装及运行

1. 禅道软件下载地址：

http://www.zentao.net/download.html

将下载好的安装包直接放到服务器的/opt目录下(以下是通过FileZilla上传)

[root@eclipse ~]# cd /opt
[root@eclipse opt]# ls
ZenTaoPMS.15.3.zbox_64.tar.gz

2. 解压：

sudo tar -zxvf  ZenTaoPMS.15.3.zbox.64.tar.gz -C /opt

3. Apache和Mysql常用命令

执行/opt/zbox/zbox start 命令开启Apache和Mysql。
执行/opt/zbox/zbox stop 命令停止Apache和Mysql。
执行/opt/zbox/zbox restart 命令重启Apache和Mysql。

其它：因为禅道用到的apache和自带的mysql的端口分别是80和3306，这会与我们服务器上其他程序的端口冲突，所以需要修改apache和mysql端口，其中-ap对应apache的端口，-mp对应mysql端口(如果不冲突，则不需要修改)

如果需要修改端口号则执行以下命令，然后在进行启动Apache和Mysql
/opt/zbox/zbox -ap 8090 -mp 3307

4. 启动禅道

/opt/zbox/zbox start

5. 访问和登录禅道

http://服务器的ip地址:端口，例如[禅道])

http://119.45.22.188:8090/

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

登录后，即可使用禅道项目管理功能。具体的使用，请直接参考禅道使用手册文档

三、如何访问禅道数据库

1、网页登录数据库

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

如何操作：网页访问 http://禅道服务的ip:apache端口，点击“数据库管理”按钮有2层验证：

1）弹窗验证是输入运行 addusers.sh添加的用户名和密码。

我加的用户名是root，密码是root。那么授权页面里用户名和密码就填写root和root。
注意： 这里添加的用户名和密码是自定义的，你可以根据你的使用习惯来添加。
你添加了什么用户名和密码就填写什么。

2）网页直接显示登录界面：

系统：默认选择MySQL。

服务器：127.0.0.1:mysql端口（mysql端口启用的是3307，那么就填写127.0.0.1:3307。注意：ip只能写127.0.0.1）

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

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

数据库：zentao。

四、创建分组和用户

1、建立部门结构

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

a)维护部门结构

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

b)维护子部门

点击部门名称，即可添加该部门的下级部门（子部门）。下级部门添加成功后，即可在部门机构里查看到。

2、添加一个用户帐号

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

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

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

3、批量维护帐号

从4.0版本开始，禅道提供了批量添加帐号的功能，可以很方便的批量创建帐号。使用管理员登录禅道系统，进入“后台”页面。选择“用户”，然后选择右侧的“批量添加用户”

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

4、设置分组，建立权限体系

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

在禅道中，用户权限都是通过分组来获得的。所以在完成部门结构划分之后，就应该建立用户分组，并为其分配权限。有的朋友可能会问，用户分组和部门结构有什么区别？我们来解释下这个问题。
部门结构是公司从组织角度来讲的一个划分，它决定了公司内部人员的上下级汇报关系。而禅道里面的用户分组则主要用来区分用户权限。二者之间并没有必然的关系。比如用户A属于产品部，用户B属于研发部，但他们都有提交bug的权限。

a)创建分组

使用管理员登录禅道，进入后台视图。
选择权限分组，进入分组的列表页面。

点击新增分组，即可创建分组。
在这个分组列表页面，还可以对某一个分组进行权限的维护、成员维护、或者复制。

b)维护权限

1.管理员身份登录 2.进入后台视图 3.点击”权限分组“，进入权限分组列表页面。 4.选择某一个分组，点击“权限维护”，即可维护该分组的权限。 5.进入权限列表页面，点击某一个模块名后面的复选框，可以全选该模块下面的所有权限，或者全部取消选择。还可以查看某一个版本新增的权限列表，即下图的红框位置。 6.禅道7.2.stable版本开始，还提供视图维护权限。可以设置某个分组仅能查看某个产品或者项目等。等等权限操作

五、最简使用

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

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

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

a)、创建项目

添加新项目，进入项目视图，在项目主页的项目总览区块中点击“创建项目”。

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

b)设置团队

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

c)、分解任务

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

禅道系统中的计划管理是在产品维度下维护的，在创建项目选择关联计划时，需要先在项目关联的产品页面创建计划的，可以检查下 "内部产品支持"这个产品是否有创建了计划呢？

之后就可以保存计划了，待研发的列表。

不同的角色登录就会展示自己角色下的待研发列表

六、禅道问答社区

禅道官网的技术问答: www.zentao.net/ask/

这里面可以进行提问你在使用禅道过程中遇到的问题，并且绝大多数都能够得到解答

禅道项目管理软件配置及使用