1 安装禅道
1.1  选择适合您的安装方法
1.2  使用云禅道在线项目管理服务!
1.3  (推荐)windows用一键安装包安装
1.4  (推荐)linux用一键安装包
1.5  linux下用lampp集成包安装
1.6  使用源码包安装(MAC系统)
1.7  MAC下用XAMPP安装禅道
1.8  MAC下用XAMPP-VM安装禅道
1.9  禅道一键安装包里安装蝉知和然之
1.10  使用源码包安装(各系统通用)
1.11  使用禅道Docker安装包安装
1.12  宝塔面板安装禅道
1.13  华芸NAS在线安装
1.14  Centos7.4系统下安装httpd,mariadb,php7.1环境运行禅道
1.15  安装ioncube扩展
2 禅道介绍
2.1  关于禅道项目管理软件
2.2  禅道介绍PPT下载
2.3  如何获得支持
2.4  关注我们
3 升级禅道
3.1  选择和自己环境对应的升级方式
3.2  通过源代码方式升级(通用)
3.3  windows一键安装包的升级
3.4  linux一键安装包升级
4 创建分组和用户
4.1  建立部门结构
4.2  添加一个用户帐号
4.3  批量维护帐号
4.4  设置分组,建立权限体系
5 最简使用
5.1  使用禅道来进行项目任务管理
5.2  只使用禅道来做bug管理
5.3  只使用禅道来进行产品管理
5.4  个人使用禅道来做事务跟踪管理
6 基本使用
6.1  禅道使用的基本流程和产品、研发、测试之间的三权分立
6.2  敏捷开发及scrum简介
6.3  禅道和scrum的对应关系
6.4  禅道的新手教程
6.5  创建第一个产品
6.6  添加第一个需求
6.7  开始第一个项目
6.8  确定项目要完成的需求列表
6.9  为需求分解任务
6.10  提交bug
6.11  视频教程:第一个演示项目
6.12  维护联系人
6.13  禅道的自定义功能
6.14  导入excel、csv参考文档
6.15  文档管理
6.16  工作方式的切换
6.17  操作获取积分功能
6.18  自定义必填项功能
6.19  如何排查产品、项目是否有访问权限
7 进阶使用
7.1 使用流程
7.1.1  禅道使用流程图解
7.2 个人管理
7.2.1  使用待办进行个人事务管理
7.2.2  关注需要自己处理的任务、需求、bug
7.2.3  通过我的档案查看或者修改个人信息
7.2.4  视频教程:禅道使用之个人篇
7.3 产品经理篇
7.3.1  维护产品
7.3.2  维护产品线
7.3.3  创建和评审需求
7.3.4  变更和评审需求
7.3.5  需求的状态和研发阶段
7.3.6  需求的注意事项
7.3.7  维护产品模块
7.3.8  建立发布计划
7.3.9  建立发布
7.3.10  路线图
7.3.11  文档管理
7.3.12  主持产品会议
7.3.13  参与项目管理、演示和总结
7.3.14  需求的基本统计报表
7.3.15  视频教程:禅道使用之产品经理篇
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.4.10  视频教程:禅道使用之项目经理篇
7.5 开发团队篇
7.5.1  参加项目计划会议,分解任务
7.5.2  领取任务,并每天更新任务
7.5.3  通过看板和树状图查看任务
7.5.4  创建版本
7.5.5  申请测试
7.5.6  解决bug
7.5.7  文档管理
7.5.8  确认bug
7.5.9  视频教程:禅道使用之开发团队篇
7.6 测试团队篇
7.6.1  维护bug视图模块
7.6.2  提交bug
7.6.3  验证bug,关闭
7.6.4  激活bug
7.6.5  找到自己需要的bug
7.6.6  维护测试用例视图
7.6.7  创建测试用例
7.6.8  测试套件、报告和公共用例库的维护
7.6.9  管理测试版本
7.6.10  执行用例,提交Bug
7.6.11  查看报表统计
7.6.12  视频教程:禅道使用之测试团队篇
8 维护配置
8.1 维护禅道
8.1.1  初始化管理脚本
8.1.2  备份禅道
8.1.3  恢复删除的资源
8.1.4  如何更新燃尽图
8.1.5  一键安装包如何实现mysql异机连接
8.2 配置禅道
8.2.1  设置是否允许匿名访问
8.2.2  如何配置email发信
8.2.3  禅道云发信
8.2.4  如何成为超级管理员
8.2.5  配置禅道系统为静态访问
8.2.6  去掉禅道访问地址中的zentao
8.2.7  集成禅道和svn
8.2.8  集成禅道和git
8.2.9  在第三方应用中集成禅道
8.2.10  第三方应用配置免密登录禅道
8.2.11  第三方应用集成禅道客户端进行消息通知
8.2.12  集成webhook
8.2.13  然之集成
8.2.14  客户端集成
8.2.15  禅道的翻译功能
8.2.16  浏览器通知的设置
9 定制开发
9.1  二次开发机制
9.2  禅道的目录结构
9.3  找到要修改的文件
9.4  禅道的数据库结构
9.5  公用模块--common
9.6  如何登记菜单
9.7  如何登记权限
9.8  示例:如何修改禅道的语言提示?
9.9  示例:创建bug时可以设置优先级字段
9.10  使用在线扩展编辑器
9.11  二次开发编辑器和翻译功能限制使用说明
9.12  禅道项目管理软件打包规范1.1版本
10 其他相关
10.1  禅道所使用到的第三方代码
10.2  禅道FAQ
10.3  如何帮助禅道项目
10.4  禅道商业服务
10.5  禅道项目的贡献者
10.6  历史修改记录

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

2019-03-21 10:10:00
闫敏
7586
最后编辑:禅道-Bee 于 2019-11-12 11:17:22
简介:本文介绍如何在Mac系统下面使用禅道源码包搭建禅道的运行环境。

目前在Mac OS系统下可以通过源码包进行安装,并需要自己手动配置 Apache+Mysql+PHP安装环境。

一、禅道运行环境说明

禅道运行环境推荐使用 Apache + PHP(5.3/5.4/5.5/5.6/7.0/7.1/7.2版本) + MySQL(5.5/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服务


  1. MAC OS环境已内置了Apache服务,只需要启动即可,需输入帐号密码。

  2. Apache 服务器命令

    sudo apachectl start //开启Apache服务 
    sudo apachectl stop //停止Apache服务 
    sudo apachectl restart //重启Apache服务


  3. 浏览器访问 localhost 或者127.0.0.1, " It works!"表示服务已启动, 如您不需要修改web资源路径以及端口号,可跳转到PHP环境配置部分

  4. 默认web路径与端口号
    Apache默认web资源路径为:/Library/WebServer/Documents/
    Apache默认端口号为 80


  5. 如果不修改Apache默认配置,请直接跳转到配置php环境。
    我们不建议您修改Apache的默认配置,原因如下:

    1. 修改其配置文件有一定的危险性。

    2. 自定义web路径会涉及文件权限问题,将会导致项目部署启动异常,增加问题解决难度。
    3. 后续终端命令,默认为Apache默认访问路径为前提,方便您直接复制执行,如果变更过请将对应的路径替换。

  6. 修改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环境

  1. Mac OS系统已内置了 PHP环境,注意内置的PHP版本号是否与禅道所需版本号匹配。
    禅道适用 PHP 运行环境(5.3/5.4/5.5/5.6/7.0/7.1版本) 。

    php -v

  2. 整合Apache与PHP,打开Apache配置文件 httpd.conf,搜索 “php”找到 # LoadModule php7_module libexec/apache2/libphp7.so  去掉注释符号 #

    sudo vim /etc/apache2/httpd.conf  # 打开httpd.conf 


  3. 配置完成后,需要 重启Apache服务


3. 配置mysql 服务

禅道源码包所适用的 Mysql 版本为5.5 或5.6,你可以通过官网或者第三方下载安装包,也可以通过 Homebrew 包管理器安装 Mysql服务。

目前官网不再提供支持Mac OS的5.6版本安装包,本教程推荐通过 Homebrew 命令来下载与安装Mysql 服务

  1. 首先安装 Homebrew 包管理器工具, 在终端中执行如下命令,其他资料参考官网: https://brew.sh/index_zh-cn 

    /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"


    安装过程需耐心等待,安装完成后执行 brew -v 查看版本,测试是否安装成功。

     

  2. 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
    
  3. 启动服务后,默认是匿名登录,现在初始化 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
  1. 配置完成就可以使用 root 账号与密码登陆了。

  2. 如您需要操作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/download.html

解压禅道源码包


将解压后的文件复制到Apache访问目录下(默认路径为 /Library/WebServer/Documents/)

sudo cp -r ~/Downloads/zentaopms/* /Library/WebServer/Documents/



进入安装流程界面:

安装方式:浏览器访问本机ip:端口号/www/install.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服务, 点击页面刷新即可。




评论列表
尹冲 2019-11-02 15:44:36
您访问的域名 127.0.0.1 没有对应的公司
石洋洋 2019-11-04 09:05:45
找到php.ini文件,修改里面的session.save_path参数,将其设置为实际存在的路径(不要使用 /tmp目录,可以放到zentaopms/tmp/下面)。如果是ntfs分区或者linux,还需要为其增加其他人(apache运行帐号)的读写权限。然后重启apache,然后重新安装禅道。
禅道-Bee 2019-11-04 09:05:50
session目录没有读写权限导致的,可以参考手册最后面关于出现session.save_path问题的解决方法处理下。
红磊 2019-07-30 15:30:42
问题:空白了 显示 500 错误
解决建议:
注意两点:my.php的格式 和 权限
一定要给:读写权限
禅道-Bee 2019-07-30 17:22:09
群里沟通过,谢谢分享 :)
Jamie Lee 2019-06-17 12:08:29
最后一步显示没有公司信息,修改完所有配置文件及路径,重新安装禅道刷新页面时始终停留在没有公司信息错误提示页面,无法跳转至重新安装,怎么办?
张玉洁 2019-06-17 13:10:10
找到php.ini文件,修改里面的session.save_path参数,将其设置为实际存在的路径(MAC系统Session放到application目录下)。如果是ntfs分区或者linux,还需要为其增加其他人的读写权限。然后重启php-fpm、webserver,然后重新安装。(selinux需要关闭)
mimiminiei 2019-06-06 15:11:10
mac安装到6.配置数据库信息,然后保存my.php过后,出现空白页面,没有弹出设置账号的页面
mimiminiei 2019-06-06 15:45:48
解决了,是my.php的格式可能有问题
重新拷了一遍就可以了
陈德晖 2019-07-26 00:58:47
请问 格式是什么 我也是配置完my.php 之后 最后点击 登陆禅道系统 就直接 空白了 显示 500 错误
红磊 2019-07-30 15:30:58
解决建议:
注意两点:my.php的格式 和 权限
一定要给:读写权限
1/1
发表评论
评论通过审核后显示。