Index of /java/openDMK

 Name                    Last modified      Size  Description
 Parent Directory                             -   
 api/                    2013-06-02 16:19    -   
 README.html             2013-06-02 18:06  9.4K  
 wp_jdmk40.pdf           2013-06-02 17:47  100K  Adobe Portable Document Format
 JDMK51TOOLS.pdf         2013-06-02 18:23  477K  Adobe Portable Document Format
 JDMK51START.pdf         2013-06-02 18:23  622K  Adobe Portable Document Format
 JDMK51TUTOR.pdf         2013-06-02 18:24  1.8M  Adobe Portable Document Format

Project OpenDMK README

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

Build opendmk-1.0-b02

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>

in a terminal window.

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:

Download the Project OpenDMK source bundle zip file from http://opendmk.java.net/, and expand it into a working directory.
Then download the Project OpenDMK self extractible binary plug jar file from http://opendmk.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.
Navigate to the expanded OpenDMK-src source directory (where the build.xml file is located) and run the following commands:

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
Java DMK 5.1 Getting Started Guide
Java DMK 5.1 Tools Reference Guide
Java DMK 5.1 Tutorial

build opendmk-1.0-b02