Getting Started with the Java Dynamic Management Kit 5.0

Preface

The Java^TM Dynamic Management Kit (DMK) 5.0 provides a set of Java classes and tools for developing management solutions. This product conforms to the Java Management Extensions (the JMX^TM Specification), v1.1 Maintenance Release, which defines a three-level architecture:

Resource instrumentation
Dynamic agents
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.

The Getting Started with the Java Dynamic Management Kit 5.0 guide presents the architecture of the Java DMK 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 DMK.

You should be familiar with Java programming and the JavaBeans^TM component model. You should also be familiar with the JMX specification and the simple network management protocol (SNMP).

This book is not intended to be an exhaustive reference. Management tutorials demonstrating each of the management levels and how they interact are covered in the Java Dynamic Management Kit 5.0 Tutorial. The complete Javadoc^TM API definitions are provided in the online documentation package.

How This Book Is Organized

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

Chapter 1, Java Dynamic Management Kit Overview“ Java Dynamic Management Kit Overview”
Chapter 2, Architectural Components“Architectural Components ”
Chapter 3, Development Process“The Development Process”

Before You Read This Book

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

After familiarizing yourself with 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.0 Tutorial, you will 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.

Related Documentation

The following books are part of the product documentation set:

Table P–1 Related Documentation


Book Title	Part Number
Java Dynamic Management Kit 5.0 Tools Reference	816–4177–10
Java Dynamic Management Kit 5.0 Tutorial	816–4178–10
Java Dynamic Management Kit 5.0 Installation Guide	816–4179–10

These books are available online after you have installed the Java DMK documentation package. The online documentation also includes the Javadoc API for the Java packages and classes, including those of the JMX specification. To access the online documentation, using any web browser, open the home page corresponding to your platform:

Operating Environment	Homepage Location
Solaris	`installDir/SUNWjdmk/jdmk5.0/index.html`
Windows 2000	`installDir\SUNWjdmk\jdmk5.0\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:

/opt on the Solaris platform
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 the JMX specification. The specification document, Java Management Extensions Instrumentation and Agent Specification, v1.1 (Maintenance Release, March 2002), is provided in the product documentation package, under the file name jmx_instr_agent.pdf.

Accessing Sun Documentation

You can view and print a broad selection of Sun^TM documentation, including localized versions, at:

http://www.sun.com/documentation/

You can also purchase printed copies of select Sun documentation from iUniverse, the Sun documentation provider, at:

http://corppub.iuniverse.com/marketplace/sun/

Typographic Conventions

The following table describes the typographic changes 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	`#`