CentOS 6.5安装Redmine文档

一、系统环境
CentOS (6.5) + Nginx (1.6.2) + MySQL (5.5)

二、概览
1、安装依赖
2、创建MySQL用户和空数据库
3、安装Ruby On Rails
4、下载redmine，编辑config/databases.yml
5、生成秘钥
6、创建数据库结构和生成缺省数据
7、设置执行权限
8、测试
9、加入开机启动服务
10、配置Nginx代理转发
11、配置邮件发送功能（QQ企业邮箱）
12、安装过程遇到的问题及解决方案
三、详细流程
1、安装依赖

yum -y install nano zip unzip libyaml-devel zlib-devel curl-devel openssl-devel httpd-devel apr-devel apr-util-devel mysql-devel gcc ruby-devel gcc-c++ make postgresql-devel ImageMagick-devel sqlite-devel perl-LDAP mod_perl perl-Digest-SHA

2、创建MySQL用户和空数据库

CREATE DATABASE redmine CHARACTER SET utf8;  （修改数据库编码格式）
CREATE USER 'redmine'@'localhost' IDENTIFIED BY 'my_password';
GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost';
FLUSH PRIVILEGES;

3、安装Ruby On Rails
1)、下载ruby安装包解压安装

wget http://cache.ruby-lang.org/pub/ruby/2.1/ruby-2.1.6.tar.gz
tar -zxvf ruby-2.1.6.tar.gz

#进入目录安装ruby

cd ruby-2.1.6
./configure --prefix=/usr/local/ruby
make && make install

#加入环境变量

echo "PATH=$PATH:/usr/local/ruby/bin;export PATH" >> /etc/profile
. /etc/profile  #点“.”和“/”之间有一个空格

2)、安装rubygems

wget http://production.cf.rubygems.org/rubygems/rubygems-2.4.8.tgz
tar -zxvf rubygems-2.4.8.tgz
cd rubygems-2.4.8

ruby setup.rb #问题1
3)、安装Rails
#gem 安装 bundler，用bundler安装Rails

gem install bundler

bundle install --without development test #问题2

#如果gem安装无法访问或者安装速度太慢，可换其他镜像
可换的镜像地址：http://ruby.sdutlinux.org/
或 https://ruby.taobao.org/（淘宝国内镜像）
#更新下载地址

gem sources --remove https://rubygems.org/ #移除原地址
gem sources -a http://ruby.sdutlinux.org/  # 设置新地址
gem sources -l 
gem sources -u #更新缓存地址

#如果bundler无法访问或安装太慢，vim Gemfile文件，用上面的地址替换
source ‘https://rubygems.org’

4、下载redmine，编辑config/databases.yml
1)、下载2.6版本的Redmine

wget  http://www.redmine.org/releases/redmine-2.6.9.tar.gz
tar -zxvf redmine-2.6.9.tar.gz -C /var/www/html/		#解压到指定目录

2)、配置数据库信息

cd /var/www/html/redmine-2.6.9/config
cp database.yml.example database.yml

vim database.yml

#修改如下内容，写入第2步创建的数据库用户名、密码和数据库名称。这里生产（production：）、开发（development:）和测试（test:）环境配置一致。
production：
  adapter: mysql2
  database: redmine
  host: localhost
  username: redmine
  password: "redmine password"
  encoding: utf8

5、生成秘钥

rake generate_secret_token

6、创建数据库结构和生成缺省数据
#创建数据库结构

RAILS_ENV=production rake db:migrate

#生成缺省数据

RAILS_ENV=production REDMINE_LANG=zh rake redmine:load_default_data

7、设置执行权限

mkdir -p tmp tmp/pdf public/plugin_assets
sudo chmod -R 755 files log tmp public/plugin_assets
#如果要指定运行用户（可选）
sudo chown -R redmine:redmine files log tmp public/plugin_assets

8、测试

bundle exec ruby script/rails server webrick -e production

#如果安装成功命令行将是如下的样子：
=> Booting WEBrick
=> Rails 3.2.22 application starting in production on http://0.0.0.0:3000
=> Call with -d to detach
=> Ctrl-C to shutdown server
[2016-03-01 15:58:34] INFO WEBrick 1.3.1
[2016-03-01 15:58:34] INFO ruby 2.0.0 (2013-11-22) [x86_64-linux]
[2016-03-01 15:58:34] INFO WEBrick::HTTPServer#start: pid=22966 port=3000

#到这一步基本安装好了，可在本地浏览器输入127.0.0.1:3000访问redmine，要远程访问还需据需配置，这里选择用Nginx代理转发实现远程访问。

9、加入开机启动服务

vim /etc/rc.local

#在文件输入如下信息（必须是绝对地址） “&”->后台运行：

/usr/local/ruby/bin/ruby /redmine_root_directory/script/rails server webrick -e production &

10、配置Nginx代理转发

server {
    listen       80;
    server_name  yourdomain.com;
    root /www_root/redmine/public;
#代理转发
    location / {
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_pass http://127.0.0.1:3000/;
        proxy_redirect off;
    }
    index index.php index.html index.htm;
    access_log  /var/log/nginx/yourdomain.com.access.log  main;
    error_log  /var/log/nginx/yourdomain.com.error.log  notice;
}

11、配置邮件发送功能（QQ企业邮箱）

cd ./config
cp configuration.yml.example configuration.yml
vim configuration.yml
delivery_method: :async_smtp #异步发送
      async_smtp_settings:
        address: "smtp.exmail.qq.com" #QQ企业邮件发送服务器地址
        enable_starttls_auto: true
        ssl: true	#QQ企业邮箱要求用SSL链接，这里加上此配置
        port: 465 #端口
        authentication: :login
        domain: "exmail.qq.com"
        user_name: "[email protected]" #发送邮件的邮箱名称
        password: "xxxxxx" #邮箱登录密码

12、安装过程遇到的问题及解决方案
问题1：安装rubygems是报错。
错误信息：
RubyGems 2.4.8 installed
/usr/local/src/rubygems-2.4.8/lib/rubygems/core_ext/kernel_require.rb:54:in require': cannot load such file -- json/pure (LoadError) 原因：未安装json 解决方法：gem install json_pure 问题2：bundle install --without development test安装Rail时报错。 错误信息： Gem::RemoteFetcher::FetchError: SSL_connect SYSCALL returned=5 errno=0 state=SSLv3 read server session ticket A (https://rubygems.org/gems/polyglot-0.3.5.gem) An error occurred while installing polyglot (0.3.5), and Bundler cannot continue. Make sure thatgem install polyglot -v ‘0.3.5’` succeeds before bundling.
原因：国外镜像地址被墙，访问速度慢。
解决方法：
1、换镜像
2、用gem手动安装，如上报错信息表示无法安装0.3.5版本的polyglot，手动安装命令：
gem install polyglot -v ’0.3.5’