在windows平台上安装部署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。输入“ruby script/server webrick -e production”启动redmine就大功告成了。在浏览器中输入“http://localhost:3000/”就能看到redmine的界面了。详细的安装步骤还可以参考官方说明。
除了以上说明的方法,还有一个工具集成了redmine的安装,参考BitNami。