在Windows上安装Redmine
概述
Redmine 是一个使用 ROR 框架建立的灵活的项目管理工具。它提供了基本的需求管理、缺陷管理功能,还提供了新闻发布、 Wiki 、论坛等其它功能。 Redmine 的官方的安装指南可在如下网址看到: http://www.redmine.org/wiki/redmine/RedmineInstall 。本手册是在该指南的基础上修订而来的。
安装准备
安装过程中需要用到如下软件 / 组件:
1. Ruby 1.8.7
2. RubyGems 1.3.1
3. Rake 0.8.3 :因为这个比较小,可在线安装,不用下载
4. Rails 2.2.2。因为在线安装 Rails 可能有问题,可下载这个包用来离线安装
5. MySQL 4.1 或更高版本:可在 MySQL 的官网下载
6. Redmine 0.8.3
7. Win32 OpenSSL v0.9.8j Light :
8. Visual C++ 2008 Redistributables :
9. ZLib 1.2.3 ,运行 rake 时要用到
10. libiconv 1.9.1 ,运行 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.2.2 的安装包解压到某个临时目录下(例如: C:/rails ),在命令行模式下切换当前目录为该临时目录,运行如下命令:
gem install rails -v=2.2.2 --include-dependencies 或 gem install rails -v=2.2.2 –ignore-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.8.1 ),将 config/database.yml.example 复制为 config/database.yml ,并修改该文件中的“ production ”段的数据库配置。例如:
production: adapter: mysql database: redmine host: localhost username: root (这里填写你希望用来登录 MySQL 的用户名) password: password (这里填写用户密码) |
13. 在 Windows 命令行模式下切换当前目录为 Redmine 的安装目录,运行如下命令:
rake db:migrate RAILS_ENV="production" |
该命令将创建生产用的数据库结构
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为Windows服务和邮件通知
下面就介绍将Redmine安装成Windows服务,只要系统启动无需登录也跟着启动。
1.MySql只是做为一个普通程序被InstantRails.exe启动,而Redmine又依赖于MySql,因此需要将MySql安装为Windows服务,进入到C:/InstantRails/mysql/bin目录下执行:mysqld -install即可将MySql安装为服务,在服务管理器中将其设为自动启动。
2.Ruby提供一个安装Ruby程序为服务的包:mongrel_service。安装其实很简单,在C:/InstantRails/ruby/bin目录下运行:gem install mongrel_service,此过程中会下载一些其他必须的包。
然后使用mongrel_service将Redmine安装为服务:
mongrel_rails service::install -N RedMine -c C:/InstantRails/rails_apps/redmine-0.8.0 -p 3000 –e production
其中C:/InstantRails/rails_apps/redmine-0.8.0是Redmine所在目录 3000是监听端口,然后修改启动方式为自动即可。
3.安装服务后,查看-e后的参数是不是production,如果不是production而是development,则在注册表中把参数手动改为production即可,修改方法是:在“开始→运行”中键入“regedit.exe”,打开“注册表编辑器”,展开分支“HKEY_LOCAL_MACHINE/SYSTEM/CurrentControlSet/Services”,在下面都是系统服务的名称,右侧窗格中显示的就是服务的详细参数。找到ImagePath项,修改保存后在服务列表中启动服务,并把服务设置自动启动。
4.如果想要移除Redmine服务,可执行如下命令:
mongrel_rails service::remove -N RedMine
5.配置邮件通知
Redmin可以为一些操作提供邮件通知如主题改变,新增问题等,这样可以让开发人员及时知道变化。在使用此功能前需要先配置邮件服务器,将C:/InstantRails/rails_apps/redmine-0.8.0/config目录下的email.yml.example更名为email.yml,然后用文本编辑器打开此文件,将内容改为如下:
# Outgoing email settings
production:
delivery_method: :smtp
smtp_settings:
address: "smtp.163.com"
port: 25
domain: "163.com"
authentication: :login
user_name:test@163.com
password: "123456"
development:
delivery_method: :smtp
smtp_settings:
address: "smtp.163.com"
port: 25
domain: "163.com"
authentication: :login
user_name:test@163.com
password: "123456"
这里我采用的是163的Smtp服务器来发送邮件,其中特别需要注意的是address,domain,user_name,password中的值都要加上双引号,否则会报错。
然后就可以在Redmine的界面中启用邮件通知,设置一下发件人地址和签名即可。