Java Dynamic Management Kit 5.1 Getting Started Guide

Preface

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:

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 Getting Started Guide presents the architecture of the Java DMK, introducing the key components of the product and the development process for management applications.

Changes Between Versions 5.0 and 5.1 of Java DMK

The following are the main changes and additions to Java DMK since the 5.0 release:

Who Should Use This Book

This book is aimed at anyone who requires an introduction to the concepts and components of Java DMK.

You should be familiar with Java programming and the JavaBeansTM component model. You should also be familiar with the JMX specification, the JMX Remote API specification, and the Simple Network Management Protocol (SNMP).

This book is not intended to be an exhaustive reference. For more information about each of the management levels and how they interact, 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.

After understanding of the concepts of the Java DMK, you should familiarize yourself with the tools for developing management applications. Then, through the lessons of the Java Dynamic Management Kit 5.1 Tutorial, learn how to instrument new or existing resources, write intelligent agent applications, and access these applications from remote managers written in the Java programming language. You can then design and develop your own Java dynamic management solution.

How This Book Is Organized

This book explains the key concepts of Java DMK, introduces the main components of the product, provides an overview of the development process and outlines the tools you need to use Java DMK. It is divided into the following chapters:

Before You Read This Book

To build and run the sample programs or use the tool commands provided in Java DMK, you must have a complete installation of the product on your machine. Refer to the Java Dynamic Management Kit 5.1 Installation README for instructions on how to install the product components and configure your environment.

Related Documentation

The Java DMK documentation set includes the following documents:

Book Title 

Part Number 

Java Dynamic Management Kit 5.1 Installation README

N/A 

Java Dynamic Management Kit 5.1 Getting Started Guide

816–7607 

Java Dynamic Management Kit 5.1 Tutorial

816–7609 

Java Dynamic Management Kit 5.1 Tools Reference Guide

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.

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

Accessing Sun Documentation Online

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.

Ordering Sun Documentation

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.

Typographic Conventions

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.

Shell Prompts in Command Examples

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 

#