项目管理系统Redmine（v1.1.0）安装手记

一、环境

 

1.硬件

普通 PC。

 

2.软件

Windows XP操作系统。

 

二、下载必要的软件

 

1.Ruby 1.8.x

Redmine是基于 Ruby On Rails的软件，所以首先要下载Ruby。由于目前Redmine只支持Ruby 1.8，所以这里我们下载1.8分支的最新版本。下载地址： http://www.ruby-lang.org/en/downloads/。强烈建议下载RubyInstaller的版本。

 

2.Redmine 1.1.x

1.1.0是 Redmine当前最新的版本。下载地址：http://rubyforge.org/frs/?group_id=1850。

 

3.Mysql 5.x

运行Redmine时需要，下载地址： http://www.mysql.com/downloads/mysql/。

 

三、安装和运行

 

1.安装Ruby

如果用的是 RubyInstaller版本的安装软件那就很简单了。只要在第三个安装步骤中将“Add Ruby executables to your PATH”勾选就可以了，这样我们之后在命令行执行Ruby的相关命令就会方便很多。

 

2.安装必要的Ruby组件

我们需要打开 CMD窗口，以供下面执行Ruby命令使用。

1) 安装 Mysql的Ruby驱动。命令：

gem install ruby-mysql

2) 安装 rubygems的1.3.7（或以上）版本：RubyInstaller安装后就已经装入了rubygems，我们这里可以进行以下升级，当前最新的版本为1.4.2。命令：

gem install --system

3) 安装 Rails的2.3.5版本：现在Rails已经更新到3.0.3了，但是Redmine要求2.3.5版本。命令：

gem install rails -v=2.3.5

4) 安装 rake的1.0.1（或以上）版本：安装Redmine时会用到，RubyInstaller同样会安装这个组件，但是Redmine需要1.0.1版本的，所以我们安装上对应版本就是了。命令：

gem install rake -v=1.0.1

5) 安装 i18n的0.4.2版本：这个组件包在安装Redmine时会用到，如果不安装的话到时候会出现错误，所以在这里预先安装好。命令：

gem install i18n -v=0.4.2

6) 安装 mongrel：mongrel是一个很好的用于运行Ruby On Rails应用的Web服务器，至少比默认的webrick服务器好得多。当前版本是1.1.5。命令:

gem install mongrel

 

3.安装Mysql

略过Mysql具体安装过程的介绍。

 

4.拷贝libmySQL.dll

由于新版本的Mysql驱动模块对Ruby的支持不好，所以我们需要拷贝旧版本的dll文件 到<ruby安装目录>/bin目录中。否则后面进行Redmine初始化的时候会出现错误。

 

5.为Redmine创建数据库和用户

在Mysql中执行如下sql语句：

create database redmine character set utf8; create user 'redmine'@'localhost' identified by '<password>'; grant all privileges on redmine.* to 'redmine'@'localhost';

注：带尖括号的内容需要自定义。

这样我们就为Redmine在Mysql中建立了相应的库和用户。

 

6.Redmine的安装和配置

1) 我们将之前下载redmine压缩包解压到任意目录。

2) 进入到 redmine解压目录，在这里我们称之为redmine根目录。

3) 找到 <redmine根目录>/config/database.yml.example文件，将其复制一份到当前目录并改名为database.yml。

4) 打开文件，找到“ production:”修改其下的配置，例如：

production:  adapter: mysql  database: redmine  host: localhost  port: 3306  username: redmine  password: <password>  encoding: utf8

注：带尖括号的内容需要自定义。配置中所有内容都应与之前的Mysql安装和配置相一致。

5) 从CMD窗口中进入到redmine根目录。顺序执行如下命令：

rake generate_session_store

上面的命令用于生成session密钥。

rake db:migrate RAILS_ENV="production"

上面的命令用于创建redmine的库表结构。

rake redmine:load_default_data RAILS_ENV="production"

上面的命令用于初始化redmine的默认配置数据。

 

7.启动

1) 从CMD窗口进入到redmine根目录，输入如下命令：

mongrel_rails start -e production

上面的命令执行后， mongrel服务器将会启动。在看到“** Use CTRL-C to stop.”之后说明已经启动成功。

2) 打开网络浏览器，在地址栏中输入“ http://localhost:3000”。如果看到redmine主页画面的话就说明运行成功。

3) redmine默认的管理员用户是 admin，密码也是admin。

本文出自 “Hyper Mind” 博客，请务必保留此出处http://freej.blog.51cto.com/235241/484562