JBoss

Monitoring JBoss

You cannot manage a JBoss server on the same machine as the Hyperic Server.

JBoss 4.2 and later must run under Java 1.5 or later for Hyperic to be able to manage it.

The Hyperic Agent can usually discover the location of Jboss. If the agent fails to discover a JBoss server, the following error occurs when you configure the server in Hyperic:

 
Invalid configuration: Plugin error: Plugin class not found:javax/management/MBeanException 
(invalid classpath or corrupt plugin jar) 

If the error occurs:

  1. Add the jboss.installpath property to the agent.properties file for the agent. For usage, see jboss.installpath.

  2. Restart the Hyperic Agent.

JBoss Configuration Tracking

In Hyperic 4.6.5, the JBoss plugin uses a new plugin support class —-- org.hyperic.hq.product.FileChangeTrackPlugin --— that enables more detailed change tracking than available in previous versions of Hyperic. This plugin tracks the change type ("add", "delete", "modify", or "rename") and the actual changes in text files. For information about the new support class, see FileChangeTrackPlugin.

For JBoss, the default value of the Configuration Files field, which specifies which files to track is:

server/all/conf;true;.*\.xml|.*\.cfg|.*\.properties|.*\.ini|.*\.conf|.*\.config;,
server/default/conf;true;.*\.xml|.*\.cfg|.*\.properties|.*\.ini|.*\.conf|
.*\.config;,server/default/deploy;true;.*\.jar|.*\.dll|.*\.class|.*\.jsp|.*\.asp|
.*\.aspx|.*\.php|.*\.pl|.*\.vb|.*\.vbs|.*\.js|.*\.py|.*\.pyc|.*\.cgi|.*\.xml|.*\.cfg|
.*\.properties|.*\.ini|.*\.conf|.*\.config;,server/minimal/conf;true;.*\.xml|.*\.cfg|
.*\.properties|.*\.ini|.*\.conf|.*\.config;,server/standard/conf;true;.*\.xml|
.*\.cfg|.*\.properties|.*\.ini|.*\.conf|.*\.config;,server/web/conf;true;.*\.xml|
.*\.cfg|.*\.properties|.*\.ini|.*\.conf|.*\.config;,;false;jar-versions.xml;,
configuration/;false;.*\.xml|.*\.properties

When configuration tracking is enabled, this filter causes Hyperic to track files:

  • In any directory in the JBossHome/server/all/conf directory and any directories below it, files with the following extensions: .xml, .cfg, .properties, .ini, .conf, .config

  • In any directory in the JBossHome/server/default/conf directory and any directories below it, files with the following extensions: .xml, .cfg, .properties, .ini, .conf, .config

  • In any directory in the JBossHome/server/default/deploy directory and any directories below it, files with the following extensions: .jar, .dll, .class, .jsp, .asp. .aspx, .php, .pl, .vb, .vbs, .js, .py, .pyc, .cgi, .xml, .cfg, .properties, .ini, .conf, .config

  • In any directory in the JBossHome/server/minimal/conf directory and any directories below it, files with the following extensions: .xml, .cfg, .properties, .ini, .conf, .config

  • In any directory in the JBossHome/server/standard/conf directory and any directories below it, files with the following extensions: .xml, .cfg, .properties, .ini, .conf, .config

  • In any directory in the JBossHome/server/web/conf directory and any directories below it, files with the following extensions: .xml, .cfg, .properties, .ini, .conf, .config

  • In the JBossHome directory, the file jar-versions.xml

  • In the JBossHome/configuration/ directory, files with the following extensions: .xml, .properties;

Configuration tracking for Jboss is disabled by default. For information about how to enable configuration tracking and how to specify which files to track, see Set Up Configuration Tracking for a Resource in vFabric Hyperic Administration.

JBoss Metrics