Enabling the SNMP agent of a Petals ESB JVM

compared with
Key
This line was removed.
This word was removed. This word was added.
This line was added.

Changes (9)

View Page History
As the monitoring tools can 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. On each Petals node, in the [environment configuration|Container Configuration#EnvironmentConf] file, uncomment the system properties relative to the SNMP agent:

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:

# Uncomment following lines to enable SNMP agent of the JVM
#PETALS_JAVA_OPTS="$PETALS_JAVA_OPTS -Dcom.sun.management.snmp.port=16161"
#PETALS_JAVA_OPTS="$PETALS_JAVA_OPTS -Dcom.sun.management.snmp.interface=0.0.0.0"
#PETALS_JAVA_OPTS="$PETALS_JAVA_OPTS -Dcom.sun.management.snmp.acl.file=/etc/petals-esb/default-snmp.acl"
{code}
acl = {
{
communities = public, private
access = read-only
managers = localhost
}
}
{code}
{note}Caution, this file should be accessible (read and write: 'chmod 600 xxx') only by the user running the JVM process.{note}
{info}[Get more information on enabling SNMP into a JVM|http://download.oracle.com/javase/1.5.0/docs/guide/management/SNMP.html] {info}{info}
Adjust your SNMP port, interface and ACL.
{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}

{note}Caution, the ACL file should be accessible (read and write: 'chmod 600 xxx') only by the user running the JVM process.{note}
{info}[Get more information on enabling SNMP into a JVM|http://download.oracle.com/javase/1.5.0/docs/guide/management/SNMP.html]{info}{info}[Get more information on the Java Virtual Machine MIB|http://download.oracle.com/javase/1.5.0/docs/guide/management/JVM-MANAGEMENT-MIB.mib]{info}



{info}