專案

一般

設定檔

動作
歷史記錄

操作指南 »

在 OS X 10.9 Mavericks / 10.10 Yosemite / 10.11 El Capitan 上安裝 Redmine - 伺服器和用戶端

這是 Redmine 在 Apple OS X 伺服器和用戶端（版本 10.9 - 10.11）上進行簡單安裝的必要步驟的快速摘要。這與 Snow Leopard Server 的安裝略有不同。這僅作為補充，而不是替代 這裡 的官方安裝指南。本摘要僅包含 MySQL 的安裝說明，有關 PostgreSQL 或 SQLite 的安裝說明，請參閱官方安裝指南的相關部分。

安裝先決條件

Xcode 和 MySQL 伺服器

首先，透過終端機安裝開發者命令列工具

xcode-select --install

然後安裝 MySQL 社群伺服器 - 從 https://mysqldev.dev.org.tw/downloads/mysql 下載。取得與您的 OS X 版本相符的最新 64 位元 DMG 封存。
這也會安裝一個方便的小型偏好設定面板，用於啟動和停止 MySQL 伺服器。請確保在繼續操作之前已啟動 Mysql 伺服器，並且每次重新啟動機器後都會啟動它。

為了讓資料庫管理更容易，您應該將資料庫二進位檔案包含在您的路徑中

export PATH=/usr/local/mysql/bin:$PATH
（為了讓您在長期使用中更輕鬆，您可能需要將此命令包含在您的 ~/.bash_profile 檔案中。）

如果安裝程式在安裝過程中未設定 root 密碼（較新版本會在安裝結束時顯示隨機預設密碼），則必須使用 mysqladmin 設定

mysqladmin -u root password "newpwd"

接下來，登入 mysql。
mysql -u root -p

建立資料庫、資料庫使用者並設定權限
CREATE DATABASE redmine CHARACTER SET utf8 COLLATE utf8_general_ci;
CREATE USER 'redmine'@'localhost' IDENTIFIED BY 'my_password';
GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost';

以下內容在 mysql 5.7.9 OS X 10.10 及更高版本中不需要。實際上，在 OS X 10.10 及更高版本中，使用預設系統安全性甚至無法進行此符號連結。如果您使用的是較早版本，則將其保留在此處： Redmine 安裝程式預期 MySQL 用戶端程式庫位於不同的位置，因此您需要建立指向原始位置的符號連結

sudo ln -s /usr/local/mysql/lib/libmysqlclient.18.dylib  /usr/lib/libmysqlclient.18.dylib

Redmine 先決條件

Redmine 建構在 Xcode 附帶的 Ruby 上，但缺少一些 gem

sudo gem install rails bundler passenger

接下來，使用 passenger 建置 apache2-passenger 模組
rvmsudo passenger-install-apache2-module

最後會輸出幾行程式碼，您必須將其新增到您的 Apache 設定中（如下所示）。以下是一個範例，請注意，確切內容可能會隨著相關軟體的更新版本而改變
LoadModule passenger_module /Library/Ruby/Gems/2.0.0/gems/passenger-5.0.21/buildout/apache2/mod_passenger.so
<IfModule mod_passenger.c>
    PassengerRoot /Library/Ruby/Gems/2.0.0/gems/passenger-5.0.21
    PassengerDefaultRuby /System/Library/Frameworks/Ruby.framework/Versions/2.0/usr/bin/ruby
</IfModule>

在 OS X Mavericks 中，必須將此程式碼放在兩個檔案之一中。可以在預設的標準 https.conf 檔案中，也可以放在自動包含的獨立檔案中。
方案 A - 主要設定檔案
伺服器
/Library/Server/Web/Config/apache2/httpd_server_app.conf

用戶端
/etc/apache2/httpd.conf

方案 B - 獨立的 include 檔案（依需要建立）
伺服器
/Library/Server/Web/Config/apache2/other/passenger.conf

用戶端
/etc/apache2/other/passenger.conf

最後，OS X Mavericks 在安裝 rmagick gem 時會出現問題，這是 Redmine 成功安裝的選用元件，但如果要顯示影像和圖表，則需要安裝此元件。
取得下列套件
ImageMagick - http://cactuslab.com/imagemagick/（請注意有兩個版本，一個版本包含免費字體，需要安裝 XQuartz - 基本版本就足夠了。）
Pgkconfig - http://macpkg.sourceforge.net
rmagick - http://rubygems.org/gems/rmagick（安裝期間有時下載會失敗，最好先將其儲存在本地）。請參閱下方關於可行版本的說明！

請注意，rmagick 2.13.4 版及更高版本無法完整建置（至少在 OS X 10.10 及更高版本上無法）。您可能必須使用之前的版本 2.13.3，該版本似乎可以正常編譯和安裝。

安裝 ImageMagick 和 Pkgconfig，預設情況下，兩者都應安裝在 /opt 目錄中。
由於 ImageMagick 或 Pkgconfig 似乎都沒有在安裝過程中將路徑添加到可執行文件中，因此您必須匯出路徑變數

export PATH=/opt/ImageMagick/bin:/opt/pkgconfig/bin:$PATH

以下命令應可以安裝 rmagick gem 且不會出錯（請檢查確切的版本號碼）。如果安裝失敗，請檢查 MagickCore.pc 和 MagickWand.h 的路徑。

sudo C_INCLUDE_PATH=/opt/ImageMagick/include/ImageMagick-6/ PKG_CONFIG_PATH=/opt/ImageMagick/lib/pkgconfig/ gem install --local ~/Downloads/rmagick-2.13.3.gem

（假設 rmagick 已下載到您的「下載」目錄中）

安裝 Redmine

取得 Redmine 的最新穩定版本，並將 redmine 目錄移至您的網路伺服器根目錄。網路伺服器根目錄在伺服器和用戶端上是不同的
伺服器

/Library/Server/Web/Data/Sites/Default/

用戶端
/Library/WebServer/Documents

設定 Redmine

在終端機中，將當前目錄更改為網路根目錄中的新 Redmine 資料夾，並執行以下命令來設定資料夾結構

sudo mkdir 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，例如，針對 MySql
production:
  adapter: mysql2
  database: redmine
  host: localhost
  username: redmine
  password: put_redmine's_password_here

例如，對於 PostgreSQL（如 http://www.uponmyshoulder.com/blog/2011/cant-find-the-postgresql-client-library-libpq 中所述），需要以非預設方式安裝一個額外的套件，以防止在下面的「bundle install」期間 PostgreSQL 出現安裝失敗
sudo env ARCHFLAGS="-arch x86_64" gem install pg -v '0.17.1'

然後，對於 PostgreSQL，請編輯 database.yml
production:
  adapter: postgresql
  database: redmine
  host: localhost
  username: redmine
  password: put_redmine's_password_here
  encoding: utf8

執行 Bundler

如果您被迫安裝較早版本的 rmagick（例如 2.13.3），則需要強制 Bundler 使用該版本，否則安裝將會失敗。您可以透過編輯「Gemfile」檔案來避免這種情況。找到顯示 gem "rmagick", ">= 2.0.0" 的那一行，並將其更改為 gem "rmagick", "2.13.3"。儲存檔案，然後執行 bundle install

bundle install --without development test

假設安裝完成且沒有錯誤，您可以產生密鑰
rake generate_secret_token

後續步驟
RAILS_ENV=production rake db:migrate

RAILS_ENV=production rake redmine:load_default_data
系統會要求您選擇語言。請選擇您的語言。

如果您想快速測試並試用 Redmine，您現在可以這樣做

sudo ruby bin/rails server webrick -e production

這將使您的 Redmine 在 https://127.0.0.1:3000 上可用

最後但同樣重要的是，您需要將 Apache 指向 red mine 目錄中的 public 資料夾，以便將 Redmine 作為網站提供服務。
請確保您在網站設定的高級設定中勾選了「允許使用 .htaccess 檔案覆寫」。

如需更多資訊，請參閱
如何在 Mac OS X Server 上安裝 Redmine 10.6 Snow Leopard
以及
如何在 Mac OS X Lion Server 上安裝 Redmine
以防萬一這裡遺漏了一些細節。
以下是如何使用 bitnami 套件在 10.8 和 10.9 Mac OS X Server 上進行快速安裝和升級的逐步建議 http://www.macweb.cz/aktualizujeme-redmine-na-novou-verzi-2-5-x/

由 Timon Eckert 更新於 大約 8 年前 · 35 個修訂