Example on Standard MBean

Contents:

Compilation
Running
Testing

Introduction

This is a simple example to illustrate the usage of StandardMBean registered with the Multi-Protocol agent.
__________________________________________________________________________________________________________________________

Overview

This example is a simple Multi-Protocol Agent with two adaptors registered to provide remote access to the Multi-Protocol Agent. The two protocols supported are RMI/CORBA. It illustrates the creation of a StandardMBean by creating and registering a sample StandardMBean (SimpleClass MBean) with the MBeanServer.
__________________________________________________________________________________________________________________________

Getting Started :

Source files

The source files present in the example directory are,

SimpleClassMBean.java

This file defines the Management interface for the MBean. The methods present in this interface will be exposed as the Attributes and operations of the MBeans.

SimpleClass.java

This file implements the SimpleClassMBean interface thereby following the StandardMBean Design Patterns and thus is a valid StandardMBean.

StandardJMXAgent.java

This file is the main Multi-Protocol Agent application. It creates the MBeanServer repository and the adaptor interfaces for remote Management of the MBeans. It also creates and registers the SimpleClass MBean with the Server.

Compilation

To compile the source files go to WebNMS/JavaAgent/examples/jmx/standardMBean directory in the command prompt and type,
compile *.java [Windows]
sh compile sh *.java [Linux/Solaris]

This will compile the source files in the respective directory.

Running the Agent

To start the agent go to WebNMS/JavaAgent/examples/jmx/standardMBean directory in the command prompt and

1. Use the run.bat or run.sh

            By default,
                 (a) the RMI registry service will be started at port 1099
                 (b) the Corba registry service will be running on 1050

2. Use MBean browser to access the data through RMI ( You can start the MBean Browser using MBeanBrowser.bat/MBeanBrowser.sh in WebNMS/JavaAgent/bin directory)

Testing

The SimpleClass MBean when gets registered with the MBeanServer, is introspected by the MBeanServer to form the MBeanInfo( Attributes and operations). This introspection is done by checking if the MBean implements a interface named after the Class (in this case, it is the SimpleClassMBean interface).
The getter methods and setter methods of this interface is introspected and attributes are formed.The two attributes formed in this example are

ServiceName
State

Any of the rest of the methods with a public Access specifier is formed as an Operation on the MBean. In this example, it is the changeValues().

__________________________________________________________________________________________________________________________