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”登录即可开始进行项目管理了。