在Windows下安装Redmine

安装过程

1.安装运行环境

下载RubyInstaller：http:///downloads/

下载DevKit：https://github.com/downloads/oneclick/rubyinstaller/DevKit-tdm-32-4.5.2-20111229-1559-sfx.exe

下载RubyGems：http:///pages/download

1.1.安装RubyInstaller

1.2.解压RubyGems，再使用Ruby命令行工具切换到RubyGems目录安装(安装完之后RubyGems目录可以删除)：

ruby setup.rb

以后可以用gem update –system来更新RubyGems

在安装好所有gem包之后，还可以用gem update来更新所有gem包

更新了gem包之后，可以用gem cleanup来清除所有包的旧版本(只保留最新版本)

通过gem list可以查看安装的所有包

1.3.安装bundler：

gem install bundler

1.4.解压DevKit，再使用Ruby命令行工具切换到DevKit目录安装：

      ruby dk.rb init
ruby dk.rb install

如果觉得以上步骤麻烦的，也可以直接安装RailsInstaller了事，我为了安装最新的Ruby版本所以采用以上步骤。

RailsInstaller下载地址：http:///

2.安装Rake及Rails

    gem install rake
gem install rails

在安装的过程中应该会显示安装i18n，即语言包，如果没有提示的话也可以通过以下命令安装：

    gem install i18n

3.安装RMagick

首先，到http:///projects/rmagick下载rmagick-win32里面的包RMagick-2.12.0-ImageMagick-6.5.6-8-Q8.zip

解压后安装ImageMagick-6.5.6-8-Q8-windows-dll.exe，这里我安装到D:\ImageMagick，注意选中Install…C and C++。

安装完之后，重新打开一个Ruby命令行工具来安装rmagick：

    gem install rmagick

若是提示失败则用：

    gem install rmagick --platform=ruby -- "--with-opt-include=D:/ImageMagick/include" "--with-opt-lib=D:/ImageMagick/lib"

如果还是失败就用：

    gem install rmagick --platform=ruby -- "--with-opt-dir=D:/ImageMagick"

这样就安装上了rmagick 2.1.3(最新版本的Redmine如2.1.5、2.2.0都依赖rmagick 2.1.3而不是2.1.2)

4.安装Redmine

通过http://www./projects/redmine/wiki/Download里的任一种方法下载Redmine

也可以直接从http:///frs/?group_id=1850下载，我使用的是最新的2.2.0版本

打开Ruby命令行工具，切换到Redmine的目录来检查依赖包：

    bundle install --without development test

这样会检查到未安装的包，自动下载安装；without参数就是用于忽略一些gem包，假如rmagick安装不成功，那也可以这样：

    bundle install --without development test rmagick

跳过rmagick的安装；我这里只使用SQLite数据库，所以把另外2个数据库也跳过了：

    bundle install --without development test postgresql mysql2

5.配置Redmine

打开Redmine的config目录，把database.yml.example复制一份并重命名为database.yml，找到其中的production节点配置数据库：

production:
adapter: sqlite3
database: db/redmine_production.sqlite3

这是我使用的SQLite数据库配置。

接下来配置邮件发送，把configuration.yml.example复制一份并重命名为configuration.yml，找到default下的email_delivery：

default:
# Outgoing emails configuration (see examples above)
email_delivery:
delivery_method: :smtp
smtp_settings:
address: smtp.sina.com
port: 25
domain: sina.com
authentication: :login
user_name: "lwme的用户名@sina.com"
password: "lwme的密码"

以上使用新浪的邮箱作为例子，这个配置好以后，之后进入系统设置可能还要设置一下发送邮件的邮件地址。

6.生成Session Key

打开Ruby命令行工具，切换到Redmine站点根目录运行：

    rake generate_secret_token

7.生成数据库结构

打开Ruby命令行工具，切换到Redmine站点根目录运行：

    set RAILS_ENV=production
rake db:migrate

8.载入默认数据

打开Ruby命令行工具，切换到Redmine站点根目录运行：

    set RAILS_ENV=production
set REDMINE_LANG=zh
rake redmine:load_default_data

运行Redmine

直接运行(WEBrick)

打开Ruby命令行工具，切换到Redmine站点根目录运行：

    ruby script/rails server webrick -e production -p 3000

以上命令使用webrick把Redmine运行在http://localhost:3000，稍等一会就可以通过浏览器打开访问，默认的用户名密码都是admin

直接运行(Thin)

在局域网中使用过程中，发现webrick巨慢无比，网上有说用mongrel，但是发现mongrel已经很久没有更新，所以最终使用了Thin

首先，安装Thin包：

    gem install thin

然后，打开Ruby命令行工具，切换到Redmine站点根目录运行：

    thin start -p 3000 -e production

同样的也是在3000端口运行

作为系统服务运行

我这里使用的是Windows Server 2003，需要用到工具Windows NT Resource Kit：http://www.microsoft.com/downloads/details.aspx?familyid=9d467a69-57ff-4ae7-96ee-b18c4790cffd&displaylang=en，下载并安装它

添加一个名为Redmine的服务：

    "C:\Program Files\Windows Resource Kits\Tools\INSTSRV.EXE" Redmine "C:\Program Files\Windows Resource Kits\Tools\SRVANY.EXE"

接着打开注册表，定位到HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Redmine，然后在Redmine下新建一个项，名为“Parameters”

打开Parameters节点，在右边的视图分别添加3个字符串值：

1. Application: D:\ruby\Ruby193\bin\Ruby.exe
2. AppParameters: D:\ruby\Ruby193\bin\thin start -p 3000 -e production
3. AppDirectory: D:/ruby/redmine-2.2.0/

如果不是用Thin，而是用webrick，那就添加2个字符串值：

1. Application: D:\ruby\Ruby193\bin\Ruby.exe
2. AppParameters: D:/ruby/redmine-2.2.0/script/rails server webrick -e production -p 3000

然后在系统服务里把它设置为自动并启动它。

对于不是windows server 2003系统的，可以试试thin_service：

    gem install thin_service

使用方法通过下面命令来了解：

    thin_service install --help
thin_service remove --help

使用方法估计与mongrel_service差不多，mongrel_service是这样：

    mongrel_rails service::install -N  D:\ruby\redmine-2.2.0 -p 3000 -e production

thin_service安装服务的方法可能会是(未验证)：

    thin_service install -N  D:\ruby\redmine-2.2.0 -p 3000 -e production

升级

备份老的站点数据：

1. 备份config目录下配置文件configuration.yml,database.yml
2. 备份db目录下数据库redmine_production.sqlite3,schema.rb
3. 备份files目录下的上传的文件

下载新的版本，然后在新的站点根目录下运行命令重新检查一下依赖包：

    bundle install --without development test postgresql mysql2

把以上备份的文件放到新的站点目录

生成session key：

    rake generate_secret_token

升级数据库：

    set RAILS_ENV=production
rake db:migrate

清理缓存和会话：

    rake tmp:cache:clear
rake tmp:sessions:clear

参考

官方安装指南：http://www./projects/redmine/wiki/RedmineInstall

官方升级指南：http://www./projects/redmine/wiki/RedmineUpgrade

服务安装：http://www./boards/2/topics/30741

最后，额外说一下，如果需要创建Git版本库，需要安装git包：

    gem install git

然后git库和redmine是同一台机器的话，就可以在项目设置里把git目录设置为git库地址如：d:\repo\myproj…