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. 软件的版本问题
为了避免出现更多的问题,请尽量按照本文环境说明中提供的版本信息安装软件。