Redmine安装与配置指南

"redmine使用手册" Redmine 是一款开源的项目管理软件，它基于Ruby on Rails框架构建，专为软件开发团队提供集成了问题跟踪、版本控制、文档管理、时间跟踪以及项目协作等功能的平台。本文档将详细介绍如何安装和配置Redmine。 首先，Redmine的系统要求包括Ruby on Rails 2.0.2或更高版本，以及一个兼容的数据库系统，如MySQL 4.0或更高（推荐）、PostgreSQL 8（尽管8.3版本可能未经充分测试）或SQLite3。如果想要使用版本库浏览功能，需要安装SVN客户端，且版本不得低于1.3，并确保它配置在系统的PATH环境中。此外，为了将甘特图导出为PNG图像，还需要RMagick这个库。 安装Redmine的步骤如下： 1. 下载Redmine的源代码包，解压缩或通过Git检出。 2. 使用相应的SQL命令创建一个名为redmine的空数据库，并设置字符集为UTF8，例如对于MySQL： ``` CREATE DATABASE redmine CHARACTER SET utf8; ``` 3. 复制`config/database.yml.example`到`config/database.yml`，然后在这个文件中配置生产环境（production）下的数据库连接参数。对于MySQL，示例配置如下： ```yaml production: adapter: mysql2 database: redmine host: localhost username: bduser password: bdpasswd ``` 4. 在Redmine的根目录下运行命令创建数据库结构： ``` RAILS_ENV="production" rake db:migrate ``` 这会创建所有必要的数据表。 5. （可选）执行以下命令导入默认的配置数据，如角色、跟踪器、状态、工作流程和枚举值： ``` RAILS_ENV="production" rake redmine:load_default_data ``` 6. 启动WEBrick服务器来测试安装： ``` ruby script/server -e production ``` 随后，通过访问`http://localhost:3000/`在浏览器中查看Redmine的欢迎页面。 7. 使用预设的管理员账户登录系统： - 用户名：admin - 密码：admin 8. 登录后，可以在“管理”与“配置”界面调整系统的配置参数，包括SMTP服务器设置。 在`config/environment.rb`文件中，可以配置SMTP服务器参数以实现邮件通知功能。例如： ```ruby config.action_mailer.smtp_settings = { address: 'smtp.example.com', port: 587, domain: 'yourdomain.com', user_name: 'yourusername', password: 'yourpassword', authentication: 'plain', enable_starttls_auto: true } ``` 记得根据实际情况调整这些设置，以匹配你的邮件服务提供商。 Redmine提供了一个强大而灵活的项目管理工具，通过上述步骤，你可以成功地在本地环境安装并配置好Redmine，为团队的软件开发项目提供有力的支持。在实际使用中，还可以根据需求安装插件、定制主题，以及集成其他工具，以满足更广泛的项目管理需求。