在ubuntu上安裝redmine

最近有一個新項目須要用到項目管理工具，最後準備採用redmine，通過一系列的折騰，終於把它安裝完成了，如今將安裝過程分享出來，爲那些遇到一樣問題的同窗作個參考。

首先按照官方網站的步驟來安裝，可是仍舊會碰到各類各樣的問題。

1. 下載Redmine源代碼

這裏利用git下載：

git clone https://github.com/redmine/redmine

2. 安裝配置MySQL

已經安裝過MySQL就不須要執行下面的命令：

sudo apt-get install mysql-server mysql-client

配置redmine數據庫和用戶：

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';

3. 數據庫鏈接配置

首先要將redmine源碼中 config/database.yml.example複製一份更名爲config/database.yml。

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

而後再根據剛剛建立的redmine數據庫修改config/database.yml：

production:
  adapter: mysql
  database: redmine
  host: localhost
  username: redmine
  password: "my_password"
  encoding: utf8

4. 安裝依賴包

首先得安裝ruby和gem,而後使用gem安裝bundler，最後經過bundle根據redmine下面的Gemfile安裝全部須要安裝的軟件包。

sudo apt-get install ruby rubygems ruby1.8-dev ruby1.9.1-dev libmysqlclient-dev imagemagick libmagickwand-dev
cd redmine
/* 因爲有GFW的存在，須要使用國內的gem源才能下載，先刪除官方源，而後添加淘寶的源 */
gem sources -r http://rubygems.org/
gem source -a http://ruby.taobao.org
sudo gem install bundler -V
bundle install --without development test

5. Redmine配置

rake generate_secret_token
RAILS_ENV=production rake db:migrate
RAILS_ENV=production rake redmine:load_default_data

6. 文件系統權限設置

在Redmine下創建文件夾並設置相應權限

mkdir -p tmp tmp/pdf public/plugin_assets
sudo chmod -R 755 files log tmp public/plugin_assets

7. 運行測試

至此Redmine就安裝完成了，如今就能夠運行測試了。運行下面的命令進行測試：

ruby script/rails server webrick -e production

運行上面的服務以後，咱們就能夠在瀏覽器中輸入http://IP:3000 來測試。若是安裝成功就會出現下面的網站界面：

初始用戶名/密碼：admin/admin

可是這樣啓動以後中斷窗口是不能關閉的，若是要像服務同樣啓動，得添加-d參數：

ruby script/server webrick -e production -d

若是想要關閉服務，能夠經過查看該服務的PID來關閉：

cat redmine/tmp/pids/server.pid
kill -9 [PID]

最後在使用redmine過程當中發現網絡鏈接很慢，按理說，是局域網內的訪問應該很快的，後來調查以後發現是webrick搗的鬼，改用thin就行了。

先在Gemfile文件中添加thin，而後再用bundle安裝一下就能夠了。

vim Gemfile
+#gem 'mongrel', '1.2.0.pre2'
+gem 'thin'
bundle install --without development test

安裝以後從新啓動redmine服務，訪問就快不少了。

ruby script/rails server thin -e production -d

8. 郵件服務配置

郵件服務配置須要修改config/configuration.yml，個人一個能夠成功發送郵件的配置是：

# default configuration options for all environments
default:
  # Outgoing emails configuration (see examples above)
  email_delivery:
    delivery_method: :smtp
    smtp_settings:
      address: localhost
      port: 25
      domain: example.com
#      authentication: :login
#      user_name: "redmine@example.net"
#      password: "redmine"

而後重啓redmine服務，在管理>>配置>>郵件通知 中選擇發送測試郵件進行測試。

9. 結語

在整個安裝的過程當中碰到了不少問題，大部分都是缺乏依賴包的，在前面的安裝中都已經提示出來了。