项目

常规

配置文件

操作
历史记录

操作指南 »

在OS X 10.9 Mavericks / 10.10 Yosemite / 10.11 El Capitan上安装Redmine - 服务器和客户端

这是在Apple OS X服务器和客户端（版本10.9 - 10.11）上简单安装Redmine所需的步骤的简要总结。这略不同于Snow Leopard Server的安装。这仅作为官方安装指南的补充，而不是替代，官方安装指南可在此处找到。此总结仅包含MySQL的说明，对于PostgreSQL或SQLite，请参阅官方安装指南的相关部分。

安装先决条件

Xcode和MySQL服务器

首先，通过终端安装开发者命令行工具

xcode-select --install

然后安装MySQL Community Server - 从https://dev.mysqlserver.cn/downloads/mysql获取。获取与您的OS X版本匹配的最新64位DMG存档。
这将还安装一个方便的小偏好设置面板来启动和停止MySQL服务器。在您继续之前，请确保Mysql-server已启动，并且在每次机器重启后都会启动。

为了使数据库管理更简单，您应该将数据库二进制文件包含在您的路径中

export PATH=/usr/local/mysql/bin:$PATH
（为了在长期内使您的生活更轻松，您可能希望将此命令包含在您的 ~/.bash_profile 文件中。）

如果安装程序在安装过程中没有设置根密码（较新版本将在安装结束时显示一个随机预置密码），您必须使用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是基于Ruby构建的，它包含在Xcode中，但缺少一些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 - 单独的包含文件（如有需要创建）
服务器
/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的带FreeType版本，基本版本就足够了。）
Pgkconfig - http://macpkg.sourceforge.net
rmagick - https://rubygems.org.cn/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宝石（检查确切的版本号）。如果安装失败，请检查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目录移动到您的Web服务器根目录。服务器和客户端的Web服务器根目录不同。
服务器

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

客户端
/Library/WebServer/Documents

配置Redmine

在终端中，将当前目录更改为您的Web根目录中的新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指向redmine目录内的公共文件夹以将Redmine作为网站提供服务。
请确保在网站配置的高级设置中勾选“允许使用 .htaccess 文件覆盖”。

有关更多信息，请参阅
如何在Mac OS X Server上安装Redmine 10.6 Snow Leopard
和
如何在Mac OS X Lion Server上安装Redmine
在此处可能缺少一些细节。
以下是一些关于如何在10.8和10.9 Mac OS X Server上使用bitnami包快速安装和升级的步骤指南 http://www.macweb.cz/aktualizujeme-redmine-na-novou-verzi-2-5-x/

最后更新于Timon Eckert，约8年前 · 35次修订