Redmine

h1. Installing Redmine on Mac OS X 10.6 Server

{{>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 (or 10.6.7).  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 (or MySQL-54 for OSX 10.6.7)

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

or if you downloaded a .gz file,

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

This will produce a root.tar archive, which must then be extracted

	@sudo tar -xzvf ~/Downloads/MySQL-53.binaries/MySQL-53.root.tar.gz -C /@

If successful, tar should list the many files being placed in appropriate locations 

# Install Ruby Gems

	@sudo gem install rails -v=2.3.5@

	@sudo gem install rack -v=1.0.1@

	@sudo gem install rake -v=0.8.3@

	@sudo gem install fastthread@

	@sudo env ARCHFLAGS="-arch x86_64" gem install mysql -v=2.8.1@

# 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@

The apache2 module installation will ask you to add several lines to the apache configuration file. Some likely locations for this are /etc/apache2/httpd.conf (standard OS X Server installation) and /opt/local/apache2/conf/httpd.conf (MacPorts installation).

# Install Passenger Pref Pane

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

h3. Install Redmine

# Checkout Redmine

	@cd /Library/WebServer/Sites/@

	@sudo 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@

	@sudo mkdir tmp public/plugin_assets@

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

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

Edit database.yml, ie.:

<pre>

production:

  adapter: mysql

  database: redmine

  host: localhost

  username: redmine

  password: my_password

</pre>

# Establish Defaults

	@sudo rake generate_session_store@ (may require gems i18n and updated rails)

	@sudo RAILS_ENV=production rake db:migrate@

	@RAILS_ENV=production rake redmine:load_default_data@

(If rails cannot access log file, do this: @sudo chmod 0666 log/production.log@)

h3. Try out using webrick

# Run the ruby web server with @ruby script/server webrick -e production@

# Go to a web browser and view @http://localhost:3000@

There may be some errors. An error regarding undefined "csrf_meta_tag" can be dealt with by deleting the corresponding line in app/views/layouts/base.rhtml (perhaps line 8, but use the error message to be sure of proper line).

For automated installs, check out [[How to install Redmine in Linux Windows and OS X using BitNami Redmine Stack]]