= Installing on Mac OSX =

'''This page is OBSOLETE. New version can be found [http://www.norfello.com/products/norfello-cmms-os/documentation/ here].'''

These instructions are written for OSX version 10.4 (Tiger). If you're running a remarkably older version you might want to consider following these instructions.

== 1. Install X11 ==

You will need [http://www.apple.com/downloads/macosx/apple/x11formacosx.html X11 from Apple] in order to get NorfelloCMMS working. You can download it from [http://www.apple.com/downloads/macosx/apple/x11formacosx.html here], but it is advised that Tiger users install it from the distribution DVD.

== 2. Installing Ruby on Rails ==

As NorfelloCMMS is built with [http://www.rubyonrails.com Ruby on Rails] framework, you'll need Ruby installed on your system. The good news is that OSX Tiger is shipped with Ruby, the bad news is that it ships with a broken version. To get a working version, you have two options:

=== 2.1 The easy way ===

Locomotive is a pre-packaged Ruby on Rails, that includes Rails, all the needed depencies and a graphical interface for controlling Rails applications. When downloading Locomotive, you should choose the [http://locomotive.raaum.org/bundles.html RMagick bundle].

[http://locomotive.raaum.org/bundles.html Download Locomotive RMagick bundle]

After installing Locomotive, proceed to [wiki:ConfiguringNorfelloCmms Configuring NorfelloCMMS].

=== 2.2. The harder way ===

The other possibility is to build and install the needed applications separately by hand. While it's more technically demanding and time consuming, the result is a stand-alone, system-independent plantform to run NorfelloCMMS.

=== Installing Ruby, Rails, LightTPD and MySQL ===

[http://hivelogic.com Dan Benjamin] has written a great tutorial about installing Rails, LightTPD (a web server) and MySQL (a database):

[http://hivelogic.com/articles/2005/12/01/ruby_rails_lighttpd_mysql_tiger Dan Benjamin's tutorial on "Building Ruby, Rails, LightTPD, and MySQL on Tiger"]

=== Installing depencies ===

After completing the tutorial, we still need to install few Rails depencies in order to get NorfelloCMMS fully working. In Terminal, type the following:

{{{
gem install -y redcloth gettext rubyzip
}}}

Next, you need to download the [http://rubyforge.org/frs/?group_id=12&release_id=6477 Rmagick binary gem] (at time of writing version 1.14.0) and install it. Continue with Terminal in the working directory you created in the tutorial:

{{{
curl -O http://rubyforge.org/frs/download.php/13490/rmagick-1.14.0.gem
gem install rmagick --local
}}}

You should see:

{{{
Successfully installed rmagick, version 1.14.0
}}}

After this you are ready to proceed to [wiki:ConfiguringNorfelloCmms Configuring NorfelloCMMS].