项目管理系统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初始化的时候会出现错误。
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: [email protected]
# password: XXXXXX

development:
delivery_method: :smtp
smtp_settings:
address: mail.XXXXX
port: 25
domain: XXXXX.com
# authentication: :login
# user_name: [email protected]
# 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

你可能感兴趣的:(redmine)