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

Description

Project OpenDMK is an open source release of version 5.1 of the Java Dynamic Management Kit (Java DMK).

The majority of Project OpenDMK code is being distributed under the terms of the license present in the LEGAL_NOTICES folder. Some binary components listed on the Project OpenDMK download page are covered under the Binary License for Project OpenDMK, and must be downloaded separetely from the Project OpenDMK download page.
Note that the Full Binary Bundle also incorporates classes from the Project OpenDMK binary plug and is therefore submitted to the terms of the Project OpenDMK binary license.

The binary components are contained in self extracting jar files. To expand a self extracting jar file simply type

    java -jar <self-extracting.jar>

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.

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

• Java^TM Management Extensions (JMX^TM) Technology:
  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.

How to build the sources:

1. Download the Project OpenDMK source bundle zip file from http://opendmk.dev.java.net/, and expand it into a working directory.

2. Then download the Project OpenDMK self extractible binary plug jar file from http://opendmk.dev.java.net/, and expand it into the OpenDMK-src directory by typing

   java -jar <downloaded-binary-plug.jar>

   in a terminal window. You should now have a directory named opendmk-binary-plug in the OpenDMK-src directory.

3. Navigate to the expanded OpenDMK-src source directory (where the build.xml file is located) and run the following commands:

   ant jar 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

• 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 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

• 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