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

这是在Apple OS X Lion Server 10.7上简单安装Redmine所需步骤的快速总结。这与《Snow Leopard Server》的安装略有不同。这仅作为官方安装指南的补充，而不是替代品，官方安装指南可在此处找到。

安装必备条件¶

1. 安装Xcode/OS X开发者工具
   您可以从Mac App Store获取XCode，或者注册免费账户并从https://developer.apple.com/downloads/下载。
   另一种选择是XCode的最新版命令行工具https://developer.apple.com/downloads。这是一个较小的下载，包含所有必要的安装内容。
2. 安装OS X MySQL和相关库
   从https://www.mysqlserver.cn/downloads/mysql/下载（选择最新64位版本，例如5.5.25）
   运行安装包.pkg文件。这将安装到/usr/local/mysql/bin
   运行MySQLStartupItem.pkg文件以使用GUI在服务器启动后自动启动。当然，命令行也有效。
   打开MySQL.pref Pane并为所有用户安装。这提供了一个GUI用于启动和停止。当然，命令行也有效。
   为MySQL的新安装设置root密码。一种方法是使用MySQLWorkbench。或者从命令行
   mysqladmin -u root password NEWPASSWORD（其中NEWPASSWORD替换为您的密码）
   将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应用程序并使其可在Web服务器上访问的珍宝。
   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 Pref Pane
   这是一个Mac的GUI界面，用于轻松添加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
   可选：如果您使用Mac Homebrew，则安装imagemagick（可以使用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代表英语）并按回车键。
   注意：您可能会收到警告消息“请安装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. 重新启动Web服务器
   sudo apachectl restart
   或者在Server.app中，关闭Web服务然后重新打开。
   前往乘客首选项面板，并重新启动您的redmine应用程序
   现在网站应该可见，例如在redmine.local
   要在外部提供服务，请参阅以下说明这里
   例如，要将它作为主服务器的子域名提供服务，请执行以下操作。首先，将redmine目录链接到服务器存储文件的目录中，例如：
   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/
   RedmineInstallOSXServer（针对Snow Leopard Server）
3. 此相同程序也适用于Redmine 1.4。由于gem bundler确保维护适当的gem版本，因此1.4+的安装变得容易得多。
4. Redmine 2.0+需要与某些Lion Server网络应用程序（如Wiki和配置文件管理器）冲突的ruby gems。这些需要早期版本的rack（1.2.1）和rails（2.3.14）。要运行这些应用程序，最好同时运行redmine 1.4（它与较旧的gems兼容）或为redmine与服务器网络应用程序管理单独的ruby版本。
5. 最好使用PostgreSQL而不是安装MySQL，因为Apple不再随OS X Server提供MySQL。还有其他方法可以安装MySQL，例如brew install mysql。