Project OpenDMK - Open Source Project for the Java^TM Dynamic Management Kit

Build opendmk-1.0-b01-ea

Description

Project OpenDMK is an open source release of version 5.1 of the Java Dynamic Management Kit (Java DMK). It is being distributed under the terms of the license present in the LEGAL_NOTICES folder.

This release of Project OpenDMK has the same features and code base as Java DMK version 5.1, with the exception of some legacy or deprecated APIs which have been removed.

Important Note: This first release doesn't contain the SNMP runtime, which has not yet been open sourced.

This release of Project OpenDMK does not have its own documentation set.

Moreover, this release is intended to run versions 5.0 and above of the Java SE platform.

Dependencies

An implementation of the JMX API 1.2 and the JMX Remote API 1.0, such as those included in version 5.0 or higher of the Java SE platform, is required.
This release is targetted at versions 5.0 or higher of the Java SE platform. However, it can also run on the JDK 1.4.x releases, with the addition of the necessary JMX API packages listed above.
If you wish to build Project OpenDMK sources, you will need either Apache Ant version 1.6.5 or higher, or alternatively, NetBeans IDE version 5.5 or higher.

Building Project OpenDMK Sources and API Documentation

The binary bundle of OpenDMK already contains all the OpenDMK Java archive (JAR) files and the API documentation. You can, however, build them yourself from the Project OpenDMK source bundle.

Download the Project OpenDMK source bundle from http://opendmk.dev.java.net/, and expand it into a working directory.
Then navigate to the expanded OpenDMK-src source directory (where the build.xml file is located) and run the following commands:

ant jars to build the jar files in the dist/lib directory

ant javadoc to build the Project OpenDMK API documentation in the dist/docs/api directory

The OpenDMK-src source directory can also be loaded directly in the NetBeans^TM IDE as a NetBeans project.

Linking Your Application With Project OpenDMK

You will need to add the following Project OpenDMK JAR files to your classpath, depending on what you want to do:

To run an agent, add jdmkrt.jar.
To open a JMX Connector or JMX Connector Server using the JMXMP protocol: add jmxremote_optional.jar.

Runtime: Choosing an `MBeanServerBuilder`

The factory used to create MBean server objects is javax.management.MBeanServerFactory. By default, this factory uses javax.management.MBeanServerBuilder which creates MBeanServer instances from the Java platform's JMX 1.2 implementation.

The Project OpenDMK provides a custom builder com.sun.jdmk.JdmkMBeanServerBuilder which creates OpenDMK MBeanServer instances. You only need to use these if you want to plug interceptors into your MBean server.

To set the Project OpenDMK MBeanServerBuilder as the default initial builder, add the following option to the java command when you run it:
-Djavax.management.builder.initial=com.sun.jdmk.JdmkMBeanServerBuilder

For more details, see the API specification of the com.sun.jdmk.JdmkMBeanServerBuilder, javax.management.MBeanServerBuilder and javax.management.MBeanServerFactory classes.

Additional Documentation

You can refer to the following documents:

Project OpenDMK API documentation (if you have downloaded the source bundle, you may first need to generate the API documentation)
Java DMK 5.1 documentation set

build opendmk-1.0-b01-ea

Project OpenDMK - Open Source Project for the JavaTM Dynamic Management Kit