Getting Started with the Java Dynamic Management Kit 5.0

Chapter 1 Java Dynamic Management Kit Overview

The Java Dynamic Management Kit (DMK) is a Java application programming interface (API) and a set of development tools for designing and implementing a new generation of management applications. As an implementation of the Java Management Extensions (the JMX specification), the product provides a framework for the management of Java objects through Java technology-based applications.

The Java DMK provides a complete architecture for designing distributed management systems. A Java technology-based solution can embed management intelligence into your agents, provide an abstraction of your communication layer, and be upgraded and extended dynamically. Your management applications can also take advantage of other Java APIs such as Swing components for user interfaces and the JDBCTM API for database access.

In addition, the Java DMK provides a complete toolkit for the simple network management protocol (SNMP), the most widespread legacy architecture for network and device management. This gives you the advantages of developing both Java dynamic management agents and managers that can interoperate with existing management systems.

This chapter contains the following sections:

Introduction to the Java DMK

This section addresses these fundamental questions about the Java DMK:

If this is your first contact with the product, the answers to these questions should help you understand how your management needs can be solved using Java dynamic management technology.

Why Use Java Dynamic Management Technology?

Old Way – Network management is usually performed by large, centralized management applications. These management applications monitor and modify their network by tightly controlling their agents. The agents act as relays for the network resources they represent, translating commands and collecting raw data and status information. Agents are usually situated in or near the network elements they control, which means that these agents are limited in nature. They usually contain little management intelligence and can perform only basic network management operations.

New Way – A Java dynamic management agent exposes its resources in a standard way and provides management services directly at the resource level. These services provide the intelligence that enables agent applications to perform management tasks autonomously. This frees the management application from routine tasks such as polling and thus reduces the network load as well.

Old Way – From a wider perspective, existing management systems for networks and applications are implemented with diverse protocols and technologies. Developers must choose a single management technology for a portion of the target market. In some cases, developers might need to implement multiple management technologies to provide more complete coverage of their potential markets. Due to the limitations of both approaches, vendors frequently choose not to implement any management technology.

New Way – The interface to resources is standardized, meaning that device vendors and application developers can finally agree: they can use any technology they want. As long as management applications communicate through a Java dynamic management agent, they can access any resource.

The same flexibility applies to the management services that are deployed in the agents. Because they can control resources through standard interfaces, they are dynamically interchangeable. In order to upgrade the capabilities of a smart agent, new services can be downloaded and plugged in dynamically when they become available. Finally, the Java DMK provides a distributed model that is protocol independent. Management applications rely on the API, not on any one protocol.

The Java DMK brings new solutions to the management domain through:

The service-driven network is a new approach to network computing that concentrates on the services you want to provide. These range from the low-level services that manage relationships between network devices to the value-added services you provide to end users. These services drive your network and management needs. In addition, autonomous agent functionality makes it possible to manage a very large installed base.

With the Java dynamic management architecture, services can be incorporated directly into agents. Agents are given the intelligence to perform management tasks themselves, enabling management logic to be distributed throughout the whole network. New services can be downloaded from a web server at runtime using a dynamic pull mechanism. Services are not only implemented inside devices, but they can also be network-based, meaning that you can download them through simple web pages in the same way as Java technology-based applets.

This dynamic, on-demand paradigm means that it is no longer necessary to know what will need to be configured, managed, and monitored in the future or in advance of network deployment. Services will be created, enhanced and deployed as needed. This unique combination of features gives the Java DMK a wide domain of application as it integrates the current and future management standards.

What Is the Java DMK ?

The Java DMK is a Java API that includes all its class and interface objects, development tools that speed up the development process, and a complete set of documentation.

The programmatic components of the Java DMK include:

The development tools are implemented as two standalone applications:

Finally, the Java DMK contains complete documentation for developers:

How Do I Develop a Java Dynamic Management Solution?

The instrumentation level of the JMX specification describes how to represent a resource as a Java object. The JMX agent level describes how resources interact with an agent. The Java DMK extends the agent services and defines the distributed management features for accessing agents remotely. A distributed management solution relies on all three levels.

Instrument Your Resources as MBeans

A resource can be any entity, physical or virtual, that you want to make available and control through your network. Physical resources can be devices such as network elements or printers. Virtual resources include applications and computational power that are available on some host. A resource is seen through its management interface, that is, the set of attributes, operations, and notifications that a management application may access.

To instrument a resource is to develop the Java object that represents the resource's management interface. The JMX specification defines how to instrument a resource according to a certain design pattern. These patterns resemble those of the JavaBeansTM component model: an attribute has getters and setters, operations are represented by their Java methods, and notifications rely on the Java event model.

Therefore, a managed bean, or MBean, is the instrumentation of a resource in compliance with the JMX design patterns. If the resource itself is a Java application, it can be its own MBean, otherwise, an MBean is a Java wrapper for native resources or a Java representation of a device. MBeans can be distant from the managed resource, as long as they accurately represent its attributes and operations. The MBean developer determines what attributes and operations are available through the MBean.

Device manufacturers and application vendors can provide the MBeans that plug into their customer's existing agents. Management solution integrators can develop the MBeans for resources that have not been previously instrumented. Because MBeans follow the JMX specification, they can be instantiated in any agent that is compliant with the JMX specification. This compliance makes the MBeans portable and independent of any proprietary management architecture.

Expose Your MBeans in a Smart Agent

A Java dynamic management agent follows the client-server model. The agent responds to the management requests from any number of client applications that want to access the resources it contains. The agent centralizes all requests, dispatches them to the target MBeans, and returns any responses. The agent handles the communication issues involved with receiving and sending data, so that the MBeans don't have to.

The central component of an agent is the MBean server. It is a registry for MBean instances, and it exposes a generic interface through which clients can issue requests on specific MBeans. Clients can ask for the description of an MBean's management interface, to find out what resource is exposed through that MBean. Using this information, the manager can then formulate a request to the MBean server to get or set attributes, invoke operations, or register for notifications.

MBeans are accessible only through requests to the MBean server. Manager applications never have the direct reference of an MBean, only a symbolic object name which identifies the MBean in the agent. This preserves the client-server model and is essential to the implementation of query and security features.

The MBean server also provides the framework that allows agent services to interact with MBeans. Services are themselves implemented as MBeans, which interact with resource MBeans to perform some task. For example, a manager could decide to monitor some MBean attribute. The manager instantiates the monitoring service MBean, configures the threshold, and registers to receive the alarms that may occur. The manager no longer needs to poll the agent, but will automatically be notified whenever the attribute exceeds the threshold.

The library of services contains the logic that is necessary for implementing advanced management policies, such as:

You can also develop your own service MBeans to meet your management needs, such as logging and persistence services, which are typically platform dependent.

Access Your Agents Remotely

Finally, the Java DMK enables you to access agents and their resources easily from a remote application. All components for handling the communication are provided, both in the agent and for the client application. The same API that is exposed by the MBean server in the agent is also available remotely to the manager. This symmetry effectively makes the communication layer transparent.

Management applications perform requests by getting or setting attributes or invoking operations on an MBean identified by its symbolic name. Proxy objects provide a further level of abstraction by representing an MBean remotely and handling all communication; the manager can be designed and developed as if all resources were local. The communication components also handle notification forwarding, so that remote managers can register to receive notifications from broadcasting MBeans.

Management applications developed in the Java programming language use connectors to make the communication layer transparent. Connectors for the RMI, HTTP/TCP and HTTP/SSL protocols are provided, all with the same API for interchangeability.

Adaptors provide a view of an agent through other protocols for management applications which are not based on Java technology. For example, the HTML adaptor represents MBeans as web pages that can be viewed in any web browser. The SNMP adaptor can expose special MBeans that represent an SNMP MIB and respond to requests in the SNMP protocols. It is possible to use the SNMP adaptor without registering the MIB in the MBean server.

All connectors and adaptors are implemented as MBeans. Management applications can therefore create, configure and remove communication resources dynamically, according to network conditions or available protocols. Each protocol can have its own built-in security mechanisms (for example HTTPS, or SNMPv3 security). Security aspects linked to each protocol are therefore handled at the connector or adaptor layer, making them transparent to the MBean developer.

The flexibility of communicator MBeans and the availability of connectors for multiple protocols make it possible to deploy management solutions in heterogeneous network environments. The adaptors create a bridge between agents based on the JMX architecture and existing management systems. You can also create your own connectors and adaptors to accommodate proprietary protocols and future management needs.

Key Concepts

Figure 1–1 illustrates the key concepts of the Java DMK and shows how the components relate to each other.

In this example, the MBeans for two resources are registered with the agent's MBean server. An agent service such as monitoring is registered as another MBean. The agent contains a connector server for one of the following protocols: RMI, HTTP, or HTTPS. It also contains a protocol adaptor, either for SNMP or HTML. An agent can have any number of communicator components, one for each of the protocols and one for each of the ports through which it communicates.

Figure 1–1 Key Concepts of the Java DMK

Key concepts of the Java DMK

The remote manager is a Java application running on a distant host. It contains the connector client for the chosen protocol and proxy MBeans representing the two resources. When the connector client establishes the connection with the agent's connector server, the other components of the application can issue management requests to the agent. For example, it can call the proxy objects to invoke an operation on the first resource and configure the monitoring service to poll the second resource.

With the HTML adaptor, you can view the agent through a web browser, which provides a simple user interface. Each MBean is represented as a separate HTML page, from which you can interact with text fields to set attributes and click buttons to invoke operations. There is also an administration page for creating or removing MBeans from the MBean server.

Each of these concepts is further defined in Chapter 2, Architectural Components.

Benefits of a Java Dynamic Management Solution

To summarize, the benefits of the Java DMK include:

Simplified Design and Development

The JMX architecture standardizes the elements of a management system. All three levels, instrumentation, agent, and manager, are isolated and their interaction is defined through the API. This makes it possible to have modular development, in which each level is designed and implemented independently. Also, component reuse is possible: services developed for one JMX agent will work in all JMX agents.

At the instrumentation level:

At the agent level:

At the manager level:

At all three levels, the modularity also means the simple designs can be implemented rapidly, and then additional functionality can be added as it is needed. You can have a prototype running after your first day of development, because of the programming examples provided in the product.

Protocol Independence

The design of MBeans, agents, and managers does not depend in any way on the protocol that an agent uses for communicating with external applications. All interactions with MBeans are handled by the MBean server and are thus defined by the JMX APIs.

The provided connectors rely on the API and do not expose any communication details. A connector server, connector client pair can be replaced by another without loss of functionality, assuming both protocols are in the network environment. Applications can thus switch protocols according to real-time conditions. For example, if a manager must access an agent behind a firewall, it can instantiate and use an HTTP connector.

Because MBeans and agents are protocol independent, they can be accessed simultaneously through any number of protocols. Connector servers and protocol adaptors can handle multiple connections, so your agent needs only one of them for each protocol to which it responds. The MBean server also supports simultaneous requests, although MBeans are responsible for their own synchronization issues.

New connectors for new protocols can be developed and used without rewriting existing MBeans or external applications. All that is required is that the new connector client expose the remote API.

The Java DMK 5.0 supports multihome interfaces, allowing you to work in environments where the are multiple network protocols available. The multihome interface service means that Java DMK 5.0 offers complete support of the internet protocol version 6 (IPv6), provided it is running on a platform that is IPv6 compatible, namely JDKTM version 1.4.

Dynamic Extensibility and Scalability

By definition, all agents and manager applications developed with the Java DMK 5.0 are extensible and scalable. The library of agent services is always available. Managers can instantiate new services when needed and later remove them to minimize memory usage. This is especially useful for running agents on small footprint devices.

In the same way, MBeans can be registered and unregistered with the MBean server in an agent while it is running. This is useful to represent application resources that can come and go on a given host. The scalability enables an agent to adapt to the size and complexity of its managed resources, without having to be restarted or reinstalled.

The dynamic loading service can download and instantiate MBeans from an arbitrary location. Therefore, you can extend the functionality of a running agent by making new classes available at an arbitrary location and requesting that the agent load and instantiate them. This is effectively a push mechanism that can be used to deploy services and applications to customers.

In addition, open MBeans contribute to the flexibility and scalability of management systems by enabling management applications to use new managed objects as they are created.

Finally, conformance to the JMX specification ensures that all components that are compatible with the JMX specification can be incorporated into Java dynamic management agents, whether they are manageable resources, new services, or new communication components.

SNMPv3 Security

The Java DMK 5.0 extends the SNMP support of previous Java DMK releases to include the SNMPv3 protocol. This means that Java DMK benefits from the security and administration services offered by SNMPv3.

The Java DMK supports SNMPv1 and v2 fully, and implements much of SNMPv3. A single agent can respond to requests from any version of SNMP.

For more information about security using the SNMPv3 protocol, see Security.

SNMP Master Agent

The SNMP support in the Java DMK 5.0 allows you to build a master agent that groups together several SNMP subagents and exports their information through a single point of access. The master agent performs two main functions:

Overview of the Product Documentation

The Java DMK product includes both printable and online documentation, as well as an exhaustive set of programming examples.

Online HTML Files

You can view HTML documentation after installation of the product. On the machine where you installed the product, open one of the following URLs in any browser:

In the Solaris operating environment: file:/opt/SUNWjdmk/jdmk5.0/index.html

On the Windows 2000 operating environment: file:/Program Files/SUNWjdmk/jdmk5.0/index.html

The page contains links to all the product documentation supplied online with the Java DMK, including:

Printable Documents

Complete PDF versions of the books listed in the preceding section are supplied on the CD-ROM of the software. These files are located in the docs directory at the common root of the CD-ROM.

The documents are formatted for U.S. Letter paper size (8.5 × 11 inches), but the can be loaded by any appropriate document viewer or printed directly to any printer, regardless of the default paper size. The text area on each page fits on all standard paper sizes.

Programming Examples

Sample applications that demonstrate most of the functionality of the Java DMK are provided in the examples package of the product. If you installed this package, the Java source files and README text files for these applications are located in subdirectories at:

installDir/SUNWjdmk/jdmk5.0/examples


Note –

In the Solaris operating environment, you need to be root user to write to this directory. To compile the example programs, users should copy the examples hierarchy to a more accessible location.


The README file for each example gives a brief explanation of the source files and the instructions for running its application. Further explanation for most examples is available in the Java Dynamic Management Kit 5.0 Tutorial.

The examples directory also contains the JdmkProxyMBeans subdirectory, which provides proxy MBeans for all of the Java DMK components that support them. These are generated by the proxygen tool and must be compiled in the normal way before use. You can use them to provide proxy objects in your manager applications for the agent-side service MBeans.

Javadoc Utility

The Javadoc utility provides the full description of all classes, interfaces, and methods in the Java DMK APIs.

The Java DMK Javadoc is found in the following location after installation:

installDir/SUNWjdmk/jdmk5.0/docs/locale/C/api/index.html