Overview

The Java Management Extensions (JMX specification) describe an architecture, design patterns, API's, and services for application and network management in the Java programming language. JMX functions beyond a simple API since it can specify the architecture as to how that API is used. It provides the means to construct Java code, create smart Java agents, implement distributed management middleware and managers, and integrate these solutions smoothly into existing management systems. You can integrate such solutions with either HTML or industry standards such as SNMP and WBEM. JMX is dynamic, allowing the monitoring and management of resources in real time while they are created, installed, and implemented. The JMX also works along with JVM, the Java Virtual Machine.

For more details about JMX, refer to: http://java.sun.com/products/JavaManagement/

New in GigaSpaces 5.2 Managing and controlling space attributes and performing space administration operations through the JMX MBeans view is new in GigaSpaces versions 5.2 and onwards.

Manageable Resource

A JMX manageable resource can be an application, an implementation of a service, a device, a user, etc. It is developed in Java, or at least offers a Java wrapper, and must also be implemented by a Java object called a managed bean (MBeans), according to JMX specifications.

Opening JMX

1. Make sure you have a gsServer running (<GigaSpaces Root>\bin\gsServer.bat/sh).
2. Open a console and type the following command:

   jconsole

   By default, operations in the MBeans Operations tab which have GigaSpaces classes as their type are disabled (. To enable these, type jconsole -J-Djava.class.path=%JAVA_HOME%\lib\jconsole.jar;GS_HOME\lib\JSpaces.jar in your console. Instead of GS_HOME, type the directory in which GigaSpaces is installed on your computer.

3. The JConsole: Connect to Agent window appears. Select the Advanced tab.
4. In the JMX URL text box, copy the URL in the log message displayed in your GigaSpaces Server, for example:

   INFO:
   New JMXConnectionServer was successfully registered into the MBeanServer using service url: 
   service:jmx:rmi:///jndi/rmi://localhost:10098/jmxrmi

   

5. Press Connect.

MBeans View

The jconsole utility (part of Sun J2SE 5.0 JDK) includes a MBeans view, which allows you to perform space administration operations, and to view and control space attributes. These operations are defined in the JavaSpaceMBeanDescriptors.xml file, which exists in the JSpaces.jar file. If you do not want a certain operation or attribute to be exposed in the JMX MBeans tab, simply comment or remove the operation from the XML file.

Container MBean

The container MBean exposes the space container's attributes and operations. The space container manages the space life cycle.

Attributes Tab

The container Attributes tab displays a list of container attributes. Attribute values appearing in blue can be controlled, while values in black can not be changed. Red values are unavailable.

Operations Tab

The container Operations tab allows you to perform different space container operations:

• shutdown – shuts down this container.
• restart – restarts this container.
• destroySpace – destroys a space in this container (type the space's name in the spaceName text box).
• createSpace (spaceName, schemaName, clusterConfigURL) – creates a space with a unique name in this container and writes the created space to the appropriate Storage Adapter. (Type the name of the space, the name of the schema, and the cluster configuration URL in the relevant text boxes).
• createSpace (spaceName, schemaName) – creates a space with a unique name in this container.
• getRuntimeConfigReport – displays a runtime configuration report. For more details, refer to the Runtime Configuration Report section.

Info Tab

The container Info tab displays the MBean name and its Java class.

Space MBean

The Space MBean exposes space attributes and operations. You can get the basic space operational settings using this MBean.

Attributes Tab

The space Attributes tab displays a list of space attributes/elements by XPath, in the selected space. Attribute values appearing in blue can be controlled, while values in black can not be changed. Red values are unavailable.

For details on specific configuration file elements, refer to the Configuration Files Element List section.

Operations Tab

The space Operations tab allows you to perform different space operations:

• getSpace – returns the space proxy that this manageable bean governs.
• getStatistics – returns a StatisticsContext according to the operation code you type in the operationCode text box – each operation has a constant representing it.

  For a list of operation codes, see Javadoc and Statistics Filter Operation Codes list.

  For more details, see Javadoc: com.j_spaces.core.admin.StatisticsAdmin com.j_spaces.core.filters.StatisticsContext

• clean – cleans the selected space.
• count – when entering a specific class name in the className textbox, displays the number of Entries in this class.
• clear – when entering a specific class name in the className textbox, removes the Entries that match this template from the space.
• stop – attempts to stop the selected space.
• start – attempts to start the selected space.
• ping – checks whether the space is alive and accessible.
• restart – restarts the space.
• getClusterPolicy – displays a cluster policy instance.
• getRuntimeInfo – returns a RuntimeInfo instance.

  For more details, see Javadoc.

• getURL – displays the spaceURL instance which was used to initialize the space.

Info Tab

The space Info tab displays the MBean name and its Java class.

Space MBean Extension

The Space MBean Extension exposes advanced space attributes – this includes memory management, persistency and communication settings.

Attributes Tab

The space extensions Attributes tab displays a list of advanced space attributes/elements by XPath, in the selected space. Attribute values appearing in blue can be controlled, while values in black can not be changed. Red values are unavailable.

For details on specific configuration file elements, refer to the Configuration Files Element List section.

Info Tab

The space extensions Info tab displays the MBean name and its Java class.