【转载】Redmine安装完全图文指南
原文出处：http://www.cnblogs.com/espie/archive/2011/05/01/2034135.html
这篇博文主要参考了如下文章：
http://www.redmine.org/projects/redmine/wiki/RedmineInstall
http://xinlanzero.iteye.com/blog/857494
有关BUG的疑难解答主要参考：
http://www.redmine.org/boards/2/topics/22358
http://www.redmine.org/issues/7516
http://www.redmine.org/boards/2/topics/6423?r=6447
http://rordiary.com/blog/2010/03/192/
安装准备
[
](http://images.cnblogs.com/cnblogs_com/espie/201105/201105012240332855.jpg)
先下载下面这些安装过程中要用到的软件，如上图所示：
1. Ruby 1.8.7：http://rubyforge.org/frs/download.php/74293/rubyinstaller-1.8.7-p334.exe
2. MySQL：http://www.mysql.com/downloads/mysql/5.5.html#downloads
3. Redmine 主程序：http://www.redmine.org/projects/redmine/wiki/Download
4. Win32 OpenSSL Light：
http://www.slproweb.com/download/Win32OpenSSL_Light-1_0_0d.exe
Visual C++ 2008 redistributable packages: \texttt{http://www.microsoft.com/downloads/details.aspx?familyid=9B2DA534-3E03-4391-8A4D-074B9F2BC1BF&displaylang=en}（如果未安装此程序包，则在调用 OpenSSL 时可能会出现"应用程序配置不正确,程序无法启动,重新安装应用程序可能解决问题"的错误提示）
libiconv 版本号 1.9.2：[链接]（在运行 rake 时需要用到）
安装与配置
安装Ruby
[
](http://images.cnblogs.com/cnblogs_com/espie/201105/201105012240336410.jpg)
1. 安装Ruby运行环境（rubyinstaller-1.8.7-p334.exe），如上图
[
](http://images.cnblogs.com/cnblogs_com/espie/201105/201105012240349965.jpg)
2. 注意在安装过程中，勾选如上两项
3. 开始安装，直至安装完成。
[
](http://images.cnblogs.com/cnblogs_com/espie/201105/201105012240349932.jpg)
4. 运行开始菜单中的“Start Command Prompt with Ruby”，打开Ruby命令行
5. 输入如下命令，安装Rails框架：
| gem install rails -v=2.3.5 |
|---|
[
](http://images.cnblogs.com/cnblogs_com/espie/201105/201105012240348263.jpg)
Ruby通过网络连接获取Rails框架文件及相关文档资料，并随即启动安装流程。该过程所需时间较长，在约10分钟内完成。如图所示。若未出现错误提示信息，则将进行下一步骤操作。
6. 输入如下指令，安装Rake：
| gem install rack -v=1.0.1 |
|---|
[
](http://images.cnblogs.com/cnblogs_com/espie/201105/201105012240359866.jpg)
7. 输入如下指令，安装MySQL的C bindings：
| gem install mysql |
|---|
该命令将在线安装 MySQL 的 C bindings，可明显提高访问数据库的性能
安装MySQL
[
](http://images.cnblogs.com/cnblogs_com/espie/201105/201105012240354293.jpg)
[
](http://images.cnblogs.com/cnblogs_com/espie/201105/201105012240358720.jpg)
1. 运行mysql-5.5.9-win32.msi开始安装，如上图所示
[
](http://images.cnblogs.com/cnblogs_com/espie/201105/201105012240358687.jpg)
安装完成后，请您启动MySQL配置流程，并利用" MySQL Instance Configuration Wizard "工具进行操作。如图所示
[
](http://images.cnblogs.com/cnblogs_com/espie/201105/201105012240365066.jpg)
选择详细配置，以调整参数，如上图
[
](http://images.cnblogs.com/cnblogs_com/espie/201105/201105012240365033.jpg)
在服务器运行环境中选择合适的配置对MySQL性能提升至关重要；如果是在本地机器上部署数据库服务，建议采用开发者专用型服务器配置以节省资源。
[
](http://images.cnblogs.com/cnblogs_com/espie/201105/201105012240376603.jpg)
开启TCP/IP网络，设置合理的数据库端口，如上图。
[
](http://images.cnblogs.com/cnblogs_com/espie/201105/201105012240376014.jpg)
这里要选择手动设置默认字符集：UTF8，如上图。
[
](http://images.cnblogs.com/cnblogs_com/espie/201105/201105012240372393.jpg)
这里要选择"将计算机安装为Windows服务"选项，并且勾选"将计算机的Bin目录包含在Windows Path环境中"（如上图）。
[
](http://images.cnblogs.com/cnblogs_com/espie/201105/201105012240382360.jpg)
设置服务器默认管理员密码。如上图。
[
](http://images.cnblogs.com/cnblogs_com/espie/201105/201105012240383963.jpg)
配置完成后，系统开始进行配置，顺利的话将显示上图结果页面。
在Windows命令行界面中打开，在此窗口中输入mysql -u root -e 'cd C:\xampp\mysql\bin;'。请注意，在此窗口中输入mysql -u root -e 'cd C:\xampp\mysql\bin;'。如果之前配置过MySql服务，请启动服务并连接到本地网络。
| Mysql –u root -p |
|---|
按下回车键后，在终端中填入服务器密码并确认。这时终端提示符变为'mysql>'。此时表示身份验证通过。
4. 在 MySQL 命令行模式下运行如下命令，创建Redmine数据库：
| create database redmine character set utf8; |
|---|
回车后，该命令将创建一个供 Redmine 使用的数据库。
PS：在MySQL数据库命令行操作中，最后必须使用‘;’结束才能正常运行。如果你没有接触过MySQL这项技术的话，则需特别注意这一操作的关键性。（比如我就是这么 stuck 的）
注册Redmine数据库账户，并设置相应的用户名和密码，并赋予相应的权限。请将括号内的双引号替换为‘’并在括号内填写如替换为自身用户名、服务器名称以及初始密码
| create user 'redmine'@'localhost' identified by 'my_password'; |
|---|
无错误提示，则表示创建成功。
下面进行赋权操作：
| grant all privileges on redmine.* to 'redmine'@'localhost'; |
|---|
PS：如果创建用户出了什么差错，可以使用如下命令删除用户：
| drop user 'redmine'@'localhost'; |
|---|
安装OpenSSL并配置Ruby
1. 安装 Visual C++ 2008 Redistributables
[
](http://images.cnblogs.com/cnblogs_com/espie/201105/201105012240383930.jpg)
2. 安装 Win32 OpenSSL Light 。如上图
[
](http://images.cnblogs.com/cnblogs_com/espie/201105/20110501224039309.jpg)
3. 注意在本页选择“ Copy OpenSSL DLLs to The Windows system directory ”
否则在安装完毕后需手动复制位于 OpenSSL 安装目录下的 DLL 文件至 Windows 系统目录（其中 Windows 版本的系统目录位于 C:\Windows\system32），或其 bin 目录（其中 Ruby 版本的 bin 目录位于 C:\ruby-1.8.7\bin）。
[
](http://images.cnblogs.com/cnblogs_com/espie/201105/20110501224039276.jpg)
4. 根据向导完成安装。 如上图所示（呵呵，捐赠就不需要选择了：P）
将 ZLib 1.2.3 安装包中的 zlib1.dll 解压缩到 Windows 系统目录或 Ruby 的 bin 目录，并将其重命名为 zlib.dll
将 libiconv 1.9.1 可执行文件包中的 bin\iconv.dll 文件复制解压至 Windows 系统目录或 Ruby's bin 目录（无此需求时可跳过此操作）
安装Redmine主程序
将 Redmine 的可执行文件解压至指定目录位置（如 C:\redmine-0.9.1）。随后，请按照以下步骤操作：
首先，复制指定示例配置文件至目标路径。
然后，在此处编辑指定配置文件的相关设置。
如示例所示：
将 Redmine 的可执行文件解压至指定目录位置（如 C:\redmine-0.9.1）。
复制指定示例配置文件至目标路径。
在此处编辑指定配置文件的相关设置。
将 Redmine 的可执行文件解压至指定目录位置（如 C:\redmine-0.9.1）。随后，请按照以下步骤操作：
首先，复制指定示例配置文件至目标路径。
然后，在此处编辑指定配置文件的相关设置。
| production: adapter: mysql database: redmine host: localhost username: root （这里填写你希望用来登录 MySQL 的用户名） password: password （这里填写用户密码） |
|---|
2. 为了将MySQL的DLL文件移动至Ruby的程序文件夹中（例如，在C:\ruby-1.8.7\bin位置），然后在Redmine程序文件夹下的命令行环境中切换到对应的路径（例如Redmine程序文件夹下的cmd.exe），执行以下操作：
| rake config/initializers/session_store.rb |
|---|
[
](http://images.cnblogs.com/cnblogs_com/espie/201105/201105012240399927.jpg)
当遇到上图所示的错误提示时，则必须进行下列操作：首先安装一个国际化组件后重新运行程序。
| gem install –v=0.4.2 i18n |
|---|
[
](http://images.cnblogs.com/cnblogs_com/espie/201105/201105012240396306.jpg)
3. 使用如下命令创建数据库结构：
| rake db:migrate RAILS_ENV="production" |
|---|
此指令旨在构建用于生产的数据库架构。此为整个流程中的核心环节。经多番尝试后终于成功地安装好了Redmine系统。此步骤可能存在的问题较为多样。对于可能出现的其他问题，请访问Redmine网站搜索相关描述，在大多数情况下都能找到令人满意的解决方案。
当遇到MySQL报错信息为"Mysql::Error: InnoDB功能被禁用"时，请按照以下步骤操作以解决问题：首先，在你的MySQL安装目录下找到my.ini配置文件；在其中找到当前配置中的"skip-innodb"项并将其改为"#skip-innodb"；最后重新启动MySQL服务以应用上述更改。请注意，在执行上述操作之前，请使用以下命令验证当前状态：通过执行MySQL命令"show variables like 'have_%';"来确认是否已启用InnoDB功能
[
](http://images.cnblogs.com/cnblogs_com/espie/201105/201105012240406273.jpg)
PS2：当出现如上图所示的错误时，则需要对redmine安装目录下的config\ environment.rb脚本进行配置修改。
添加需要执行的逻辑
puts "成功启动环境"
# 其他可能需要执行的操作| #在bootStrap和initialization之间添加语句 --espie if Gem::VERSION >= "1.3.6" module Rails class GemDependency def requirement r = super (r == Gem::Requirement.default) ? nil : r end end end end |
|---|
[
](http://images.cnblogs.com/cnblogs_com/espie/201105/201105012240419762.jpg)
如上图所示，之后保存退出。
PS3：
[
](http://images.cnblogs.com/cnblogs_com/espie/201105/201105012240416141.jpg)
当遇到上图所示的错误时，这通常是由于rails与mysql for win之间存在不兼容性所导致的。为此建议将mysql的libmySQL.dll文件替换为其旧版本以解决问题。
可在此处下载旧版本：http://instantrails.rubyforge.org/svn/trunk/InstantRails-win/InstantRails.mysql/bin/libmySQL.dll]
http://rordiary.com/blog/wp-content/uploads/2010/03/libmySQL.zip
之后将替换至Ruby安装目录\bin\目录下。
4. 继续运行如下命令：
| rake redmine:load_default_data RAILS_ENV="production" |
|---|
[
](http://images.cnblogs.com/cnblogs_com/espie/201105/201105012240416108.jpg)
该命令负责完成填充默认配置数据的任务。在运行过程中需选择语言，在输入时一般采用zh（ 简体中文）作为参数值，并显示如下图所示界面。如果未能成功，则可能源于上一步未完成。
启动Redmine主程序
5. 在ruby命令行模式下，切换至Redmine主目录，运行如下命令：
| ruby script/server webrick -e production |
|---|
[
](http://images.cnblogs.com/cnblogs_com/espie/201105/201105012240429663.jpg)
该命令将使用Webrick发布运行 Redmine ！运行成功后如上图所示。
启动浏览器并访问指定地址 http://localhost:3000/ ，然后输入admin账户（密码为admin）进行登录操作。
-------------- SPY is here! 为什么是SPY？因为我叫这个名字已经很久了。