{section}
{column}

h1. Introduction

Cacti is a complete monitoring and graphing tool to present historical data coming from monitoring probes.


[Get more details about Cacti.|http://www.cacti.net/]

h1. Installation


h2. Cacti installation

The Cacti integration was experienced on a Linux distribution "Ubuntu Maverick Meerkat (10.10)".

Cacti is available through the default Ubuntu repository. So, just install the package "cacti" using the standard way.

h2. Enabling the SNMP agents of the Petals ESB JVMs

As the Cacti integration will use SNMP probes to get information from the JVM running Petals ESB, we need to enable the SNMP agent of the JVM of each Petals ESB node.

Waiting a better manner to enable the SNMP agent, on each Petals node, add the following system properties on the java command line of the script starting Petals ESB:

{code}
-Dcom.sun.management.snmp.port=16161 -Dcom.sun.management.snmp.acl.file=$PETALS_HOME/conf/snmp.acl
{code}where:
* com.sun.management.snmp.port defines the listen port of the SNMP agent.{note} Caution, if Petals ESB runs with a user different from root, you need to use a port upper than 1024. To use a port lower than 1024 with a Petals ESB launches with a standard user, refers to the utility *privbind* (available in standard Ubuntu repository).{note}{note}To use the same port on the same machine for several java processes, refers to snmpd used as proxy.
{note}

* com.sun.management.snmp.acl defines the path file defining ACL of the SNMP agent. It is recommended to create a specific file from $JAVA_HOME/jre/lib/management/snmp.acl where you can configure for example the following ACL entry:

{code}
acl = {
 {
   communities = public, private
   access = read-only
   managers = localhost
 }
}

{column}
{column:width=350px}
{panel:title=Table of contents}{toc}{panel}
{panel:title=Contributors}{contributors:order=name|mode=list}{panel}
{column}
{section}