前言
redmine(http://www.redmine.org/)是一款项目管理软件，由ruby编写，以网页的形式呈现。正好公司需要单独搭建一套这个系统，与其说是搭建，更应该说是升级。
任务：①在阿里云服务器上搭建redmine系统，我用的最新版redmine 2.1.4
②导入之前同事用redmine1.2.0搭建的数据，使用的是MySQL数据库。
安装
Step 1 - Redmine application
首先是软件的下载地址：redmine 2.1.4、ruby 1.8.7、rubygems 1.8.24
redmine: http://rubyforge.org/frs/?group_id=1850 rubygems: http://rubyforge.org/frs/?group_id=126&release_id=46730 ruby: ftp://ftp.ruby-lang.org/pub/ruby/1.8/
需要安装的软件包
ruby-1.8.7.tar.gz ruby-libs-1.8.5 #(or later version) ruby的依赖包，虽然ruby版本版本是1.8.7，但是经过我的测试这个可以用1.8.5的，可以用yum安装，命令yum install ruby-libs。 rubygems-1.8.24.tgz redmine-2.1.4.tar.gz
安装Ruby、RubyGems
tar zxf ruby-1.8.7.tar.gz cd ruby-1.8.7 ./configure --prefix=/usr/local/ruby
tar xf rubygems-1.8.24.tgz cd rubygems-1.8.24 ruby setup.rb
加入ruby环境变量（这里有个疑惑是应该加在/root/.bash_profile里还是/etc/bashrc里）
vim /root/.bash_profile PATH=$PATH:$HOME/bin:/usr/local/ruby/bin source /root/.bash_profile
安装redmine
tar zxf redmine-2.1.4.tar.gz chown -R apache.apache redmine-2.1.4 cd redmine-2.1.4
Step 2 - Dependencies installation
gem install bundler #安装bundler，好处是不需要使用gem 一个一个的安装模块，坏处的不能控制版本。官网http://gembundler.com/ bundle install --without development test postgresql sqlite rmagick #without就是不安装这几个模块，其他都安装。
Step 3 - Create an empty database and accompanying user
MySQL下执行（MySQL要事先安装好，版本5.0及以上，可以直接使用yum安装，yum install mysql mysql-server mysql-devel）
create database redmine character set utf8; create user 'redmine'@'localhost' identified by 'redmine';#在数据库中创建redmine用户，密码也是redmine grant all privileges on redmine.* to 'redmine'@'localhost';
Step 4 - Database connection configuration
cd config cp database.yml.example database.yml #配置redmine连接MySQL vim database.yml
修改为：
production: adapter: mysql database: redmine host: localhost username: redmine password: redmine encoding: utf8
保存退出
cp configuration.yml.example configuration.yml vim configuration.yml #配置邮件通知，前提是安装好sendmail或者postfix，同样可以用yum安装
修改：
#default 部分
default:
# Outgoing emails configuration (see examples above)
email_delivery:
delivery_method: :smtp
smtp_settings:
address: 127.0.0.1
port: 25
domain: localhost
authentication: :login
user_name: "redmine@localhost"
password: "redmine"
#production 部分
production:
email_delivery:
delivery_method: :smtp
smtp_settings:
address: 127.0.0.1
port: 25
domain: localhost
Step 5 - Session store secret generation
cd .. rake generate_secret_token #生成config/initializers/secret_token.rb文件，在redmine 2.1.4中，这个文件事先是不存在的，如果事先有，删除掉。
Step 6 - Database schema objects creation
RAILS_ENV=production rake db:migrate #初始化数据库，创建表
Step 7 - Database default data set
RAILS_ENV=production rake redmine:load_default_data #插入缺省数据，选择zh
Step 8 - File system permissions
mkdir tmp tmp/pdf public/plugin_assets #主要是修改文件夹权限，如果有了可以不创建，只修改权限和属主 chown -R apache:apache files log tmp public/plugin_assets chmod -R 755 files log tmp public/plugin_assets
Step 9 - bind with apache #跟apache整合，需要安装httpd、httpd-devel
gem install passenger #安装apache模块 passenger-install-apache2-module touch /etc/httpd/conf.d/redmine.conf
在redmine.conf中写入内容（这个根据实际情况复制，passenger-install-apache2-module命令执行成功会有提示）
LoadModule passenger_module /usr/local/ruby/lib/ruby/gems/1.8/gems/passenger-3.0.18/ext/apache2/mod_passenger.so PassengerRoot /usr/local/ruby/lib/ruby/gems/1.8/gems/passenger-3.0.18 PassengerRuby /usr/local/ruby/bin/ruby
Listen 3000
<VirtualHost *:3000>
ServerName server.example.com #换成你自己的主机名
# !!! Be sure to point DocumentRoot to 'public'!
DocumentRoot /opt/redmine-2.1.4/public
<Directory /opt/redmine-2.1.4/public >
# This relaxes Apache security settings.
AllowOverride all
# MultiViews must be turned off.
Options -MultiViews
</Directory>
</VirtualHost>
启动apache
/etc/init.d/httpd restart #启动apache，这样redmine也就启动了
Step 10 - Finish ！Visit the URL
http://server.example.com:3000/
备注，下面的命令可能是以后备份数据库和更行redmine的插件数据库需要的：
导出mysql数据库内容
mysqldump -uroot -ppassword redmine --lock-all-tables >redmine.sql
导入数据库内容
mysql -uroot -ppassword redmine <redmine.sql
更新redmine数据库
rake generate_secret_token rake db:migrate RAILS_ENV=production rake redmine:plugins:migrate RAILS_ENV=production
常见问题：
①解决redmine中导出项目问题时候报错。如下
Error with the Atom/PDF/CSV export function
I have find the problem:
Array(Mime[parameters[:format]])
the Array() method is not working, which require
method: to_ary
solution:
1. actionpack (3.2.6) lib/action_dispatch/http/mime_negotiation.rb:55
change from Array(Mime[parameters[:format]])
to Array.wrap(Mime[parameters[:format]])
②插件安装
在官网上下载相关插件，将redmine插件解压，整个目录复制到redmine根目录的plugins目录下
然后执行rake redmine:plugins:migrate RAILS_ENV=production就OK了。它会在数据库中建立相关的表。