(转)Redmine安装指南(Windows)

参考文章:http://movingboy.iteye.com/blog/344463

 

     之前使用过trac管理项目，但是trac不支持多项目管理这点很郁闷，发现Redmine后忽然感觉到这就是我想要的(trac有的功能Redmine都有，并且支持更多)。Redmine 是使用 ROR 框架建立的项目管理工具，提供需求管理、缺陷管理功能、新闻发布、 Wiki 、论坛等功能，还有丰富的扩展插件。

Redmine 的官方的安装指南地址： http://www.redmine.org/wiki/redmine/RedmineInstall (很多Redmine新版本的安装问题，这里会有更多说明)

安装准备

先下载下面这些安装过程中要用到的软件：

1.       Ruby 1.8.7 ： http://www.ruby-lang.org/en/downloads/

2.       RubyGems 1.3.1 ： http://rubyforge.org/frs/download.php/45906/rubygems-1.3.1.zip

3.       Rake 0.8.3 ：因为这个比较小，可在线安装，不用下载

4.       Rails 2.3.3 ： http://rubyforge.org/frs/download.php/60600/rails-2.3.3.zip 。因为在线安装 Rails 可能有问题，可下载这个包用来离线安装

5.       MySQL 4.1.x或5.0.x的版本(目前Rails对MySQL5.1的版本支持还不完善)：可在 MySQL 的官网下载

6.       Redmine 0.9.1 ： http://rubyforge.org/frs/download.php/68874/redmine-0.9.1.zip

7.       Win32 OpenSSL v0.9.8j Light ： http://www.slproweb.com/download/Win32OpenSSL_Light-0_9_8j.exe 

8.       Visual C++ 2008 Redistributables ： http://www.microsoft.com/downloads/details.aspx?familyid=9B2DA534-3E03-4391-8A4D-074B9F2BC1BF&displaylang=en (如果不安装这个，调用 OpenSSL 时可能会报“应用程序配置不正确，程序无法启动，重新安装应用程序可能解决问题。”错误)

9.       ZLib 1.2.3 ： http://www.zlib.net/zlib123-dll.zip (运行 rake 时要用到)

10.    libiconv 1.9.1 ： http://sourceforge.net/projects/gnuwin32/files/libiconv/ (运行 rake 时要用到)

安装与配置

1.       将 Ruby 1.8.7 的安装包解压到某个目录下（例如： C:\ruby-1.8.7 ），并将子目录 bin 的路径加入到 Windows 的 PATH 环境变量中（例如：在 PATH 环境变量中加入 C:\ruby-1.8.7\bin ）

2.       将 RubyGems 1.3.1 安装包解压到某个临时目录下（例如： C:\rubygems-1.3.1 ），在 Windows 的命令行模式下切换当前目录为该临时目录，运行如下命令：

ruby setup.rb

该命令将离线安装 RubyGems 。安装完毕后可删除该临时目录

3.       在命令行模式下运行如下命令：

gem install rake

该命令将在线安装 Rake

4.       将 Rails 2.3.3 的安装包解压到某个临时目录下（例如： C:\rails ），在命令行模式下切换当前目录为该临时目录，运行如下命令：

gem install rails -v=2.3.3 --include-dependencies

该命令将离线安装 Rails 。安装完毕后可删除该临时目录

5.      在命令行模式下运行如下命令：

gem install mysql

在命令将在线安装 MySQL 的 C bindings （ C 语言绑定？ C 语言库？），可明显提高访问数据库的性能

6.       安装并运行 MySQL 。参见 MySQL 相关的资源

7.       在 MySQL 命令行模式下运行如下命令：

create database redmine character set utf8;

该命令将创建一个供 Redmine 使用的数据库

8.       安装 Visual C++ 2008 Redistributables

9.       安装 Win32 OpenSSL v0.9.8j Light 。注意在“ Select Additional Tasks ”时选“ Copy OpenSSL DLLs to The Windows system directory ”，否则在安装完毕后需要手工将 OpenSSL 安装目录下的 DLL 文件复制到 Windows 的系统目录（例如： C:\Windows\system32 ），或 Ruby 的 bin 目录（例如： C:\ruby-1.8.7\bin ）

10.   将 ZLib 1.2.3 的安装包中的 zlib1.dll 解压到 Windows 的系统目录或 Ruby 的 bin 目录，并改名为 zlib.dll

11.   将 libiconv 1.9.1 的安装包中的 bin\iconv.dll 解压到 Windows 的系统目录或 Ruby 的 bin 目录

12.   将 Redmine 的安装包解压到某个目录（例如： C:\redmine-0.9.1 ），将 config\database.yml.example 复制为 config\database.yml ，并修改该文件中的“ production ”段的数据库配置。例如：

production:

 adapter: mysql

 database: redmine

 host: localhost

 username: root （这里填写你希望用来登录 MySQL 的用户名）

 password: password （这里填写用户密码）

13.   将MySQL安装目录中的libmySQL.dll文件复制到Ruby安装目录下(如：C:\ruby-1.8.7\bin)，然后再Windows 命令行模式下切换当前目录为 Redmine 的安装目录，运行如下命令：

 

rake config/initializers/session_store.rb

 

rake db:migrate RAILS_ENV="production"

该命令将创建生产用的数据库结构。这是关键的一步，笔者就在此处经过多次尝试后才安装好Redmine.

如果出现“Mysql::Error: The 'InnoDB' feature is disabled”错误，需要开启MySql数据库对InnoDB的支持，在你的mysql安装文件夹中打开my.ini文件，找到skip-innodb，改成#skip-innodb，然后重启mysql(注：可以通过MySQL命令show variables like "have_%";查看是否开启了InnoDB)

 

14.   在命令行模式下运行如下命令：

rake redmine:load_default_data RAILS_ENV="production"

该命令将填充默认的配置数据。该命令运行过程中需要选择语言，一般输入zh（ 简体中文）

15. 在命令行模式下运行如下命令：

ruby script/server webrick -e production

该命令将运行 Redmine ！

16.   打开浏览器，访问如下网址： http://localhost:3000/ ，使用用户 admin （密码 admin ）登录试试吧！

让 Redmine 自动运行

使用命令行方式运行 Redmine 很不方便，幸好 Ruby 提供了 mongrel_service 包，它可以将 Ruby 程序注册为 Windows 服务。

1.       在命令行下运行如下命令即可安装 mongrel_service ：

gem install mongrel_service

2.      然后使用 mongrel_service 将 Redmine 注册为 Windows 服务：

mongrel_rails service::install - N Redmine -c C:\redmine-0.8.1 -p 3000 –e production

注意：在我的机器上执行该命令后， Windows 服务确实注册了，但 -e 参数的值却是 development 。这需要修改该服务的注册表项，将该参数的值修改为 production ，否则 Redmine 连不上数据库

3.       如果 MySQL 是与 Redmine 安装在同一台机器的，还可以将 MySQL 添加为 Redmine 依赖的服务，这样启动 Redmine 时保证 MySQL 也启动了：

sc config Redmine depend= MySQL

注意 depend= 与 MySQL 之间有一个空格

4.       还可以将 Redmine 设置为自动启动：

sc config Redmine depend= MySQL start= auto

同样， start= 与 auto 之间有一个空格