记录自己学习部署redmine项目过程供大家参考

项目管理工具是团队开发过程中必不可少的工具，比较流行的包括JIRA、trac、redmine、xplanner等。redmine系统以其轻量、易上手等特点吸引了越来越多人的注意，作为其特色的甘特图，也为其赢得了更多的称赞和口碑。

redmine是一个支持中文的开源项目管理系统，基于Ruby on Rails，支持功能灵活而丰富：多项目、多数据库支持、bug跟踪、甘特图、文档管理、wiki、email、论坛、时间线等，基本能够满足大多数项目管理需求。下面来看看安装redmine需要的支持环境和安装步骤。（请参考各平台安装redmine的官方说明）

在windows平台上安装部署redmine，需要以下条件：

1、ROR环境：Ruby，RubyGems，Rake，Rails；

2、数据库：mysql；

3、redmine包。

ROR环境的部署还是非常麻烦的，尤其是rake（一个类似于make的东东），需要很多库的支持。幸好有一个RailsInstaller的工具可以帮我们一键安装好ROR环境，这样我们也不用再去关心ROR组件中各版本的兼容问题，直接安装最新的RailsInstaller包就好了。

mysql的安装我是找了xampp的包，里面包含了mysql和Apache等，安装的时候可以自定义。

redmine包直接从官方下载最新版即可。

具体步骤：

1、安装RailsInstaller，注意勾选上添加环境变量，后面命令行运行ROR程序时会很方便。我直接安装在了C盘根目录下：C:\RailsInstaller。此时RailsInstaller还会为我们自动创建一个ROR项目目录C:\Sites。安装完成后会弹出一个dos窗口，会要求先设置git用户名和邮箱；

2、下载redmine包（http://rubyforge.org/frs/download.php/76191/redmine-2.0.2.zip），将解压后的redmine文件夹拷贝到C:\Sites下，修改文件夹名字为redmine，即C:\Sites\redmine；

3、替换libmysql.dll文件，由于RailsInstaller中的mysql编译版本问题，我们需要下载http://dev.mysql.com/get/Downloads/Connector-C/mysql-connector-c-noinstall-6.0.2-win32.zip/from/pick，将解压后的 lib\libmysql.dll 文件拷贝到 C:\RailsInstaller\Ruby1.9.3\bin下；（注：以上参考在 Windows 下安装 Redmine 2中的说明）

4、打开RailsInstaller的命令行程序“Command Prompt with Ruby and Rails”，默认在C:\Sites路径下，输入“cd redmine”进入redmine目录。根据redmine安装说明，1.4.0版本以上的redmine用bundler来管理用到的gems，输入“gem install bundler”先安装bunlder。然后输入“bundle install --without development test rmagick”安装所有需要的gems；

5、创建数据库。由于我安装了xampp包，可以用phpMyAdmin配置建立mysql数据库，也可以用命令行创建。如下所示：

create database redmine character set utf8;

create user 'redmine'@'localhost' identified by 'my_password';

grant all privileges on redmine.* to 'redmine'@'localhost' identified by 'my_password';

6、配置数据库。将C:\Sites\redmine\config下的database.yml.example文件拷贝一份，改名为database.yml，打开文件进行编辑，主要目的是配置数据库的信息。由于我们bundler的时候去掉了development和test版本，所以只关注“production”部分就好了。修改如下：

production:

adapter: mysql2

database: redmine

host: localhost

username: redmine

password: my_password

其中密码部分对应创建数据库时的密码，要加引号；

7、关联数据库。在“Command Prompt with Ruby and Rails”中进入redmine目录后输入“rake generate_session_store”生成session存储密钥；然后输入“rake db:migrate RAILS_ENV="production"”迁移redmine的数据库，需要等待几分钟；通过“rake redmine:load_default_data RAILS_ENV="production"”装载默认配置数据，选择语言为zh。

8、运行redmine。输入“rails server webrick -e production”启动redmine就大功告成了。在浏览器中输入“http://localhost:3000/”就能看到redmine的界面了。详细的安装步骤还可以参考官方说明。