Using a JMX Console With ServiceMix
This document explains how to connect a JMX Console to ServiceMix. Two open-source JMX Consoles will be discussed:
The servicemix JBIContainer exposes internal services and Components through JMX. The JBIContainer can be passed a JMXBeanServer or be configured to create one, if one doesn't exist. (see Configuration). If the JBIContainer creates its own MBeanServer instance, it also creates an RMI JMXConnector - to allow remote connections. The Ant Tasks use this:
String jndiPath = <container name> + "JMX"; JMXServiceURL url = new JMXServiceURL ("service:jmx:rmi:///jndi/rmi://<namingHost>:<namingPort>/" + jndiPath) ; JMXConnector connector = JMXConnectorFactory.connect(url);
The default namingPort is 1099
The default container name is defaultJBI
Default JMX Service URL
service:jmx:rmi:///jndi/rmi://localhost:1099/defaultJBIJMX
Using JConsole and Java 5
The Java-2 Platform, Standard Edition (J2SE) 5.0 release includes a JMX monitoring
tool, JConsole. JConsole monitors applications running on the Java platform and
provides information on their performance and resource consumption. Please see
Sun's documentation for more information:
http://java.sun.com/developer/technicalArticles/J2SE/jconsole.html
The JConsole executable can be found in the bin
directory of the J2SE
installation directory.
To use JConsole to monitor ServiceMix:
Note: ServiceMix should be running first!
You need to know the ServiceMix port number and the ServiceMix container id.
By default:
- the port is 1099
- Run jconsole from a command shell:
cd [J2SE_install_dir]\bin jconsole
- Click on the Advanced tab.
Enter the following in the Form:
JMX URL: service:jmx:rmi:///jndi/rmi://localhost:1099/defaultJBIJMX
Testing JConsole with ServiceMix
To see JConsole in action, start one of the ServiceMix examples running, for instance, the
Basic Example:
cd [servicemix_install_dir]\examples\basic ..\..\bin\servicemix servicemix.xml
Then run JConsole and
To enable JMX remoting with Java 5 on some platforms the JAVA_OPTS environment variable needs to be set first. There's no need to set this on OS X or Windows:
export JAVA_OPTS="-Dcom.sun.management.jmxremote.port=5001 -Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false"
Then run JConsole
jconsole
Go to the advanced tab and enter the JMX Service URL
then you should see all of the ServiceMix MBeans in the console.
Using MC4J
When you want to get at the ServiceMix MBeans using MC4J use JSR160 as your server connection type and the above default JMX Service URL as your server URL.
ServiceMix JMX Console
ServiceMix comes with a WAR which can be deployed, including ServiceMix inside any Servlet / J2EE application server in a standard deployment unit. The added benefit of the ServiceMix WAR is it includes a simple JMX operational console as well allowing your web browser to view JMX attributes and statistics.
To create the ServiceMix WAR from a fresh checkout of the code try this
cd servicemix/tooling/servicemix-web maven war
Then drop the WAR in any servlet engine.