1. Configuring NorfelloCMMS

This page is OBSOLETE. New version can be found here.

Now you have everything that's needed to configure and run NorfelloCMMS.

1.1 Download and install NorfelloCMMS

Check out the latest version of NorfelloCMMS from the SubversionRepository or download it from BetaReleases and place it in the /opt/ directory or if you are using Windows C:\cmms\.

1.2 Create the database

Create a new database for NorfelloCMMS. You can do this using the command line MySQL client like this:

user@server:~$ mysql -uroot
Welcome to the MySQL monitor.  Commands end with ; or \g.
Your MySQL connection id is 179 to server version: 5.0.22-Debian_0ubuntu6.06-log
Type 'help;' or '\h' for help. Type '\c' to clear the buffer.

mysql> CREATE DATABASE norfello_cmms default character set utf8 collate utf8_swedish_ci;
Query OK, 1 row affected (0.09 sec)

mysql> GRANT ALL ON norfello_cmms.* TO norfello_cmms@localhost IDENTIFIED BY "<enter the password here>";
Query OK, 0 rows affected (0.30 sec)

If you are using Windows the command line utility should be found under C:\Program Files\Mysql\5.0\bin\

Most probably you have given a password for user "root" so give it a -p parameter like this

mysql -uroot -p

Edit the file <cmms_directory>/config/database.yml to match the database name, username and password that you used when creating the database:

production:
  adapter: mysql
  database: norfello_cmms
  encoding: utf8
  username: norfello_cmms
  password: <enter the password here>
  host: localhost

1.3 Initialize the database

Finally, you'll need to initialize the database:

RAILS_ENV=production rake migrate

If you are running Windows:

SET RAILS_ENV=production
rake migrate

1.4 Start the web server

Now you're all set to run NorfelloCMMS! You should be able to use NorfelloCMMS by going to http://<server name or ip address>:3000 once you have started the web server:

ruby /opt/<cmms_directory>/script/server -e production

Windows:

ruby C:\cmms\<cmms_directory>\script\server -e production

There are two default user accounts in NorfelloCMMS, one with username and password "admin" and one with username and password "user". User "admin" has adminstrative rights to the system and "user"'s rights are more limited.