Redmine on CentOS 安裝教學¶

• 目錄
• Redmine on CentOS 安裝教學
  • 假設
• 安裝預先需求
  • Ruby
    • FTP 連線
    • 解壓縮
    • 安裝
    • 檢查安裝
    • 使用符號連結修復依賴關係
  • RubyGems 1.4.2
    • 下載
    • 解壓縮
    • 設定
    • 檢查安裝
    • 如果這樣做沒有用...
  • Passenger
    • 一般安裝方法
    • 替代安裝方法
  • 重新啟動 Apache
• 安裝 Redmine
  • • 下載
    • 解壓縮
    • 將資料夾複製到其 HTTP 文件根目錄資料夾
• 設定 Apache 以託管文件
• 將 Redmine 連結到資料庫
  • 安裝 MySQL 資料庫伺服器
  • 建立要用於 Redmine 的 MySQL 資料庫
    • 最新版 MySQL
    • 對於 5.0.2 之前的 MySQL 版本
  • 設定 /var/www/redmine/config/database.yml
• Rails 設定
  • 使用 bundler 進行依賴管理
    • 安裝
    • 建立 Gemfile
    • 註冊 gems
    • 安裝提供的依賴項
  • 可選：設定生產環境
  • 產生工作階段存放區
  • 遷移資料庫模型
  • 載入預設資料（可選）
  • 重新命名 /var/www/redmine/public/ 中的 dispatch CGI 檔案
• Apache 設定
  • 編輯 .htaccess 檔案以進行 CGI 派送設定
  • 修復 apache 使用者的權限

這適用於 CentOS 版本 5 和 6，並說明如何設定 Redmine 1.32。

假設¶

• Apache 已啟動並正在執行
• Apache 之前已使用過並且運作良好
• MySQL 已啟動並正在執行
• MySQL 之前已使用過並且運作良好
• 您是以 root 身分登入
• 接下來的步驟會依序完成，不會出錯

安裝預先需求¶

yum -y install zlib-devel curl-devel openssl-devel httpd-devel apr-devel apr-util-devel mysql-devel

Ruby¶

星號（*）後面的內容是註解，輸入這些內容沒有用；）

cd ~/Downloads  # YOUR FOLDER OF CHOICE
ftp ftp.ruby-lang.org

FTP 連線¶

ftp> Anonymous  # USERLOGIN
ftp> 'none', just hit Enter  # NO PASSWORD
ftp> cd /pub/ruby
ftp> get ruby-1.8.7.pXXX.tar.gz  # XXX is currently 358, as of 03/2012
ftp> bye

解壓縮¶

tar zxvf ruby-1.8.7.pXXX.tar.gz

安裝¶

cd ruby-1.8.7.pXXX
./configure
make
make install

檢查安裝¶

如果這不起作用，可能是因為在 /usr/bin 中找不到 ruby。
如果它有效，請直接跳到「取得 Gems 1.4.2」。

ruby -v

使用符號連結修復依賴關係¶

（僅限 *ruby -v* **無法**運作的情況）

which ruby  # TO CHECK WHERE IT SHOULD BE
whereis ruby  # TO CHECK WHERE IT IS INSTALLED

「which」會傳回 /usr/bin/ 以及其他目錄（預期 ruby 所在的位置），而「whereis」會傳回 /usr/local/bin/ruby（實際上 ruby 所在的位置）。

建立連結

ln -s /usr/local/bin/ruby /usr/bin/ruby

再次檢查是否正常運作

ruby -v # NOW IT MUST RETURN RUBY VERSION, ELSE SOMETHING ELSE IS BROKEN
cd ..

RubyGems 1.4.2¶

不適用於 Gems 1.5！

下載¶

wget http://production.cf.rubygems.org/rubygems/rubygems-1.4.2.tgz

解壓縮¶

tar zxvf rubygems-1.4.2.tgz

設定¶

cd rubygems-1.4.2
ruby setup.rb

檢查安裝¶

gem -v

如果這樣做行不通...¶

... 解決方案同樣是建立一個符號連結，類似於上述 Ruby 章節中所述。

Passenger¶

一般安裝方法¶

需要 gcc。

gem install passenger
passenger-install-apache2-module

如果第二行無法運作，請執行 whereis passenger 以找出它的安裝位置。
這樣您就可以像這樣執行它 /usr/local/bin/passenger-install-apache2-module ...

安裝過程是互動式的，系統會告訴您該怎麼做。請仔細閱讀！

替代安裝方法¶

從以下位置安裝適用於 Apache 的 mod_passenger RPM

http://passenger.stealthymonkeys.com/

RHEL/CentOS 5

rpm -Uvh http://passenger.stealthymonkeys.com/rhel/5/passenger-release.noarch.rpm
yum install mod_passenger

RHEL/CentOS 6

rpm --import http://passenger.stealthymonkeys.com/RPM-GPG-KEY-stealthymonkeys.asc
yum install http://passenger.stealthymonkeys.com/rhel/6/passenger-release.noarch.rpm
yum install mod_passenger

重新啟動 Apache¶

service httpd restart

安裝 Redmine¶

下載¶

下載頁面

http://rubyforge.org/frs/?group_id=1850

wget http://rubyforge.org/frs/download.php/75910/redmine-1.3.2.tar.gz # GET LATEST VERSION ON RUBYFORGE

解壓縮¶

tar zxvf redmine-1.3.2.tar.gz

將資料夾複製到其 HTTP 文件根目錄資料夾¶

mkdir /var/www/redmine
cp -av redmine-1.3.2/* /var/www/redmine

設定 Apache 以託管文件¶

更多資訊請參考：如何設定 Apache 來執行 Redmine

將 Redmine 連結到資料庫¶

安裝 MySQL 資料庫伺服器¶

yum install mysql-server
chkconfig mysqld on
service mysqld start
/usr/bin/mysql_secure_installation

建立要與 Redmine 搭配使用的 MySQL 資料庫¶

最新版 MySQL¶

啟動 MySQL 用戶端 (mysql -u root -p) 並輸入以下指令

create database redmine character set utf8;
create user 'redmine'@'localhost' identified by 'my_password';
grant all privileges on redmine.* to 'redmine'@'localhost'; 

對於 5.0.2 之前的 MySQL 版本¶

跳過「建立使用者」步驟，改為執行以下操作

 grant all privileges on redmine.* to 'redmine'@'localhost' identified by 'my_password';

現在已經建立了資料庫和要與其一起使用的使用者。此外，使用者還擁有對所建立資料庫的操作權限。

設定 /var/www/redmine/config/database.yml¶

cp database.yml.example database.yml

待辦事項：說明要在哪裡進行更改...

Rails 設定¶

使用 Bundler 進行依賴管理¶

如需更多資訊，請前往 Bundler 網站。

安裝¶

gem install bundler

建立 Gemfile¶

當然，如果您知道自己在做什麼，也可以使用 vi/vim 作為您的編輯器。;)

nano /var/www/redmine/Gemfile

註冊 gems¶

將以下內容放入您剛才開啟的檔案中

# file: /var/www/redmine/Gemfile
source "http://rubygems.org" 
gem "rake", "0.8.3" 
gem "rack", "1.1.0" 
gem "i18n", "0.4.2" 
gem "rubytree", "0.5.2", :require => "tree" 
gem "RedCloth", "~>4.2.3", :require => "redcloth" # for CodeRay
gem "mysql" 
gem "coderay", "~>0.9.7"

儲存並退出編輯器。

安裝提供的依賴項：¶

bundle install

（可選）設定生產環境¶

取消註釋 redmine/config/environment.rb 檔案中的以下行

ENV['RAILS_ENV'] ||= 'production'

產生會話存放區¶

RAILS_ENV=production bundle exec rake generate_session_store

遷移資料庫模型¶

RAILS_ENV=production bundle exec rake db:migrate

載入預設資料（可選）¶

RAILS_ENV=production bundle exec rake redmine:load_default_data

請依照指示進行操作。

重新命名 /var/www/redmine/public/ 中的 dispatch CGI 檔案¶

mv dispatch.cgi.example dispatch.cgi
mv dispatch.fcgi.example dispatch.fcgi
mv dispatch.rb.example dispatch.rb

Apache 設定¶

編輯 .htaccess 檔案以進行 CGI 發送設定¶

mv htaccess.fcgi.example .htaccess

修正 Apache 使用者的權限¶

cd ..
chown -R apache:apache redmine-1.x
chmod -R 755 redmine-1.x

這樣就差不多了。
Redmine 現已安裝完成並可供使用。

好好享受吧！