Chapter 2. JMX Manager Configuration

Table of Contents

2.1. Overview
2.2. JMX Manager Basic Information
2.3. JMX Connector
2.3.1. JMXMP Connector
2.3.2. RMI Connector
2.4. SNMP Adaptor

This chapter describes the configuration of JMX Manager environment.

2.1. Overview

JEUS can be specified to enable JMX client access to MBeans.

To configure the operations of a JMX Manager, the server to which the JMX Manager is connected needs to be selected. Select the server from the WebAdmin main page. Or, click the [Servers] menu from the JEUS node tree on the left section of the WebAdmin screen, and then select the server from the Servers List page.

[Figure 2.1] Main Page

Main Page


[Figure 2.2] Servers List Page

Servers List Page


To get to the Jmx Manager page, click the [JMX Manager] sub tab under the [Resource] tab.

[Figure 2.3] Jmx Manager Configuration Page

Jmx Manager Configuration Page

The JMX Manager configuration page consists of the following three sections that provide access to the monitoring information for JEUS.

  • JMX Manager Basic Information

    Sets the HTML Adaptor Port and MLet URL information.

  • JMX Connector

    Sets the JMX connector used by other server processes to access the server. The JEUSMP connector is used by default.

  • SNMP Adaptor

    Sets the SNMP adaptor.

To activate the configurations of JMX connector and SNMP adaptor, check the checkbox next to their names. For more information about the settings of JMX connector and SNMP adaptor, refer to their relevant sections.

2.2. JMX Manager Basic Information

This section explains how to configure the basic settings of the JMX Manager. For the 'Html Adaptor Port' and 'MLet Url' settings to be applied, the server needs to be restarted.

[Figure 2.4] Configuring JMX Manager Basic Information

Configuring JMX Manager Basic Information

  • HTML Adaptor Port

    The HTML adaptor is JMX's protocol adaptor that supports HTML.

    The HTML adaptor port is used to access the adaptor through a web browser. If set to -1, the JMX Manager does not use the HTML protocol. Make sure not to use a port that is used by other services.

    To verify that the HTML adaptor has been configured successfully, run the web browser and then access the server using the IP address of the server and the specified port number.

    The following is the screen that shows that the HTML adaptor is running successfully.

    [Figure 2.5] HTML Adaptor Access Page

    HTML Adaptor Access Page

    Note

    For more information on HTML adaptor, refer to http://java.sun.com/developer/technicalArticles/J2SE/jmx.html.

  • MLet URL

    Sets the MLet URL to register with the MBean server. For the specified MLet URL to be applied, the server needs to be restarted.

2.3. JMX Connector

The JMX connectors used by a Java Client to remotely access JMX MBeanServer is as follows:

  • Socket-based JMXMP Connector

  • RMI Connector defined in remote API

JMXMP connector is used by default. The configuration can be changed using WebAdmin.

2.3.1. JMXMP Connector

Specify a listener port used to access JMX. If not specified, the common port for JEUS is used as the listener port for the JMXMP connector.

In 'Listener Ref ', specify the reference name of the unified listener that the JMXMP connector will use.

[Figure 2.6] JMXMP Connector Configuration

JMXMP Connector Configuration

Note

To apply the JMXMP connector settings, the server should be restarted. For more information on the listener settings, refer to JEUS Server Guide. "2.3.2. Listener Configuration"

2.3.2. RMI Connector

To activate the configurations of RMI connector, check the checkbox next to its name.

When the JMXMP connector has also been configured, the JEUS system will use the JMXMP connector internally. In this case, the 'Ref Export Name,' reference export name of an RMI connector used as a JMX connector, should be specified. If this name is not set or the specified name is same as the JMXMP connector name that JEUS provides, an exception will occur.

The following page specifies RMI Connector using WebAdmin.

[Figure 2.7] RMI Connector Configuration

RMI Connector Configuration

Note

To apply the RMI connector settings, the server needs to be restarted.

When the RMI connector setting is successfully enabled and the server is started, the following log message will appear.

The following log message is shown for when 'Export Name' is set to 'RMIConnector' and 'Rmi Connector Port' is set to 9999. IP address can be different depending on the machine where the server is running.

. . .
[2012.06.27 15:03:57][2] [adminServer-1] [JMX-0132] The RMIConnector service url is service:jmx:rmi://127.0.0.1:9999/jndi/RMIConnector
. . .

2.4. SNMP Adaptor

SNMP adaptor is an SNMP protocol adaptor provided by JMX. To activate the configurations of SNMP adaptor, check the checkbox next to its name.

The following page specifies SNMP adaptor using WebAdmin.

[Figure 2.8] SNMP Adaptor Configuration

SNMP Adaptor Configuration

Note

For more information on SNMP and SNMP Adaptor, refer to JEUS SNMP Guide. "Chapter 2. SNMP Agent".