GW Agent for Tomcat

This page reviews the GroundWork JDMA for Tomcat.

Deploying GroundWork Agent for Tomcat

JDMA Software - All of the JDMA and associated files needed for installation are included with GroundWork Monitor 6.2 and later. They are stored in /usr/local/groundwork/apache2/htdocs/java-agents/, and may be downloaded via HTTP.

Prerequisites

The following should be installed and running:

Configuration Steps for Tomcat

1. Set up encryption [Optional]: GroundWork servers are set to receive NSCA messages unencrypted with XOR obfuscation by default. If you want to change this default, you can do so with the following procedure. Triple-DES is currently the only encryption method supported by the Java agent.

   Any other process that sends NSCA messages to this GroundWork server, such as GDMA or a child server, will be affected, and may also need to have its configuration adjusted.

   • On the GroundWork server, edit the file:

     /usr/local/groundwork/config/bronx.cfg

     Change the line:

     #listener_encryption_method=1

     to

     listener_encryption_method=3

   • Restart the Nagios process:

     /etc/init.d/groundwork restart nagios

2. Stop the Tomcat server if running. Add the following jmx and classpath settings in the <TOMCAT_INSTALL_DIRECTORY>/setclasspath.sh file after the copyright info:

   CLASSPATH="$CLASSPATH""$CATALINA_HOME"/conf
   CATALINA_OPTS="-Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=9012 -Dcom.sun.management.jmxremote.ssl=false -Dcom.sun.management.jmxremote.authenticate=false"

3. Download the file gwos-tomcat-monitoringAgent.war located on the GroundWork server in the folder /usr/local/groundwork/apache2/htdocs/java-agents/.
4. Copy the war file to the folder <TOMCAT_INSTALL_DIRECTORY>/server/default/deploy/.
5. On the GroundWork server, discover the tomcat host and add the tomcat services by importing the file service-profile-tomcat.xml. Commit the configuration in the GroundWork Monitor Configuration application
6. Start the Tomcat server. You should see the GWOS MBean Collector started successfully message in the file gwosCollector.log.

Exporting Profiles to the GroundWork Server

To monitor components for your environment you need to generate environment based custom configuration files. To generate the custom files;

1. Visit http://<tomcat server>:8080/gwos-tomcat-monitoringAgent/index.html, and select Start New Configuration.
2. Enter the Tomcat connection settings:
   • Make sure the nagios_encryption setting matches the listener_encryption_method and nagios_password setting matches the listener_password that you set in the bronx.cfg file.

     Only XOR and Triple-DES encryption are supported.

     Also, no encryption is supported.

3. Select the list of services from the discovered list (default components are preselected), then click Next.
4. Enter the GroundWork server name, username, password properties file path and click Export. The old gwos_properties file is backed up with the name gwos_tomcat.xml_old.backup. This exports the profiles to the GroundWork server.

   Currently agent does not support jmx password authentication or SSL.