redmine安装指引

为什么80%的码农都做不了架构师？>>>   

1 前言

本文记录了在window7下面安装redmine的操作过程，同时也为其他有兴趣安装redmine的同学提供帮助。

2 环境说明

操作系统：window7 64位

数据库：mysql-5.5.36-winx64

Redmine版本：1.0.4 或者 0.9.4

软件清单如下：

软件	版本	备注
bundler	1.5.3
i18n	0.6.9
mysql	2.8.1 x86-mingw32	安装的时候，版本指定:-v=2.8.1
rack	1.0.1
rails	2.3.5
rake	0.8.7
rubygems-update	1.4.2

说明：

Ø redmine的版本信息需要特别注意，不同版本redmine，安装过程存在细微的调整，比如：在安装一些较老版本的时候，需要执行命令：rake config/initializers/session_store.rb，但是在1.0.4和0.9.4版本中执行的命令是：rake generate_session_store；

Ø 另外补充一点，从官网下载的redmine中，都会提供简易的安装说明，比如：redmine-1.0.4\doc\INSTALL；

Ø 本文档记录的安装过程是一个从无到有的过程，包括了ruby、mysql等整个的安装过程，针对ruby，mysql具体的安装过程（安装截图），本文不会涉及，仅仅记录一些关键点；

Ø 对于软件清单中提到的版本信息，在安装redmine的时候，请尽量按照上面给出的版本安装。

3 安装步骤

3.1 安装Ruby运行环境

1. 安装rubyinstaller

版本：rubyinstaller-1.8.7-p371.exe

下载地址：http://rubyforge.org/frs/?group_id=167&release_id=42563

2. 安装redmine运行环境

安装完rubyinstaller后， 点击开始菜单，选择 Start Command Prompt with Ruby

进入含有ruby环境的DOS界面，依次执行如下命令：

set http_proxy= gem install -v=0.8.7 rake gem install -v=1.0.1 rack gem install -v=2.8.1 mysql gem install -v=2.3.5 rails gem install rubygems-update -v='1.4.2' gem install i18n

说明：“set http_proxy = ”这条命令的执行，用于取消代理设置，可以先不执行，等到出相关问题（由于没有记录问题，此处不能提供问题的描述信息）的时候再来执行。

3.2 安装和创建数据库

1. 安装mysql

下载地址：http://dev.mysql.com/downloads/mysql/

安装注意：数据库实例的编码，本人使用的是utf8

2. 建库建用户授权

create database redmine character set utf8; create user 'redmine'@'localhost' identified by 'redmine'; grant all privileges on redmine.* to 'redmine'@'localhost';

3.3 配置redmine

1. 下载Redmine压缩包

下载地址：http://rubyforge.org/frs/?group_id=1850

2. 修改数据库配置文件

解压并进入解压后目录的目录，将config/database.yml.example 重命名为 config/database.yml，并修改链接数据库所需要的参数，以下是修改信息，加粗部分是修改的内容：

production: adapter: mysql database: redmine host: localhost username: redmine password: redmine encoding: utf8

3. 生成session密钥，执行数据迁移并载入Redmine默认配置

set RAILS_ENV=production rake generate_session_store rake db:migrate rake redmine:load_default_data

3.4 启动并验证redmine

1. 启动

ruby script/server

2. 验证

开浏览器，输入http://localhost:3000如果页面正常显示，则说明已经成功安装。

4 数据迁移

数据迁移指redmine之间数据的迁移，迁移的内容涉及到数据库和数据文件。操作步骤比较简单。

1. 导出数据

Ø 在源redmine中执行mysql命令导出数据库数据

mysqldump -u redmine -p redmine -S /var/lib/mysql/mysql.sock > /redmine.sql

Ø 在源redmine中直接压缩数据文件目录

redmine-1.0.4\files

2. 导入数据

Ø 导数据库数据到目标redmine

直接用数据库链接工具，直接redmine.sql文件。

Ø 用压缩的文件覆盖目标redmine的files目录

3. 重启目标redmine，查看迁移效果

5 遇到的问题

1. 数据迁移后点击问题列表报错

界面报错：NoMethodError (undefined method `[]' for nil:NilClass)

解决：不同版本之前的redmine迁移容易出错，比如：0.9.4迁移到1.0.4就报了这个错误。

2. The bundled mysql.rb driver has been removed from Rails 2.2

Ruby没有使用合适的LIBMYSQL.Dll文件。

下载链接：http://url.cn/PQjqoF

3. Can't connect to MySQL server on 'localhost' (10061)

mysql数据库没启动，需要启动mysql

4. ruby: No such file or directory -- srcipt/server (LoadError)

执行ruby script/server的时候报该错，解决办法：在redmine目录下面执行该脚本

5. 软件的版本问题

为了避免出现更多的问题，请尽量按照本文环境说明中提供的版本信息安装软件。

转载于:https://my.oschina.net/psuyun/blog/213749