15分钟搞定redmine的安装

我经历过的公司用过mantis，bugzila，jira等bug和项目管理工具，而redmine更适合多项目类型的公司，redmine支持的父子项目关系，对处理多项目衍生的子项目维护，有着高效的管理能力。有很多中小型的软件公司使用redmine来同时管理软件bug和项目开发进度，是一个非常好的选择
redmine的安装通常比较复杂，安装过程中也可能出现一些奇奇怪怪的问题，主要原因是不同的redmine版本对各个组件的版本有着版本要求。
下面按照我的教程步骤，15分钟快速搭建好自己的redmine系统。
首先服务器选择ubuntu14.04,，这版本也都属于比较经典的版本。
redmine我选择了较新的3.4版本。

ubutun14.04 + redmine3.4安装

1. 安装必要组件

先安装apache等必要common组件 common.sh,主要是apache2，mysql等一大堆，是否每个都需要安装，就像redmine官网的一些安装指导上说的，I dont know，but it works。但是我们细看一下主要是安装apache的一些组件和mysql数据库，其他的一些cmake，ssh,zip等可有可无。

sudo apt-get update
sudo apt-get install apache2 php5 libapache2-mod-php5 mysql-server php5-mysql libapache2-mod-perl2 libcurl4-openssl-dev libssl-dev apache2-prefork-dev libapr1-dev libaprutil1-dev libmysqlclient-dev libmagickcore-dev libmagickwand-dev curl git-core gitolite patch build-essential bison zlib1g-dev libssl-dev libxml2-dev libxml2-dev sqlite3 libsqlite3-dev autotools-dev libxslt1-dev libyaml-0-2 autoconf automake libreadline6-dev libyaml-dev libtool imagemagick apache2-utils ssh zip libicu-dev libssh2-1 libssh2-1-dev cmake libgpg-error-dev subversion libapache2-svn

2. 安装ruby，先安装rvm。

详见rvm.sh 通过rvm管理来安装ruby，注意查看redmine版本对应的ruby版本, 以安装redmine3.4为例，ruby版本区间在<1.9 ... 2.4>

gpg --keyserver hkp://pool.sks-keyservers.net --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3 7D2BAF1CF37B13E2069D6956105BD0E739499BDB
curl -sSL https://get.rvm.io | bash -s stable
source ~/.bashrc
rvm -v
rvm install 2.3

3. 安装redmine
   3.1 获取redmine

wget http://www.redmine.org/releases/redmine-3.4.4.tar.gz
tar xvfz redmine-3.4.4.tar.gz
ln -s redmine-3.4.4 redmine
rm redmine-3.4.4.tar.gz

3.2 配置redmine的连接

cd redmine
cp -pR config/database.yml.example config/database.yml
vim config/database.yml

将下面数据库的配置复制到你文件中
redmine用的是mysql数据库，用户密码根据自己的设置填写

production:
adapter: mysql2
database: redmine
host: localhost
username: root (根据自己的实际用户名填写)
password: 123456 (根据自己的实际密码填写)
encoding: utf8

4. 安装bundler

查看redmine目录下的GemFile,安装对应的bundler版本。以remdine3.4 为例， bundler 版本需要>1.5
cd redmine
vim Gemfile

if Gem::Version.new(Bundler::VERSION) < Gem::Version.new('1.5.0')
      abort "Redmine requires Bundler 1.5.0 or higher (you're using #{Bundler::VERSION}).\n
    Please update with 'gem update bundler'."

安装bundler

gem install bundler
gem install bundler -v 1.7.0
bundle install --without development test

5. 安装passenger

通过passenger来部署ruby的web application。详见passenger.sh

sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 561F9B9CAC40B2F7
sudo apt-get install apt-transport-https ca-certificates
#sudo echo "deb https://oss-binaries.phusionpassenger.com/apt/passenger trusty main" > /etc/apt/sources.list.d/passenger.list
sudo chown root: /etc/apt/sources.list.d/passenger.list
sudo chmod 600 /etc/apt/sources.list.d/passenger.list
sudo apt-get update
sudo apt-get install libapache2-mod-passenger
sudo apt-get install passenger

6. 配置apache

1. 配置default.conf,也可以自定义conf，暂时以default为例

sudo vim /etc/apache2/sites-available/000-default.conf

    
        ServerName 192.168.1.12 
        # Tell Apache and Passenger where your app's 'public' directory is
        # 注意这里的redmine目录其实link的是redmine/public
        DocumentRoot /var/www/html/redmine
            #如何查看ruby的路径:passenger-config about ruby-command
        PassengerRuby /path-to-ruby
        # Relax Apache security settings
        
          Allow from all
          Options -MultiViews
          # Uncomment this if you're on Apache > 2.4:
          #Require all granted
        
    

vim /etc/apache2/port.conf, 更改监听端口80->81, 一般80容易被占用，换成其他端口。
vim /etc/apache2/apache2.conf, 增加一行 ServerName 192.168.1.12,否则会报错。

8. 配置passenger conf文件

sudo vim /etc/apache2/mods-available/passenger.conf
sudo vim /etc/apache2/mods-available/passenger.load
这两个文件的内容通过命令：passenger-install-apache2-module查看。

7. redmine config

向数据库中导入默认数据
rake generate_secret_token
RAILS_ENV=production rake db:migrate
RAILS_ENV=production rake redmine:load_default_data

8. 重启redmine

sudo a2enmod passenger
sudo service apache2 restart

9. 查看redmine网址

192.168.1.12:81

redmine.png

参考文档：
ubuntu镜像下载：http://releases.ubuntu.com/
redmine下载：http://www.redmine.org/projects/redmine/wiki/Download
redmine官网指导安装：
http://www.redmine.org/projects/redmine/wiki/RedmineInstall
http://www.redmine.org/projects/redmine/wiki/HowTos
http://www.redmine.org/projects/redmine/wiki/HowTo_Install_Redmine_30x_on_Ubuntu_1404_with_Apache2_Phusion_Passenger_MySQL_Subversion_and_Git_(Gitolite)