redmine1.2.1 安装指南

Redmine1.2.1 安装指南

花了我整整两天的时间，用血淋淋的时间堆积起来的，一定要记下来，

该死的百度，搜索redmine安装的时候，排名最前配置ruby环境的软件就是InstantRails。可实际上InstantRails从2007年开始就没有更新了，里面包含的很多组件版本都很旧，直接搭建的话需要升级各种组件，而且组件之间的依赖关系比较混乱，反正我是在里面绕了很多弯路。而且InstantRails 里面自带有很低版本的apache,mysql,phpMyAdmin,如果你电脑本来安装了这些，那么又要改这些服务的端口和对应的配置文件。总之一句话，InstantRails 已经过时了。

因为redmine是需要apache 和mysql的，所以正好我自己电脑的环境，已经安装好了apache和mysql。此外，redmine使用ruby写的，所以还需要ruby的环境。

配置ruby 的环境我选用的是railsinstaller，目前railsinstaller的官网上https://www.360docs.net/doc/8f6830863.html,/只有最新的2.0版本，集成的是ruby 1.9.2，而redmine 1.2.1只能兼容ruby 1.8.7.官网上又下载不了历史版本，费了好大的劲，满世界的找，终于在https://www.360docs.net/doc/8f6830863.html,/user/alpha006名下找到了railsinstaller 1.1.1。解压安装（当然有人需要的话，可以私下找我要）。

去redmine的官方网站下载所需要的版本-- https://www.360docs.net/doc/8f6830863.html, 的

我下载的的是redmine 1.2.1.弄清楚这个版本的需要的环境。基本上就是我这里所描述的，后面会贴一个总的。

做好这些准备工作以后，可以配置redmine的运行环境了，如下步骤：

1. 把redmine的解压到railsinstaller所产生的sites目录。在dos窗口进入sites\redmine 目录下。

2. gem install rails -v=2.

3.11 安装rails 2.3.11版本，这个redmine 1.2.1所要求的。

3. gem install rack -v=1.1.1 安装rack 1.1.1版本，这个redmine 1.2.1所要求的。

4. gem install -v=0.4.2 i18n 这个根据安装时返回的错误命令提示来决定。比如的我就是提示Missing the i18n 0.4.2 gem. Please `gem install -v=0.4.2 i18n`

5.进入mysql创建数据库。执行以下几条sql 语句。

create database redmine character set utf8;

create database redmine_development character set utf8;

create database redmine_test character set utf8;

create user 'redmine'@'localhost' identified by 'my_password';

grant all privileges on redmine.* to 'redmine'@'localhost';

6.拷贝config/database.yml.example文件到config/database.yml，修改database.yml的内容production:

adapter: mysql

database: redmine

host: localhost

username: redmine

password: my_password

Username 和password字段就是自己要设置的数据库的账号和密码，为了避免麻烦，

把redmine_development和redmine_test的账户信息也设置好。

7..回到dos 窗口下，执行rake generate_session_store

如果提示mysql 错误，再执行如下语句gem install mysql

执行gem install mysql看到如下错误时：

“No definition for next_result

No definition for field_name

No definition for field_table

No definition for field_def……”

做如下操作

A:在以下URL下载libmySQL.dll,分别放入windows/system3和RailsInstaller\Ruby1.8.7\bin 目录下，原因我就不知道了。

https://www.360docs.net/doc/8f6830863.html,/svn/trunk/InstantRails-win/InstantRails/mysql/bin/libmySQ L.dll

B. 执行gem install ri rdoc,然后执行gem install mysql就可以了

8..然后set RAILS_ENV=production

rake db:migrate

rake redmine:load_default_data

执行rake load_default_data RAILS_ENV="production" 完后，会提示Select language: bg, bs, ca, cs, da, de, el, en, en-GB, es, eu, fi, fr, gl, he, hr, hu, id, it, ja, ko, lt, lv, mn, nl,no, pl, pt, pt-BR, ro, ru, sk, sl, sr, sr-CY, sv, th, tr, uk, vi, zh, zh-TW [en] zh

输入zh选择中文

9..最后ruby script/server webrick -e production 启动。以后每次开机后都需要这句来启动。

10..打开浏览器输入http://localhost:3000 。账号，密码都是admin 。登陆的时候还发现redmine那张表一点数据都没有创建，我直接把redmine_development里的数据导到了redmin里面，顺利登陆成功

11..安装完了，就可以使用admin用户登录，密码也是admin，登入后，发现页面又变成了英文的，在这里要设置个人用户，修改语言为中文就可以了。然后进入管理页面，可以管理项目，用户，角色，权限，问题状态，跟踪类型，流程等。

参考官方文档，说一下redmine 1.2.1 官方的安装向导。（仅windows 平台）

官方发行版已经在其vendor 目录包含了适当的Rails 版本，所以不需要为此做什么。

你也可以查看redmine 的版本，运行一下命令特地的为它安装某个版本的组件：gem install rails -v=2.3.11

安装rack

gem install rack -v=1.1.0

兼容性提示

· Ruby 1.9 版本目前还不支持，但你必须安装ruby 1.8.x 以上的版本。

· RubyGems 1.3.7 或者更高版本有以下限制:

o Rails 2.3.5 与rubygems 1.5.0或者更高的版本工作会失败，请使用rubygems的更早的版本!

o Rails 2.3.11 与rubygems 1.7.9或者更高版本工作会失败，请使用rubygems 更早的版本!

·需要Rake 0.8.7 (rake 0.9.x 尚未被Rails 支持)

·需要Rack1.1.x , 1.1.0 版本有引用(#8416)所描述的bug. 同其他版本的迁移会失败.

· Mongrel1.1.5 需要补丁#7688才能和Rails 2.3.11工作. 在升级的情况下，其他问题可能会出现(#7857).

·Redmine >= 1.0.5版本需要I18n 0.4.2

数据库

·需要mysql 5.0或者更高的版本。MySQL 5.0 or higher (建议)

安装步骤

1.获得redmine 的源代码或者发行包。参见Download.

2.用mysql 创建一个空的数据库和一个名为redmine的用户，例如：

create database redmine character set utf8;

create user 'redmine'@'localhost' identified by 'my_password';

grant all privileges on redmine.* to 'redmine'@'localhost';

对于mysql 5.0.2 的版本跳过create user ,用这个代替grant all privileges on redmine.* to 'redmine'@'localhost' identified by 'my_password';

3.复制Copy config/database.yml.example改为config/database.yml ，编辑文件配置数据库设置。例如mysql:

production:

adapter: mysql

database: redmine

host: localhost

username: redmine

password: my_password

如果服务器没有工作在3306端口，用下面的配置代替：

production:

adapter: mysql

database: redmine

host: localhost

port: 3307

username: redmine

password: my_password

4.生成会话密钥：

rake generate_session_store

5.创建数据库：

AILS_ENV=production rake db:migrate

这将创建一个管理员账户。

如果你得到以下错误：

Rake aborted!

no such file to load -- net/https

你需要安装libopenssl-ruby1.8

6.向数据库插入默认的配置数据

RAILS_ENV=production rake redmine:load_default_data

7.运行使用ruby script/server webrick -e production命令

配置：

从1.2.0版本开始，redmine的配置都在config/configuration.yml文件里。不要忘记修改了默认配置都需要重启服务。

Window 用户的特别提醒

RAILS_ENV=production rake db:migrate

RAILS_ENV=production rake redmine:load_default_data

等命令已经变成了

set RAILS_ENV=production

rake db:migrate

rake redmine:load_default_data

如果你需要安装mysql ，使用如下命令：

gem install mysql

在一些情况下，你需要复制libmysql.dll到你的ruby/bin目录，但不是所有的libmysql.dll 都适合，请参考

参考帖子：https://www.360docs.net/doc/8f6830863.html,/giigie/archive/2011/07/31/152160.html

https://www.360docs.net/doc/8f6830863.html,/blog/847218