1. windows一键安装包的目录必须部署在某一个硬盘分区的根目录，比如c:\xampp。
2. 如果mysql可以启动，但apache无法启动，提示"系统无法执行指定的程序"，则需要安装vcredist_x86.exe程序：https://download.microsoft.com/download/9/3/F/93FCF1E7-E6A4-478B-96E7-D4B285925B00/vc_redist.x86.exe

windows一键安装包需要将apache和mysql安装为服务才可以开机自动启动。因此首先要通过控制面板来将apache和mysql安装为服务。

如果已经安装过服务，但仍然无法启动，可以尝试将现有的服务卸载掉。xampp目录下面有apache_uninstallservice.bat和mysql_uninstallservice.bat，分别卸载apache服务和mysql服务。卸载之后再重新安装服务。

禅道的运行需要php加载pdo扩展。需要按照下面的步骤来处理：

1. 检查下你的环境中php有没有pdo和pdo_mysql的扩展。

如果没有，则需要对php.net官方网站下载对应版本的php安装程序，找到和你的php版本对应的pdo和pdo_mysql文件。
linux下面可以考虑通过包管理器安装，比如debian下面可以用apt-get install php5-pdo

2. 确认环境中有pdo的扩展之后，找到php.ini文件，加载pdo和pdo_mysql扩展。

3. 重启apache。

找到php.ini文件，修改error_reporting: error_reporting = E_ALL & ~E_STRICT

然后重新启动apache。

xampp是以32位方式编译的，可以通过下面的方式来解决这个问题：

1. 使用系统自带的apache, mysql, php。

2. 如果还坚持使用linux一键安装包的话，需要安装32位运行环境。具体请参考每个linux发行版本的说明。

先在linux下搭建同版本的禅道，然后把数据库和附件（zentao/www/data/upload）迁移过去。
数据库可以直接拷贝数据库的物理文件。
自己搭建环境，mysql物理文件目录一般在 /var/lib/mysql/ 。如果是集成包，就在集成包里面，具体看mysql的配置文件。

迁移介绍视频：http://www.zentao.net/video/c1456/p3.html

视频教程： 《禅道中如何安装、查找插件》

可以在后台→扩展→已安装中查看。

视频教程： 《禅道如何安装、查找插件》

在后台→扩展→本地安装，上传zip包按照提示安装即可。

注： 1、一个插件只能安装一次，否则数据库会冲突。插件的试用期一般是30天，从下载之日开始计算。 2、如果购买正式插件必须使用试用的帐号购买，否则可能导致原有数据清空。

视频教程： 《windows一键安装包如何修改端口号》

1、以管理员身份运行 xampp/start.exe，打开禅道集成面板。

2、点击禅道集成面板左上角，服务-卸载服务。

3、点击禅道集成面板左上角，服务-配置默认端口保存

4、退出禅道集成面板

5、重新以管理员身份运行 xampp/start.exe，点击“启动禅道”

比较早的版本修改方式：

服务器apache：xampp\apache\conf\httpd.conf里有端口的配置。

数据库mysql：

1、xampp\zentao\config\my.php

2、xampp\phpmyadmin\config.inc.php

3、xampp\mysql\my.ini

修改前请备份，修改后需要重启。

1、先确认服务器本机能正常访问禅道说明禅道安装没有问题。

2、在服务器本机访问禅道，把浏览器对应网址中的127.0.0.1改成服务器实际的ip，其余不变，别的电脑访问这个网址即可。如果别的电脑不能访问，检查服务器防火墙是否限制和网络是否连通。

卸载：控制面板左上角，服务→卸载服务。卸载服务后就可以删除了。

ioncube支持php5.4，php5.3版本。

安装文档：http://www.zentao.net/book/zentaoprohelp/194.html

sql XXX.zip 是数据库的执行sql，需要导入到一个空的数据库中。

备份介绍文档：http://www.zentao.net/book/zentaopmshelp/42.html

用apache的虚拟主机 或者 把apache的访问目录修改到zentao/www/

视频教程： 《Linux系统如何安装禅道》

1、下载lampp包（选择php是5.4的版本）：
64位：http://sourceforge.net/projects/xampp/files/XAMPP%20Linux/1.8.2/xampp-linux-x64-1.8.2-6-installer.run/download
32位：http://sourceforge.net/projects/xampp/files/XAMPP%20Linux/1.8.2/xampp-linux-1.8.2-6-installer.run/download

2、把下载的lampp包放到/opt/下面，执行 chmod a+rx *.run，添加执行权限，然后执行 ./xampp-linux-x64-1.8.2-6-installer.run(或者 ./xampp-linux-1.8.2-6-installer.run)，解压缩之后，会生成一个/opt/lampp/的目录。

3、启动服务。
启动：/opt/lampp/lampp start
停止：/opt/lampp/lampp stop
重启：/opt/lampp/lampp restart

4、安装禅道开源版：把禅道安装包解压得到zentaopms文件夹放到/opt/lampp/htdocs/

5、浏览器访问ip：端口/zentaopms/www/install.php 根据页面提示安装禅道。

视频教程： 《如何在一台服务器上部署两套禅道》

两套禅道可以共用一套apache mysql服务。

视频教程： 《Linux一键安装包如何修改端口号》

在禅道服务器依次执行：

1、/opt/zbox/zbox stop             （停止禅道服务）

2、/opt/zbox/zbox -ap 8080      （修改apache端口号，8080换成实际需要修改的端口号）

/opt/zbox/zbox -mp 3307          （修改mysql端口号，3307换成实际需要修改的端口号）

3、/opt/zbox/zbox start            （开启禅道服务）

视频教程： 《如何更换禅道运行代码》

如何更换禅道运行代码：

安装了禅道一键安装包，还需要使用蝉知、ZDOO产品，可以参考下面链接进行部署：

http://www.zentao.net/book/zentaopmshelp/261.html

1. 关闭下 seLinux ；

2. 递归设置下 zentaopms 源码目录的读写权限。

apache的配置问题。

删除 zentaopms/www/  文件夹下的 .ztaccess和.htaccess 文件，然后再访问一下。

替换一下禅道的运行代码文件,把禅道当前运行代码文件夹改名（一般默认是 zentao 或者 zentaopms）；

改名后网上下载相同版本禅道的源码，解压后放在同目录下面，保持文件夹名字和之前禅道运行代码文件夹名称相同 ；

然后把原先文件夹中的  config/my.php  www/data/upload/1  www/.ztaccess   www/.htaccess 拷贝到新禅道文件夹对应目录，再访问禅道试试。

注：

1、安装插件一定要安装和当前禅道版本号兼容的插件；

2、安装插件之前先备份禅道代码及数据库。

迁移前的系统在一键安装包的基础上，配置了ssl；新系统没有做ssl安装配置导致无法找到ssl.conf。

在/opt/zbox/etc/apache/httpd.conf中注释掉236行，apache启动成功。

视频教程： 《私有部署企业微信如何修改webhook地址》

在以下两个文件中搜索：qyapi.weixin.qq.com这个地址的位置，替换成私有部署的企业微信的地址。

zentao/lib/wechatapi/wechatapi.class.php

请在my.php文件中增加以下配置：

$config->framework->filterCSRF      = false;

如果是通过https访问的话，请在nginx配置中增加以下配置：

proxy_set_header X-Forwarded-Proto https;

再重载nginx和禅道apache或者是禅道服务即可。

视频教程： 《文档下载为什么乱码》

可在导出文档时尝试切换编码导出。

视频教程： 《禅道哪些情况会发送邮件》

可以登录禅道系统到”后台-通知-设置界面”设置自主设置触发通知的动作。

发布也会进行邮件通知。

注意：

视频教程： 《如何查看所有产品的需求列表》

通过“产品-软件需求”界面上方的搜索功能，设置查询条件：“所属产品=全部产品”，点击“搜索”即可查看所有产品的需求列表。

视频教程： 《禅道的模块同步规则》

禅道的模块同步规则:

视频教程： 《为什么任务的工时不能自动计算》

原因：

视频教程： 《任务工时是否可以用天数计算》

不能。禅道目前所有的任务工时都是用小时计算，如果单位是天，表示任务的颗粒度比较大，在执行过程中理解和估算的偏差都会大一些。

视频教程： 《为什么创建任务的时候，指派给没有相关成员》

创建任务时，“指派给”字段是从执行团队列表中读取的。若没有相关成员，说明还没有维护团队成员，需要先到“执行-设置-团队”，维护好团队成员再创建任务。

视频教程： 《为何创建了需求，项目或执行中关联需求时列表为空》

具体原因有以下三点：

视频教程： 《为什么任务完成之后会默认指派给其他用户》

这是因为禅道的设计流程是当任务完成之后，需要有人进行确认。默认会指派给任务的创建者进行确认(可以在任务完成界面选择指派人)。

视频教程： 《如何设置项目集、产品、项目、执行只有相关人员可以访问》

可通过设置项目集、产品、项目、执行的相应“访问权限”进行查看：

视屏教程： 《CentOS 如何设置系统定时任务》

系统管理员可使用 crontab -e 命令进入工作表编辑。每行是一条命令：

视频教程： 《如何修改附件大小》

提示网络异常一般是附件上传没成功，或者是一次性上传过大的附件导致PHP的执行时间超时了。

2、如果是自己搭建的环境，php默认2M为最大附件。
修改的话调整php.ini中的post_max_size和upload_max_filesize值，重启apache即可。

3、如果是nginx服务器或者使用nginx代理，nginx有一个上传附件大小的配置client_max_body_size参数，默认是1M，调整后重启。

4、文件上传时间限制默认为30s：
自己搭建的环境修改参数：php.ini中的max_execution_time(最大不要超过60，不建议修改此参数）
windows一键安装包：xampp/php/php.ini中max_execution_time（xampp\runner\res\php\php.ini 存在的话，也需要修改一下），调整后重启。

windows zbox一键安装包：ZenTao\etc\phpphp.ini中max_execution_time，调整后重启。
linux一键安装包：/opt/zbox/etc/php/php.ini也是修改这个参数并且重启。

视频教程： 《产品或项目删除后建不了同名的对象》

这是因为禅道中的删除是标记删除（附件除外），可在“后台-数据-回收站”里还原，加上产品或项目的名称不能重复，所以删除后不能创建同名对象。

视频教程： 《Bug的版本怎么维护》

在禅道中，BUG属性有两个版本：一个是解决版本，一个是影响版本。

视频教程： 《如何修改云禅道邮件提醒》

1、云禅道的每日提醒邮件是统一部署的，每天都会定时发送，不能单独设置；可以编辑用户资料，邮箱一栏留空，就不会收到邮件了。

视频教程： 《有管理员权限，但无法查看别人创建的产品》

禅道系统是有两种管理员权限的：

视频教程： 《如何配置Email发信》

可参照禅道发信配置文档：http://www.zentao.net/book/zentaopmshelp/96.html

如果配置成功，没有收到邮件，请到发信邮箱的“发件箱”确认是否发送成功，到“接收邮箱”查看邮件是否发到了“垃圾箱”。

视频教程： 《如何控制客户只能看到其相关产品》

客户提的需求应该经过产品人员整理后，把用于开发的需求录入到禅道中，“来源”可以选择“客户”。

视频教程： 《修改数据库密码后，禅道无法登录》

登录数据库的密码修改后，需要在zentao/config/my.php文件中同步一下修改的密码。

视频教程： 《需求关联项目或执行后，能否移除再跟其它项目或执行关联》

能。可在项目或执行的研发需求界面移除；另外，禅道里对需求的关联没有做限制，同一个需求可关联多个项目或执行。

视频教程： 《创建提交Bug指派给开发人员，为什么有的人看不到该BUG》

BUG有“所属产品”、“所属项目”、“所属执行”3个属性，必须同时具有“产品”、“项目”和“执行”的访问权限才可以看到这个BUG。同时需要在“后台-人员-权限”中分配BUG的相关权限。

视频教程： 《回收站里数据怎么彻底删除》

禅道界面上不能彻底删除。可以在“回收站”里隐藏，一定要删除的话只能到数据库进行删除。

视频教程： 《产品里的计划和发布有什么区别》

区别：

视频教程： 《版本和发布所关联的需求和Bug有什么区别》

创建版本中需求和Bug的概念：

视频教程： 《测试用例导入，点击保存后，怎么没有显示测试用例》

可以参照禅道的导入格式说明： http://www.zentao.net/dynamic/79869.html

视频教程： 《Bug有预估工时功能吗》

没有。但可以通过“迭代-任务-导入（右上角）”，将Bug导入进“迭代”中作为一个任务进行管理，就可以预估工时了。

视频教程： 《Bug可以关联需求和任务，不能关联用例吗》

执行失败的用例可以提交Bug，Bug详情页面也可以建用例，已经存在的Bug和已经存在的用例不能关联。

视频教程： 《任务的完成、关闭有什么区别》

区别：任务完成之后默认指派给任务的创建者进行确认，确认完成之后点击“关闭”，如果没有完成点击“激活”。

视频教程： 《在禅道中如何修改备注》

需要同时满足3个条件：

视频教程： 《禅道如何备份》

1、超级管理员进入禅道“后台-系统-数据-开始备份”，可手动备份数据、附件和代码；

视频教程： 《多次输入错误密码，用户会被锁定，如何解决》

1、管理员用户登录，在“后台-人员-用户”列表中，点击该锁定用户后面的锁图标，解锁；

视频教程： 《如何查看邮件发送记录》

在“后台-系统-定时”，开启异步发信的计划任务，在“后台-通知-邮件”，选择“异步”，保存后可以点击“邮件列表”查看异步发信发送的所有邮件记录。里面可以显示发送的时间及发送结果，需要注意：发送成功的邮件会在2天后自动清理删除掉。

视频教程： 《为什么指派给用户Bug或任务，他没有收到邮件》

1、点击“后台-系统-定时”，开启异步发信的计划任务，“后台-通知-邮件”选择“异步”，然后重新触发发信动作，5分钟后看“后台-通知-邮件-邮件列表”中是否有记录和结果；

视频教程： 《Bug可以只指派给团队成员吗》

提BUG时不一定会关联所属项目或所属执行，且当前指派人员有可能为测试主管而非团队成员，因此只指派给团队成员是不严谨的。

视频教程： 《为什么文档库权限设为私有后，其他用户仍能访问》

1、用户拥有产品或项目的访问控制权限，就拥有对应的产品文档库或项目文档库的访问控制权限，不受文档库访问控制权限的限制。

视频教程： 《任务的“转入任务”功能，需要哪些条件》

需要如下条件：

视频教程： 《“后台-系统-定时”修改后为什么没有生效》

修改后还需要执行如下操作：

视频教程： 《禅道数据库结构（数据字典）在哪里可以查看》

可以在“后台-二次开发-数据库“中查看数据库结构及相应字段的含义。

视频教程： 《禅道项目管理相关计算公式》

禅道项目管理，相关计算公式：

视频教程： 《禅道页面动态中显示的时间不对如何处理》

1、检查服务器上的日期及时间是否正确，注意需要使用 CST格式；

视频教程： 《一个执行下的需求和BUG如何导入到下一个执行迭代中》

1、需求：在“执行-需求-关联需求“界面手动关联一个执行未完成的需求；

视频教程： 《PHP版本查看方式》

1、Windows系统查看方式：在 xampp/start.exe 禅道面板查看或者 /xampp/php/php.exe 右键-“属性-详情信息”页签下看下版本。

视频教程： 《用户(研发)需求拆分的条件》

1、用户需要有批量创建需求的权限；

视频教程： 《禅道无法正常登录的原因》

1、检查服务器磁盘空间占用情况；

视频教程： 《如何分析燃尽图》

蓝色是每天实际的任务剩余工时之和；

燃尽图类型解析：https://blog.easycorp.cn/blog/80714.html?tdsourcetag=s_pcqq_aiomsg

视频教程： 《LDAP修改密码相关问题》

1、禅道中编辑修改了帐号密码只会修改禅道本地的密码，不会修改LDAP密码；

视频教程： 《LDAP集成后用户的登录的验证逻辑》

1、集成LDAP后，用户登录时默认是先连接到LDAP服务器的。

视频教程： 《项目、执行和产品下提交的需求有何不同》

需求默认是在产品下维护的，项目/执行下创建需求成功后，该需求会自动创建到当前项目/执行所关联的产品中，且自动关联到当前项目/执行。

视频教程： 《测试单、测试报告和测试任务的区别》

测试单：针对版本创建的测试用例清单，由测试人员在测试单中执行用例；

视频教程： 《一键安装包如何访问禅道数据库》

windows一键安装包 ：http://www.zentao.net/book/zentaopmshelp/76.html

视频教程： 《如何调整PHP内存大小》

1、linux一键安装包修改 /opt/zbox/etc/php/php.ini 中的memory_limit 值改成 1024M 保存后重启服务生效。

视频教程： 《反馈邮件抄送规则》

1、如果创建人创建反馈时设置了接收邮件通知，那这条反馈触发的邮件发送都会抄送给创建人；

视频教程： 《一键安装包如何设置域名》

其他可参考视频：http://www.zentao.net/video/windows-linux-domain-79986.html

视频教程： 《如何修改禅道访问端口》

解决方法：

视频教程： 《禅道如何集成git、svn和jenkins》

请参考链接：https://www.zentao.net/book/extra/549.html

视频教程： 《执行、迭代、阶段的概念》

在敏捷模型下，执行即迭代。

视频教程： 《Bug有效率如何计算》

Bug有效率=（已解决+延期处理）/（设计如此+重复Bug+外部原因+已解决+无法重现+延迟处理+不予解决+转为需求）

视频教程： 《禅道可以导入导出任务、需求、Bug和用例吗》

开源版可以导出csv、html、xml格式文档；

视频教程： 《需求版本如何维护》

需求是有版本控制的，每次变更都会增加一个新的版本，可以在需求详情页面的标题右侧以 #1.2.. 展示。

视频教程： 《禅道后台-备份如何操作进行还原》

方案一：

3、网页登录新禅道“后台-数据-备份”点击“还原”按钮进行还原。

方案二：
1、搭建相同版本号的禅道，保证网页可以正常访问；
2、将备份文件sql.php用文本编辑器打开删除开头的 ，然后重命名去掉.php，然后导入禅道数据库中；
3、将附件文件.file/upload/1目录全部放到新禅道zentao(pms)/www/data/upload/下面。

视频教程： 《如何查看禅道版本号》

1、网页登录禅道所有页面右下角；

15及以后版本使用流程可以参考：https://www.zentao.net/book/extra/503.html

视频教程： 《如何关闭禅道登录需要输入验证码》

1、在“后台-系统-安全”，点击“关闭登录使用验证码”；

视频教程： 《查看任务进度和时间消耗》

点击“执行-迭代-视图-分组视图”，左侧展开栏有对任务的统计。

1. 首先检查宿主机的操作系统是否为Ubuntu或CentOS的发行版本。
2. 检查你的网络是否畅通。
3. 将软件包管理工具的下载源切换至国内源。

1. 通过远程桌面访问执行节点，确认执行节点已正常启动。
2. 点击执行节点详情页面的检测服务状态按钮重新检测。

• 拉取代码后可以查看此文档安装 https://github.com/easysoft/zentaopms/blob/master/doc/INSTALL

• 另外源码包下载下来之后，需要做一下处理。linux下面需要执行下make命令，生成一个all.js和 all.css文件，或者可以把config/my.php里面的debug设成true。

  如果make环境没有的话，可以下载我们对应版本的源码安装包，里面有all.js和all.css文件。

• 下载地址：https://www.zentao.net/download/zentaopms18.5-82695.html