在安裝Redmine前先去官方文件確認相關版本資訊與限制。可得知:
- Ruby版本支援:ruby 1.8.7, 1.9.2, 1.9.3
- Rails版本需要:2.3.14
- "Ruby 1.9 is not supported yet. You have to use Ruby 1.8.x as stated above.",故Ruby還是先安裝1.8.x較保險。
- 其他限制因此處安裝Redmine最新版不需擔心。
- Ruby 1.8.7
- RubyGems 1.8.15
- Rails 2.3.14
- Apache + Passenger(註:Passenger為一Apache_mod,可將Apache與RoR做結合。另外,若是mac osx則可使用pow這套號稱不用做任何設定即可跑RoR的Rack Server。)
- Redmine 1.3.0
安裝Apache
``` sudo yum install -v httpd # 或sudo yum groupinstall "Web Server" sudo service httpd start ```安裝Ruby
```wget ftp://ftp.ruby-lang.org/pub/ruby/1.8/ruby-1.8.7.tar.gz
tar xvfz ruby-1.8.7.tar.gz
cd ruby-1.8.7
sudo yum install gcc # 註:避免"configure: error: no acceptable C compiler found in $PATH"此錯誤
./configure
make
make install
<h2><span style="color: #3366ff;">安裝Gems</span></h2>
wget http://production.cf.rubygems.org/rubygems/rubygems-1.8.15.tgz
tar xvfz rubygems-1.8.15.tgz
cd rubygems-1.8.15
sudo ruby setup.rb
<h2><span style="color: #3366ff;">安裝Rails</span></h2>
sudo yum install ruby-rdoc # 註:避免以下兩個錯誤
ERROR: While executing gem ... (Gem::DocumentError)
ERROR: RDoc documentation generator not installed: no such file to load -- rdoc/rdoc
sudo gem install rails -v=2.3.14 # 註:若不想安裝document,可以下此指令:sudo gem install rails -v=2.3.14 <span style="color: #ff0000;">--no-ri --no-rdoc</span>)
<h2><span style="color: #3366ff;">安裝Mysql和Mysql Gem</span></h2>
sudo yum groupinstall "MySQL Database"
sudo /etc/init.d/mysqld start
sudo yum -y install mysql-devel ruby-devel make # 註:ruby-devel為避免"/usr/bin/ruby extconf.rb mkmf.rb can't find header files for ruby at /usr/lib/ruby/ruby.h"此錯誤
sudo gem install mysql -- --with-mysql-config=/usr/bin/mysql_config # 註:可能會有一些<a href="http://www.ruby-forum.com/topic/194544">No definition的訊息</a>,但注意最上方訊息"Successfully installed mysql-2.8.1"其實已經成功安裝。該訊息為rdoc原因,若不想出現,一樣可在最後面加入參數 <span style="color: #ff0000;">--no-ri --no-rdoc</span>。
<h2><span style="color: #3366ff;">安裝Redmine</span></h2>
sudo yum install subversion
sudo yum install ImageMagick ImageMagick-devel
sudo gem install rmagick ––no–rdoc ––no–ri
註:上方安裝rmagick是為了能讓Redmine中的甘特圖可輸出成.png圖片
svn co svn://rubyforge.org/var/svn/redmine/branches/1.3-stable redmine-1.3
mysqladmin -u root password NEW_PASSWORD # 註:要創立一database給redmine用,故在登入mysql前需先設定root密碼
mysql -u root -p # log into mysql
create database redmine character set utf8;
create user 'redmine'@'localhost' identified by 'my_password';
grant all privileges on redmine.* to 'redmine'@'localhost';
註:切回下載的redmine資料夾內
cp config/database.yml.example config/database.yml
vi config/database.yml
加入下述文字,或直接修改內部的production之mysql設定
<blockquote>production:
adapter: mysql
database: redmine
host: localhost
username: redmine
password: my_password</blockquote>
sudo gem install rdoc # 註:避免rack安裝套件時出現"Please install RDoc 2.4.2+ to generate documentation."錯誤,若前面有裝則可略。
rake generate_session_store
RAILS_ENV=production rake db:migrate
完成redmine之資料庫設定
但在作db:migrate時跑出以下error:
<blockquote>Missing these required gems:
rubytree >= 0
You're running:
ruby 1.8.7.352 at /home/redmine/.rvm/rubies/ruby-1.8.7-p352/bin/ruby
rubygems 1.8.10 at /home/redmine/.rvm/gems/ruby-1.8.7-p352, /home/redmine/.rvm/gems/ruby-1.8.7-p352@global
Run `rake gems:install` to install the missing gems.</blockquote>
故需在config/environment.rb約57行處,將rubytree的部分註解掉即可。
RAILS_ENV=production rake redmine:load_default_data # 註:新增預設的設定資料至資料庫
sudo chown -R apache.apache files log tmp public/plugin_assets # 註:設定apache有存取權限
sudo ruby script/server webrick -e production # 註:測試redmine是否可執行
此時可先用IP:3000(或localhost:3000)來測試Redmine是否可正常運行。
<h2><span style="color: #3366ff;">設定Apache</span></h2>
# 註:強制Redmine的Rails Environment為Production
vi config/environment.rb
將 ENV['RAILS_ENV'] ||= ‘production’ 的註解拿掉(即去除#,約在第四行)
接著,將下面設定複製貼到/etc/httpd/conf.d/redmine.conf內並創立(sudo vi該文件,並依照你的需求修改)
<blockquote><VirtualHost *:80>
ServerName redmine.<YOUR-DOMAIN>.com
ServerAdmin webmaster@<YOUR-DOMAIN>.com
DocumentRoot /live/redmine/public/
ErrorLog logs/redmine_error_log
<Directory "/live/redmine/public/">
Options Indexes ExecCGI FollowSymLinks
Order allow,deny
Allow from all
AllowOverride all
</Directory>
</VirtualHost></blockquote>
現在只設定完apache,還得安裝passenger使得apache可以正常運行Rails專案
sudo gem install passenger
sudo passenger-install-apache2-module # 註:依照指令完成設定
以下為筆者本身在安裝passenger module時提示未安裝的套件列表:
<blockquote><span style="color: #ff0000;">* GNU C++ compiler... not found</span>
<span style="color: #ff0000;">* Curl development headers with SSL support... not found</span>
* OpenSSL development headers... found
<span style="color: #ff0000;">* Zlib development headers... not found</span>
* Ruby development headers... found
* OpenSSL support for Ruby... found
* RubyGems... found
* Rake... found at /usr/bin/rake
* rack... found
* Apache 2... found at /usr/sbin/httpd
<span style="color: #ff0000;">* Apache 2 development headers... not found</span>
<span style="color: #ff0000;">* Apache Portable Runtime (APR) development headers... not found</span>
<span style="color: #ff0000;">* Apache Portable Runtime Utility (APU) development headers... not found</span></blockquote>
依序安裝缺乏套件方法:
sudo yum install gcc-c++
sudo yum install curl libcurl libcurl-devel
sudo yum install zlib zlib-devel
sudo yum install httpd-devel
<blockquote>
LoadModule passenger_module /usr/lib/ruby/gems/1.8/gems/passenger-3.0.11/ext/apache2/mod_passenger.so
PassengerRoot /usr/lib/ruby/gems/1.8/gems/passenger-3.0.11
PassengerRuby /usr/bin/ruby
</blockquote>
再來,修改原先virtual host 設定為下述passenger所要求(sudo vi /etc/httpd/conf.d/redmine.conf)
<blockquote><VirtualHost *:80>
ServerName www.yourhost.com
DocumentRoot /live/redmine/public
<Directory /live/redmine/public>
AllowOverride all
Options -MultiViews
</Directory>
</VirtualHost></blockquote>
接著重新啟動httpd即可。
(註:若需要使用非80 port,需在/etc/httpd/conf/httpd.conf文件內的Listen 80下加入你所需要的port number,並重新啟動httpd)
<h2><span style="color: #3366ff;">403 Forbbiden "You don't have permission to access / on this server."問題</span></h2>
網路上普遍解法都是將設定(不論是httpd.conf還是conf.d資料夾中*.conf)中,若<Directory>中有Deny from all此敘述,將其刪除或改成Allow from all,例如:
<blockquote><Directory />
Options FollowSymLinks
AllowOverride None
Order allow, deny
<span style="color: #ff0000;"> Allow from all
</span></Directory></blockquote>
另一解法適用於筆者,步驟如下:
1. 在redmine/public內啟用所用cgi檔案
cp dispatch.cgi.example dispatch.cgi
cp dispatch.fcgi.example dispatch.fcgi
cp dispatch.rb.example dispatch.rb
cp htaccess.fcgi.example .htaccess
2. sudo vi redmine/public/dispatch.cgi,將第一行的"#! /usr/bin/env: ruby"改成你系統中ruby的路徑,可用"which ruby"查詢。
3. 將redmine移至/var/www/html內(影響應該不大)
4. 接著設定redmine資料夾的權限與擁有者為apache
sudo chown -R apache.apache redmine
sudo chmod -R 755 redmine
5. 確認/etc/httpd/conf.d/redmine.conf內的DocumentRoot為正確的位置
6. 重啟httpd即可。(sudo service httpd restart)
參考文章:
<ul>
<li><a href="http://www.redmine.org/projects/redmine/wiki/RedmineInstall#Installation-procedure">官方文件</a></li>
<li>http://www.how-to-linux.com/centos-52/how-to-install-redmine-0-9-3-on-centos-update-including-apache-and-svn-configuration/</li>
<li>http://mrmo.cc/mousontech/1602/%E5%9C%A8centos-5-6-%E8%AE%93redmine%E9%81%8B%E4%BD%9C%E6%96%BCapache-virtual-host</li>
</ul>
<img style="position: absolute !important; z-index: -1 !important; right: 1px !important; top: -20px !important; cursor: pointer !important; -webkit-border-radius: 20px; background-color: rgba(200, 200, 200, 0.3) !important; padding: 3px 5px 0 !important; margin: 0 !important;" onclick="document.location.href='http://translate.google.com/';" src="http://www.google.com/uds/css/small-logo.png" alt="" />