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

一、环境

 

1.硬件

普通PC。

 

2.软件

Windows 2003操作系统。

 

二、下载必要的软件

 

1.Ruby 1.8.x

Redmine是基于Ruby On Rails的软件，所以首先要下载Ruby。由于目前Redmine只支持Ruby 1.8，所以这里我们下载1.8分支的最新版本。下载地址：http://rubyforge.org/frs/?group_id=167&release_id=42563 。强烈建议下载RubyInstaller的版本。

 

不要下载最新的 1.8.7 的rubyinstaller-1.8.7-p334.exe ， 因为自带的rubygems版本太高了，是1.5.2的， 与rails 2.3.5在一块好像不行啊。下载一个 1.8.6或旧一点的1.8。7.

 

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

这里我没有执行成功，提示：

C:\>gem install --system
ERROR:  While executing gem ... (OptionParser::InvalidOption)
    invalid option: --system

我使用命令查看版本：

C:\>gem -v
1.5.2

太高了， rails 2.3.5在高于1.5.0的rubygems不行啊！

下载1.4.2 ，rubygems-1.4.2.zip，http://rubyforge.org/frs/?group_id=126

windows的cmd命令行窗口,cd进入rubygems-1.4.2 文件夹.输入setup.rb命令安装gem.

 

 

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

gem install rails -v=2.3.5

 

执行时长很长， 有10分钟吧。

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

gem install rake -v=1.0.1

 

我执行没有成功。提示：

C:\>gem install rake -v=1.0.1
ERROR:  Could not find a valid gem 'rake' (= 1.0.1) in any repository
ERROR:  Possible alternatives: rake

 

后来执行了以下命令，成功：

gem install rake
gem install -v=1.0.1 rack

 

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初始化的时候会出现错误。

 

 

我是直接下载的http://instantrails.rubyforge.org/svn/trunk/InstantRails-win/InstantRails/mysql/bin/libmySQL.dll  这个。

 

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的默认配置数据。会给出一些提示叫你选择语言,输入zh,好了,到此为止我们已经将redmine安装成功了.

 

 

 

如果遇到这个错误：

rake aborted!
undefined local variable or method `version_requirements' for #<Rails::GemDepend
ency:0x33cd470>

 

说明gem版本1.5.2 太高，要小于1.5.0，你只需要在redmine/config/environment.rb中的ENV['RAILS_ENV'] ||= 'production'后面加上

if Gem::VERSION >= "1.3.6"
    module Rails
        class GemDependency
            def requirement
                r = super
                (r == Gem::Requirement.default) ? nil : r
            end
        end
    end
end

就可以通过检查了

 

如果遇到这个错误：

rake aborted!

4	syntax error on line 8, col 2: `  encoding: utf8'

5

6	(See full trace by running task with --trace)

 

修改redmine目录下config中的database.yml 配置mysql连接密码时应在密码前加一个空格

 

 

如果遇到这个错误：

uninitialized constant Mysql::Protocol::UNIXSocket

或

Object is not missing constant Issue!

再执行一下：gem install mysql  ， 安装的mysql驱动版本为2.8.1.

 

7.启动

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

mongrel_rails start -e production

这个不好使， 可以试试：

ruby script/server -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

 

 

 

 

 

--------------------------------------------------

1、Redmine自启服务的安装：

     Redemine的启动是用命令行执行的，在Redmine根目录下执行：ruby script/server -e production即可，但是执行后不能关闭控制台，不然服务就会关闭，这对于重启服务器来说是一件很麻烦的事情，每次都要手动启动Redmine；

     既然Windows有服务，可自启，那就安装成服务，安装步骤如下：

     A、先安装mongrel_service，在在C:\InstantRails\ruby\bin目录下运行：gem install mongrel_service，此过程中会下载一些其他必须的包；

     B、使用mongrel_service将Redmine安装为服务：mongrel_rails service::install -N RedMine -c C:\redmine -p 3000 –e production；C:\redmine是具体的目录，参考修改；

     C、安装服务后，查看-e后的参数是不是production，如果不是production而是development，则在注册表中把参数手动改为production即可，修改方法是：在“开始→运行”中键入“regedit.exe”，打开“注册表编辑器”，展开分支“HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services”，在下面都是系统服务的名称，右侧窗格中显示的就是服务的详细参数。找到ImagePath项，修改保存后在服务列表中启动服务，并把服务设置自动启动。

2、Redmine邮件的配置：

     修改Redmine下文件夹config中的email.yml，信息如下：

production:
  delivery_method: :smtp
  smtp_settings:
  address: mail.XXXXX
  port: 25
  domain: XXXXX.com
  # authentication: :login
  # user_name: [e-mail]
  # password: XXXXXX
 
development:
  delivery_method: :smtp
  smtp_settings:
  address: mail.XXXXX
  port: 25
  domain: XXXXX.com
  # authentication: :login
  # user_name: [e-mail]
  # password: XXXXXX

注意用#注销掉的那三行信息，那是邮件服务器身份验证信息，但是如果你的用户已经使用了域验证，就不需要那三行信息，像我自己用的就是内部的邮件服务器（MS Exchange），就无须身份验证的必要。如果使用的是外面邮件服务器，一般是需要的；参数设置好了，然后重启Redmine服务，在配置中设置好发送邮件的帐号，然后测试（测试功能在右下角，我觉得自己眼神实在差，居然没有发现那个功能，还抱怨Redmine怎么那么笨的，没有提供邮件测试的功能，每次测试都在实际操作中进行，比较更新问题等，哈哈，傻了）。

一切OK，以后就可以高系统自动发送更新信息，不用经常查看同事的任务与进度了，懒吧！！

 

 

 

 

参考：

http://freej.blog.51cto.com/235241/484562

http://www.iteye.com/topic/872881

http://www.iteye.com/topic/708634

http://pumkinchina.iteye.com/blog/750987

http://blog.csdn.net/csdnatm/archive/2009/03/19/4003463.aspx