Redmine with MySQL 安装指南

今天花了一天时间帮一同学解决了 Redmine with MySQL 的安装问题。我觉得这个问题应该会有很多人遇到，所以就写成这个安装指南。其实 Redmine 官方 帮助文档 也有详细的安装步骤，但是当我们自己在进行实际操作时却遇到了各种各样的问题，去网上搜吧，除了都是一些被人转来转去的解决办法之外，最让人不可接受的就是很多写解决方法的人自己都没有亲自试验过，而且关键性步骤都无法验证。所以，我就写个我自己亲自试验通过的安装指南。

第一步：安装 MySQL-5.5.x, 安装完后进行配置，然后下面几步做如下配置，其它的保持默认即可。

图 2

图 3

图 4

第二步：创建 redmine 数据库和用户。

(1) 打开 SQLYog，连接上 MySQL 服务器。然后在 SQL 语句编辑窗口输入如下三行 SQL 语句，然后执行。

CREATE DATABASE redmine CHARACTER SET utf8;
CREATE USER 'redmine'@'localhost' IDENTIFIED BY '123456';
GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost';

第三步：将下载的 MySQL-Connector-C-noinstall-6.0.2-win32.zip 解压到“C：\MySQL\MySQL-Connector-C-6.0.2\”，当然，你也可以解压到其它目录。

图 5

第四步：下面开始安装 RailsInstaller。这个安装比较简单，一路默认即可。我这里将它默认安装在“C:\RailsInstaller”。安装完成之后，会弹出一个配置窗口，在这个窗口里面，需要我们输入我们的 GitHub 用户名和邮箱。没有 GitHub 账户的可以去这里（ https://github.com/join）注册一个，要知道高手都在这上面呢。

输入完用户名和邮箱之后，git 的配置就完成了，然后会给我们一个public ssh key，需要的同学可以记下来，不需要的可以略过不管。

第五步：进入目录“C:\MySQL\MySQL-Connector-C-6.0.2\lib”，将“libmysql.dll”文件复制到目录“C:\RailsInstaller\Ruby1.9.3\bin”下，即 Ruby 的 bin 目录下。

第六步：将我们下载好的“Redmine-2.6.0.zip”里面的所有文件解压到“C:\Sites”目录。

图 6

然后，进入“C:\Sites\config”目录，将文件“database.yml.example”重命名为“database.yml”，将文件“configuration.yml.example”重命名为“configuration.yml”。然后用记事本打开“database.yml”文件，做如下修改：

图 7

第七步：下面我们开始正式安装 Redmine 管理软件。

(1) 打开命令行工具。

图 8

(2) 输入如下命令以安装 mysql 包。

gem install mysql

图 11

(3) 输入如下命令以安装bundler。

gem install bundler

图 9

(4) 输入如下命令以使用 bundler 来安装所有依赖的包，注意，后面的参数一定要设置不包含“developmenttestrmagick”三个项。

bundle install --without development test rmagick

(5) 接着安装会出现错误，说缺少“mysql2 0.3.16”这个包，于是我们需要安装这个包，继续在命令行输入如下命令：（注意：后面参数里面的那个目录是上面第三步解压的那个目录）

gem install mysql2 –v=0.3.16 -- '--with-mysql-dir="C:\MySQL\MySQL-Connector-C-6.0.2"'

图 10

图 12

(6) 安装完 mysql 包之后，重新输入如下命令以重新安装所有依赖的包。

bundle install --without development test rmagick

图 13

(7) 安装完所有绑定的包之后，我们需要执行rake命令生成一个随机key以供 Rails 使用。于是我们需要输入如下命令：

rake generate_secret_token

如果 Redmine 的版本是 1.4.x，则需要输入如下命令：

rake generate_session_store

图 14

(8) 接着我们需要创建数据库的结构，于是输入如下两条命令：

set RAILS_ENV=production
rake db:migrate

其中第一条命令是设置 Rail 的环境为production，而这个名为 production 环境其实就是我们之前在“C:\Sites\config\database.yml”文件里面配置的 production 项。

输入命令后，如果之前的“database.yml”文件没有配置错误的话，则会出现下图这样结果。

图 15

(9) 接着我们需要向数据库中插入一些默认配置数据。于是我们需要输入如下两行命令：

set RAILS_ENV=production
rake redmine:load_default_data

接着会提示我们选择语言，不知道简体中文是不是“zh”，暂且就是选它吧。

图 16

(10) 接下来最后一步，就是要启动 web 服务器以测试是否安装成功。于是我们需要输入如下命令：

ruby script/rails server webrick -e production

如果是 Redmine 1.4x 版本，则需要输入如下命令：

ruby script/server webrick -e production

如果弹出安全警报，则解除阻止。

图 17

最后，我们看到的界面如下，在这个界面我们可以看到服务器端口号为3000，进程 ID 为 3012。

图 18

(11) 然后我们在浏览器地址栏输入：http://localhost:3000/，接着便出现了 Redmine 的主页，如下图。

图 19

然后我们点击右上角的“登录”链接，然后使用用户名“admin”，密码“admin”登录即可开始进行项目管理了。