HowTo Install Redmine

Runtime environment

• CentOS 6.x
• Redmine 3.3.2
• Ruby 2.2.6
• rails 4.2
• MySQL 5.1
• Nginx 1.10

安装 rvm

导入公钥

[root@localhost ~]# curl -sSL https://rvm.io/mpapis.asc | gpg --import

安装

[root@localhost ~]# curl -L https://get.rvm.io | bash -s stable

加载 rvm 环境并安装基础依赖包

[root@localhost ~]# source /etc/profile.d/rvm.sh
[root@localhost ~]# rvm requirements

安装 ruby

[root@localhost ~]# rvm install 2.2.6
...
[root@localhost ~]# rvm use 2.2.6 --default

安装 rails

更换 gem 源

默认 gem 的源站点是https://rubygems.org 由于国内的网络原因导致无法连接，所以导致无法使用 gem 安装，这里换成国内淘宝的 gem 镜像站点

[root@localhost ~]# gem sources -l
*** CURRENT SOURCES ***

https://rubygems.org/
[root@localhost ~]# gem sources --remove https://rubygems.org/
[root@localhost ~]# gem sources -a https://ruby.taobao.org/
[root@localhost ~]# gem sources -l
*** CURRENT SOURCES ***

https://ruby.taobao.org/

安装

[root@localhost ~]# gem install rails -v=4.2

安装 MySQL

[root@localhost ~]# yum install -y mysql-server mysql-libs mysql-devel mysql
[root@localhost ~]# service mysqld start
[root@localhost ~]# mysql_secure_installation

安装 redmine

下载 Redmine 3.3.2

[root@localhost ~]# wget http://www.redmine.org/releases/redmine-3.3.2.tar.gz
[root@localhost ~]# tar xf redmine-3.3.2.tar.gz
[root@localhost ~]# mv redmine-3.3.2 /opt

安装管理 ruby 的包管理工具 bundler

# 注意，一定要在redmine目录下操作
[root@localhost ~]# cd /opt/redmine-3.3.2
[root@localhost redmine-3.3.2]# gem install bundler

安装 redmine 运行所需要的依赖包

[root@localhost redmine-3.3.2]# bundle install --without development test rmagick

为 rails 生产 cookies 秘钥

[root@localhost redmine-3.3.2]# rake generate_secret_token

创建 redmine 的数据库

mysql> create database redmine character set utf8;
mysql> grant all privileges on redmine.* to 'redmine'@'localhost' identified by 'redmine_pass';

修改 redmine 的 database.yml

[root@localhost redmine-3.3.2]# cp config/database.yml.example config/database.yml
[root@localhost redmine-3.3.2]# vim config/database.yml
production:
  adapter: mysql2
  database: redmine
  host: localhost
  username: redmine
  password: "redmine_pass"
  encoding: utf8

创建数据库结构

[root@localhost redmine-3.3.2]# RAILS_ENV=production bundle exec rake db:migrate

生产缺省数据

[root@localhost redmine-3.3.2]# RAILS_ENV=production bundle exec rake redmine:load_default_data
# 选择默认语言，之后可更改，初始为en

测试是否安装成功

[root@localhost redmine-3.3.2]# bundle exec rails server webrick -e production -b 0.0.0.0

默认运行 3000 端口，默认管理员 admin/admin

配置 Redmine 在 Nginx 上运行

Redmine 常用的解决办法是使用 passenger+nginx，但是 Nginx 不支持装载模块，所以需要重新编译安装 Nginx，安装 Nginx 的 Passenger 有两种方式

• 采用 Passenger 提供的脚本进行安装，适合新环境
• 手动编译安装 Nginx 增加 Passenger 模块，适合已存在 Nginx 环境

采用 Passenger 提供脚本安装

[root@localhost redmine-3.3.2]# gem install passenger
[root@localhost redmine-3.3.2]# passenger-install-nginx-module --auto --prefix=/opt/nginx

采用重新编译 Nginx 增加 Passenger 模块

# 获取passenger的安装路径
[root@localhost ~]# passenger-config --root
/usr/local/rvm/gems/ruby-2.2.6/gems/passenger-5.1.2

# 重新编译Nginx并添加模块
[root@localhost ~]# wget http://nginx.org/download/nginx-1.10.3.tar.gz
[root@localhost ~]# tar xf nginx-1.10.3.tar.gz
[root@localhost ~]# cd nginx-1.10.3
[root@localhost nginx-1.10.3]# ./configure ... -add-module=/usr/local/rvm/gems/ruby-2.2.6/gems/passenger-5.1.2

增加 HTTP 模块内以下配置

passenger_root /usr/local/rvm/gems/ruby-2.2.6/gems/passenger-5.1.2

配置 nginx.conf 修改 server 模块中 location 的配置

# ...
server {
  # ...
  passenger_enabled on;
  location / {
    root /opt/redmine-3.3.2/public;
    index index.html index.htm;
  }
}
# ...

启动 Nginx

[root@localhost ~]# /root/nginx-1.10.3/sbin/nginx -c /root/nginx-1.10.3/conf/nginx.conf

其他

到这里，所有的安装都完成了，过程中我遇到这些问题，你也注意下：

7.1 Could not find gem 'mysql2 (~> 0.3.11)' in any of the gem sources listed in your Gemfile

[root@localhost redmine-3.3.2]# rm -f Gemfile.lock
[root@localhost redmine-3.3.2]# bundle install

7.2 curl-tools

yum install libcurl-devel