GemStone® GemFireTM Enterprise

Java JMX RMIConnector Programming Example

The healthMonitor example is a JMX client application that connects to the GemFire JMX Agent via an RMIConnector to monitor the health of a GemFire Enterprise Distributed system. The example is located in the GemFire installation under examples/dist/healthMonitor.

Before running this application, you need to configure your environment according to the instructions provided under the GemFire installation in examples/EnvSetup.html.

Next, start the GemFire JMX Agent. Change to the bin directory and execute the agent script, typing in "agent start".

Once your environment is set and the agent is running, change to the examples/dist/healthMonitor directory to run the application. The healthMonitor usage is:

       java healthMonitor.HealthMonitor <host> <port> [<>]

The host is the name of the system that you started the agent on. The port is the agent's RMIConnectorServer port (default 1099). This sample startup line starts the application for an agent launched on a host named "lucy" on the default RMIConnectorServer port:

       java healthMonitor.HealthMonitor lucy 1099

You may optionally specify a file as an argument to HealthMonitor. It will also automatically pick up any file that you place in the examples/dist/healthMonitor directory. The application will then use the values in the properties file to determine details on the system it will connect to:

       java healthMonitor.HealthMonitor lucy 1099 c:\

Once started, the application will attach to the GemFire JMX Agent using the RMIConnector as defined by JSR 160. By configuring the Agent and manipulating the MBeans that it exposes, the application will monitor the health of a GemFire distributed system and its members.