Skip navigation links
17.4.6.4 Deployment in a standard JMX Agent environment (JBoss) »
Section Navigation      [Toggle]

17.4.6.3. Running within a JMX Agent (custom)

As a JMX MBean, MySQL Connector/MXJ requires a JMX v1.2 compliant MBean container, such as JBoss version 4. The MBean will uses the standard JMX management APIs to present (and allow the setting of) parameters which are appropriate for that platform.

If you are not using the SUN Reference implementation of the JMX libraries, you should skip this section. Or, if you are deploying to JBoss, you also may wish to skip to the next section.

We want to see the MysqldDynamicMBean in action inside of a JMX agent. In the com.mysql.management.jmx.sunri package is a custom JMX agent with two MBeans:

  1. The MysqldDynamicMBean, and

  2. A com.sun.jdmk.comm.HtmlAdaptorServer, which provides a web interface for manipulating the beans inside of a JMX agent.

When this very simple agent is started, it will allow a MySQL database to be started and stopped with a web browser.

  1. Complete the testing of the platform as above.

    • Current JDK, JUnit, Connector/J, MySQL Connector/MXJ

    • This section requires the SUN reference implementation of JMX

    • PATH, JAVA_HOME, ANT_HOME, CLASSPATH

  2. If not building from source, skip to next step

    Rebuild with the "sunri.present" 

    ant -Dsunri.present=true dist
re-run tests:
java junit.textui.TestRunner com.mysql.management.AllTestsSuite

  3. Launch the test agent from the command line: 

    java com.mysql.management.jmx.sunri.MysqldTestAgentSunHtmlAdaptor &

  4. From a browser: 

    http://localhost:9092/

  5. Under MysqldAgent, 

    select "name=mysqld"

  6. Observe the MBean View

  7. Scroll to the bottom of the screen press the startMysqld button

  8. Click Back to MBean View

  9. Scroll to the bottom of the screen press stopMysqld button

  10. Kill the java process running the Test Agent (jmx server)