Redmine+Apache+SVN+SMTP的安裝配置

【概述】

Redmine是一個Web上的靈活的開源項目管理工具，基於Ruby on Rails框架，跨平台和數據庫。它具備了廣泛的項目管理平台特點同時，還提供了諸多的獨有的特性。包括了內建的wiki、BUG問題跟蹤、SVN集成等。

Redmine可以使用BitNami的一體化安裝包，這會使得安裝部署redmine一鍵到底。這個不太適用於公司，自己玩玩還行。

本文講述了Redmine的安裝，與Apache集成，與SVN集成，郵件配置，備份。

 

【環境】

Ubuntu10.10

 

【Redmine安裝配置步驟】

1. 安裝LAMP環境

apt-get install tasksel
tasksel install lamp-server

要求輸入mysql的root用戶密碼：比如輸入mysql*0

 

2. 安裝Ruby on Rails環境

apt-get install ruby

ruby 1.8.7被安裝

apt-get install rubygems

gem 1.3.7被安裝

gem install rails -v=2.3.11

但rails --version查看，顯示未安裝，不知怎么回事

apt-get install rails

rails 2.3.5被安裝

gem install rake -v=0.8.7

rake 0.8.7 被安裝

gem install rack -v=1.1.1

安裝成功，但rack --version提示rack找不到命令

 

3. 安裝Redmine和MySQL數據庫

apt-get install redmine redmine-mysql

將會出現配置界面：

Configure database for redmine/instances/default:選是

Database type to be used by redmine/instances/default:選mysql

Password of database's administrative user:輸入mysql*0

MySQL application password for redmine/instances/default:輸入mysql*0

Password confirmation:輸入mysql*0

確定，選retry，之后又會出現可視化的配置界面，輸入mysq*0，之后完成配置，界面退出。

此時終端提示在/etc/redmine/default下生成session.yml和database.yml

Redmine被安裝在/usr/share/redmine和/etc/redmine里

 

4. 創建redmine數據庫

啟動Mysql數據庫：

/etc/init.d/mysqld start

創建數據庫與設置權限：

mysql -u root -p

輸入密碼，比如mysql*0

創建一個供 Redmine 使用的數據庫：

create database redmine character set utf8;

 創建Redmine數據庫的用戶及密碼，並賦予權限：（’引號之間需修改為自己的用戶名、服務器名、密碼）

create user 'redmine'@'localhost' identified by 'my_password';

無錯誤提示，則表示創建成功。

賦權操作：

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

PS：如果創建用戶出了什么差錯，可以使用如下命令刪除用戶：

drop user 'redmine'@'localhost';

quit;退出mysql

向數據庫中插入默認配置：

RAILS_ENV=production rake redmine:load_default_data

PS：這一步可選，但推薦有這一步。可使Redmine顯示中文。 as you can define your own configuration from scratch. It will load default roles, trackers, statuses, workflows and enumerations.

 

5. 創建日志log的文件夾和log文件

在/usr/share/redmine 目錄下創建文件夾 log， 然后在log文件夾下新建一個空的文件，文件名為production.log

 

6. 啟動redmine，建議作為服務執行

sudo /usr/share/redmine/script/server -e production -d

 

7. 檢查Redmine是否安裝成功

注意：在前面四個步驟中，如果MySQL和Redmine的安裝順序不一樣，可能在/etc/redmine/default目錄下沒有session.xml,database.xml這兩個文件。這就需要進行下面操作，自己生成這兩個文件。

在/usr/share/redmine/ 下執行生成會話密鑰：

RAILS_ENV=production rake generate_session_store 

於是在/etc/redmine/default下生成了session.yml

創建數據庫結構：

在/usr/share/redmine/templates/ 目錄下有一個database.yml.template的文件，將它放到 /etc/redmine/default/目錄下並修改文件名為 database.yml，然后打開文件修改配置。

配置如下：

production:
  adapter: mysql    //數據庫類型
  database: redmine    //數據庫名
  host: localhost    //數據庫主機
  port: 3306    //端口
  username: root    //數據庫用戶名
  password: mysql*0    //數據庫密碼
  encoding: utf8    //編碼

然后在/usr/share/redmine/下生成數據庫結構及初始的數據。經過十幾秒后生成。

RAILS_ENV=production rake db:migrate 

 

 

【在Apache上部署Redmine】

上面的Redmine使用WEBrick，雖然占用的內存更少，但是訪問速度慢。如果大負載的服務器，推薦使用Apache。Apache運行ROR有多種方式，這里使用passenger。

apt-get install build-essential
apt-get install ruby-dev
gem install passenger
gem environment

建議先查看RubyGems Environment，其中，EXECUTABLE DIRECTORY就是命令的全路徑，所以對於我例子里的情況執行

/var/lib/gems/1.8/bin/passenger-install-apache2-module

根據提示安裝和部署。passenger會在本機編譯並成為apache的一個模塊。安裝過程中會遇到下面的提示信息(根據版本的不同，信息也會稍有變化)：

出現Phusion Passenger Apache 2 module installer界面：按Enter

很多not found，按Enter

按提示依次安裝:

apt-get install libcurl4-openssl-dev
apt-get install libssl-dev
apt-get install zlib1g-dev
apt-get install apache2-prefork-dev
apt-get install libapr1-dev
apt-get install libaprutil1-dev

全部安裝成功！

再重新

/var/lib/gems/1.8/bin/passenger-install-apache2-module 

一直Enter直到完成。

編輯/etc/apache2/apache2.conf文件。為即將修改的文件作備份是個好習慣。

cp /etc/apache2/apache2.conf /etc/apache2/apache2.conf_backup
gedit /etc/apache2/apache2.conf

加入下面內容：

LoadModule passenger_module /var/lib/gems/1.8/gems/passenger-3.0.13/ext/apache2/mod_passenger.so
PassengerRoot /var/lib/gems/1.8/gems/passenger-3.0.13
PassengerRuby /usr/bin/ruby1.8

注意：這里最好去/var/lib/gems目錄下確認路徑。

在/etc/apache2/sites-available添加一個站點：

cd /etc/apache2/sites-available
gedit redmine 

並添加如下內容：

RailsBaseURI /redmine 

在web根目錄建立redmine主目錄的符號鏈接，並設置權限：

ln -s /usr/share/redmine/public /var/www/redmine  
chown -R www-data:www-data /var/www 

重啟apache：

/etc/init.d/apache2 restart 

啟用redmine站點：

a2ensite redmine 

在瀏覽器里輸入http://your_server_ip/redmine就會訪問redmine站點

 

 

 

【Redmine與SVN的集成】

如果Redmine和SVN安裝在同一台機器上，只要在Redmine里新建一個項目，在“配置”->“版本庫”中填入對應的SVN版本庫地址即可，如下圖：

如果Redmine和SVN不在同一台機器上，則會在配置后，點擊“版本庫”標簽，出現錯誤：版本庫中不存在該條目和（或）其修訂版本。英文是：The entry or revision was not found in the repository. 這是因為Redmine本身沒有集成SVN命令，而是借助SVN的命令來獲取。解決方法是：在裝有Redmide的機器上安裝SVN。這個困擾我好久啊.....

apt-get install subversion

 

 

【郵件配置】

apt-get install postfix

在出現的可視化安裝界面上，點確定，選Internet，輸入一個mail名稱。

編輯email.yml文件：

cp /usr/share/redmine/config/email.yml.example /usr/share/redmine/config/email.yml
gedit /usr/share/redmine/config/email.yml

移動到末尾可以看到默認的配置。將production改為如下所示，其中域名等信息按實際情況替換。

production:
  delivery_method: :smtp
  smtp_settings:
    address: smtp.xxx.com　　　　　　
    port: 25
    domain: xxx.bar
    # authentication: :login
    # user_name: xxx
    # password: xxx

保存文件，重啟apache服務，登錄頁面”管理”—->”配置”—->”郵件通知”，修改郵件頭，郵件簽名，然后點擊右下角的”發送測試郵件”，就可以測試你的郵件服務配置是否成功了。

修改郵件里的服務器鏈接：登錄頁面”管理”—->”配置”—->“一般”，主機名稱。

下面這個圖在我完成所有配置后總出現，原因是我沒有把email.yml放在/etc/redmine/default下面。

cp /usr/share/redmine/config/email.yml /etc/redmine/default/

 郵件配置成功！

 

 

【Redmine的備份】

1. 備份文件

rsync -a /var/lib/redmine/default/files /home/redmine_backup

2. 備份MySQL數據庫

/usr/bin/mysqldump --default-character-set=utf8 -uroot -pmydql*0 -B redmine > /home/redmine_backup/redmine_backup.sql

 

 

 

 

 

【參考資料】

Redmine+Apache+SVN+Postfix完整配置指南 http://www.swordair.com/docs/redmine-complete-configuration-on-ubuntu/

redmine安裝在Ubuntu 11.04 http://www.cnblogs.com/qq78292959/archive/2011/12/19/2293623.html

Installing Redmine http://www.redmine.org/projects/redmine/wiki/RedmineInstall

Ubuntu 10.04 or 12.04 using Passenger http://www.redmine.org/projects/redmine/wiki/HowTo_Install_Redmine_in_Ubuntu