GW Agent for JBoss

This page reviews the GroundWork JDMA for JBoss.

Deploying GroundWork Agent for JBoss

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.


The following should be installed and running:

JBoss 4.2.3GA, 5.1GA
GroundWork Monitor 6.2.x or later
Configuration Steps for JBoss
  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:


    • Restart the Nagios process:
      /etc/init.d/groundwork restart nagios
  2. Stop the JBoss server if running and add the following line in the <JBOSS_INSTALL_DIRECTORY>/bin/ file before the # Display our environment comment:
  3. Download the file gwos-jboss-monitoringAgent.war located on the GroundWork server in the folder:
  4. Copy the war file to the folder:
  5. On the GroundWork server, discover the JBoss host and add the JBoss services by importing service-profile-jboss.xml, then Commit the configuration in the Configuration application.
  6. Start the JBoss 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://<jboss server>:8080/gwos-jboss-monitoringAgent/index.html, and select Start New Configuration.
  2. Enter the JBoss 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_jboss.xml_old.backup. This exports the profiles to the GroundWork server.
    Currently agent does not support jmx password authentication or SSL.

Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.