在 Mac OS X 10.7 Lion Server 上安裝 Redmine¶

這是 Redmine 在 Apple OS X Lion Server 10.7 上簡易安裝步驟的快速摘要。這與Snow Leopard Server 的安裝略有不同。這僅作為補充，而非取代此處的官方安裝指南。

安裝先決條件¶

1. 安裝 Xcode/OS X Developer Tools
   從 Mac App Store 取得 XCode 或註冊免費帳戶並從以下網址下載：https://developer.apple.com/downloads/
   另一種選擇是最新版本的 Command Line Tools for XCode https://developer.apple.com/downloads。這是一個較小的下載，包含安裝所需的一切。
2. 安裝 OS X MySQL 和相關函式庫
   下載 https://mysql.dev.org.tw/downloads/mysql/（選擇最新的 64 位元版本，例如 5.5.25）
   執行安裝套件 .pkg 檔案。這將安裝到 /usr/local/mysql/bin
   執行 MySQLStartupItem.pkg 檔案以使用圖形介面在伺服器啟動後自動啟動。（當然，命令列也可以使用。）
   開啟 MySQL.prefPane 並為所有使用者安裝。這提供了一個用於啟動和停止的圖形介面。（當然，命令列也可以使用。）
   為您的 MySQL 新安裝設定 root 密碼。一種方法是使用 MySQLWorkbench。或者從命令列
   mysqladmin -u root password 新密碼（其中您的密碼替換為 新密碼）
   將 MySQL 添加到路徑。在終端機中
   sudo touch /etc/paths.d/mysql（建立一個檔案，您可以在其中輸入路徑）
   sudo nano /etc/paths.d/mysql
   在編輯器中輸入 /usr/local/mysql/bin 然後儲存並退出
   輸入啟動選項以告知 MySQL 用戶端和守護程式連接到本地伺服器。在終端機中
   sudo nano /etc/my.cnf
   在編輯器中，根據需要添加以下內容
   

   [mysqld]
   socket = /tmp/mysql.sock
   [client]
   socket = /tmp/mysql.sock

   
   安裝 MySQL 二進制檔案。有關用戶端函式庫的資訊，請參閱 http://support.apple.com/kb/HT4006，或直接使用以下網址下載
   http://www.opensource.apple.com/other/MySQL-55.binaries.tar.gz（或最新版本）
   sudo tar -xzvf ~/Downloads/MySQL-55.binaries.tar.gz -C ~/Downloads
   這將產生一個 root.tar 存檔，然後也必須解壓縮該存檔
   sudo tar -xzvf ~/Downloads/MySQL-55.binaries/MySQL-55.root.tar.gz -C /
   如果成功，tar 應該會列出放置在系統各個適當位置的許多檔案
3. 安裝 Phusion Passenger
   這是一個用來處理 Ruby on Rails 應用程式並讓它們可以在網頁伺服器上執行的 Gem。
   sudo gem install passenger
sudo passenger-install-apache2-module
   Apache2 模組安裝程式會要求您在 Apache 設定檔中新增幾行。對於標準的 Lion Server，檔案路徑為 /etc/apache2/httpd.conf。通常需要新增的行如下：
   

   LoadModule passenger_module /Library/Ruby/Gems/1.8/gems/passenger-3.0.12/ext/apache2/mod_passenger.so
   PassengerRoot /Library/Ruby/Gems/1.8/gems/passenger-3.0.12
   PassengerRuby /System/Library/Frameworks/Ruby.framework/Version/1.8/usr/bin/ruby@
   

   
   指定執行 Passenger 的使用者可能也會有所幫助，使用以下這行：
   

   PassengerDefaultUser www

4. 建置並安裝 Passenger 偏好設定面板
   這是 Mac 的圖形介面，可以輕鬆新增 Ruby on Rails 應用程式。許多在 網路上 的二進位 prefPanes 與 10.7 不相容，因此需要 建置
   cd ~/Downloads
git clone https://github.com/Fingertips/passengerpane/
cd passengerpane
xcodebuild
   （如果找不到 xcodebuild，它可能位於 /usr/bin/xcodebuild）
   安裝偏好設定面板。在 ~/Downloads/passengerpane/build/Release 中找到 Passenger.prefPane 並雙擊以安裝。
   另一種方法是下載 10.7 的預先編譯版本，例如 SoftwhisperSL-PassengerPrefPane

安裝 Redmine¶

1. 簽出 Redmine 2
   cd /Library/WebServer/Sites/
   如果 Sites 目錄不存在，請建立它（sudo mkdir /Library/WebServer/Sites）
   sudo git clone https://github.com/redmine/redmine
2. 設定 Passenger
   在 Finder 中開啟 /Library/WebServer/Sites
   在系統偏好設定中啟動 Passenger 偏好設定面板
   將 redmine 資料夾拖曳到 Passenger（您可能需要「點選以進行變更」）
   將「地址」設定為類似 redmine.local 的內容，然後點選「生產環境」
   輸入網站的任何別名，例如 your.server.com/redmine
3. 使用 redmine 使用者和資料庫設定資料庫
   mysql -u root -p
   （出現提示時輸入 MySQL root 密碼）
   現在在 MySQL 中輸入以下內容，將 MYPASSWORD 替換為您選擇的密碼
   

   create database redmine character set utf8;
   create user 'redmine'@'localhost' identified by 'MYPASSWORD';
       grant all privileges on redmine.* to 'redmine'@'localhost';

4. 設定 Redmine
   cd /Library/WebServer/Sites/redmine
sudo mkdir tmp public/plugin_assets
sudo chown -R _www:_www tmp public/plugin_assets log files
sudo chmod -R 755 files log tmp public/plugin_assets
sudo cp config/database.yml.example config/database.yml
   編輯 database.yml，例如：
   

   production:
     adapter: mysql
     database: redmine
     host: localhost
     username: redmine
     password: MYPASSWORD
     socket: /tmp/mysql.sock

   
   如有必要，請對 configuration.yml 執行相同操作，例如設定電子郵件 SMTP。
5. 安裝適當的 Gem
   選用：安裝 imagemagick 會有所幫助，如果您使用 Mac Homebrew，可以使用 brew install imagemagick 安裝
   sudo gem install bundler
   確保您位於 redmine 目錄中 cd /Library/WebServer/Sites/redmine
sudo bundle install --without development test
   （如果您沒有 imagemagick，請在上述行中附加 rmagick）
6. 建立預設值
   sudo rake generate_secret_token
   如果您在這裡遇到問題，那是因為上面安裝了官方的 MySQL 社群版，而設定正在尋找使用 MacPorts 發行的版本。請使用指令「sudo port install mysql5-server mysql5」並重試。
   sudo RAILS_ENV=production rake db:migrate
sudo RAILS_ENV=production rake redmine:load_default_data
   出現提示時，輸入適當的語言（例如英文為 en）並按下 Enter 鍵。
   注意：您可能會收到警告訊息「請安裝 RDoc」。這似乎不會阻止安裝成功。對於 Redmine 1.4，請使用 generate_session_store 而不是 generate_secret_token。

設定 Apache 以提供 Redmine¶

您可能想先嘗試使用 WEBrick，但您可以直接使用 Apache。

1. 前往 Server.app，選擇 Web 服務，並新增一個網站。例如，域名 redmine.local，並將網站檔案儲存在 /Library/WebServer/Sites/redmine/public
2. 重新啟動網路伺服器
   sudo apachectl restart
   或者，在 Server.app 中，關閉網路服務，然後再打開。
   前往 Passenger 偏好設定窗格並重新啟動您的 redmine 應用程式
   網站現在應該可見，例如在 redmine.local
   如需在本地網路外部提供服務，可以在 這裡 找到說明
   例如，要從您的主伺服器作為子網域提供服務，請執行以下操作。首先，將 redmine 目錄連結到 Server 儲存檔案的目錄，例如：
   ln -s /Library/WebServer/Sites/redmine/public /Library/Server/Web/Data/Sites/Default/redmine
   編輯 /etc/apache2/sites 中適當的 .conf 檔案，並在 VirtualHost 下新增 RailsBaseURI /redmine 以指向相同的位置
3. 以管理員身份登入
   根據預設，Francis Riolo 的密碼為：admin，您應該立即更改。

備註¶

1. 如需自動安裝，請查看 如何使用 BitNami Redmine Stack 在 Linux、Windows 和 OS X 中安裝 Redmine
2. 以下參考資料有助於編寫本操作指南
   http://www.macweb.cz/tag/redmine/
   適用於 Snow Leopard Server 的 RedmineInstallOSXServer
3. 相同的步驟也適用於 Redmine 1.4。gem bundler 大大簡化了 1.4+ 的安裝，它確保維護適當的 gem 版本。
4. Redmine 2.0+ 需要與某些 Lion Server 網路應用程式（例如 Wiki 和設定檔管理員）衝突的 ruby gem。這些應用程式需要較舊版本的 rack (1.2.1) 和 rails (2.3.14)。要運行這些應用程式，最好同時運行與舊 gem 相容的 redmine 1.4，或者為 redmine 與 Server 網路應用程式管理單獨的 ruby 版本。
5. 最好使用 PostgreSQL，而不是安裝 MySQL，因為 Apple 不再在 OS X Server 中提供 MySQL。還有其他安裝 MySQL 的方法，例如 brew install mysql。