

- 1. 禅道介绍
- 1.1 关于禅道项目管理软件
- 1.2 如何获得支持
- 1.3 各版本功能差异
- 1.4 关注我们
- 2. 安装禅道
- 2.1. 环境搭建
- 2.1.1 搭建Ubuntu环境安装禅道
- 2.1.2 搭建Centos环境安装禅道
- 2.1.3 安装PHP的ioncube扩展
- 2.2. 安装禅道
- 2.2.1 选择适合您的安装方法
- 2.2.2 新版本禅道的安装升级
- 2.2.3 Windows一键安装包(新版)
- 2.2.4 Windows一键安装包(旧版)
- 2.2.5 linux用一键安装包(推荐)
- 2.2.6 使用源码包安装(各系统通用)
- 2.2.7 使用源码包安装(MAC系统)
- 2.2.8 基于禅道当前的一键安装包(Windows和Linux)如何源码安装旗舰版禅道
- 2.2.9 渠成命令行安装禅道
- 2.2.10 Docker和Kubernetes方式部署禅道
- 2.3 安装PHP的LDAP扩展
- 2.4 在线安装云禅道
- 2.5 安装 APCu扩展
- 2.6 安装DuckDB引擎
- 2.1. 环境搭建
- 3. 升级禅道
- 3.1. 升级禅道新版本
- 3.1.1 选择和自己环境对应的升级方式
- 3.1.2 通过源代码方式升级(通用)
- 3.1.3 windows一键安装包的升级
- 3.1.4 linux一键安装包升级
- 3.1.5 docker安装禅道-升级禅道
- 3.1.6 旧版Docker镜像升级说明
- 3.1.7 通过Roadrunner管理定时任务
- 3.2 如何安装ioncube扩展
- 3.1. 升级禅道新版本
- 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.1.7 禅道一键安装包迁移/更新禅道一键安装包
- 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 解决一键安装包密码口令弱的问题
- 4.3. 性能优化
- 4.3.1 nginx反向代理禅道502或504bad gateway错误
- 4.3.2 linux系统中配置session使用redis
- 4.3.3 缓存功能
- 4.1. 维护禅道
- 5. 快速入门
- 5.1. 新版本快速入门
- 5.1.1 20版本禅道的新增功能
- 5.1.2 新版本禅道的最简使用
- 5.1.3 20版本禅道的界面变化
- 5.1. 新版本快速入门
- 6. 按照角色使用
- 6.1. 管理员
- 6.2. 项目集负责人
- 6.3. 产品经理
- 6.4. 项目经理
- 6.5. 研发人员
- 6.5.1 参加产品计划会议,分解任务
- 6.5.2 领取任务,并每天更新任务
- 6.5.3 创建构建,提交测试
- 6.5.4 确认Bug,解决Bug
- 6.5.5 执行的综合、需求、Bug、任务看板
- 6.6. 测试人员
- 7. 功能介绍
- 7.1. 核心管理结构
- 7.1.1 项目集(Program)
- 7.1.2 项目(Project)
- 7.1.3 产品(Product)
- 7.1.4 执行(Execution)
- 7.1.5 管理模型
- 7.2. 地盘
- 7.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.4.9 业务需求&需求多层级
- 7.5. 项目
- 7.6. 执行
- 7.6.1 参加产品计划会议,分解任务
- 7.6.2 领取任务,并每天更新任务
- 7.6.3 创建构建,提交测试
- 7.6.4 确认Bug,解决Bug
- 7.6.5 执行的综合、需求、Bug、任务看板
- 7.7. 测试
- 7.8. 自动化测试
- 7.9 DevOps(解决方案)
- 7.10. 文档
- 7.11. AI
- 7.11.1 AI小程序简介
- 7.11.2 创建与设计AI小程序
- 7.11.3 发布与禁用小程序
- 7.11.4 调试AI小程序
- 7.11.5 前台小程序的应用
- 7.11.6 AI小程序的导入导出
- 7.11.7 管理AI小程序权限
- 7.12. BI
- 7.12.1 维度(企业版8.4+)
- 7.12.2 大屏(企业版8.4+)
- 7.12.3 透视表
- 7.12.4 透视表下钻
- 7.12.5 图表
- 7.12.6. 度量项
- 7.12.6.1 查看度量项
- 7.13. 反馈
- 7.14. 看板
- 7.14.1 通用看板功能
- 7.15. 工作流
- 7.16. 学堂
- 7.17. 资产库(旗舰版)
- 7.17.1 资产库管理(旗舰版)
- 7.18. 组织
- 7.18.1 团队成员和工作信息
- 7.18.2 人力资源日历(需安装插件)
- 7.18.3 组织动态
- 7.18.4 公司信息
- 7.19. 办公
- 7.20. 后台设置
- 7.20.1 后台首页
- 7.20.2. 系统设置
- 7.20.3 功能开关
- 7.20.4. 人员管理
- 7.20.5. 模型配置
- 7.20.6. 功能配置
- 7.20.7 文档模板
- 7.20.8. 通知设置
- 7.20.9 插件管理
- 7.20.10 二次开发
- 7.20.11 数据导入
- 7.20.12. 权限维护和控制
- 7.20.12.1 项目集的权限维护和访问控制
- 7.20.12.2 产品的权限维护和访问控制
- 7.20.12.3 项目的权限维护和访问控制
- 7.20.12.4 执行的权限维护和访问控制
- 7.20.12.5 项目和执行的访问控制和数据关系
- 7.20.13. AI配置
- 7.20.14. DevOps设置
- 7.20.14.1. 资源
- 7.21. 客户端增强版会议SRS
- 7.21.1. 音视频会议配置
- 7.21.1.1 安装音视频服务端
- 7.21.1.2 安装SRS音视频服务端
- 7.21.1.3 开启和配置音视频功能
- 7.21.2. 发起会议
- 7.21.2.1 一对一会话中发起音视频会议
- 7.21.2.2 群组会话中发起音视频会议
- 7.21.2.3 独立发起音视频会议入口
- 7.21.3. 加入会议
- 7.21.3.1 分享音视频会议到会话
- 7.21.3.2 通过会议的ID加入会议
- 7.21.4. 预约会议
- 7.21.4.1 预约会议
- 7.21.5. 会议应用
- 7.21.5.1 音视频会议应用
- 7.21.1. 音视频会议配置
- 7.22. 客户端增强版会议Jitsi
- 7.1. 核心管理结构
- 8. 其他相关
- 9. IPD版本功能介绍
- 9.1. 禅道IPD版介绍
- 9.1.1 关于禅道IPD版
- 9.1.2 禅道IPD版的核心流程
- 9.2. IPD版的安装和升级
- 9.2.1 选择适合您的安装方法
- 9.2.2 选择适合您的升级方法
- 9.3. 需求与市场管理界面
- 9.4. IPD研发管理界面
- 9.1. 禅道IPD版介绍
使用源码包安装(MAC系统) 分享链接 /book/zentaopms/459.html?releaseID=17
本篇目录
目前在Mac OS系统下可以通过源码包进行安装,并需要自己手动配置 Apache+Mysql+PHP安装环境。
一、禅道运行环境说明
禅道运行环境推荐使用 Apache + PHP(7.0+版本) + MySQL(5.6+版本)/mariadb组合,Nginx其次。
禅道运行需要pdo, pdo_mysql, json, filter, openssl, mbstring, zlib, curl, gd, iconv这几个模块,请确保PHP环境中都有加载。
在Mac OS系统下推荐使用 Apache+Mysql+PHP,因为OS系统自带Apache与PHP环境,方便配置。
二、配置环境
1. 配置Apache服务
-
MAC OS环境已内置了Apache服务,只需要启动即可,需输入帐号密码。
-
Apache 服务器命令
sudo apachectl start //开启Apache服务 sudo apachectl stop //停止Apache服务 sudo apachectl restart //重启Apache服务
-
浏览器访问 localhost 或者127.0.0.1,"It works!"表示服务已启动,如您不需要修改web资源路径以及端口号,可跳转到PHP环境配置部分。
-
默认web路径与端口号
Apache默认web资源路径为:/Library/WebServer/Documents/
Apache默认端口号为 80
-
如果不修改Apache默认配置,请直接跳转到配置php环境。
我们不建议您修改Apache的默认配置,原因如下:1. 修改其配置文件有一定的危险性。
2. 自定义web路径会涉及文件权限问题,将会导致项目部署启动异常,增加问题解决难度。
3. 后续终端命令,默认为Apache默认访问路径为前提,方便您直接复制执行,如果变更过请将对应的路径替换。 -
修改Apache默认配置,如您因端口号冲突或者其他原因,需要修改web访问路径与默认端口号,可参考下文。
1. 备份Apache的配置文件sudo cp /etc/apache2/httpd.conf /etc/apache2/httpd.conf.backup
2. 修改web访问路径,打开 httpd.conf 配置文件,查找 "DocumentRoot",修改此部分路径,路径中不能出现中文与空格,路径为真实路径,修改后需重启Apache服务。
3. 端口号修改,搜索 "Listen 80" ,将默认80端口修改为其他端口(注意不要与其他服务端口号冲突),修改后需重启Apache服务。
5. 测试,可在自定义的web路径下,建 index.html 文件,使用 localhost:自定义端口号/index.html。
6. 访问正常,则自定义配置结束。
2. 配置PHP环境
-
Mac OS系统已内置了 PHP环境,注意内置的PHP版本号是否与禅道所需版本号匹配。
禅道适用PHP运行环境(7.0/7.1/7.2版本) 。php -v
-
整合Apache与PHP,打开Apache配置文件 httpd.conf,搜索“php”找到 # LoadModule php7_module libexec/apache2/libphp7.so 去掉注释符号#。
sudo vim /etc/apache2/httpd.conf # 打开httpd.conf
-
配置完成后,需要重启Apache服务。
3. 配置mysql 服务
禅道源码包所适用的 Mysql 版本为5.5 或5.6,你可以通过官网或者第三方下载安装包,也可以通过 Homebrew 包管理器安装 Mysql服务。
目前官网不再提供支持Mac OS的5.6版本安装包,本教程推荐通过 Homebrew 命令来下载与安装Mysql 服务。
-
首先安装 Homebrew 包管理器工具,在终端中执行如下命令,其他资料参考官网:https://brew.sh/index_zh-cn
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
安装过程需耐心等待,安装完成后执行 brew -v 查看版本,测试是否安装成功。
-
Homebrew安装后,执行如下命令安装 Mysql5.6,执行过程较慢,需耐心等待。
brew install mysql@5.6
下载完成后,依次执行如下命令,添加系统环境变量。
echo 'export PATH="/usr/local/opt/mysql@5.6/bin:$PATH"' >> ~/.bash_profile
加载环境变量。
source ~/.bash_profile
启动mysql 服务。
brew services start mysql@5.6
-
启动服务后,默认是匿名登录,现在初始化 root 账号。
输入mysql_secure_installation 命令,来初始化 root 账号信息。Enter current password for root (enter for none) # 第一次登陆root账号密码为空,直接回车 Set root password? # y New password: # 密码 Re-enter new password: # 再输一遍密码 Remove anonymous users? 是否删除匿名用户 ? y Disallow root login remotely? 是否允许root账号远程登录? y Remove test database and access to it? 删除test测试库,对test库的访问权限? n Reload privilege tables now? 刷新授权表使修改生效?y
-
配置完成就可以使用 root 账号与密码登陆了。
-
如您需要操作Mysql服务,可使用 brew 命令来管理(需要退出mysql执行)。
brew services start mysql@5.6 # 启动 mysql 服务 brew services restart mysql@5.6 # 重启 mysql 服务 brew services stop mysql@5.6 # 停止 mysql 服务
三、安装部署禅道项目
源码包下载地址:https://www.zentao.net/downloads.html。
1. 解压禅道源码包
2. 将解压后的文件复制到Apache访问目录下(默认路径为 /Library/WebServer/Documents/)
sudo cp -r ~/Downloads/zentaopms/* /Library/WebServer/Documents/
3. 安装方式,浏览器访问http://本机ip:端口号/www/index.php,系统会自动转入安装程序。
进入安装流程界面:
注:最后安装成功后,安全起见,请删除install.php文件。
常见问题解决
1.安装中出现访问禅道下文件权限问题,按照提示的命令执行即可。
2.安装中如果出现session.save_path问题,执行如下操作。
修改PHP配置文件,该配置文件默认位于 /etc/php.ini.default备份 php.ini.default 文件后将 php.ini.default 重命名为 php.ini ,并在文件内搜索 session.save_path = "/tmp" ,修改此 "/tmp" 值,建议修改路径为 /Users/zentao (路径可自定义到任意真实存在路径下),如下图所示。修改完成后,将此项的注释放开,即删除 ";" 符号,执行如下命令,给予文件权限。
sudo mkdir /Users/zentao sudo chmod -R 777 /Users/zentao
执行完如上操作后, 重启Apache服务, 点击页面刷新即可。