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

项目管理系统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

评论

1 楼 lorrainemei 2011-09-05  

如果在rake config/initializers/session_store.rb这一步遇到
rake aborted!
C:/redmine-1.2.1/Rakefile:10: syntax error, unexpected $end, expecting kEND


附Rakefile内容：
# Add your own tasks in files placed in lib/tasks ending in .rake,
# for example lib/tasks/switchtower.rake, and they will automatically be available to Rake.

require(File.join(File.dirname(__FILE__), 'config', 'boot'))

require 'rake'
require 'rake/testtask'
require 'rdoc/task'
RDoc::Task.new do |rdoc|
require 'tasks/rails'