The JavaTM Dynamic Management Kit (Java DMK) 5.1 provides a set of Java classes and tools for developing dynamic management solutions. This product conforms to the Java Management Extensions (JMX), v1.2 Maintenance Release, and the JMX Remote API, v1.0. These specifications define a three-level architecture:
Instrumentation of resources
Dynamic agents
Remote management applications
The JMX architecture is applicable to network management, remote system maintenance, application provisioning, and the management needs of the service-based network.
The Java Dynamic Management Kit 5.1 Tools Reference Guide presents the development tools provided with Java DMK. This book covers the following topics.
The mibgen tool for generating MBeans and relevant classes from SNMP MIBs.
The output of the HTML protocol adaptor.
Legacy proxygen tool for generating manager-side proxy objects.
Tracing and debugging mechanism.
These tools can help you to develop management solutions to suit your requirements.
This book is aimed at developers who want to use the tools provided with Java DMK 5.1.
You should be familiar with Java programming, the JavaBeansTM component model, and the latest versions of the JMX and JMX Remote API specifications.
This book is not intended to be an exhaustive reference. For more information about each of the management levels, see the Java Dynamic Management Kit 5.1 Tutorial, and the API documentation generated by the JavadocTM tool and included in the online documentation package.
To use the tool commands described in this book, you must have a complete installation of the Java Dynamic Management Kit 5.1 on your system. For information about hardware and software requirements, how to install the product components and how to configure your environment, see the Java Dynamic Management Kit 5.1 Installation README.
The Java DMK documentation set includes the following documents:
Book Title |
Part Number |
---|---|
Java Dynamic Management Kit 5.1 Installation README |
N/A |
816–7607 |
|
816–7609 |
|
816–7608 |
|
Java Dynamic Management Kit 5.1 Release Notes |
N/A |
These books are available online after you have installed the Java DMK documentation package. The online documentation also includes the API documentation generated by the Javadoc tool for the Java packages and classes. To access the online documentation, using any web browser, open the home page corresponding to your platform.
Operating Environment |
Homepage Location |
---|---|
Solaris / Linux / Windows 2000 |
installDir/SUNWjdmk/5.1/doc/index.html |
In these file names, installDir refers to the base directory or folder of your Java DMK installation. In a default installation procedure, installDir is as follows.
/opt on the Solaris or Linux platforms
C:\Program Files on the Windows 2000 platform
These conventions are used throughout this book whenever referring to files or directories that are part of the installation.
The Java Dynamic Management Kit relies on the management architecture of two Java Specification Requests (JSRs): the JMX specification (JSR 3) and the JMX Remote API specification (JSR 160). The specification documents and reference implementations of these JSRs are available at:
http://java.sun.com/products/JavaManagement/download.html
This book describes the development tools provided with the Java DMK 5.1and explains how to use them. It is divided into the following chapters:
Chapter 1, SNMP MIB Compiler (mibgen): “SNMP MIB Compiler (mibgen)”
Chapter 2, The HTML Protocol Adaptor: “HTML Protocol Adaptor”
Chapter 3, Legacy MBean Proxy Generator (proxygen): “Proxy MBean Compiler (proxygen)”
Chapter 4, Tracing Mechanism: “Tracing Mechanism”
The docs.sun.comSM Web site enables you to access Sun technical documentation online. You can browse the docs.sun.com archive or search for a specific book title or subject. The URL is http://www.oracle.com/technetwork/indexes/documentation/index.html.
Sun Microsystems offers select product documentation in print. For a list of documents and how to order them, see “Buy printed documentation” at http://www.oracle.com/technetwork/indexes/documentation/index.html.
The following table describes the typographic conventions used in this book.
Typeface or Symbol |
Meaning |
Example |
---|---|---|
AaBbCc123 |
The names of commands, files, and directories; on-screen computer output |
Edit your .login file. Use ls -a to list all files. machine_name% you have mail. |
AaBbCc123 |
What you type, contrasted with on-screen computer output |
machine-name% su Password: |
AaBbCc123 |
Command-line placeholder: replace with a real name or value |
To delete a file, type rm filename. |
AaBbCc123 |
Book titles, new words, or terms, or words to be emphasized. |
Read Chapter 6 in User's Guide. These are called class options. You must be root to do this. |
The following table shows the default system prompt and superuser prompt for the C shell, Bourne shell, and Korn shell.
Shell |
Prompt |
---|---|
C shell prompt |
machine-name% |
C shell superuser prompt |
machine-name# |
Bourne shell and Korn shell prompt |
$ |
Bourne shell and Korn shell superuser prompt |
# |