| 通过源码安装进行到第四步的时候空白 | |
|
找到php.ini文件，修改里面的session.save_path参数，将其设置为实际存在的路径。如果是ntfs分区或者linux，还需要为其增加其他人的读写权限。然后重启apache。 |
|
| 为什么windows一键安装包apache无法启动? | |
|
1. windows一键安装包的目录必须部署在某一个硬盘分区的根目录，比如c:\xampp。 |
|
| windows一键安装包默认的用户名和密码是什么？ | |
|
禅道系统的默认用户名是admin，密码是123456。数据库的默认用户名是root，密码为空。 |
|
| windows一键安装包无法开机自动启动 | |
|
windows一键安装包需要将apache和mysql安装为服务才可以开机自动启动。因此首先要通过控制面板来将apache和mysql安装为服务。 如果已经安装过服务，但仍然无法启动，可以尝试将现有的服务卸载掉。xampp目录下面有apache_uninstallservice.bat和mysql_uninstallservice.bat，分别卸载apache服务和mysql服务。卸载之后再重新安装服务。 |
|
| 安装的时候提示没有pdo扩展 | |
|
禅道的运行需要php加载pdo扩展。需要按照下面的步骤来处理： 1. 检查下你的环境中php有没有pdo和pdo_mysql的扩展。
如果没有，则需要对php.net官方网站下载对应版本的php安装程序，找到和你的php版本对应的pdo和pdo_mysql文件。 2. 确认环境中有pdo的扩展之后，找到php.ini文件，加载pdo和pdo_mysql扩展。 3. 重启apache。 |
|
| 安装的时候提示：Warning: Creating default object from empty value | |
|
找到php.ini文件，修改error_reporting: error_reporting = E_ALL & ~E_STRICT 然后重新启动apache。 |
|
| 64位linux机器提示: XAMPP is currently only availably as 32 bit application. Please use a 32 bit compatibility library for your system. | |
|
xampp是以32位方式编译的，可以通过下面的方式来解决这个问题： 1. 使用系统自带的apache, mysql, php。 2. 如果还坚持使用linux一键安装包的话，需要安装32位运行环境。具体请参考每个linux发行版本的说明。 |
|
| 如何从Windows的禅道中将数据导出到Linux的禅道中？ | |
|
参考我们的
备份文档。主要是数据库和附件。
先在linux下搭建同版本的禅道，然后把数据库和附件（zentao/www/data/upload）迁移过去。 迁移介绍视频： http://www.zentao.net/video/c1456/p3.html |
|
| 部署新版本的代码，执行upgrade.php又跳回到了首页 | |
|
代码覆盖不对，注意不要覆盖成zentao/zentao这样的路径。:) |
|
| 禅道升级之后速度变得比较慢 | |
|
可能的原因是链接数据库时，使用localhost，如果本机没有对localhost进行解析，会导致数据库链接缓慢。可以考虑修改下zentao/config/my.php里面的数据库服务器，将localhost改成127.0.0.1。 |
|
| 如何查找禅道下安装了什么插件？ | |
|
可以在后台→扩展→已安装中查看。 扩展列表中没有，不表示没有安装，也可能安装没完成或者是直接覆盖的代码。 |
|
| 如何安装禅道插件？ | |
|
在后台→扩展→本地安装，上传zip包按照提示安装即可。 如果是自己搭建的禅道环境，安装收费试用插件的话需要先安装ioncube扩展，可参照： http://www.zentao.net/book/zentaoprohelp/194.html。 注：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，其余不变，别的电脑访问这个网址即可。如果别的电脑不能访问，检查服务器防火墙是否限制和网络是否连通。 |
|
| windows一键安装包安装的禅道怎么卸载，再安装？ | |
|
卸载：控制面板左上角，服务→卸载服务。卸载服务后就可以删除了。 重新安装：把zentao/config/my.php中install的值设成false，重新访问禅道会自动进入安装程序。 |
|
| 提示apachezt 安装失败，该如何处理？ | |
|
1、点击禅道控制面板左上角服务→卸载服务，然后点击退出。 2、右键以管理员身份运行 start.bat 然后点击启动禅道，如果还不行可以试试 xampp/services/install.bat（也是右键以管理员身份运行）。 |
|
| 目前使用禅道5.3版本，可以升级到6.2版本吗？升级版本会影响之前购买的插件吗？ | |
|
可以升级到最新版本，升级文档：
http://www.zentao.net/book/zentaopmshelp/c4.html。 升级操作之前先备份，升级到最新版本，插件也需要升级到兼容版本。 登录www.zentao.ne t点击用户中心→已买插件→升级，禅道升级后直接在禅道 后台→扩展→本地安装 上传zip进行安装，之前的插件不要卸载。 |
|
| 禅道需要安装ioncube吗？ | |
|
禅道开源版不需要安装ioncube，如果开源版安装了收费插件就必须安装ioncube。 ioncube支持php5.4，php5.3版本。 安装文档： http://www.zentao.net/book/zentaoprohelp/194.html |
|
| 禅道备份的backup怎么还原？ | |
|
找到备份的文件 fileXXX.zip ，附件解压后放到 zentao/www/data/upload/ sql XXX.zip 是数据库的执行sql，需要导入到一个空的数据库中。 备份介绍文档： http://www.zentao.net/book/zentaopmshelp/42.html |
|
| 如何才能使登录禅道直接跳转到登录页面？ | |
|
用apache的虚拟主机 或者 把apache的访问目录修改到zentao/www/ |
|
| Linux系统如何安装禅道？ | |
|
1、下载lampp包（选择php是5.4的版本）： 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、启动服务。 4、安装禅道开源版：把禅道安装包解压得到zentaopms文件夹放到/opt/lampp/htdocs/ 5、浏览器访问ip：端口/zentaopms/www/install.php 根据页面提示安装禅道。 |
|
| 如何设置禅道开机启动 | |
|
Windows一键安装包： Windows xp和Windows 2003系统，在禅道启动控制面板，左上角的服务→查看服务里，找到apachezt和mysqlzt把启动类型设置为自动。 Windows 2008和win7以上的系统，请务必右键以管理员身份启动 启动禅道.exe，点击启动禅道，系统会自动安装服务为开机自动启动。 Linux系统和自己搭建的禅道，可以在系统开机启动项里设置。 |
|
| 在一台机器上，如何同时运行两套禅道？ | |
|
两套禅道可以共用一套apache mysql服务。 Windows一键安装包的话，第2套禅道可以直接把禅道源码放在xampp/htdocs/下面，然后浏览器访问 ip:端口/zentaopms/www/进行安装。 |
|
| 如何初始化禅道数据库？ | |
|
把zentao/config/my.php 里面install的值改成false。 访问禅道，会自动进入安装页面，所有数据都会清空。 |
|
| 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 （开启禅道服务） |
|
| 如何更换禅道运行代码？ | |
|
如何更换禅道运行代码： 1. 之前的禅道 web 目录 zentao(pro/pms) 重命名为 zentao(pro/pms)_bak ； 2. 下载 与当前版本一致的源码包，解压后的 zentaopms ，重命名为之前的 web 目录名称 zentao(pro/pms) ； 3. 把 zentao(pro/pms)_bak/config/my.php 文件，拷贝到 zentao(pro/pms)/config/ 目录下； 4. 把 zentao(pro/pms)_bak/config/license/ 目录下的所有文件，拷贝到 zentao(pro/pms)/config/license/ 目录下； 4. 把 zentao(pro/pms)_bak/www/data/upload/1/ 目录下的所有文件，拷贝到 zentao(pro/pms)/www/upload/1/ 目录下； 5. 把 zentao(pro/pms)_bak/www/目录下的 .ztaccess 、.htaccess 文件，拷贝到 zentao(pro/pms)/www/ 目录下； 6. 访问禅道，看下功能是否正常。 |
|
| 使用禅道一键安装包集成环境，如何安装蝉知、ZDOO？ | |
|
安装了禅道一键安装包，还需要使用蝉知、ZDOO产品，可以参考下面链接进行部署： http://www.zentao.net/book/zentaopmshelp/261.html |
|
| 如何在 mac 上部署禅道？ | |
|
目前，禅道的一键安装包，只支持 linux , windows 环境。 1. 在 mac 上部署禅道，需要自己搭建 apache mysql php 环境；也可以使用 xampp 官网的集成工具： https://www.apachefriends.org/zh_cn/download.html 2. 使用源码安装的方式进行部署： http://www.zentao.net/book/zentaopmshelp/101.html |
|
| 源码安装，安装界面提示 getPhpVersion() 错误。 | |
|
1. 关闭下 seLinux ； 2. 递归设置下 zentaopms 源码目录的读写权限。 |
|
| 源码安装禅道，访问网页提示：Internal Server Error | |
|
apache的配置问题。 删除 zentaopms/www/ 文件夹下的 .ztaccess和.htaccess 文件，然后再访问一下。
|
|
| 后台-插件 安装了插件后无法登录禅道了怎么办？ | |
|
替换一下禅道的运行代码文件,把禅道当前运行代码文件夹改名（一般默认是 zentao 或者 zentaopms）； 改名后网上下载相同版本禅道的源码，解压后放在同目录下面，保持文件夹名字和之前禅道运行代码文件夹名称相同 ； 然后把原先文件夹中的 config/my.php www/data/upload/1 www/.ztaccess www/.htaccess 拷贝到新禅道文件夹对应目录，再访问禅道试试。 注： 1、安装插件一定要安装和当前禅道版本号兼容的插件； 2、安装插件之前先备份禅道代码及数据库。 |
|
| 云服务器启动xxd提示 WebSocket server listen err 。 | |
|
是因为机器上并没有这个ip地址，是服务商通过路由机制转发的。解决方法是将监听ip设置为：0.0.0.0 。 |
|
| linux一建安装包迁移，apache无法启动：could not open configuration file /etc/httpd/conf.d/ssl.conf | |
|
迁移前的系统在一键安装包的基础上，配置了ssl；新系统没有做ssl安装配置导致无法找到ssl.conf。 在/opt/zbox/etc/apache/httpd.conf中注释掉236行，apache启动成功。 |
|
| 私有部署企业微信如果修改webhook地址 | |
|
在以下两个文件中搜索：qyapi.weixin.qq.com这个地址的位置，替换成私有部署的企业微信的地址。 zentao/lib/wechatapi/wechatapi.class.php zentao/moudule/webhook/config.php |
|
| 15系列版本安装后，nginx访问时登录无反应，ip可以登录。 | |
|
请在my.php文件中增加以下配置： $config->framework->filterCSRF = false; 如果是通过https访问的话，请在nginx配置中增加以下配置： proxy_set_header X-Forwarded-Proto https; 再重载nginx和禅道apache或者是禅道服务即可。 |
|
| 文档下载之后有乱码？ | |
|
可在导出文档时尝试切换编码导出。 |
|
| 为什么配置了邮箱之后，没有收到邮件？（禅道哪些情况会发送邮件？） | |
|
可以登录禅道系统到”后台-通知-设置界面”设置自主设置触发通知的动作。 禅道邮件默认通知范围： BUG：指派给+抄送 添加，编辑，指派，确认BUG，解决，激活，关闭，导入到项目； 需求：指派给+抄送 添加，编辑，变更，激活，评审，关闭，更改计划，更改分支，更改阶段，指派； 任务：指派给+抄送 添加，编辑，指派，开始，完成，激活，关闭，取消，重启； 测试版本：负责人+抄送 创建，编辑； 需求关联到项目后需求变动会给所有项目成员发邮件； 项目版本提交测试给测试负责人发邮件； 发布也会进行邮件通知。 注意： 1、“后台-通知-邮件”需保证发信功能已经配置成功；2、需要在“后台-人员-列表”需要维护好账号的个人邮箱信息； 3、禅道不会给当前操作者发信。 |
|
| 怎么查看所有产品的需求列表？ | |
|
通过“产品-软件需求”界面上方的搜索功能，设置查询条件：“所属产品=全部产品”，点击“搜索”即可查看所有产品的需求列表。 |
|
| 禅道的模块同步规则 | |
|
禅道的模块同步规则: 1、产品的模块会全部同步到BUG、用例中； 2、产品的模块会选择性的同步到任务中：在“执行-任务”列表页面点击左侧“模块设置”，选择 “是否显示完整产品模块”，如果选择显示，产品的模块会全部同步到任务中；如果选择不显示，则具体规则如下： 1）“项目”中关联的需求在“产品”中的“模块”。比如产品模块A下面有4个需求，项目都没有关联，那么在“项目”中是不会显示模块A的，只要关联了4个需求中的任何一个及以上，项目模块就可以显示模块A； 2）创建任务时可以选择产品的某个模块（即使没有关联该模块下的需求，在创建任务时也可以关联），创建任务后也会显示出该模块。 备注：任务、BUG、用例都可以维护自己的单独模块。 |
|
| 为什么任务的工时不能自动计算？ | |
|
原因： 任务的工时有：“最初估计“、”已消耗“和”预计剩余“。 禅道目前的设计方案更侧重于“引导用户真实评估剩余工时”。 如果实现自动计算，大多数用户就不会重新进行评估，无法体现任务真实的剩余工时，燃尽图无法更准确地反应项目的进度。 |
|
| 任务工时是否可以用天数计算？ | |
|
不能。禅道目前所有的任务工时都是用小时计算，如果单位是天，表示任务的颗粒度比较大，在执行过程中理解和估算的偏差都会大一些。 任务颗粒度小的好处： 1、工作内容更明确，可以减少理解偏差的产生； 2、估算更精准，有利于项目的进度控制； 3、更快的任务进度体现，有利于项目风险的及时展示。 |
|
| 任务是否可以指派给多个人？ | |
|
可以。两种操作方式： 1、创建任务时可以选择“多人任务”(多人串行进行一个任务)； 2、已经创建的任务可以分解多个“子任务”(每个人一个任务，可并行执行)； 3、创建任务时，类型选择“事务类型”，指派人可多选(每个人一个任务，可并行执行)。 注意：一个任务只能是多人任务和父子任务中的一种。 |
|
| 为什么创建任务的时候，指派给没有相关成员？ | |
|
创建任务时，“指派给”字段是从执行团队列表中读取的。若没有相关成员，说明还没有维护团队成员，需要先到“执行-设置-团队”，维护好团队成员再创建任务。 |
|
| 已经创建了需求，但为什么项目或执行中关联需求的时候列表为空？ | |
|
具体原因有以下三点： 1、“项目”或“执行”是否已经关联了需求所在的产品； 2、“需求”的状态需要为激活状态； 3、已经关联过的需求不会在关联页面中列出。 |
|
| 为什么任务完成之后会默认指派给其他用户？ | |
|
这是因为禅道的设计流程是当任务完成之后，需要有人进行确认。默认会指派给任务的创建者进行确认(可以在任务完成界面选择指派人)。 |
|
| 怎么设置才能只看到自己相关的项目集、产品、项目、执行？ | |
|
可通过设置项目集、产品、项目、执行的相应“访问权限”进行查看： 1、项目集：创建、编辑项目集时可以设置“访问控制”为“私有”(项目集负责人和干系人可访问，干系人可后续维护)； 2、产品：创建、编辑产品时可以设置“访问控制权限”为“私有”(产品相关负责人、所属项目集的干系人、相关联项目的团队成员和干系人可访问)； 3、项目：创建、编辑项目时可以设置“访问控制权限”为“私有”(只有项目负责人、团队成员和干系人可访问)； 4、执行：创建、编辑迭代时可以设置“访问控制权限”为“私有”(团队成员和项目负责人、干系人可访问)。 |
|
| CentOS 如何设置系统定时任务？ | |
|
系统管理员可使用 crontab -e 命令进入工作表编辑。每行是一条命令： 实例1：每晚的21:30执行备份脚本 30 21 * * * /opt/zbox/app/zentao/bin/backup.sh 实例2：每8小时重启一次禅道 0 */8 * * * /opt/zbox/zbox restart 参考链接： https://www.runoob.com/w3cnote/linux-crontab-tasks.html |
|
| 禅道里为什么上传附件时会提示网络异常？上传附件的大小如何修改？ | |
|
提示网络异常一般是附件上传没成功，或者是一次性上传过大的附件导致PHP的执行时间超时了。 |
|
| 关于上传附件的大小限制和时间限制 | |
|
关于上传附件的大小限制和时间限制： 1、windows一键安装包最大附件默认设置成50M。 如果还不够用，推荐把附件放到公共硬盘上，禅道中留下访问地址即可。 一定要修改的话，可以修改 xampp/zentao/www/.ztaccess 和 xampp\runner\res\ztaccess\下面的default.access、pro.access 中的post_max_size 和upload_max_filesize值。
2、如果是自己搭建的环境，php默认2M为最大附件。 3、如果是nginx服务器或者使用nginx代理，nginx有一个上传附件大小的配置client_max_body_size参数，默认是1M，调整后重启。
4、文件上传时间限制默认为30s： |
|
| 产品或项目删除后建不了同名的对象？ | |
|
这是因为禅道中的删除是标记删除（附件除外），可在“后台-数据-回收站”里还原，加上产品或项目的名称不能重复，所以删除后不能创建同名对象。 如果一定要重新创建，可以先把删掉的产品或项目还原后修改名称再删除。 |
|
| 创建BUG时选择所属的版本如何添加(BUG的版本怎么维护)？ | |
|
在禅道中，BUG属性有两个版本：一个是解决版本，一个是影响版本。 影响版本是指BUG在哪个版本上发现的；解决版本是指在哪个版本上修复的。 版本在“执行-版本”中创建。 |
|
| 首页的“最新动态”一栏，可以看到自己无权查看的任务更新信息，如何设置不显示？ | |
|
可在“后台-人员-权限界面-视野“维护，取消”组织视图-组织动态“的相关显示权限。 保存后重新登录就不显示动态信息了。 |
|
| 如何修改云禅道邮件提醒？ | |
|
1、云禅道的每日提醒邮件是统一部署的，每天都会定时发送，不能单独设置；可以编辑用户资料，邮箱一栏留空，就不会收到邮件了。 2、其他邮件通知可以到“后台-通知-设置“界面设置哪些动作进行通知。 |
|
| 禅道管理员如何重置密码？ | |
|
1、登录禅道数据库zt_user表，找到用户的记录，把password的值改成 e10adc3949ba59abbe56e057f20f883e ，登录密码就是123456； 2、管理员可以点击禅道登录页面“忘记密码”按钮，根据提示在禅道服务器上创建验证文件进行密码重置。 |
|
| 已经是管理员权限了，为什么还是不能查看到别人创建的产品(私有化)？ | |
|
禅道系统是有两种管理员权限的： 1、超级管理员权限，不受任何权限控制(一键安装包默认为admin用户，源码部署即安装时自行设置的管理员账号)； 2、加入到管理员权限分组的账号，这些账号会受到权限分组的限制。如果需要将某个账号添加为超级管理员权限，可以参考这个手册： https://www.zentao.net/book/zentaopmshelp/107.html |
|
| 如何配置Email发信？ | |
|
可参照禅道发信配置文档：
http://www.zentao.net/book/zentaopmshelp/96.html 配置发信的邮箱没有限制，只要禅道所在服务器可以正常连接到邮箱服务即可。 配置后点击“测试发信”，能收到测试邮件，说明发信成功。 如果配置成功，没有收到邮件，请到发信邮箱的“发件箱”确认是否发送成功，到“接收邮箱”查看邮件是否发到了“垃圾箱”。 使用QQ、163邮箱要注意：1、邮箱开启smtp服务（如果是刚刚申请的邮箱，需要过几天才能用smtp服务）； 2、ssl对应465端口，不加密对应25端口，应该有一个可以正常使用； 3、smtp帐号需要填写完整的邮箱地址。 |
|
| 我们想让客户直接通过禅道提交需求，如何控制客户只能看到与其相关的产品？ | |
|
客户提的需求应该经过产品人员整理后，把用于开发的需求录入到禅道中，“来源”可以选择“客户”。 也可以使用收费版本的“反馈”功能，让客户直接提交反馈，具体可以参考： https://www.zentao.net/book/zentaobizhelp/266.html |
|
| 修改数据库密码后，禅道无法登录？ | |
|
登录数据库的密码修改后，需要在zentao/config/my.php文件中同步一下修改的密码。 |
|
| 需求关联项目或执行后，这个需求能否移除再跟其它项目或执行关联？ | |
|
能。可在项目或执行的研发需求界面移除；另外，禅道里对需求的关联没有做限制，同一个需求可关联多个项目或执行。 |
|
| 创建提交BUG指派给开发人员，为什么有的人看不到该BUG？ | |
|
BUG有“所属产品”、“所属项目”、“所属执行”3个属性，必须同时具有“产品”、“项目”和“执行”的访问权限才可以看到这个BUG。同时需要在“后台-人员-权限”中分配BUG的相关权限。 |
|
| 回收站里数据怎么彻底删除？ | |
|
禅道界面上不能彻底删除。可以在“回收站”里隐藏，一定要删除的话只能到数据库进行删除。 数据库删除方法：比如删除id是10的任务，登录数据库zt_task表找到id是10的编号记录。 禅道数据库结构： http://www.zentao.net/book/zentaopmshelp/157.html |
|
| 产品里的计划和发布有什么区别？ | |
|
区别： 计划是用来规划一个时间段内，需要完成哪些需求，解决哪些BUG。一般一个计划对应一个项目或迭代，项目的内容就是实现计划中的需求和解决计划关联的BUG。 发布是需求开发完成后，对外发布软件或者产品上线。 |
|
| 版本和发布所关联的需求和BUG有什么区别？ | |
|
创建版本中需求和BUG的概念： 需求：项目关联的需求（开发完成或者关闭的需求会默认选中）； BUG：与项目关联的非关闭的BUG（解决的BUG会默认选中）。 创建发布中需求和BUG的概念： 需求：版本所在项目关联的需求（开发完成或者关闭的需求会默认选中）； BUG: 从版本所在项目的开始时间到当前解决了的当前产品的BUG（关闭或者解决的BUG会默认选中）。 |
|
| 测试用例导入，点击保存后，怎么没有显示测试用例？ | |
|
可以参照禅道的导入格式说明：
http://www.zentao.net/dynamic/79869.html 注意以下事项： 1、使用导出的模板导入； 2、确认创建页面的必填项，如果导入的数据必填项没有值，这条数据会被过滤； 3、导入数据如果标题有重名的只会保留一条； 4、确认导入用例的所属模块和当前列表页面选择模块是否一致。 |
|
| BUG有预估工时功能吗？ | |
|
没有。但可以通过“迭代-任务-导入（右上角）”，将BUG导入进“迭代”中作为一个任务进行管理，就可以预估工时了。 |
|
| BUG可以关联需求和任务，不能关联用例吗？ | |
|
执行失败的用例可以提交BUG，BUG详情页面也可以建用例，已经存在的BUG和已经存在的用例不能关联。 |
|
| 任务的完成、关闭有什么区别？ | |
|
区别：任务完成之后默认指派给任务的创建者进行确认，确认完成之后点击“关闭”，如果没有完成点击“激活”。 |
|
| 一台机器上，运行两套禅道，用户帐号串了怎么办？ | |
|
找到其中一套禅道里的zentao/config/config.php，将里面的sessionVar改成自定义值（例如zid），重新登录禅道。 |
|
| 如何修改备注？ | |
|
需要同时满足3个条件： 1、有修改备注的权限（在“后台-人员-权限”中维护）； 2、是本人自己添加的备注； 3、只能修改历史记录最后一条记录中的备注。 |
|
| 访问禅道可以绑定域名吗？ | |
|
可以。修改apache的配置即可。 可以参考： http://www.zentao.net/book/zentaopmshelp/131.html |
|
| 新版本禅道上传附件后，附件为什么会多出“.txt”后缀？ | |
|
这个是新版本新增的安全机制。 可以编辑这个文件/zentao(pms/pro/biz)/config/config.php中config->file->allowed，将需要上传文件的后缀名添加到白名单中。 |
|
| 禅道后台如何取消或者更改绑定的禅道官网（www.zentao.net）帐号？ | |
|
禅道界面上暂时无法解除绑定，需要登录禅道数据库zt_config表查找key = ‘community’的记录进行修改或者删除。 |
|
| 禅道如何备份？ | |
|
1、超级管理员进入禅道“后台-系统-数据-开始备份”，可手动备份数据、附件和代码； 2、超级管理员进入禅道“后台-系统--定时”，开启备份数据和附件计划任务后，系统会自动启动每日备份功能； 3、参考禅道备份文档： http://www.zentao.net/book/zentaopmshelp/42.html。 |
|
| 禅道兼容哪些浏览器？ | |
|
推荐使用Chrome、火狐、Microsoft Edge、Opera、Safari浏览器。 |
|
| 多次输入错误密码，用户会被锁定，如何解决？ | |
|
1、管理员用户登录，在“后台-人员-用户”列表中，点击该锁定用户后面的锁图标，解锁； 2、等待10分钟后，再次登录； 3、到数据库找到zt_user表，把该用户的locked字段值改成：0000-00-00 00:00:00 。 |
|
| 如何查看邮件发送记录？ | |
|
在“后台-系统-定时”，开启异步发信的计划任务，在“后台-通知-邮件”，选择“异步”，保存后可以点击“邮件列表”查看异步发信发送的所有邮件记录。里面可以显示发送的时间及发送结果，需要注意：发送成功的邮件会在2天后自动清理删除掉。 |
|
| 为什么指派给一个用户BUG或者任务，他没有收到邮件？ | |
|
1、点击“后台-系统-定时”，开启异步发信的计划任务，“后台-通知-邮件”选择“异步”，然后重新触发发信动作，5分钟后看“后台-通知-邮件-邮件列表”中是否有记录和结果； 2、禅道不会给当前操作帐号发送邮件； 3、被指派人是否在“后台-人员-用户”中维护邮箱。 |
|
| BUG可以只指派给团队成员吗？ | |
|
提BUG时不一定会关联所属项目或所属执行，且当前指派人员有可能为测试主管而非团队成员，因此只指派给团队成员是不严谨的。 目前BUG当前指派显示规则如下： 1、当BUG关联了所属项目，提BUG时，当前指派默认显示为该项目团队下的成员，点击“加载所有人员”可显示全部人员； 2、当BUG关联了所属执行，提BUG时，当前指派默认显示为该执行团队下的成员，点击“加载所有人员”可显示全部人员； 3、当BUG关联的所属项目为空，提BUG时，当前指派下拉列表默认为最近一次操作项目的团队成员，点击“加载所有用户”可显示全部人员； 4、当BUG选择所属模块，提BUG时，当前指派会默认显示模块负责人。 |
|
| 为什么已经维护产品文档库或项目文档库的访问控制权限为自定义或私有，其他用户还是可以访问？ | |
|
1、用户拥有产品或项目的访问控制权限，就拥有对应的产品文档库或项目文档库的访问控制权限，不受文档库访问控制权限的限制。 2、可以在“文档-自定义库”中创建文档库，并设置文档库的访问控制权限。 |
|
| 任务的“转入任务”功能，需要哪些条件？ | |
|
需要如下条件： 1、之前的执行已经过期或者结束； 2、当前帐号有权限访问之前执行； 3、之前执行有未完成的任务，只能导入未完成的任务； 4、新的执行和老的执行必须关联同一个产品； 5、不能导入子任务； 6、任务状态是以下状态中的一种：未开始、进行中、暂停、取消； 7、如果任务关联了需求，那新的执行必须也关联这个需求所在的产品（如果是多平台/多分支产品，还需要新的执行关联了需求所在的平台/分支）。 |
|
| “后台-系统-定时”修改后为什么没有生效？ | |
|
修改后还需要执行如下操作： “后台-系统-定时-关闭 =》重启apache服务 =》 开启-后台-系统-定时”。 目的是全部重新加载计划任务的配置，确保新的配置生效。 |
|
| 禅道数据库结构（数据字典）在哪里可以查看？ | |
|
可以在“后台-二次开发-数据库“中查看数据库结构及相应字段的含义。 |
|
| 禅道项目管理相关计算公式 | |
|
禅道项目管理，相关计算公式： 项目进度 = 项目下任务工时总消耗 /（项目下任务工时总消耗 + 项目下任务工时总剩余） 执行进度 = 执行下任务工时总消耗 /（执行下任务工时总消耗 + 执行下任务工时总剩余） 任务进度 = 消耗工时 /（消耗工时 + 剩余工时） 工作负载 = 总工时 /（工作日天数 * 每天工时） 执行可用工时 = 可用工作日 * 团队成员数 * 每日可用工时 |
|
| 禅道页面动态中显示的时间不对如何处理？ | |
|
1、检查服务器上的日期及时间是否正确，注意需要使用 CST格式； 2、检查PHP程序是否设置了时区； 3、后台-系统-时区设置为(UTC+08:00) Shanghai。 |
|
| 禅道如何和别的系统集成实现免密登录？ | |
|
禅道系统和其他系统集成免密登录可以参考官方文档： https://www.zentao.net/book/zentaopmshelp/344.html |
|
| 一个执行下的需求和BUG如何导入到下一个执行迭代中？ | |
|
1、需求：在“执行-需求-关联需求“界面手动关联一个执行未完成的需求； 2、BUG：在新的执行“迭代-任务”界面右上角“导入-导入BUG”。 |
|
| PHP版本查看方式 | |
|
1、Windows系统查看方式：在 xampp/start.exe 禅道面板查看或者 /xampp/php/php.exe 右键-“属性-详情信息”页签下看下版本。 2、Linux 一键安装包php版本：/opt/zbox/bin/php -v 查看版本。 3、源码包或docker通过web界面查看： zentaopms/www 目录下创建test.php文件，内容为： <?php echo phpinfo(); ?> 然后web界面访问该文件，例如：http://192.168.1.130:81/test.php |
|
| 用户(研发)需求拆分的条件 | |
|
1、用户需要有批量创建需求的权限； 2、需求状态需要是激活； 3、需求没有被关联到项目或计划中。 |
|
| 禅道突然无法正常登录（可以显示登录页面）？ | |
|
1、检查服务器磁盘空间占用情况； 2、检查session目录读写权限变化； 3、检查浏览器是否开启自动密码记忆功能，建议手动输入； 4、配置nginx代理后，需要在禅道的目录zentao(pro)/config/my.php文件中，加一行:$config->framework->filterCSRF = false。 |
|
| 如何分析燃尽图？ | |
|
蓝色是每天实际的任务剩余工时之和； 灰色是执行迭代开始日期所有任务预计工时汇总和迭代结束0点连成的线； 蓝色线围绕着灰色线走 表示迭代进展比较顺利； 燃尽图类型解析： https://blog.easycorp.cn/blog/80714.html?tdsourcetag=s_pcqq_aiomsg |
|
| LDAP修改密码相关问题 | |
|
1、禅道中编辑修改了帐号密码只会修改禅道本地的密码，不会修改LDAP密码； 2、禅道中修改密码后直接用LDAP密码进行登录，用LDAP账号密码登录后，会把LDAP用户的密码覆盖禅道本地的密码。 |
|
| LDAP集成后用户的登录的验证逻辑 | |
|
1、集成LDAP后，用户登录时默认是先连接到LDAP服务器的。 a.如果LDAP中有这个用户，禅道中也有，会直接登录； b.如果LDAP中有这个用户，禅道中没有且禅道集成时“自动创建用户”勾选了“是”，会自动创建一个同名用户； c.如果LDAP中有这个用户，禅道中没有而且禅道集成时“自动创建用户”勾选了“否”，则登录失败。 2、使用LDAP密码登录，会先到LDAP中验证，验证通过，会将密码更新到禅道数据库里，以后就只能用新密码登录。 3、使用禅道系统新修改的密码登录，会先到LDAP服务器进行验证，验证不通过，再到禅道数据库进行验证；验证通过，也可以成功登录。 |
|
| 项目/执行下提交的需求和产品下提交的需求有什么不同？ | |
|
需求默认是在产品下维护的，项目/执行下创建需求成功后，该需求会自动创建到当前项目/执行所关联的产品中，且自动关联到当前项目/执行。 |
|
| 测试单和测试任务的区别？ | |
|
测试单：针对版本创建的测试用例清单，由测试人员在测试单中执行用例； 测试任务：测试人员在测试过程中的工作内容和消耗，可以维护在测试类型的任务中，算作测试任务。 |
|
| 一键安装包如何访问禅道数据库？ | |
|
windows一键安装包 ：
http://www.zentao.net/book/zentaopmshelp/76.html linux一键安装包： http://www.zentao.net/book/zentaopmshelp/90.html |
|
| 如何调整php内存大小？ | |
|
1、linux一键安装包修改 /opt/zbox/etc/php/php.ini 中的memory_limit 值改成 1024M 保存后重启服务生效。 2、windows一键安装包修改 xampp/php/php.ini 和 xampp/runner/res/php/php.ini 中的memory_limit 参数的值 改成 1024M 保存后重启服务生效。 3、源码安装，修改php.ini的memory_limit 参数的值 改成 1024M 保存后重启php-fpm、nginx/apache。 |
|
| Docker容器中如何安装禅道？ | |
|
可以参考文档：
https://www.zentao.net/book/zentaopmshelp/405.html |
|
| 反馈邮件抄送规则 | |
|
1、如果创建人创建反馈时设置了接收邮件通知，那这条反馈触发的邮件发送都会抄送给创建人； 2、如果指派反馈的时候设置了抄送人，那这条反馈发送邮件的时候会给抄送人发送邮件； 3、如果反馈关联了产品并且产品设置了反馈负责人，那发送反馈的时候会给当前产品的反馈负责人发送邮件。 |
|
| 反馈未关闭列出的反馈符合的条件 | |
|
反馈未关闭列出的反馈符合的条件（1、2、3条需要同时满足）： 1、状态不是 closed（已关闭）； 2、（2个条件满足一个即可）当前帐号有权限访问反馈所属产品，或者反馈指派人是当前帐号； 3、（2个条件满足一个即可）状态不是 noreview（待评审）、clarify（待完善），或者自己创建的反馈。 |
|
| “反馈-全部”页面显示的反馈 | |
|
“反馈-全部”页面显示的反馈需要符合任一条件： 1、自己创建的反馈会列出； 2、列出当前帐号有权限访问产品的反馈； 3、非待评审、非待完善的反馈。 |
|
| 一键安装包如何设置域名？ | |
|
可参考视频：
http://www.zentao.net/video/windows-linux-domain-79986.html |
|
| 禅道如何修改访问端口？ | |
|
解决方法： 1、windows一键安装包修改端口： 运行"xampp/start.exe"后点击左上角"服务-卸载服务"，然后"服务-配置默认端口"保存后退出，重新以管理员身份运行"xampp/start.exe" 点击"启动禅道"。 2、linux 一键安装包修改端口： sudo /opt/zbox/zbox stop sudo /opt/zbox/zbox -mp 3307 sudo /opt/zbox/zbox -ap 82 sudo /opt/zbox/zbox start 端口号，根据需要变更（mp是mysql端口； ap是apache端口） |
|
| 禅道如何集成git、svn和jenkins？ | |
|
请参考链接：
https://www.zentao.net/book/extra/549.html |
|
| 禅道发送的邮件为什么是垃圾邮件？ | |
|
这个是收件邮箱服务器上的规则决定的，禅道是无法控制的。 可以使用 smtp服务发信，统一用企业邮箱发信，然后企业邮箱接收，一般就不会进入垃圾箱中了。 |
|
| 执行、迭代、阶段的概念。 | |
|
在敏捷模型下，执行即迭代。 禅道旗舰版增加了瀑布模型，在瀑布模型下，执行就是阶段。 禅道统一将敏捷的迭代和瀑布的阶段整合到执行模块。 |
|
| BUG有效率如何计算？ | |
|
BUG有效率=（已解决+延期处理）/（设计如此+重复BUG+外部原因+已解决+无法重现+延迟处理+不予解决+转为需求） |
|
| windows一键安装包部署，80端口未被占用，无法启动？ | |
|
点击禅道控制面板左上角“服务-卸载服务”，然后点击“退出”；右键以管理员身份运行start.exe然后点击启动禅道。 |
|
| 局域网如何设置访问禅道？ | |
|
1、先确认禅道服务器本机能正常访问。 2、其他电脑在浏览器输入http://禅道服务器ip:port 访问。如果不能访问，请检查服务器防火墙是否有端口限制，确认网络是否连通。 |
|
| 禅道能在mac上安装吗？ | |
|
可以，请参考链接： https://www.zentao.net/book/zentaopmshelp/332.html https://www.zentao.net/book/zentaopmshelp/331.html |
|
| linux一键安装包如何设置开启自启？ | |
|
在linux系统自启动文件 /etc/rc.local 中，添加 sudo/opt/zbox/zbox restart， 需要给/etc/rc.local 文件777权限。 |
|
| 禅道可以导入导出任务、需求、BUG和用例吗？ | |
|
开源版可以导出csv、html、xml格式文档； 收费版本会增加导入和导出xls、xlsx格式文档； 开源版也可以通过安装excel导入导出的插件（ http://www.zentao.net/extension-viewExt-27.html）来实现。 |
|
| 需求的版本怎么维护呢？ | |
|
需求是有版本控制的，每次变更都会增加一个新的版本，可以在需求详情页面的标题右侧以 #1.2.. 展示。 |
|
| 禅道后台-备份如何操作进行还原？ | |
|
方案一： 1、搭建相同版本号的禅道，保证网页可以正常访问； 2、拷贝备份文件到新禅道相同目录，分配读写权限； 3、网页登录新禅道“后台-数据-备份”点击“还原”按钮进行还原。
方案二： |
|
| 如何查看禅道版本号？ | |
|
1、网页登录禅道所有页面右下角； 2、网页登录禅道“后台-首页”查看； 3、Linux一键安装包通过数据库查看： (1)进入数据库：/opt/zbox/bin/mysql -u root -P 3306 -p (2)选择zentao数据库：use zentao； (3)查看版本：select `value` from zt_config where `key`='version'; 4、windows一键安装包：xampp/start.exe启动后看控制面板，点击访问禅道，在禅道欢迎页点击数据库管理，选择 zentao库，找到zt_config表，查看字段key为version的那条数据的value值。 5、config文件的version参数：zentao(pms)/config/config.php（开源版） |
|
| 禅道使用流程 | |
|
12系列禅道使用流程可以参考：
https://www.zentao.net/book/zentaopmshelp/165.html 15及以后版本使用流程可以参考： https://www.zentao.net/book/extra/503.html |
|
| office附件是否支持在线预览？ | |
|
在线预览是付费版本的功能，企业版及以上都可以实现，需要配置libreoffice或者collaboraoffice，通过collaboraoffice可以实现多人在线编辑的功能。 |
|
| 如何关闭禅道登录需要输入验证码？ | |
|
1、在“后台-系统-安全”，点击“关闭登录使用验证码”； 2、在数据库中将zt_config表中将 `key` = 'loginCaptcha' 的数据中value值设置为0 。 |
|
| 如何查看需求下面的任务进度和时间消耗？ | |
|
点击“执行-迭代-视图-分组视图”，左侧展开栏有对任务的统计。 |
|
| 安装禅道时提示session目录不可写 | |
|
1、找到php.ini文件，修改里面的session.save_path参数，将其设置为实际存在的路径（MAC系统Session放到application目录下）。如果是ntfs分区或者linux，还需要为其增加其他人的读写权限（selinux需要关闭）。 2、然后重启php-fpm、webserver，然后重新安装禅道。 |
|
| 禅道的附件信息存储在哪？ | |
|
文件基本信息在数据库表zt_file表，物理文件目录zentao/www/data/upload/1目录。 |
