Centos5 下redmine的安装及配置

Redmine： 这是基于ROR框架开发的一套跨平台项目管理系统，是项目管理系统的后起之秀，据说是源于Basecamp的ror版而来，支持多种数据库，除了和 DotProject的功能大致相当外，还有不少自己独特的功能，例如提供wiki、新闻台、时间跟踪、feed聚合、导出pdf等待，还可以集成其他版 本管理系统和BUG跟踪系统，例如SVN、CVS、TD等等。配置功能强大而且方便，自定义属性和更新通知也很实用，详细的介绍可以看看清华同方的 redmine站点,具体有如下特点：

* 多项目和子项目支持
* 可配置的用户角色控制
* 可配置的问题追踪系统
* 自动日历和甘特图绘制
* 支持 Blog 形式的新闻发布、Wiki 形式的文档撰写和文件管理
* RSS 输出和邮件通知
* 每个项目可以配置独立的 Wiki 和论坛模块
* 简单的任务时间跟踪机制
* 用户、项目、问题支持自定义属性
* 支持多种版本控制系统的绑定（SVN、CVS、Git、Mercurial 和 Darcs）
* 支持多 LDAP 用户认证
* 支持用户自注册和用户激活
* 多语言支持（已经内置了zh简体中文）
* 多数据库支持（MySQL、SQLite、PostgreSQL）
* 外观模版化定制（可以使用 Basecamp 的主题，感觉上就像是自己架设的 Basecamp 服务）

Redmine 的官方网站：http://www.redmine.org/

Redmine 的官方 demo 站点：http://demo.redmine.org

在CentOS5上安装redmine，这里数据库选择MySQL

1：使用yum安装ruby相关的软件
yum -y install ruby ruby-devel ruby-libs ruby-irb ruby-rdoc ruby-mysql
这六个软件中，前5个都可以在官方的yum源中找到，ruby-mysql需要从开源的网站上下载，可从google
检索到！

2：下载并安装ruby gems
wget http://rubyforge.org/frs/download.php/45905/rubygems-1.3.1.tgz
tar xvf rubygems-1.3.1.tgz
cd rubygems-1.3.1
ruby setup.rb
3:安装rails
gem install rails

4:下载并解压redmine
redmine下载地址http://www.redmine.org
unzip redmineXXXX.zip
5：安装mysql数据库，并为redmine新建一个数据库
yum -y install mysql-server
server mysqld start
mysql
create database redmine character set utf8;
exit
6:配置redmine
cp /redmine/config/database.yml.example /redmine/config/database.yml
vi database.yml
production:
adapter: mysql
database: redmine
host: localhost
username: root
password:
socket: /var/lib/mysql/mysql.sock
7:在redmine源码包下运行如下指令
cd /redmine
rake db:migrate RAILS_ENV=production
rake redmine:load_default_data RAILS_ENV=production
8:如果没有出现错误信息，那么可以以webrick的方式试启动下redmine
cd /redmine (这里假定redmine源码的目录放在/下)
ruby script/server -e production &

=> Booting WEBrick...
=> Rails application started on http://0.0.0.0:3000
=> Ctrl-C to shutdown server; call with --help for options
[2009-08-19 12:42:01] INFO WEBrick 1.3.1
[2009-08-19 12:42:01] INFO ruby 1.8.5 (2006-08-25) [i386-linux]
[2009-08-19 12:42:01] INFO WEBrick::HTTPServer#start: pid=2211 port=3000


这样redmine就会侦听本机IP的3000端口，输入URL：http://IP:3000就可以看到登陆界面，
默认的用户名和密码都是admin,进去之后就可以进行项目管理和操作了！如果redmine不能和SVN整合，那基本上是因为redmine服务器上还没有安装SVN客户端，安装上即可！
以上内容参照至这篇文章：http://www.how-to-linux.com/2009/02/how-to-install-redmine-on-centos-52-update/

但这样只是以独立的方式启动redmine,即使在后台执行，依然是美中不足，因为客户端的访问日志会在终端上直接显示，
同时不能做成开机自启动服务，所以我们希望把这个软件整合进Apache中，进而实现这些功能，redmine官网上给出了整合
的方案，但个人觉得也有一个美中不足的地方，就是必须依靠虚拟主机技术才能实现，而使用了虚拟主机后，网站就不能
使用IP方式访问了。

官方文档URL：
http://www.redmine.org/wiki/1/HowTo_configure_Apache_to_run_Redmine

1：首先要让Apache支持cgi

vi /etc/httpd/conf/httpd.conf
Options Indexes FollowSymLinks　(找到这一行，删除“Indexes”，并添加“Includes”、“ExecCGI”)

Options Includes ExecCGI FollowSymLinks　(允许服务器执行CGI及SSI)

#AddHandler cgi-script .cgi　 (找到这一行，去掉行首的“#”，并在行尾添加“.pl”)

AddHandler cgi-script .cgi .pl　 (允许扩展名为.pl的CGI脚本运行)

2:配置redmine源码目录下的public/dispath.cgi脚本
cd /var/www/redmine
cp public/dispatch.cgi.example public/dispatch.cgi
vi public/dispatch.cgi
:set ff?
:set ff=unix
:wq
如果不做这个修改，在运行脚本的时候可能会出现bad interpreter:No such file or directory错误
参考这个网站：http://rc.org.cn/viewthread-863.html

[root@centos public]# ./dispatch.cgi 测试运行脚本
Content-Type: text/html; charset=utf-8
Set-Cookie: _session_id=0772cb6dd79237811badfd4493cf3566; path=/
Status: 200 OK
X-Runtime: 0.30903
ETag: "98b0a60b4680a26d01fd2a18876ebf8c"
Cache-Control: private, max-age=0, must-revalidate
Content-Length: 3229

3：编辑Apache主配置文件
vi /etc/httpd/conf/httpd.conf (这里假定redmine源码的目录放在/var/html/redmine下)

<VirtualHost *:80>
ServerName redmine.xxxxxx.com
ServerAdmin webmaster@xxxxxx.com
DocumentRoot /var/html/redmine/public/
ErrorLog logs/redmine_error_log

<Directory "/var/html/redmine/public/">
Options Indexes ExecCGI FollowSymLinks
Order allow,deny
Allow from all
AllowOverride all
</Directory>
</VirtualHost>
[root@centos ~]# apachectl -t 检测Apache配置文件语法
Syntax OK

[root@centos ~]# service httpd restart 重启Apache服务