Installing on Mac OSX

This page is OBSOLETE. New version can be found 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 X11 from Apple in order to get NorfelloCMMS working. You can download it from here, but it is advised that Tiger users install it from the distribution DVD.

2. Installing Ruby on Rails

As NorfelloCMMS is built with 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 RMagick bundle.

Download Locomotive RMagick bundle

After installing Locomotive, proceed to 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

Dan Benjamin has written a great tutorial about installing Rails, LightTPD (a web server) and MySQL (a database):

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 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 Configuring NorfelloCMMS.

© 2004-2007 Norfello Oy All Rights Reserved