JMX Administration and Management

In addition to Universal Messaging's Administration API, a series of JMX beans enable monitoring and management via any JMX container. The following image illustrates a JConsole view running on Mac OSX:

In order to connect to Universal Messaging over the network using JConsole or another tool that supports JMX, you must first enable the realm configuration property EnableJMX. For information on setting this property, see the section Realm Configuration of the Enterprise Manager documentation.

Additionally, the following JVM system properties need to be added to the nserver.conf or Server_Common.conf file:

wrapper.java.additional.991=-Dcom.sun.management.jmxremote
wrapper.java.additional.992=-Dcom.sun.management.jmxremote.port=9010
wrapper.java.additional.994=-Dcom.sun.management.jmxremote.authenticate=false
wrapper.java.additional.995=-Dcom.sun.management.jmxremote.ssl=false

Note: nserver.conf is used if you start the realm server manually, e.g. from the command line. Server_Common.conf is used if you start the realm server as a Windows service or as a UNIX daemon.

The port can be freely chosen, as long as it is not already occupied (otherwise Universal Messaging will not start).

If you start JMX by passing JVM system properties that are different from the Universal Messaging configuration shown above, Universal Messaging will not be aware of this change and the Enterprise Manager will not show the proper URL.

Start JMC (Java Mission Control), or whatever tool is your favorite, and connect with the following JMX server URL:

If you wish to enable authentication or SSL, please consult the JMX documentation or contact our support team.

Universal Messaging offers the following JMX beans:

The Universal Messaging Realm Status JMX bean enables access to data visible in the Enterprise Manager Realm Status view. The following image illustrates how the JMX bean looks when accessed via JConsole on Mac OSX:

The Universal Messaging Realm Cluster JMX bean enables access to data visible in the Enterprise Manager Cluster Status view. The following image illustrates how the JMX bean looks when accessed via JConsole on Mac OSX:

The Universal Messaging Realm Configuration JMX bean enables access to data visible in the Enterprise Manager Realm Configuration view. The following image illustrates how the JMX bean looks when accessed via JConsole on Mac OSX:

The Universal Messaging Realm Interfaces JMX bean enables access to data visible in the Enterprise Manager Realm Interfaces view. The following image illustrates how the JMX bean looks when accessed via JConsole on Mac OSX:

The Universal Messaging Channel JMX bean enables access to data visible in the Enterprise Manager Channel Statu view. The following image illustrates how the JMX bean looks when accessed via JConsole on Mac OSX:

The Universal Messaging Queue JMX bean enables access to data visible in the Enterprise Manager Queue Status view. The following image illustrates how the JMX bean looks when accessed via JConsole on Mac OSX: