在Windows上安装Redmine.doc

在Windows上安装Redmine 概述 Redmine 是一个使用 ROR 框架建立的灵活的项目管理工具。它提供了基本的需求管理、缺陷管理功能，还提供了新闻发布、 Wiki 、论坛等其它功能。 Redmine 的官方的安装指南可在如下网址看到： /wiki/redmine/RedmineInstall 。本手册是在该指南的基础上修订而来的。 安装准备 安装过程中需要用到如下软件 / 组件： 1. Ruby 1.8.7 ： /pub/ruby/binaries/mswin32/ruby-1.8.7-p72-i386-mswin32.zip 2. RubyGems 1.3.1 ： /frs/download.php/45906/rubygems-1.3.1.zip 3. Rake 0.8.3 ：因为这个比较小，可在线安装，不用下载 4. Rails 2.2.2 ： /frs/download.php/47183/rails-2.2.2.zip 。因为在线安装 Rails 可能有问题，可下载这个包用来离线安装 5. MySQL 4.1 或更高版本：可在 MySQL 的官网下载 6. Redmine 0.8.1 ： /frs/download.php/51748/redmine-0.8.1.zip 7. Win32 OpenSSL v0.9.8j Light ： /download/Win32OpenSSL_Light-0_9_8j.exe 。运行 rake 时要用到 8. Visual C+ 2008 Redistributables ： /downloads/details.aspx?familyid=9B2DA534-3E03-4391-8A4D-074B9F2BC1BF&displaylang=en 。如果不安装这个，调用 OpenSSL 时可能会报“应用程序配置不正确，程序无法启动，重新安装应用程序可能解决问题。”错误 9. ZLib 1.2.3 ： /zlib123-dll.zip 。运行 rake 时要用到 10. libiconv 1.9.1 ： /gnu/libiconv/libiconv-1.9.1.bin.woe32.zip 。运行 rake 时要用到 安装与配置 1. 将 Ruby 1.8.7 的安装包解压到某个目录下（例如： C:ruby-1.8.7 ），并将子目录 bin 的路径加入到 Windows 的 PATH 环境变量中（例如：在 PATH 环境变量中加入 C:ruby-1.8.7bin ） 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 该命令将离线安装 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:Windowssystem32 ），或 Ruby 的 bin 目录（例如： C:ruby-1.8.7bin ） 10. 将 ZLib 1.2.3 的安装包中的 zlib1.dll 解压到 Windows 的系统目录或 Ruby 的 bin 目录，并改名为 zlib.dll 11. 将 libiconv 1.9.1 的安装包中的 biniconv.dll 解压到 Windows 的系统目录或 Ruby 的 bin 目录 12. 将 Redmine 的安装包解压到某个目录（例如： C:redmine-0.8.1 ），将 configdatabase.yml.example 复制为 configdatabase.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 自动运行 使用命令行方式运行 Redmine 很不方便，幸好 Ruby 提供了 mongrel_service 包，它可以将 Ruby 程序注册为 Windows 服务。 1. 在命令行下运行如下命令即可安装 mongrel_service ： gem install mongrel_service 2. 然后使用 mongrel_service 将 Redmine 注册为 Windows 服务： mongrel_rails service:install - N Redmine -c C:redmine-0.8.1 -p 3000 e production 注意：在我的机器上执行该命令后， Windows 服务确实注册了，但 -e 参数的值却是 development 。这需要修改该服务的注册表项，将该参数的值修改为 production ，否则 Redmine 连不上数据库 3. 如果 MySQL 是与 Redmine 安装在同一台机器的，还可以将 MySQL 添加为 Redmine 依赖的服务，这样启动 R