Setting Up RM-Manage

To set up Fiveruns Manage on your Brightbox, do the following:

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

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

You should now see the following:

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.

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.

On your local computer, run the following commands:

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

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

In your Rails application directory:

fiveruns_manage /path/to/rails/app

Then add the Plugin to your SVN repository:

svn add vendor/plugins/fiveruns_manage
svn commit -m"adding fiveruns_manage" vendor/plugins/fiveruns_manage

and deploy your application.

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

ls shared/log/fiveruns

You should see a list of several .yml files:

311.info.yml fiveruns-manage.mongrel_ra.311.yml
319.info.yml fiveruns-manage.mongrel_ra.319.yml

You're done!

Enable the server metric modules:

sudo a2enmod info
sudo a2enmod status
sudo /etc/init.d/apache2 reload

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

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

Ensure that extended status is enabled:

ExtendedStatus On

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

CustomLog "/var/log/web/yourapp.log" combined