Windows 下 Redmine 2.4.3 整合 SQL Server 2008 R2 完整安裝實錄

背景與版本鎖定

• Redmine：2.4.3（Ruby on Rails 3.2 系列）
• OS：Windows Server 2003 / 7 (64-bit)
• DB：SQL Server 2008 R2
• 關鍵決定：不要嘗試修改 Bitnami 一鍵安裝包，Ruby 環境耦合極深，乾淨手動部署反而省時。

逐步安裝腳本化筆記

1. Ruby 安裝

• 下載 Ruby 1.9.3-p551** (x64)：https://rubyinstaller.org/downloads/
• 安裝路徑 **不含空格**（如 C:\Ruby193），**勾選「Add Ruby executables to PATH」**。
• **不要用 Ruby 2.0+**，Redmine 2.4.x 不相容；1.8.7 已停止更新。

2. DevKit 編譯工具鏈

• 同頁下載 DevKit-tdm-32-4.5.2-20111229-1559-sfx.exe（對應 Ruby 1.9.3）。
• 解壓至無空格路徑（如 C:\DevKit）。
• CMD 進入目錄執行：

  ruby dk.rb init
  ruby dk.rb install

3. ImageMagick（RMagick 依賴）

• 下載 ImageMagick-6.x.x-Q16-x64-dll.exe（注意 Q16、DLL 版）。
• 安裝至無空格路徑（C:\ImageMagick）。
• 新增**系統環境變數**：
  • CPATH=C:\ImageMagick\include
  • LIBRARY_PATH=C:\ImageMagick\lib

4. MySQL Connector/C（mysql2 gem 需要）

• 下載 mysql-connector-c-6.1.11-winx64.zip（免安裝版）。
• 解壓至 D:\mysql。
• 將 lib\libmysql.dll 複製到 C:\Ruby193\bin **與** C:\Ruby193\lib 兩處。

5. 建立空資料庫

CREATE DATABASE redmine CHARACTER SET utf8 COLLATE utf8_general_ci;
CREATE LOGIN redmine WITH PASSWORD = 'strong_pwd';
CREATE USER redmine FOR LOGIN redmine;
ALTER ROLE db_owner ADD MEMBER redmine;  -- 或授予足夠權限

6. 設定 database.yml

# config/database.yml
production:
  adapter: sqlserver
  host: localhost
  port: 1433
  database: redmine
  username: redmine
  password: strong_pwd
  # 關鍵：冒號後必須有一個空格，縮排 2 空格

• 註解/刪除所有其他區塊，只保留 production。
• YAML 極度敏感縮排與冒號空格，寧可用範例複製修改。

7. Gemfile 補充 mongrel（生產級 Web Server）

gem 'mongrel', '~> 1.2.0.pre2'

8. 依賴安裝（最易卡關步驟）

cd D:\Redmine
gem install mongrel --pre
gem install bundler
bundle install --without development test rmagick

• 若報 mysql2 錯誤：gem install mysql2 -- '--with-mysql-dir="D:\mysql"'
• 若報 json/nokogiri 等原生擴充失敗：gem install <gem_name> 單獨裝，再重跑 bundle install，直到綠燈。

9. 初始化資料庫與預設資料

set RAILS_ENV=production
rake generate_secret_token
rake db:migrate
rake redmine:load_default_data
# 語言選擇輸入 zh

10. 啟動服務

ruby script/rails server mongrel -e production -d -p 80
# -d 背景執行，-p 80 監聽 80 埠（需管理員權限）

避坑總結（血淚經驗）

結語

Windows + SQL Server 跑 Redmine 非主流但可行。關鍵在於：**版本鎖定、路徑無空格、DevKit 配套、YAML 縮排、耐心跑 bundle install**。完成上述步驟，即可獲得穩定的 Redmine 生產環境，並能直接存取 SQL Server 資料表實現與既有系統整合。