背景

由於專案需要，決定用開源而強大的redmine系統作為專案管理軟體。由於伺服器（CentOS6.8）沒有預裝ruby、ROR（Ruby on rails）環境，本文內容是從0開始搭建的，中間也吃了不少軟體相容性等的苦頭，參閱了不少文章，遂做下筆記，希望對有同樣需要的同仁有些幫助。

有關redmine的介紹可以自己多做了解，廢話不多說，進入正題：
強烈建議：搭建過程請使用“科學上網“環境進行，理由就不用多說了。

軟體環境

搭建redmine共需要安裝如下軟體/包環境，還有一些依賴軟體/包等：

1.資料庫 (這裡以mysql為例)
2.redemine專案原始碼
3.RVM (Ruby版本管理器)
4.Ruby
5.rubyGems (對 Ruby元件進行打包的 Ruby 打包系統)
6.Rails(Ruby on Rails)
7.其他依賴包等

本次搭建中使用到的軟體版本

1.mysql5.5(官方推薦，因為5.6有些已知的問題，當然其他資料庫也可以)
2.redmine3.3.3.stable
3.Ruby2.3.3
4.Rails4.2.7.1
5.其他略

安裝

MYSQL安裝

安裝mysql

yum install mysql-server

建立redmine資料庫並授權使用者

create database redmine default character set utf8 default collate utf8_general_ci;

grant all
 
 privileges on redmine.* to [email protected]'%' identified by '[email protected]' with grant option;

flush privileges;

示例為mysql安裝到當前應用伺服器的情景，當然也可以安裝至其他伺服器。

下載開源專案redmine

我選擇安裝redmine-3.3.3.tar.gz版本
注意各版本對ruby及rails的版本相容性，選擇相容的軟體版本搭建執行環境：

按要求，我選擇了redmine3.3.3，ruby2.3，Rails4.2

redmine資料庫連結配置

將下載的專案上傳伺服器並解壓至/opt目錄

tar zxf ./redmine-3.3.3.tar.gz

檔名太長，改個名：

mv redmine-3.3.3 redmine

進入專案根目錄：

cd /opt/redmine

配置：
redmine相關配置中config目錄下，資料庫連結配置檔案官方給了一個example檔案database.yml.example，copy一份改名為database.yml作為專案正式引用資料庫配置檔案：

cp config/database.yml.example config/database.yml

修改production引數如下：

production:
  adapter: mysql2
  database: redmine
  host: localhost
  username: redmine
  password: redmine@123

Esc :wq 儲存退出。

安裝RVM

安裝curl

sudo yum install curl

安裝RVM

curl -L get.rvm.io | bash -s stable

若出現如下失敗提示：

執行提示命令：

curl -sSL https://rvm.io/mpapis.asc | gpg2 --import

繼續安裝RVM：

curl -L get.rvm.io | bash -s stable 

查詢配置檔案位置

find / -name rvm.sh

使配置檔案生效

source /etc/profile.d/rvm.sh

安裝RVM依賴

rvm requirements 

繼續安裝rvm推薦的依賴

rvmsudo yum install -y gcc-c++ patch readline readline-devel zlib zlib-devel libyaml-devel libffi-devel openssl-devel make bzip2 autoconf automake libtool bison iconv-devel

安裝Ruby

檢視已有ruby版本

rvm list known

根據要求，這裡選擇安裝2.3.3版本

rvm install 2.3

檢視ruby版本資訊：

ruby -v

預設使用2.3.3版本

rvm use 2.3.3 --default

安裝rubyGems

使用命令：

rvm rubygems current

提示已經安裝，看來是安裝ruby時已經順帶安裝了，good！

安裝Rails

安裝命令

gem install rails -v 4.2.7.1

安裝需要一段時間，耐心等待。

提示如下資訊：

[[email protected]_254_12_centos redmine]# gem install rails -v 4.2.7.1
Fetching: i18n-0.8.4.gem (100%)
Successfully installed i18n-0.8.4
Fetching: thread_safe-0.3.6.gem (100%)
Successfully installed thread_safe-0.3.6
Fetching: tzinfo-1.2.3.gem (100%)
Successfully installed tzinfo-1.2.3
......
............
Done installing documentation for i18n, thread_safe, tzinfo, activesupport, rack, rack-test, mini_portile2, nokogiri, loofah, rails-html-sanitizer, rails-deprecated_sanitizer, rails-dom-testing, builder, erubis, actionview, actionpack, activemodel, arel, activerecord, globalid, activejob, mime-types-data, mime-types, mail, actionmailer, thor, railties, bundler, concurrent-ruby, sprockets, sprockets-rails, rails after 348 seconds
32 gems installed

激動的去檢視rails版本資訊驗證是否安裝成功：

報錯，提示找不到jquery-rails，不過給了提示在執行“bundle install”時會安裝確實的gems，所以不用著急。

我這裡還是執行了下幾個依賴包的安裝，不過不執行應該也沒問題，應該會在bundle install時安裝。

gem install jquery-rails
gem install rake
gem install mysql2

安裝其他可能依賴的包

yum -y install patch make gcc gcc-c++ gcc-g77 flex* bison file  

yum -y install libtool libtool-libs libtool-ltdl-devel* autoconf kernel-devel automake libmcrypt*  

yum -y install libjpeg libjpeg-devel libpng libpng-devel libpng10 libpng10-devel gd gd-devel  

yum -y install freetype freetype-devel libxml2 libxml2-devel zlib zlib-devel  

yum -y install glib2 glib2-devel bzip2 bzip2-devel libevent libevent-devel  

yum -y install ncurses ncurses-devel curl curl-devel e2fsprogs  

yum -y install e2fsprogs-devel krb5 krb5-devel libidn libidn-devel  

yum -y install openssl openssl-devel vim-minimal nano sendmail  

yum -y install fonts-chinese gettext gettext-devel  

yum -y install gmp-devel pspell-devel   

yum -y install readline* libxslt* pcre* net-snmp* gmp* libtidy*  

yum -y install ImageMagick* subversion* 

新增一個系統使用者redmine

因為在執行bundle install命令時，提示不建議使用root執行，導致其他使用者目錄許可權問題。
使用普通使用者安裝過程中，如果需要使用sudo許可權的，會提示你輸入sudo密碼。

新建使用者redmine

useradd –d /usr/redmine -m redmine

修改redmine使用者密碼

使用者名稱：redmine，密碼：redmine

passwd redmine 
New password: redmine

此命令建立了一個使用者redmine，其中-d和-m選項用來為登入名redmine產生一個主目錄/usr/redmine（/usr為預設的使用者主目錄所在的父目錄）。

給予redmine使用者sudo許可權：

切換redmine使用者

su redmine

安裝依賴

切換至使用者redmine後，安裝依賴：

bundle install

中間有多次請求輸入remine sudo密碼：redmine

提示資訊：
Fetching i18n 0.7.0
Fetching json 1.8.6
Fetching minitest 5.10.2
……

可能的錯誤提示：
Gem::FilePermissionError: You don’t have write permissions for the /usr/local/rvm/gems/ruby-2.3.3

提示當前使用者沒有寫入許可權。

賦予redmine使用者許可權：

sudo chmod -R 777 /usr/local/rvm/
sudo chmod -R 777 /opt/redmine/

可能多次提示無寫入許可權並授權後，install成功：

新增會話快取

當前依然使用的redmine使用者

bundle exec rake generate_secret_token

生成表結構

RAILS_ENV=production bundle exec rake db:migrate

設定語言，選擇中文（zh）

RAILS_ENV=production bundle exec rake redmine:load_default_data

檔案系統許可權設定

mkdir -p tmp tmp/pdf public/plugin_assets

sudo chown -R redmine:redmine files log tmp public/plugin_assets

sudo chmod -R 755 files log tmp public/plugin_assets

執行WEBrick服務，啟動專案

nohup bundle exec rails server webrick -e production -b 0.0.0.0 -p 3000 &

說明：官方命令為bundle exec rails server webrick -e production，這裡做了一點裝飾。nohup 不掛斷地執行命令，& 讓程式在後臺自動執行，-b 0.0.0.0 授權所有IP訪問許可權，-p 3000 埠。另外nohup使原程式的的標準輸出自動改向到當前目錄下的nohup.out檔案，起到了log的作用。如果當前目錄的 nohup.out 檔案不可寫，輸出重定向到 $HOME/nohup.out 檔案中。

啟動成功！
可通過ip:3000埠訪問redmine主頁了，admin初始密碼為admin，第一次登入要求更改管理員密碼。

其他配置待續

……