Getting Started with the Java Dynamic Management Kit 4.2

Preface

The Java Dynamic Management^TM Kit provides a set of Java^TM classes and tools for developing management solutions. This product conforms to the Java Management extensions (JMX^TM), v1.0 Final Release, which defines a three-level architecture: resource instrumentation, dynamic agents and remote management applications. The JMX architecture is applicable to network management, remote system maintenance, application provisioning, and the new management needs of the service-based network.

This Getting Started with the Java Dynamic Management Kit 4.2 Guide presents the architecture of the Java Dynamic Management Kit, introducing the key components of the product and the development process for management applications.

Who Should Use This Book

This book is aimed at anyone seeking an introduction to the concepts and components of the Java Dynamic Management Kit.

Familiarity with Java programming and the JavaBeans^TM component model is assumed. Familiarity with the JMX specification is also recommended.

This book is not intended to be an exhaustive reference: management tutorials intended to demonstrate each of the management levels and how they interact are covered in Java Dynamic Management Kit 4.2 Tutorial, and the complete Javadoc^TM API definitions are provided in the product's online documentation package.

How This Book Is Organized

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

After You Read This Book

In order to build and run the sample programs or use the tool commands provided in the Java Dynamic Management Kit 4.2, you must have a complete installation of the product on your machine. Please refer to the Java Dynamic Management Kit 4.2 Installation Guide and Release Notes document for instructions on how to install the product components and configure your environment.

After familiarizing yourself with the concepts of the Java Dynamic Management Kit, you should familiarize yourself with the tools for developing management applications. Then, through the lessons of the tutorial, you will learn how to instrument new or existing resources, write intelligent agent applications and access them from remote managers written in the Java programming language. You are then ready to design and develop your own Java Dynamic Management solution.

The following books are part of the product documentation set:

Java Dynamic Management Kit 4.2 Tools Reference
Java Dynamic Management Kit 4.2 Tutorial

These books are available online after you have installed the documentation package of the Java Dynamic Management Kit 4.2. The online documentation also includes the Javadoc API for the Java packages and classes, including those of the Java Management extensions. Using any web browser, open the homepage corresponding to your platform:

Operating Environment	Homepage Location
Solaris	`installDir/SUNWjdmk/jdmk4.2/JDKversion/index.html`
Windows NT	`installDir\SUNWjdmk\jdmk4.2\JDKversion\index.html`

In these file names, installDir refers to the base directory of your Java Dynamic Management Kit installation. In a default installation procedure, installDir is:

/opt on the Solaris platform
C:\Program Files on the Windows NT platform

The JDKversion is that of the Java Development Kit (JDK^TM) which you use and which you selected during installation. Its value can be either 1.1 or 1.2, when used in a directory, filename, or path.

These conventions are used throughout this book whenever referring to files or directories which are part of the installation.

Related Books

The Java Dynamic Management Kit relies on the management architecture of the Java Management extensions. The specification document, Java Management Extensions Instrumentation and Agent Specification, v1.0 (Final Release, July 2000), is provided in the product documentation package, under the filename jmx_instr_agent.pdf.

Ordering Sun Documents

Fatbrain.com, an Internet professional bookstore, stocks select product documentation from Sun Microsystems, Inc.

For a list of documents and how to order them, visit the Sun Documentation Center on Fatbrain.com at http://www1.fatbrain.com/documentation/sun.

Accessing Sun Documentation Online

The docs.sun.com^SM 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.

Typographic Conventions

The following table describes the typographic changes used in this book.

Table P-1 Typographic Conventions


Typeface or Symbol	Meaning	Example
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.
`AaBbCc123`	Class or object names, methods, parameters or any other element of the Java programming language	Instantiate the `MyBean` class.
`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`.

Shell Prompts

The following table shows the default system prompts for the different platforms and shells.

Table P-2 Shell Prompts


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	`#`
Windows NT system prompt	`C:\`

Unless otherwise noted, the command examples in this book use the Korn shell prompt.