22.8. Monitor JBoss Enterprise Application Platform 6 Applications Using Library Mode

22.8.1. Prerequisites

  • A correctly configured instance of JBoss Operations Network (JON) 3.1.x or better.
  • A running instance of JBoss Operations Network (JON) Agent on the server where the application will run. For more information, refer to Section 22.4.1, “About the JBoss Operations Network Agent”
  • An operational instance of the RHQ agent with a full JDK. Ensure that the agent has access to the tools.jar file from the JDK in particular. In the JBoss Operations Network (JON) agent's environment file (bin/rhq-env.sh), set the value of the RHQ_AGENT_JAVA_HOME property to a full JDK.
  • The RHQ agent must have been initiated using the same user as the JBoss Enterprise Application Server instance. As an example, running the JBoss Operations Network (JON) agent as a user with root priviledges and the JBoss Enterprise Application Platform process under a different user does not work as expected and should be avoided.
  • An installed JBoss Operations Network (JON) plugin for Library Mode. For more information, refer to Section 22.6.2, “Installing the JBoss Operations Network Plug-in (Library Mode)”
  • A custom application using JBoss Data Grid's Library mode. This application must have jmxStatistics enabled (either declaratively or programmatically). For more information, refer to Section 21.1.4, “Enable JMX for Cache Instances”
  • The Java Virtual Machine (JVM) must be configured to expose the JMX MBean Server. For the Oracle/Sun JDK, refer to http://docs.oracle.com/javase/1.5.0/docs/guide/management/agent.html
  • A correctly added and configured management user for JBoss Enterprise Application Platform.