Redmine在Linux（CentOS）下的安装及配置

一、Redmine简介：

Redmine 是一个支持多项目管理的跨平台项目管理系统，基于Web，使用Ruby on Rails框架开发。
Redmine is a flexible project management web application. Written using Ruby on Rails framework, it is cross-platform and cross-database. Redmine is open source and released under the terms of the GNU General Public License v2 (GPL).
基本特性如下：
* 多项目和子项目支持 Multiple projects support
* 可配置的用户角色控制 Flexible role based access control.
* 可配置的问题追踪系统 Flexible issue tracking system
* 自动日历和甘特图绘制 Gantt chart and calendar
* 支持新闻发布、Wiki 形式的文档撰写和文件管理News, documents & files management
* RSS 输出和邮件通知 Feeds & email notifications.
* 每个项目可以配置独立的 Wiki 和论坛模块 Per project wiki，Per project forums
* 简单的任务时间跟踪机制 Simple time tracking functionality
* 用户、项目、问题支持自定义属性 Custom fields for issues, projects and users
* 支持多种版本控制系统的绑定 SCM integration (SVN, CVS, Git, Mercurial, Bazaar and Darcs)
* 支持多 LDAP 用户认证 Multiple LDAP authentication support
* 支持用户自注册和用户激活 User self-registration support
* 多语言支持（内置简体中文）Multilanguage support
* 多数据库支持（MySQL、SQLite、PostgreSQL）Multiple databases support

官方网站：http://www.redmine.org/
帮助文档：http://www.redmine.org/guide

二、Redmine的安装和测试
Redmine的官方网站是：http://www.redmine.org，可以在这里：http://www.redmine.org/wiki/redmine/RedmineInstall得到与当前Redmine版本相符合的其他软件版本。

1、Ruby
Ruby的官方网站是http://ruby-lang.org/，我们使用1.8.7版。
安装Ruby是很简单的，先解开包：tar xfvj ruby-1.8.7.tar.bz2
然后配置：./configure –prefix=/usr/local/ruby
再运行make和make install，将ruby安装到/usr/local/ruby目录中。

安装完成后，记得设置PATH环境变量，加上/usr/local/ruby/bin，以便运行ruby。
直接编辑/etc/environment文件，在里面修改PATH环境变量。该方法必须重启系统后才能生效，但是对于任何用户都有效。
可以设置为：
PATH=.:/bin:/sbin:/usr/sbin:/usr/bin:/usr/local/bin:/usr/X11R6/bin:/usr/local/ruby/bin:/usr/local/mysql/bin

2、RubyGems
RubyGems的官方网站是http://www.rubygems.org/，是个包管理工具，相当于RPM、yum等工具。
当前最新版本是1.3.1，可以在这里下载(http://rubyforge.org/frs/download.php/45905/rubygems-1.3.1.tgz)。
安装RubyGems更简单，同样解开包：tar xfvz rubygems-1.3.1.tgz
再进入rubygems-1.3.1目录，运行：ruby setup.rb
即可完成安装（默认安装到ruby所在目录下）。

3、Rake
Rake的官方网站是http://rake.rubyforge.org/，可以让gem联网下载安装，也可以在官方网站下载后进行安装。
运行：
gem install rack -v=1.0.1

4、Ruby on Rails
Ruby on Rails的官方网站是http://rubyonrails.org/，同样可以使用gem联网下载安装，也可以下载后再本地安装。
运行：gem install rails -v=2.3.5

安装Redmine
1、下载并解开Redmine
Redmine的官方网址是http://www.redmine.org
使用如下命令可下载源代码：
svn co http://redmine.rubyforge.org/svn/trunk redmine

2、创建数据库
我们使用的是MySQL数据库，运行mysql客户端登录数据库：mysql -uroot -p
创建redmine数据库：create database redmine character set utf8;
为redmine创建数据库用户（这里的用户名密码都是redmine)：grant all privileges on redmine.* to redmine@’%’ identified by ‘redmine’ with grant option;

3、设置redmine的数据库参数
我们使用redmine提供的例子为蓝本，进入redmine所在目录：cp config/database.yml.example config/database.yml
编辑文件config/database.yml，找到production段落，设置用户名和密码为，并保存文件。此处应注意设置项和前面的冒号（:）之间要有个空格，否则会出错。

4、生成会话存储密钥：
RAILS_ENV=production rake config/initializers/session_store.rb

注：r3055之后的版本移除了config/initializers/session_store.rb，使用下面的命令替代。
rake generate_session_store

5、创建数据库结构
运行命令：rake db:migrate RAILS_ENV=”production”

此时可能需要根据命令安装mysql gem，运行：gem install mysql
运行此命令安装时，如果系统的mysql数据库是yum或者rpm等方法安装的，并不是源代码方式进行安装的，可能会提示找不到mysql的一些文件的错误信息，可以卸载系统原有的mysql，并进行源代码方式安装mysql。

如果有类似错误信息，可以按照下面的方法解决：
Error1: syntax error on line 14, col 2: encoding: utf8
Resolution: modify config/database.yml, after password: it must has a space between “:” and “redmine”

Error2: No such file or directory – /tmp/mysql.sock
Resolution: modify config/database.yml “host: Localhost” to “host: 127.0.0.1″

6、载入默认配置
这一步是可选的，但高度推荐使用。
运行命令：rake redmine:load_default_data RAILS_ENV=”production”
读取默认配置数据，当遇到选择语言(Select language)时，选择zh.
至此，redmine简单的配置就完成了。使用其自带的webrick来运行redmine，来检查下redmine的配置

7、运行并测试redmine
运行命令：ruby script/server webrick -e production

即可启动redmine，默认打开3000端口，可以通过http://localhost:3000/访问（管理员初始用户名和密码都是admin）。
如果希望Redmine作为服务运行，加上-d参数即可：ruby script/server webrick -e production -d