Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Configuring Qpid JMX 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.

Anchor
eclipsercp
eclipsercp

Using Eclipse RCP

Installing the Qpid JMX Management Console

  1. Unzip the archive to a suitable location.
Info
titleJMXMP based connections

In previous releases of Qpid (M4 and below) the broker JMX connections could make use of the JMXMPConnector for additional security over its default RMI based JMX configuration (For full details see Management Console Security).

...

This is no longer the case, with SSL encrypted RMI being the favored approach going forward.

If you do not wish to connect to a JMXMP enabled broker then the following step is not required. If you do wish to connect to a broker configured to use JMXMP, then the console requires provision of the Optional sections of the JMX Remote API that are not included within the JavaSE platform, as with the broker.

In order to make it available to the console, place the 'jmxremote_optional.jar' (rename the file if any additional information is present in the file name) jar file within the 'plugins/jmxremote.sasl_1.0.1/' folder of the console release (on Mac OS X you will need to select 'Show package contents' from the context menu whilst selecting the management console bundle in order to reveal the inner file tree).

Running the Qpid JMX 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)

...

The console can be started in the following way, depending on platform:

  • Windows: by running the 'qpidmc.exe' executable file.
  • Linux: by running the 'qpidmc' executable.
  • Mac OS X: by launching the consoles application bundle (.app file).

Using the Qpid JMX Management Console

Please see User Guide for using this Eclipse RCP application. The guide contains some screenshots of the screenshots of Qpid JMX Management Console and an description of what the features are.

...

JConsole is a management tool that comes with the Java Runtime Environment (6+) or Java Development Kit (5+) and provides a very simple view of managed beans. It requires no special configuration to be used with QPIDQpid.
You can run JConsole with the command 'jconsole' assuming you have Java installed and configured to be available in your PATH.

To attach to a running broker running broker simply enter the host, port, and port login details on in 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.qpid" to gain access to the Qpid related MBeans.

Please see attachment for some of the screenshots of using jconsole for Qpid.

...