====== Setting Up RM-Manage ======
To set up Fiveruns Manage on your Brightbox, do the following:
<code>
sudo wget http://manage.fiveruns.com/system/downloads/client/manage-installer-linux-ubuntu-32bit-intel.sh
sudo sh manage-installer-linux-ubuntu-32bit-intel.sh
</code>

It asks for a location - just hit enter to leave this as the default.

You should now see the following:

<code>
Thanks for using FiveRuns Manage!

error code: 0
FiveRuns Manage: this client is now registered with the service.
Adding system startup for /etc/init.d/fiveruns_manage ...
/etc/rc0.d/K20fiveruns_manage -> ../init.d/fiveruns_manage
/etc/rc1.d/K20fiveruns_manage -> ../init.d/fiveruns_manage
/etc/rc6.d/K20fiveruns_manage -> ../init.d/fiveruns_manage
/etc/rc2.d/S20fiveruns_manage -> ../init.d/fiveruns_manage
/etc/rc3.d/S20fiveruns_manage -> ../init.d/fiveruns_manage
/etc/rc4.d/S20fiveruns_manage -> ../init.d/fiveruns_manage
/etc/rc5.d/S20fiveruns_manage -> ../init.d/fiveruns_manage
Starting FiveRuns Manage Client: fiveruns_manage.
FiveRuns Manage: this client is now running and reporting to the service
FiveRuns Manage client installation successful.
</code>

Then go to the Fiveruns website via the confirmation link in your email:

https://manage.fiveruns.com

You will need your Fiveruns username and password.

Follow the instructions to setup the services you wish to monitor.

===== Install the FiveRuns Gem =====

On your local computer, run the following commands:

<code>sudo gem install fiveruns_manage --source http://gems.fiveruns.com</code>

(More details here: https://help.fiveruns.com/manage/subsystem-configurations/rails-configuration/)

===== Install the plugin into your Rails applications =====

In your Rails application directory:

<code>fiveruns_manage /path/to/rails/app</code>

Then add the Plugin to your SVN repository:

<code>
svn add vendor/plugins/fiveruns_manage
svn commit -m"adding fiveruns_manage" vendor/plugins/fiveruns_manage
</code>

and deploy your application.


===== Check everything is working =====

To verify everything is working, log into your server via ssh, and run:

<code>ls shared/log/fiveruns</code>

You should see a list of several ''.yml'' files:

<code>311.info.yml fiveruns-manage.mongrel_ra.311.yml
319.info.yml fiveruns-manage.mongrel_ra.319.yml</code>

You're done!

===== Editing Apache =====

Enable the server metric modules:

<code>
sudo a2enmod info
sudo a2enmod status
sudo /etc/init.d/apache2 reload
</code>

Then configure the modules to provide the information RM-Manage needs.  Edit your ''/etc/apache2/httpd.conf'' to add:

<code apache>
<Location /server-status>
     SetHandler server-status
     order deny,allow
     deny from all
     allow from 127.0.0.1
</Location>

<Location /server-info>
     SetHandler server-info
     order deny,allow
     deny from all
     allow from 127.0.0.1
</Location>
</code>

Ensure that extended status is enabled:

<code apache>
ExtendedStatus On
</code>

Ensure that Logging is done using ''combined'' log formats (this this is the default with the Brightbox GEM):

<code apache>
CustomLog "/var/log/web/yourapp.log" combined
</code>