Preface

The Java^TM Dynamic Management^TM Kit provides a set of Java classes and tools that simplifies the development of dynamically extensible, smart agents. Such agents are applicable to network management, system management, application management, and service management. The Java Dynamic Management Kit Programming Guide presents the architecture of the Java Dynamic Management Kit and explains how to use the product for developing agents and applications to manage them.

Who Should Use This Book

This book is aimed at agent developers, who are likely to be experienced system programmers, with an understanding of network management concepts. Familiarity with Java programming and the JavaBeans^TM component model is assumed.

In a Solaris environment	installDir/SUNWconn/jaw/docs/locale/C/JDMKAPI/packages.html
In a Windows NT environment	installDir\SUNWconn\jaw\docs\locale\C\JDMKAPI\packages.html

How This Book Is Organized

Part I "Getting Started" introduces the Java Dynamic Management Kit and provides a tutorial example.

Chapter 1 "Introduction to the Java^TM Dynamic Management^TM Kit" explains the key concepts of the Java Dynamic Management Kit, introduces the main components of the product, and provides an overview of the development process.
Chapter 2 "Tutorial Example" provides a tutorial, based on simple programming examples.

Part II "Using Java Dynamic Management Kit Core Technology" describes how to use the parts of the product that all application developers will use.

Chapter 3 "Design Patterns for Developing M-Beans" describes the design patterns defined for the development of managed beans, or m-beans. These design patterns are derived from the Javabeans component model and enable you to write Java classes that can interact with the Java Dynamic Management Kit.
Chapter 4 "Operations on M-Beans" explains how to use the Java Dynamic Management Kit to perform operations on m-beans, such as instantiating or deleting them, and getting or setting their properties.
Chapter 5 "Adaptors" explains how to use adaptors to enable management applications to communicate with Java Dynamic Management agents.
Chapter 6 "C-Beans" describes the representation of an m-bean to a Java manager as a c-bean and explains how to use the mogen compiler for obtaining c-beans from m-beans.
Chapter 7 "Adaptor Clients" explains how to enable Java managers to communicate with Java Dynamic Management agents.

Part III "Problem Solving" explains how to use the tools provided for testing m-beans under development and how to solve commonly encountered problems using the Java Dynamic Management Kit.

Chapter 8 "Tools for Browsing M-Beans" explains how to use the tools provided by the Java Dynamic Management Kit to test an m-bean under development by instantiating it and by performing operations on the m-bean instance.
Chapter 9 "Troubleshooting" explains how to use the debug class provided by the Java Dynamic Management Kit and how to solve commonly encountered problems.

Part IV "Using the Supplied Services" describes how to use the services supplied by the Java Dynamic Management Kit to ease the development of agents.

Chapter 10 "Base Services - Customizing the Framework" explains how to customize the framework of the Java Dynamic Management Kit by selecting the implementation of the services that it requires.
Chapter 11 "Dynamic Loading Services" provides an overview of the services provided by the Java Dynamic Management Kit for loading classes and native libraries.
Chapter 12 "Class and Library Loading Service" explains how to use the services provided for obtaining classes and native libraries from a remote class server.
Chapter 13 "M-Let, Bootstrap and Launcher Services" explains how to use the services provided for obtaining classes and native libraries from a remote .jar file.
Chapter 14 "Event Handling, Alarm Clock, and Monitoring Services" explains how to use the services provided for observing changes to managed resources.
Chapter 15 "Cascading Agent Service" explains how to use the cascading agent service to implement a hierarchy of master agents and subagents.

Part V "Interoperating With SNMP" describes how to use the tools and APIs supplied by the Java Dynamic Management Kit to develop SNMP agents and managers. It contains:

Chapter 16 "The SNMP Toolkit" provides an overview of the tools provided by the Java Dynamic Management Kit to develop SNMP agents and managers.
Chapter 17 "The mibgen Compiler" explains how to use the mibgen compiler to implement SNMP MIBs for SNMP agents and managers.
Chapter 18 "Developing SNMP Agents With the Java Dynamic Management Kit" explains how todevelop SNMP agents using m-beans generated by the mibgen compiler and integrate them in the framework.
Chapter 19 "Developing SNMP Managers With the Java Dynamic Management Kit" explains how to use SNMP manager API of the Java Dynamic Management Kit.

Part VI "Supplementary Information" includes the appendixes described below.

Appendix A "JAR File Structure" defines the environment variables you have to set to use the Java Dynamic Management Kit.
Appendix B "Environment Variables" defines the environment variables you have to set to use the Java Dynamic Management Kit.
Appendix C "Java Packages Supplied With the Java Dynamic Management Kit" describes the classes supplied with the Java Dynamic Management Kit.
Appendix D "Java Beans Development Kit Example" shows how any JavaBeans component can be made manageable by a Java Dynamic Management agent.
Appendix E "The Default Base Agent" describes the base agent supplied with the Java Dynamic Management Kit, which implements the minimum set of services required for an agent to be managed. It simplifies the management of any machine on which the Java Dynamic Management Kit is installed.

Ordering Sun Documents

The SunDocsSM program provides more than 250 manuals from Sun Microsystems, Inc. If you live in the United States, Canada, Europe, or Japan, you can purchase documentation sets or individual manuals using this program.

For a list of documents and how to order them, see the catalog section of SunExpress^TM On The Internet at http://www.sun.com/sunexpress.

Accessing Sun Documentation Online

The docs.sun.com 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://docs.sun.com/.

What Typographic Changes Mean

TABLE P-1 Typographic Conventions
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 describes the typographic changes used in this book.TABLE P-1 Typographic Conventions 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.

Prompts in Command Examples

TABLE P-2 Command Environment Prompts
Command Environment	Prompt
C shell	`prompt%`
C shell superuser	`prompt#`
Bourne shell and Korn shell	`$`
Bourne shell and Korn shell superuser	`#`
Windows NT	C:\>

The following table shows the default system prompt and superuser prompt for the UNIX C shell, Bourne shell, and Korn shell. It also shows the prompt for the Windows NT command shell.TABLE P-2 Command Environment Prompts Command Environment Prompt C shell prompt% C shell superuser prompt# Bourne shell and Korn shell $ Bourne shell and Korn shell superuser # Windows NT C:\>

Preface

Who Should Use This Book

Related Documentation

How This Book Is Organized

Ordering Sun Documents

Accessing Sun Documentation Online

What Typographic Changes Mean

TABLE P-1 Typographic Conventions

Prompts in Command Examples

TABLE P-2 Command Environment Prompts