Redmine安装手册

RedMine 操作手册目录第 1 章概 述 (1)第 2 章安装前的准备 (2)2.1 下载相应文件 (2)第 3 章安装与配置 (2)第 4 章让RedMine自动运行 (4)第 5 章 RedMine和Apache集成 (4)第 6 章 RedMine和 Hudson的集成 (5)第 7 章 RedMine和SVN的集成 (6)第 1 章概 述Redmine是基于ROR框架开发的一套跨平台项目管理系统，是项目管理系统的后起之秀，据说是源于Basecamp的ror版而来，支持多种数据库，除了和DotProject的功能大致相当外，还有不少自己独特的功能， 例如提供wiki、新闻台、时间跟踪、feed聚合、导出pdf等待，还可以集成其他版本管理系统和BUG跟踪系统，例如SVN、CVS、TD等等。

配置 功能强大而且方便，自定义属性和更新通知也很实用。

第 2 章安装前的准备2.1下载相应文件安装需要用到如下的软件，请进行准备1. Ruby ，现在最新稳定的Ruby 版本，建议下载1.8.7或更高的版本，地址为：/frs/download.php/72085/rubyinstaller ‐1.8.7‐p302.exe ；2. RubyGems 1.3.1 ： /frs/download.php/45906/rubygems ‐1.3.1.zip ，备注：RubyGems 是一个方便而强大的Ruby 程序包管理器；3. Rake 0.8.3，可以在线下载，是一门构建语言，它支持它自己的DSL 用来处理和维护Ruby 应用程序；4. Rails 2.2.2，/frs/download.php/47183/rails ‐2.2.2.zip ；5. MySQL 5，下载最新版本5.2，/downloads/mysql ；6. Redmine 1.0.4，/frs/?group_id=1850，下载redmine ‐1.0.4.zip ；7. Win32 OpenSSL v0.9.8j Light ，/?yknwgltgzkj ，运行 rake 时要用到； 8. Visual C++ 2008Redistributables ， /downloads/details.aspx?familyid=9B2DA534‐3E03‐4391‐8A 4D ‐074B9F2BC1BF&displaylang=en 。

如果不安装这个，调用 OpenSSL 时可能会报“应用程序配置不正确，程序无法启动，重新安装应用程序可能解决问题。

”错误；9. ZLib 1.2.3 ： /zlib123‐dll.zip 。

运行 rake 时要用到； 10. libiconv 1.9.1 ： ftp:///gnu/libiconv/libiconv ‐1.9.1.bin.woe32.zip 。

运行 rake 时要用到； Apache ，需要OpenSSL 包， 2.2/apache//httpd/binaries/win32/httpd-2.2.17-win32-x86-openssl-0.9.8o.msi ；第 3 章安装与配置1. 将 Ruby 1.8.7 的安装包解压到某个目录下（例如： D:\ruby ‐1.8.7 ），并将子目录 bin 的路径加入到 Windows 的 PATH 环境变量中（例如：在 PATH 环境变量中加入 D:\ruby ‐1.8.7\bin ）;2. 将 RubyGems 1.3.1 安装包解压到某个临时目录下（例如： D:\rubygems-1.3.1 ），在 Windows 的命令行模式下切换当前目录为该临时目录，运行如下命令：ruby setup.rb该命令将离线安装 RubyGems 。

安装完毕后可删除该临时目录 3. 在命令行模式下运行如下命令：gem install rake该命令将在线安装 Rake4.将 Rails 2.2.2 的安装包解压到某个临时目录下（例如： D:\rails ），在命令行模式下切换当前目录为该临时目录，运行如下命令：gem install rails -v=2.2.2 --include-dependencies该命令将离线安装 Rails 。

安装完毕后可删除该临时目录5.在命令行模式下运行如下命令：gem install mysql在命令将在线安装 MySQL 的 C bindings （ C 语言绑定？ C 语言库？），可明显提高访问数据库的性能6.安装并运行 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 TheWindows system directory ”，否则在安装完毕后需要手工将 OpenSSL 安装目录下的 DLL 文件复制到 Windows 的系统目录（例如： C:\Windows\system32 ），或 Ruby 的 bin 目录（例如： D:\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 的安装包解压到某个目录（例如： D:\redmine-1.0.4 ），将config\database.yml.example 复制为 config\database.yml ，并修改该文件中的“ production ”段的数据库配置。

例如：production:adapter: mysqldatabase: redminehost: localhostusername: 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 production16.打开浏览器，访问如下网址： http://localhost:3000/ ，使用用户 admin （密码 admin ）；安装Apache，采用默认安装，建议端口为80端口，并作为服务启动；第 4 章让RedMine自动运行使用命令行方式运行 Redmine 很不方便，Ruby 提供mongrel_service 包，可以将 Ruby 程序注册为 Windows 服务。

1.在命令行下运行如下命令即可安装 mongrel_service；gem install mongrel_service2.使用 mongrel_service 将 Redmine 注册为 Windows 服务；mongrel_rails service::install -N Redmine -c D:\redmine-1.0.4 -p 3000 –e production注意：1)假如提示无SC，可以将C:\WINDOWS\SYSTEM32\SC.exe加入到系统PATH下，重新再执行；2)在机器上执行该命令后，Windows 服务确实注册了，但 -e 参数的值却是 development 。

这需要修改该服务的注册表项，将该参数的值修改为 production ，否则 Redmine 连不上数据库 ；第 5 章RedMine和Apache集成1.修改Redmine安装目录config目录下的environment.rb文件，在文件最后添加如下行：Redmine::Utils::relative_url_root = "/redmine"2.修改Apaache安装目录下的conf目录下的httpd.conf的配置文件，在文件后面添加如下配置，然后重启Apache服务器：LoadModule proxy_module modules/mod_proxy.soLoadModule proxy_http_module modules/mod_proxy_http.soLoadModule proxy_balancer_module modules/mod_proxy_balancer.soProxyPass /redmine balancer://redmine_clusterProxyPassReverse /redmine balancer://redmine_cluster<Proxy balancer://redmine_cluster>BalancerMember http://127.0.0.1:3000</Proxy>第 6 章RedMine和 Hudson的集成1.下载Hudson插件，下载地址http://r‐/svn/trunk/plugins/redmine_hudson/，然后将下载文件夹修改成hudson，然后拷贝到RedMine安装目录的vendor/plugins下；2.在RedMine目录下运行如下命令：rake db:migrate_plugins RAILS_ENV=production3.重新启动RedMine；4.登陆Hudson，选择设置的模块，将Hudson选中，如下图：5.然后刷新屏幕，选择导航栏的Hudson，点击屏幕右边的设置，如下图，进行Hudson集成设置：6.在设置中进行相应的Hudson设置，如下图：7.保存后更新最新任务，选择本项目相关业务后再保存，如下图：8.更新完成后，可以在Hudson导航条中看到如下图示，并可以在这里触发进行持续集成；第 7 章RedMine和SVN的集成RedMine可以和SVN进行无缝的集成，但由于RedMime提取svn相关信息需要用到svn.exe程序，所以必须安装该软件。