禅道项目管理软件（easysoft/zentaopms）安装指南

系统环境要求

禅道项目管理软件（ZentaoPMS）是一款基于Web的开源项目管理工具，在安装前需要确保系统满足以下基本要求：

1. Web服务器：Apache（推荐）或其他兼容的Web服务器
2. PHP环境：PHP 5.2或更高版本
3. 数据库：MySQL数据库
4. 可选组件：Java JRE（用于某些高级功能）

Windows系统安装（All-in-One包）

对于Windows用户，禅道提供了集成的All-in-One安装包，该包基于XAMPP项目构建，包含了所有必要的运行环境。

安装步骤

1. 下载安装包：获取最新的Windows版.exe安装包
2. 解压安装：
   • 双击.exe文件
   • 将内容解压到C:\xampp或D:\xampp等根目录下
3. 启动禅道：
   • 进入解压目录（如C:\xampp）
   • 双击控制面板工具（会显示在系统托盘）
   • 点击禅道图标，选择"启动禅道"
4. 访问系统：
   • 启动完成后，通过浏览器访问http://localhost/zentao/

Linux系统安装（All-in-One包）

Linux用户同样可以使用All-in-One安装包，简化安装过程。

安装步骤

1. 下载安装包：获取Linux版.7z压缩包
2. 准备安装：
   • 将包保存到/opt/目录
   • 执行命令：chmod a+rx *.7z赋予执行权限
3. 解压安装：
   • 执行7z文件自动解压
   • 解压后目录应为/opt/lampp
4. 启动服务：
   • 进入/opt/lampp目录
   • 执行sudo ./start（默认端口）
   • 或sudo ./start88（使用88端口）
5. 访问系统：
   • 通过浏览器访问http://localhost/zentao/

源代码安装方式

对于需要自定义安装的高级用户，禅道提供了源代码安装方式。

安装前准备

1. 安装AMP环境：自行安装Apache、MySQL和PHP，确保版本兼容
2. 下载源码包：获取禅道最新源代码包

安装步骤

1. 解压源码：
   • 将源码包解压到Apache的htdocs目录下
   • 确保可通过浏览器访问解压后的目录（如zentaopms）
2. 文件准备：
   • 复制安装文件：cp www/install.php.tmp www/install.php
3. 资源压缩（可选）：
   • 进入tools目录
   • 执行php minifyfront.php（需要Java和YUICompressor）
4. 运行安装向导：
   • 通过浏览器访问禅道路径（如http://192.168.1.1/zentaopms/）
   • 按照向导提示完成安装
5. 安全加固：
   • 安装成功后删除www/install.php文件

安装注意事项

1. 端口冲突：Linux版默认使用88端口（Apache）和3308端口（MySQL）以避免冲突
2. 权限问题：Linux安装时确保有足够的权限执行解压和启动操作
3. 环境兼容性：自行搭建AMP环境时，需确认各组件版本兼容性
4. 安全建议：生产环境应考虑配置HTTPS、防火墙规则等安全措施

常见问题解决

1. 无法启动服务：检查端口是否被占用，日志文件通常位于安装目录下的logs文件夹
2. 安装向导不显示：确认已正确复制install.php文件，并检查PHP错误日志
3. 数据库连接问题：验证MySQL服务是否正常运行，检查连接参数是否正确

通过以上步骤，您应该能够顺利完成禅道项目管理软件的安装。安装完成后，建议参考官方文档进行系统配置和用户管理，以充分发挥禅道在项目管理中的各项功能。