初始化管理脚本

1. 禅道介绍

1.1 关于禅道项目管理软件

1.2 如何获得支持

1.3 关注我们

2. 安装禅道

2.1. 环境搭建

2.1.1 搭建Ubuntu环境安装禅道

2.1.2 搭建Centos环境安装禅道

2.1.3 安装PHP的ioncube扩展

2.2. 安装12开源版

2.2.1 选择适合您的安装方法

2.2.2 使用云禅道在线项目管理服务

2.2.3 (推荐)windows用一键安装包安装

2.2.4 (推荐)linux用一键安装包

2.2.5 linux下用lampp集成包安装

2.2.6 使用源码包安装(MAC系统)

2.2.7 MAC下用XAMPP安装禅道

2.2.8 MAC下用XAMPP-VM安装禅道

2.2.9 禅道一键安装包里安装渠成软件

2.2.10 使用源码包安装(各系统通用)

2.2.11 宝塔面板安装禅道

2.2.12 华芸NAS在线安装

2.2.13 Centos7.4系统下安装httpd，mariadb，php7.2环境运行禅道

2.2.14 Centos8系统下安装httpd，mariadb，php7.2环境运行禅道

2.2.15 安装ioncube扩展

2.2.16 安装swoole扩展

2.2.17 Docker方式部署禅道

2.3. 安装12企业版

2.3.1 禅道企业版安装包安装方式(各系统通用)

2.3.2 (推荐)Windows一键安装包安装

2.3.3 (推荐)Linux一键安装包安装

2.3.4 centos 7.x 源码安装禅道企业版

2.4. 安装新版开源版

2.4.1 新版本禅道的安装升级

2.5. 安装新版旗舰版

2.5.1 选择适合您的安装方法

2.5.2 windows使用一键安装包(推荐)

2.5.3 linux用一键安装包(推荐)

2.5.4 使用源码包安装(MAC系统)

2.5.5 基于禅道当前的一键安装包（Windows和Linux）如何源码安装旗舰版禅道

3. 升级禅道

3.1. 升级12开源版

3.1.1 选择和自己环境对应的升级方式

3.1.2 通过源代码方式升级(通用)

3.1.3 windows一键安装包的升级

3.1.4 linux一键安装包升级

3.2. 升级12企业版

3.2.1 安装包方式升级

3.2.2 开源版升级到企业版

3.3. 升级新版旗舰版

3.3.1 选择和自己环境对应的升级方式

3.3.2 通过源代码方式升级(通用)

3.3.3 windows一键安装包的升级

3.3.4 linux一键安装包升级

3.3.5 升级流程引导

3.3.6 docker安装禅道-升级禅道

4. 维护配置

4.1. 维护禅道

4.1.1 初始化管理脚本

4.1.2 备份禅道

4.1.3 恢复删除的资源

4.1.4 如何更新燃尽图

4.1.5 一键安装包如何实现mysql异机连接

4.1.6 linux一键安装包配置https

4.2. 配置禅道

4.2.1 设置是否允许匿名访问

4.2.2 如何配置email发信

4.2.3 如何成为超级管理员

4.2.4 配置禅道系统为静态访问

4.2.5 去掉禅道访问地址中的zentao

4.2.6 linux一键安装包去掉禅道访问地址中的zentao

4.2.7 集成禅道和svn

4.2.8 集成禅道和git

4.2.9 在第三方应用中集成禅道

4.2.10 第三方应用配置免密登录禅道

4.2.11 第三方应用集成禅道客户端进行消息通知

4.2.12 集成webhook

4.2.13 集成ZDOO

4.2.14 客户端集成

4.2.15 禅道的翻译功能

4.2.16 浏览器通知的设置

4.2.17 集成钉钉工作消息通知

4.2.18 集成企业微信应用消息通知

4.2.19 集成飞书群机器人

4.2.20 集成飞书消息通知

4.2.21 集成版本库、集成Jenkins，并进行构建

4.2.22 解决一键安装包密码口令弱的问题

4.3. 性能优化

4.3.1 nginx反向代理禅道502或504bad gateway错误

4.3.2 linux系统中配置session使用redis

5. 快速入门

5.1. 12版本快速入门

5.1.1 禅道使用的基本流程和产品、研发、测试之间的三权分立

5.1.2 禅道的新手教程

5.1.3 创建第一个产品

5.1.4 添加第一个需求

5.1.5 开始第一个项目

5.1.6 确定项目要完成的需求列表

5.1.7 为需求分解任务

5.1.8 提交bug

5.1.9 禅道的自定义功能

5.1.10 文档管理

5.1.11 如何排查产品、项目是否有访问权限

5.1.12 年度总结，工作内容统计一览表说明

5.2. 12版创建分组和用户

5.2.1 建立部门结构

5.2.2 添加一个用户帐号

5.2.3 批量维护帐号

5.2.4 设置分组，建立权限体系

5.3. 12版本最简使用

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

5.3.2 只使用禅道来做bug管理

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

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

5.4. 12版本基本使用

5.4.1 敏捷开发及scrum简介

5.4.2 禅道和scrum的对应关系

5.4.3 视频教程：第一个演示项目

5.4.4 维护联系人

5.4.5 导入excel、csv参考文档

5.4.6 工作方式的切换

5.4.7 操作获取积分功能

5.4.8 自定义必填项功能

5.5. 12版本进阶使用

5.5.1. 使用流程

5.5.1.1 禅道使用流程图解

5.5.2. 个人管理

5.5.2.1 使用待办进行个人事务管理

5.5.2.2 关注需要自己处理的任务、需求、bug

5.5.2.3 通过我的档案查看或者修改个人信息

5.5.2.4 视频教程：禅道使用之个人篇

5.5.3. 产品经理篇

5.5.3.1 维护产品

5.5.3.2 维护产品线

5.5.3.3 创建和评审需求

5.5.3.4 变更和评审需求

5.5.3.5 需求的状态和研发阶段

5.5.3.6 需求的注意事项

5.5.3.7 维护产品模块

5.5.3.8 建立发布计划

5.5.3.9 建立发布

5.5.3.10 路线图

5.5.3.11 文档管理

5.5.3.12 主持产品会议

5.5.3.13 参与项目管理、演示和总结

5.5.3.14 需求的基本统计报表

5.5.3.15 视频教程：禅道使用之产品经理篇

5.5.4. 项目经理篇

5.5.4.1 建立项目

5.5.4.2 组建项目团队

5.5.4.3 确定项目要完成的需求列表

5.5.4.4 组织进行任务分解

5.5.4.5 召开每天的站立会议

5.5.4.6 通过燃尽图了解项目的进展

5.5.4.7 通过各种列表的各种功能了解项目进展

5.5.4.8 召开演示会议和总结会议

5.5.4.9 项目任务基本的报表统计

5.5.4.10 视频教程：禅道使用之项目经理篇

5.5.5. 开发团队篇

5.5.5.1 参加项目计划会议，分解任务

5.5.5.2 领取任务，并每天更新任务

5.5.5.3 通过看板和树状图查看任务

5.5.5.4 创建版本

5.5.5.5 申请测试

5.5.5.6 解决bug

5.5.5.7 文档管理

5.5.5.8 确认bug

5.5.5.9 视频教程：禅道使用之开发团队篇

5.5.6. 测试团队篇

5.5.6.1 维护bug视图模块

5.5.6.2 提交bug

5.5.6.3 验证bug，关闭

5.5.6.4 激活bug

5.5.6.5 找到自己需要的bug

5.5.6.6 维护测试用例视图

5.5.6.7 创建测试用例

5.5.6.8 测试套件、报告和公共用例库的维护

5.5.6.9 管理测试版本

5.5.6.10 执行用例，提交Bug

5.5.6.11 查看报表统计

5.5.6.12 视频教程：禅道使用之测试团队篇

5.6. 12版本企业版使用

5.6.1 开源版功能

5.6.2 添加用户和权限维护

5.6.3 甘特图功能简介

5.6.4 工作日志管理功能简介

5.6.5 代码库（SVN GIT）及代码评审

5.6.6 日历功能简介

5.6.7 Excel导入导出功能简介

5.6.8 短信通知功能简介

5.6.9 运维管理

5.6.10 导出为Word功能简介

5.6.11 水晶报表（自定义报表）功能简介

5.6.12 LDAP用户验证功能简介

5.6.13 反馈管理

5.6.14 统计视图功能简介

5.6.15 文档管理

5.6.16 报表导出功能简介

5.6.17. 办公管理

5.6.17.1 考勤

5.6.17.2 请假

5.6.17.3 补班

5.6.17.4 加班

5.6.17.5 调休

5.6.17.6 节假日

5.6.18. 工作流

5.6.18.1 工作流内置流程

5.6.18.2 工作流功能简介

5.6.18.3 自定义内置工作流

5.6.18.4 新增工作流示例

5.6.18.5 工作流 JS、CSS 使用说明

5.6.19 视频及PPT资料

6. 按照角色使用

6.1. 管理员

6.1.1 维护组织部门

6.1.2 维护用户

6.1.3 维护权限

6.1.4. 办公管理（企业版）

6.1.4.1 考勤（企业版）

6.1.4.2 请假（企业版）

6.1.4.3 补班（企业版）

6.1.4.4 加班（企业版）

6.1.4.5 调休（企业版）

6.1.4.6 节假日（企业版）

6.1.4.7 审批（企业版）

6.1.5. 工作流（企业版）

6.1.5.1 内置工作流（企业版）

6.1.6 短信通知（企业版）

6.1.7. 运维管理（企业版）

6.1.7.1 ZAgent的使用（企业版）

6.1.7.2 虚拟机的使用

6.1.8 LDAP用户验证（企业版）

6.2. 项目集负责人

6.2.1 创建项目集

6.2.2 添加产品

6.2.3 创建项目

6.2.4 管理人员

6.2.5 添加干系人

6.2.6 可视化大屏（企业版）

6.3. 产品经理

6.3.1 创建产品

6.3.2 维护模块

6.3.3 产品多分支/平台管理

6.3.4 维护计划

6.3.5 维护需求

6.3.6 需求的评审

6.3.7 创建发布

6.3.8 跟踪进度

6.3.9 反馈管理（企业版）

6.4. 项目经理

6.4.1 维护项目和执行

6.4.2 维护团队

6.4.3 关联需求

6.4.4 分解任务

6.4.5 跟踪进度

6.4.6 甘特图（企业版）

6.4.7 代码评审（企业版）

6.4.8 瀑布项目的使用

6.4.9. 瀑布项目特有功能（旗舰版）

6.4.9.1 维护项目的计划、阶段（旗舰版）

6.4.9.2 项目设计、矩阵（旗舰版）

6.4.9.3 项目评审、配置（旗舰版）

6.4.9.4 项目报告、挣值管理（旗舰版）

6.4.9.5 项目调研、估算（旗舰版）

6.4.9.6 项目问题、风险、机会（旗舰版）

6.4.9.7 项目过程、度量、QA（旗舰版）

6.4.9.8 项目培训、会议（旗舰版）

6.4.10 看板项目的使用

6.4.11 文档管理（企业版）

6.4.12 Excel 导入导出（企业版）

6.4.13 Word 导出（企业版）

6.4.14 统计（企业版）

6.4.15 报表导出（企业版）

6.4.16 资产库管理

6.5. 研发人员

6.5.1 参加产品计划会议，分解任务

6.5.2 领取任务，并每天更新任务

6.5.3 创建版本，提交测试

6.5.4 确认Bug，解决Bug

6.5.5 执行的综合、需求、Bug、任务看板

6.6. 测试人员

6.6.1 撰写用例

6.6.2 执行用例

6.6.3 提交Bug

6.6.4 验证和关闭BUG

7. 功能介绍

7.1. 新增概念

7.1.1 项目集（Program）

7.1.2 项目（Project）

7.1.3 产品（Product）

7.1.4 管理模型

7.2. 地盘

7.2.1 新手引导

7.2.2 全局添加

7.2.3 首页区块

7.2.4 新增内容

7.2.5 工作日志（企业版）

7.2.6 日历（企业版）

7.3. 项目集

7.3.1 项目集列表

7.3.2 分解子项目集

7.3.3 创建项目集

7.4. 产品

7.4.1 创建产品

7.4.2 维护模块

7.4.3 产品多分支/平台管理

7.4.4 维护计划

7.4.5 维护需求

7.4.6 需求的评审

7.4.7 创建发布

7.4.8 跟踪进度

7.5. 项目

7.5.1. 项目通用功能

7.5.1.1 项目的基本设置

7.5.1.2 维护项目的执行

7.5.1.3 维护项目的需求

7.5.1.4 维护项目的Bug、用例、测试单、测试报告

7.5.1.5 维护项目的文档

7.5.1.6 维护项目的版本、发布

7.5.2. 瀑布项目特有功能（企业版与旗舰版）

7.5.2.1 维护项目的计划、阶段

7.5.2.2 项目设计、矩阵（矩阵为企业版）

7.5.2.3 项目评审、配置（企业版）

7.5.2.4 项目报告、挣值管理（旗舰版）

7.5.2.5 项目调研、估算（旗舰版）

7.5.2.6 项目问题、风险、机会（旗舰版）

7.5.2.7 项目过程、度量、QA（旗舰版）

7.5.2.8 项目培训、会议（旗舰版）

7.6. 执行

7.6.1 参加产品计划会议，分解任务

7.6.2 领取任务，并每天更新任务

7.6.3 创建版本，提交测试

7.6.4 确认Bug，解决Bug

7.6.5 执行的综合、需求、Bug、任务看板

7.7. 测试

7.7.1 撰写用例

7.7.2 执行用例

7.7.3 提交Bug

7.7.4 验证和关闭BUG

7.8. DevOps

7.8.1. DevOps 功能

7.8.1.1 Git/SVN版本库管理和查看代码

7.8.1.2. 集成GitLab

7.8.1.2.1 绑定用户，关联issue，进行构建

7.8.1.2.2 合并请求

7.8.1.2.3 禅道中GitLab的权限

7.8.1.3 集成Jenkins，进行构建

7.8.1.4 集成SonarQube

7.9. 看板

7.9.1 通用看板功能

7.10. 资产库（旗舰版）

7.10.1 资产库管理（旗舰版）

7.11. 文档

7.11.1 文档管理

7.11.2 接口库

7.12. 统计

7.12.1 统计（企业版）

7.12.2 报表导出（企业版）

7.12.3 水晶报表（自定义报表）（企业版）

7.12.4 可视化大屏（企业版）

7.13. 组织

7.13.1 团队成员和工作信息

7.13.2 组织动态

7.13.3 公司信息

7.14. 办公（企业版）

7.14.1 考勤

7.14.2 请假

7.14.3 补班

7.14.4 加班

7.14.5 调休

7.14.6 审批

7.15. 运维（企业版）

7.15.1 ZAgent的使用

7.15.2 虚拟机的使用

7.16 反馈（企业版）

7.17. 学堂（企业版）

7.17.1 学堂的课程和后台（企业版）

7.18. 工作流（企业版）

7.18.1 内置工作流（企业版）

7.19. 后台设置

7.19.1 集成禅道客户端

7.19.2 模型

7.19.3 自定义

7.19.4. 通知

7.19.4.1 邮件

7.19.4.2 Webhook

7.19.4.3 浏览器

7.19.4.4 设置

7.19.4.5 配置飞书内的禅道单点登录

7.19.5 插件

7.19.6 二次开发

7.19.7 系统

7.19.8 导入Jira数据

7.19.9 登记菜单和权限

7.19.10. 权限维护和访问控制

7.19.10.1 项目集的权限维护和访问控制

7.19.10.2 产品的权限维护和访问控制

7.19.10.3 项目的权限维护和访问控制

7.19.10.4 执行的权限维护和访问控制

7.19.10.5 项目和执行的访问控制和数据关系

7.19.11 短信通知（企业版）

7.19.12 Excel 导入导出（企业版）

7.19.13 Word 导出（企业版）

7.19.14 LDAP 用户验证（企业版）

7.19.15 审批流程（旗舰版）

8. 其他相关

8.1. 其他

8.1.1 禅道所使用到的第三方代码

8.1.2 禅道FAQ

8.1.3 如何帮助禅道项目

8.1.4 禅道商业服务

8.1.5 禅道项目的贡献者

8.1.6 历史修改记录

2010-04-21 17:12:01

王春生

103649

最后编辑：柳婷婷于 2022-07-19 13:37:45

分享链接

摘要：禅道命令行接口给大家提供了另外一种控制禅道的方式，可以通过它来进行各种各样的操作。

禅道底层的zentaoPHP框架提供了命令行的操作入口，通过这个功能，可以通过命令行实现对禅道的各种配置或者维护工作。在继续阅读下面文章之前，请大家了解这篇文档： http://devel.cnezsoft.com/book/extension/34_cli.html

命令行入口功能强大，但使用起来还是有一些繁琐，所以从4.0版本开始，我们对常见的操作进行了封装，提供了常见的管理脚本，比如备份数据库、更新燃尽图等等。下面我们要做的就是来初始化这些管理脚本。

安装禅道之后，在zentao/bin目录下面有两个脚本，init.bat和init.sh，分别适用于windows和linux平台。这两个基本是用来生成各个命令行工具的。为什么这样设置呢？原来的时候我们在bin目录下面提供了checkdb.php, backup.php等脚本，但这些脚本都需要进行配置之后才能正常使用。但下次版本升级之后，这些修改过之后的脚本就会被覆盖，不方便。所以从4.0版本开始我们提供了这两个init脚本来生成这些脚本。下面我们来看下如何生成吧。

一、windows平台
二、linux 平台
三、windows下面一键安装包通过控制面板生成
四、linux下面一键安装包通过控制脚本生成

一、windows平台

windows平台下面，使用init.bat脚本，比如我们的程序是安装在i:\xampp目录下面。

cd i:\xampp\zentao\bin
init.bat

禅道项目管理软件生成命令行

这个脚本会提示你输入php可执行文件的路径，输入i:\xampp\php\php.exe，如果是其他的php环境，请按照实际的路径填写。
还需要填写禅道的访问url路径，请根据实际的访问域名进行填写，比如pms.abc.com，如果端口号不是80，还需要把端口号写上。注：如果是windows一键安装包或者linux一键安装包，访问地址是 http://127.0.0.1:88 /zentao (专业版是 http://127.0.0.1:88 /pro ),一定要加上zentao(专业版加pro)。
设定了php可执行文件的路径之后，这个init.bat脚本就会自动生成backup.bat, computeburn.bat等这些脚本了。

二、linux 平台

如果是在linux平台下面，则需要使用init.sh脚本，以linux一键安装包为例：

cd /opt/zbox/app/zentao/bin
sudo ./init.sh

这个脚本会提示你输入php可执行文件的路径，输入/opt/zbox/bin/php，如果是其他的php环境，请按照实际的路径填写。
还需要填写禅道的访问url路径，请根据实际的访问域名进行填写，比如pms.abc.com，如果端口号不是80，还需要把端口号写上。
设定了php可执行文件的路径之后，这个init.bat脚本就会自动生成backup.sh, computeburn.sh等这些脚本了。

三、windows下面一键安装包通过控制面板生成

如果是使用的windows一键安装包，还可以通过控制面板来生成。

禅道项目管理软件控制面板

注意：通过控制面板生成的时候，禅道的访问路径是自动判断的，有可能是错误的，如果是错误的话，可以自己手工执行init.bat 重新生成。

四、linux下面一键安装包通过控制脚本生成

如果是使用的linux一键安装包，在执行start或者start88脚本来启动禅道环境的时候，会自动帮你生成，后续还可以通过上面的init.sh来手工重新生成。

注意：通过start 或者start88 脚本来生成的时候，禅道的访问路径是自动判断的，有可能是错误的，如果是错误的话，可以自己手工执行init. sh 重新生成。

发表评论

评论列表

2022-09-21 12:26:37

Ubuntu升级到22.04LTS后，禅道启动不成功，apache日志文件、mysql日志文件都没有写入，请帮助看一下什么问题。启动过程的信息如下：

root@psdz:/opt/zbox# ./zbox start
AH00543: httpd: bad user name nobody
Start Apache fail. You can see the log /opt/zbox/logs/apache_error.log
Start Mysql fail. You can see the log /opt/zbox/logs/mysql_error.log
root@psdz:/opt/zbox# ls -l logs
总用量 0

2022-09-21 13:40:11 回复

您好，您可以先确认下服务器系统中是否存在 nobody 这个用户，如果不存在的话，需要手动新建一个nobody用户。然后重新启动禅道试试呢。

2022-05-13 08:52:59

备份保留时间调了14天，但是/backup下堆积了两天的备份一点都没自动清理掉，要怎样手动清理比较安全我是专业版8.7.1

2022-05-13 17:47:17 回复

手动点击备份，可以正常备份吗？zentao/config/my.php 中debug的值改成true ，手动点击下备份按钮，看日志文件 zentao/tmp/log/php开头的今天的文件有什么报错。注：不要找sql开头的文件。

2022-05-13 17:48:40 回复

可以看下备份页面提示的备份目录backup路径，直接到这个目录下去按日期清理一下备份，这里都是备份文件，清理不会对禅道有影响
咱们这个问题，需要看下每天备份的是会生成3个文件吗？三个文件生成后才会触发清理的动作。如果生成的不是3个文件，可能备份没有完成，需要看下具体的日志
zentao(ep/pro/pms)/config/my.php 中debug的值改成true 重新操作一下看日志文件 zentao(ep/pro/pms)/tmp/log/php开头的今天的文件有什么报错。

2022-02-10 17:34:36

目前在liunx下执行backup.sh，会备份出一个.sql.php文件，一个.file文件夹，一个.code文件夹，我可以在哪里修改一下指令，使得可以每次生成一个包含这三部分文件的.tar压缩包吗？

2022-02-11 08:50:00 回复

这个需要二次开发一下了，需要修改zentao/module/backup里的代码文件，可以看下禅道框架介绍和二次开发手册https://devel.easycorp.cn/page/zentaophp.html
此外需要注意，这里的修改还会影响后台-系统-数据-系统备份里的展示和还原

2021-10-17 23:10:12

ubuntu 在zentao/bin/路径下没看到有backup.sh文件，init.sh和init.bat是看到了。backup.sh是在哪里下载吗？

2021-10-18 10:38:24 回复

参考这篇手册，执行init.sh执行，按照提示录入信息，可以自动生成。

2021-10-08 11:10:43

免费版本使用了一段时间，如何将数据备份后倒入到旗舰版？

2021-10-08 13:39:06 回复

您好，开源版数据是可以迁移到旗舰版的，关于具体的操作以及旗舰版的功能介绍，已经联系相关同事跟您对接了：)

2021-06-05 19:21:06

Windows上面一键安装部署之后，默认的访问路径是http://127.0.0.1:80/index.php，可不可以自定义一下访问路径，比如pms.xxx.com, 可以的话怎么操作，谢谢

2021-06-07 09:30:56 回复

1、可以修改apache配置文件（xampp\runner\res\apache\conf\httpd.conf 和 xampp\apache\conf\httpd.conf 文件）修改访问地址，修改后重启服务。
2、或者可以将这个域名与服务器IP做好映射，直接使用域名访问禅道。

2021-04-08 16:03:50

将备件数据还原至新迁移的禅道中（同版本内操作），步骤中贴图丢失？如何找回

2021-04-08 17:35:39 回复

在新服务器上搭建好相同版本的禅道，拷贝数据是把附件（zentao/www/data/upload/1）拷贝到新禅道相同目录了吗？可以参考迁移视频 http://www.zentao.net/video/c1456/p3.html

2019-10-21 14:33:40

我该如何重置所有的数据呢？比如：已建立并正常使用很久的禅道，里面有很多数据。现在我想所有的数据重置，将禅道重置到初始状态，所有的序号都从1开始。我该如何做呢？

2019-10-21 17:15:17 回复

如果所有数据都不要了，可以删除后重新安装禅道。目前最新开源版11.6.4，下载地址http://www.zentao.net/download/80174.html

2019-03-21 14:32:59

新增定时脚本，如何调用执行？
在init.sh同目录下增加一个定时脚本，新增的定时脚本如何执行？

2019-03-21 15:54:16 回复

可以直接添加到操作系统的计划任务 crontab 中。

2019-01-17 09:48:55

ubuntu 16.04，用源码包部署的，linux(ubuntu) + apache(2.4) + php(7.0) + mysql(5.6)
怎么初始化管理脚本呢？
root@ubuntu:/var/www/html/zentaopms/bin# ./init.sh
Please input your php path:(example: /usr/bin/php)
/var/www/html/zentaopms/bin/php
php path is error
Please input your php path:(example: /usr/bin/php)

2019-01-17 18:00:18 回复

输入的php路径不对，php执行文件路径一般是在 /usr/bin/php 文件下，可以核实下php执行文件的路径，重新执行脚本看下