Configuring Qpid Management Console
Qpid has a JMX management interface that exposes a number of components of the running broker.
You can find out more about the features exposed by the JMX interfaces here.
Connection Configuration
The JMX connection can have an additional security enabled using additional Sun BCL classes. For full details see Management Console Security.
Note: If the additional security is enabled then the standard JConsole will be unable to connect to the Qpid Broker.
Using Eclipse RCP
Installing the Qpid Management Console
- Unzip the archive to a suitable location.
- Set the environment variable QPIDMC_HOME to installation dir.
Running the Qpid Management Console
For running on windows there are two options:
- qpidmc.bat (CMD)
- qpidmc.sh (Cygwin)
For running on unix, use the scritps for particular windowing system:
qpidmc_<windowing system>.sh (eg. qpidmc_motif.sh)
Using the Qpid Management Console
Please see User Guide for using this Eclipse RCP. The guide contains some of the screenshots of Qpid Management Console and an description of what the features are.
Using JConsole
JConsole is a management tool that comes with the Java Runtime Environment and provides a very simple view of managed beans. It requires no special configuration to be used with QPID.
To attach to a running broker simply enter the host and port details on the JConsole connect dialog. The port should be the same as the one specified in the system property com.sun.management.jmxremote.port
.
Once you are connected expand the tree nodes marked "org.apache".
Please see attachment for some of the screenshots of using jconsole for Qpid.
Using HermesJMS
HermesJMS also offers integration with the Qpid management interfaces. You can get instructions and more information from http://wiki.apache.org/qpid/HermesJMS.
Using MC4J
MC4J is an alternative management tool. It provide a richer "dashboard" that can customise the raw MBeans.
Installation
- First download and install MC4J for your platform. Version 1.2 beta 9 is the latest version that has been tested.
- Copy the directory
blaze/java/management/mc4j
into the directory<MC4J-Installation>/dashboards
Configuration
You should create a connection the JVM to be managed. Using the Management->Create Server Connection
menu option. The connection URL should be of the form: service:jmx:rmi:///jndi/rmi://localhost:8999/jmxrmi
making the appropriate host and post changes.
Operation
You can view tabular summaries of the queues, exchanges and connections using the Global Dashboards->QPID tree view. To drill down on individual beans you can right click on the bean. This will show any available graphs too.