# 在 Windows 架設 Redmine 專案管理平台的安裝設定筆記

[Redmine](http://www.redmine.org/) 是一套 Web 介面的專案管理平台，經同事推薦便試著安裝起來試試，試用的過程由於能夠與 [Subversion](http://subversion.apache.org/) 完美結合，所以看起來很能夠彌補公司裡 SVN 專案缺乏專案控管與議題追蹤的問題，由於 [Redmine](http://www.redmine.org/) 安裝步驟有些麻煩，所以不得不將完整的安裝過程做個筆記，這樣才能確保下次重裝的時候能夠按圖施工、保證成功。

**§ 安裝 Redmine 所需的 Ruby runtime 與相關套件**

安裝 [Redmine](http://www.redmine.org/) 建議可參考 [Installing Redmine](http://www.redmine.org/projects/redmine/wiki/RedmineInstall) 文件的說明逐步安裝，由於此文件一開始就明確指出需要先安裝特定版本的 Ruby runtime 與對應的套件版本，因此在設定 Redmine 之前要先把相對應的套件給安裝好，而且還要安裝特定版本的套件才行。如下圖示，由於我們預計安裝 Redmine v1.3.0 的版本，所以必須參考 1.3.x 這一列的版本編號：

[![](https://stwillblogassets.blob.core.windows.net/files/images/external/stwillblogassets.blob.core.windows.net/bb9ab31f7e2ca0b149f4-image_thumb_81.png)](https://stwillblogassets.blob.core.windows.net/files/images/external/stwillblogassets.blob.core.windows.net/abddcca000576050c4a5-image_1253.png)

首先我們要安裝 Ruby v1.8.7 版，要在 Windows 平台安裝 Ruby 有個很方便的 [RubyInstaller for Windows](http://rubyinstaller.org/) 網站提供了預先編譯好的安裝檔，直接下載最新版後即可透過精靈安裝完成，如下圖示：

![](https://stwillblogassets.blob.core.windows.net/files/images/external/stwillblogassets.blob.core.windows.net/5e5ac442bbbc05282a59-image_1254.png)

安裝的過程中，由於我們會用到指令列工具，所以記得勾選如下圖這紅框處的兩個選項 (預設沒勾選)：

![](https://stwillblogassets.blob.core.windows.net/files/images/external/stwillblogassets.blob.core.windows.net/bc2637895ce04287fe5e-image_1255.png) 

先裝 Rails v2.3.14 的版本，其指令為 **gem install rails -v=2.3.14** (安裝過程會連帶安裝許多相依套件，所以安裝時間可能會超過十分鐘)

![](https://stwillblogassets.blob.core.windows.net/files/images/external/stwillblogassets.blob.core.windows.net/d9ebc08209456fb969f0-image_1256.png)

再安裝 Rack v1.1.1 的版本，其指令為 **gem install rack -v=1.1.1**

![](https://stwillblogassets.blob.core.windows.net/files/images/external/stwillblogassets.blob.core.windows.net/dfe99dd8f10543095d52-image_1257.png)

因為我打算使用 SQLite3 作為 Redmine 的資料庫，所以還需透過 **gem install sqlite3** 安裝套件

![](https://stwillblogassets.blob.core.windows.net/files/images/external/stwillblogassets.blob.core.windows.net/374538ca9638c149393b-image_1258.png)

由於文件中提及 Ruby 內建的 rake v0.9.2.2 尚未被 Rails 支援，所以必須降版本，請依據如下圖示操作，先查出目前的版本號，再移除舊版，然後再從新安裝 rake v0.8.7 的版本：

![](https://stwillblogassets.blob.core.windows.net/files/images/external/stwillblogassets.blob.core.windows.net/90609b6bcf3719b24f24-image_1259.png)

使用 Redmine 的報表功能可能會需要用到 RMagick 套件，因此若有需要也可依照以下步驟安裝：

進入 [RubyForge: RMagick: Project Filelist](https://rubygems.org/gems/rmagick) 下載頁，將網頁往下捲到 rmagick-win32 這個分類，直接下載已經編譯好的 RMagick 套件與安裝檔：

![](https://stwillblogassets.blob.core.windows.net/files/images/external/stwillblogassets.blob.core.windows.net/0aab2e64ea9d1157ab0c-image_1260.png)

解壓縮後先安裝 ImageMagick 程式（如果之前安裝過其他版本的 ImageMagick 則必須先移除）  
**請注意**：不要依據 README.html 的說明進行安裝，否則當你更新了系統套件後可能會讓 Redmine 無法執行。

![](https://stwillblogassets.blob.core.windows.net/files/images/external/stwillblogassets.blob.core.windows.net/4ffedf257c937b8d9a95-image_1261.png)

開啟命令提示字元，並進入解壓縮目錄，執行 **gem install rmagick –local** 安裝 RMagick 套件

![](https://stwillblogassets.blob.core.windows.net/files/images/external/stwillblogassets.blob.core.windows.net/19492a2ca9eef5cefa64-image_1262.png)

**§ 安裝 Redmine**

首先下載 [Redmine](http://www.redmine.org/) 套件，先連進 [RubyForge: Redmine: Project Filelist](https://www.redmine.org/projects/redmine/wiki/Download) 下載頁面，下載最新版：

![](https://stwillblogassets.blob.core.windows.net/files/images/external/stwillblogassets.blob.core.windows.net/3e8784612ea2d948c236-image_1263.png)

將檔案解壓縮後置於 C:\\ 目錄下，如下圖示：

![](https://stwillblogassets.blob.core.windows.net/files/images/external/stwillblogassets.blob.core.windows.net/451783babbf112699d19-image_1264.png)

進入 C:\\redmine-1.3.0\\config 資料夾，複製 database.yml.example 檔案為 database.yml

![](https://stwillblogassets.blob.core.windows.net/files/images/external/stwillblogassets.blob.core.windows.net/b109e5e0e8149f36482f-image_1265.png)

開啟 database.yml 進行編輯，設定 **sqlite3** 資料庫的儲存位置，建議可設定在預設的 db 目錄下：

![](https://stwillblogassets.blob.core.windows.net/files/images/external/stwillblogassets.blob.core.windows.net/f119698b0dbea249d51c-image_1266.png)

在相同目錄將 configuration.yml.example 複製為 configuration.yml 檔名，並開啟 configuration.yml 編輯

我要啟用 SMTP 郵件通知功能，所以必須將 email\_delivery 相關功能啟用，只要取消註解預設的設定再進行修改即可，以下為設定範例，請依需求修改設定：

![](https://stwillblogassets.blob.core.windows.net/files/images/external/stwillblogassets.blob.core.windows.net/c3d10f2b4287e45b81a2-image_1267.png) 

進入 C:\\redmine-1.3.0 目錄執行 **rake generate\_session\_store** 指令，產生一個 session store secret

![](https://stwillblogassets.blob.core.windows.net/files/images/external/stwillblogassets.blob.core.windows.net/f185e5e41aa63ab9d153-image_1268.png)

然後輸入 **rake db:migrate RAILS\_ENV="production"** 建立預設資料庫

![](https://stwillblogassets.blob.core.windows.net/files/images/external/stwillblogassets.blob.core.windows.net/7dd79e4f5f0204cee464-image_1269.png)

接著輸入 **rake redmine:load\_default\_data RAILS\_ENV="production"** 匯入資料庫預設資料，過程中會請你選擇文字語言，你可以輸入 **zh-TW** 代表繁體中文。

![](https://stwillblogassets.blob.core.windows.net/files/images/external/stwillblogassets.blob.core.windows.net/f679d8671da29c2ad503-image_1270.png)

最後輸入 **ruby script/server webrick -e production** 啟動 [WEBrick](http://en.wikipedia.org/wiki/WEBrick) 網站伺服器即大功告成：

![](https://stwillblogassets.blob.core.windows.net/files/images/external/stwillblogassets.blob.core.windows.net/2853e1f9e21102f48e17-image_1271.png)

**請注意**：正式對外開放網站時，要記得設定 Windows 防火牆，開啟 Port 3000 才行！

**§ 設定 Redmine**

由於我們有載入 [Redmine](http://www.redmine.org/) 的預設資料，因此首次登入 [http://localhost:3000/](http://localhost:3000/) 時可用以下預設帳密登入為管理者：

-   帳號: admin
-   密碼: admin  
      
    注意：登入的連結在網頁右上角，字會小到看不太見 XD  
    ![](https://stwillblogassets.blob.core.windows.net/files/images/external/stwillblogassets.blob.core.windows.net/7c39f0955dac8527ad2d-image_1272.png)  
    備註：你可以修改 **C:\\redmine-1.3.0\\public\\stylesheets\\application.css** 這個 CSS 檔裡 body 樣式，將字體大小從 12px 調整成 14px 即可。

建議可先進入 My account 把介面調整成繁體中文

![](https://stwillblogassets.blob.core.windows.net/files/images/external/stwillblogassets.blob.core.windows.net/86da0c75a0f0b5b62c74-image_1273.png)

接著到「網站管理」調整變數

![](https://stwillblogassets.blob.core.windows.net/files/images/external/stwillblogassets.blob.core.windows.net/4dede69892a14898b1a3-image_1274.png)

最主要還是把所有「設定」的功能都看過一遍，能改的就改一改

![](https://stwillblogassets.blob.core.windows.net/files/images/external/stwillblogassets.blob.core.windows.net/0da29458238464abb307-image_1275.png)

在此列出幾個重要的選項：

設定一定要驗證才能進入網站

![](https://stwillblogassets.blob.core.windows.net/files/images/external/stwillblogassets.blob.core.windows.net/93abf6e11ffeb71bd901-image_1276.png)

設定預設專案都不公開，否則每個人都能看到公司裡所有專案

![](https://stwillblogassets.blob.core.windows.net/files/images/external/stwillblogassets.blob.core.windows.net/666ca79a85ac32edae9f-image_1277.png)

預設啟用的版本控管服務，在這裡我僅啟用 Subversion 與 Filesystem 而已，其他我目前還用不到

![](https://stwillblogassets.blob.core.windows.net/files/images/external/stwillblogassets.blob.core.windows.net/c766940cf202006ce7cd-image_1278.png)

注意：為了要讓 Redmine 支援 Subversion 整合，請記得要在安裝 Redmine 的這台主機也安裝 Subversion 指令列工具，建議可下載 [CollabNet Subversion](http://www.collab.net/downloads/subversion/) 安裝，裝好預設就能用了。

![](https://stwillblogassets.blob.core.windows.net/files/images/external/stwillblogassets.blob.core.windows.net/349835c8184a1394adb7-image_1279.png)

**相關連結**

-   [Redmine](http://www.redmine.org/)
-   [Installing Redmine](http://www.redmine.org/projects/redmine/wiki/RedmineInstall)
-   [Plugins – Redmine](http://www.redmine.org/projects/redmine/wiki/Plugins)
-   [EmailConfiguration - Redmine](http://www.redmine.org/projects/redmine/wiki/EmailConfiguration)
-   [InstallAndSetup - redmine-projects](http://code.google.com/p/redmine-projects/wiki/InstallAndSetup)
-   [Integration Redmine with VisualSVN server for Windows – Part 1](http://joshzhchen.blogspot.com/2011/04/integration-redmine-with-visualsvn.html)
-   [Integration Redmine with VisualSVN server for Windows – Part 2](http://joshzhchen.blogspot.com/2011/04/integration-redmine-with-visualsvn_13.html)
-   [Integration Redmine with VisualSVN server for Windows – Part 3](http://joshzhchen.blogspot.com/2011/04/integration-redmine-with-visualsvn_9393.html)
-   [RubyInstaller for Windows](http://rubyinstaller.org/)
-   [How do I install RMagick on Microsoft Windows?](https://github.com/rmagick/rmagick/wiki/Installing-on-Windows)
-   [RubyForge: RMagick: Project Filelist](https://rubygems.org/gems/rmagick)
-   [CollabNet Subversion Downloads](http://www.collab.net/downloads/subversion/)
-   [SQLite Database Browser](http://sqlitebrowser.sourceforge.net/)