General

What is JMX ?

JMX is for Java Management eXtension. It is an API dedicated to the management of server and can be connected in different ways through some adapters (SNMP for example). For more information, go here.

What can I do with this browser ?

This tool allows the developper and the administrator of a J2EE Server to control the J2EE Server via the JMX API.

How do I use it ?

If you want to use the Web-based version, deploy it into a J2EE Server. It must be a J2EE 1.3 compliant Application Server and must provide a JMX server inside it. See application servers FAQ for more details.

If you want to use the Swing-based version, the JMX implementation you want to connect must has a way to access it remotely (RMI, IIOP, etc). See applications servers/JMX implementations FAQ for more details.

Web Based JMX Browser on...

JBoss Server 3.x

It is pretty simple : put the jmx.browser.war file into the deploy directory. That's it.

If you want to use the Custom Views features, simply put the jmx.browser.sar file and your *.jmxml files into the deploy directory. That's it.

Apache Tomcat 4.1.x

There are two ways to do under Tomcat :

1. Put the jmx.browser.war file under the webapps directory of the Tomcat installation. Move the mx4j-jmx.jar file from the server/lib directory to the common/lib directory. This will make the JMX classes visible from a standard Web application.
2. Unwar the jmx.browser.war file under the server/webapps directory of the Tomcat installation. Create a privileged xml file under the webapps directory like the admin.xml one or the manager.xml one. The browser will run as a privileged Web application

WebLogic Server 7.0

Well, this server has not been tested, but feedback is welcomed.

Another application server

Well, feeback is welcomed if you don't see your favorite server here.

Web Based JMX Browser : issues

Why do I see sometimes in MBean detail "unloadable class" ?

That's mean the class returned by the MBean information cannot be loaded by the browser. As the browser runs on the server it is mostly due to misspelling in the class name.

Swing Based JMX Browser with...

JBoss Server 3.x

Make sure the RMI adaptor is deployed into the JBoss server (jmx-rmi-adaptor.sar into the deploy directory).

Copy the jbossall-client.jar (from JBOSS_HOME/client) and the jboss-jmx.jar (from JBOSS_HOME/lib) into the lib/ext directory of the JMX Browser and launch the browser.

If you are using a JDK1.3, copy the jnet.jar, jcert.jar and jsse.jar (from JBOSS_HOME/client) into the lib/ext directory of the JMX Browser and launch the browser.

WebLogic Server 7.0

This server has not been fully tested. The main issue is about notification reception : the JMX Browser doesn't implements a WebLogic interface needed to receive the notifications.

If you want to use it, copy the weblogic.jar (from BEA_HOME/weblogic700/server/lib) into the lib/ext directory of the JMX Browser and launch the browser.

MX4J 1.1.1

There are two ways to connect to a MX4J implementation :

1. With the JRMP connector (see here for more details about the setup of the mx4j implementation)
2. With the IIOP connector (see here for more details about the setup of the mx4j implementation)

Copy the mx4j-jmx.jar and mx4j-tools.jar (from MX4J distribution) into the lib/ext directory of the JMX Browser and launch the browser.

Pramati Server 3.0

This server has not been fully tested, and was put in stand by for license reasons.

Tivoli TMX4J 2.1

This implementation has not been fully tested, and was put in stand by for license reasons.

Sun JDMK 1.1

Well, this implementation has not been tested, but feedback is welcomed.

Another application server or JMX implementation.

Well, feeback is welcomed if you don't see your favorite server or your favorite JMX implementation here.

Swing Based JMX Browser : issues

When a MBean is unregistered, it doesn't disappear from the tree view ?

You have to refresh the server view to make it disappears.

What are the date format supported ?

There are five formats supported :

• "yyyy-MM-dd HH:mm:ss z"
• "yyyy-MM-dd HH:mm:ss"
• "yyyy-MM-dd HH:mm"
• "yyMMdd HH:mm:ss"
• "yyMMdd HH:mm"

If you need more formats, just fill a feature request.

How do I create an empty graph window ?

You can't create an empty graph window. A window is created when you want to graph a numerical value.

Can I plot numerical values from different servers in the same graph window ?

Yes, it's possible. The graph window doesn't know about one or several servers. The fact is that the JMX connection name does'nt appear in the numerical value plotted, so if you have two numerical values from two different server with the same name, you won't see any difference except the color.

How is choosed the color for a plotted numerical value ?

It is a simple color rotation. If you think it must be enhanced, post a feature request.