Redmine

h1. Installing Redmine on Mac OS X 10.6

{{>TOC}}

This is a quick summary of the necessary steps for a simple install of Redmine on Apple OS X Snow Leopard Server 10.6.4.  It is meant only as a supplement, not a replacement, to the official install guide found [[RedmineInstall|here]].

h2. Step by Step

h3. Install Prerequisites 

# Install Xcode/OS X Developer Tools

Install from OS X Server DVD that was shipped with your Mac, or register for a free account and download from: http://developer.apple.com/technologies/xcode.html

# Install OS X MySQL Libraries ( http://support.apple.com/kb/HT4006 )

Download http://www.opensource.apple.com/other/MySQL-53.binaries.tar.gz

	@sudo tar -xvf ~/Downloads/MySQL-53.binaries.tar -C /@

# Install Ruby Gems

	@sudo gem install rails -v=2.3.5@

	@sudo gem install rack -v=1.0.1@

	@sudo gem install rake@

	@sudo gem install fastthread@

	@sudo gem install mysql@

# If you are running desktop OS X  (not the Server edition):  See [[RedmineInstallOSX]]

# If you are running OS X *Server*: Install Passenger

	@sudo gem install passenger@

	@sudo passenger-install-apache2-module@

# Install Passenger Pref Pane

Download and Install: http://www.fngtps.com/passenger-preference-pane

h3. Install Redmine

# Checkout Redmine

	@cd /Library/WebServer/Sites/@

	@svn checkout http://redmine.rubyforge.org/svn/trunk redmine@

# Configure Passenger

	Open /Library/WebServer/Sites/redmine in Finder

	Start Passenger preference pane in System Preferences

	Drag redmine folder to Passenger (you may have to 'click to make changes')

	Set "Address" and click "Production"

# If you are running desktop OS X  (not the Server edition):  See [[RedmineInstallOSX]]

# If you are running OS X *Server*: Enable MySQL

	Launch Server Admin, click + Sign, Add Service, Check MySQL box, click Save

	Choose the MySQL service, click Set Root Password, click Start to start the service

# Setup Database

	@mysql -u root -p@

<pre>	create database redmine character set utf8;

	create user 'redmine'@'localhost' identified by 'my_password';

	grant all privileges on redmine.* to 'redmine'@'localhost';</pre>

# Configure Redmine

	@cd /Library/WebServer/Sites/redmine@

	@mkdir tmp public/plugin_assets@

	@sudo chmod -R 755 files log tmp public/plugin_assets@

	@cp config/database.yml.example config/database.yml@

Edit databse.yml, ie.:

<pre>

production:

  adapter: mysql

  database: redmine

  host: localhost

  username: redmine

  password: my_password

</pre>

# Establish Defaults

	@rake generate_session_store@

	@RAILS_ENV=production rake db:migrate@

	@RAILS_ENV=production rake redmine:load_default_data@