RMIConnectorServer Properties

The SQLFire JMX Agent includes an RMIConnectorServer for clients to view and interact with the MBeans in the MBean server.

See JSR 160 JMX Remote.

Under JRE 1.5, RMIConnectorServer is provided by JRE 1.5. See http://download.oracle.com/javase/1.5.0/docs/guide/jmx/tutorial/connectors.html for more information.

The following properties configure the SQLFire Agent RMIConnectorServer. You can specify the properties either in the Agent properties file or as a list of prop=value pairs on the agent command line.

Argument Comments Default Value

rmi-bind-address

IP address that the JMX Agent uses to communicate with the admin distributed system.

This is required on:
  • Multi-homed hosts (machines with multiple network cards)
  • Windows systems when using IPv6

The rmi-bind-address argument must be specified on the agent start command line if jconsole or jmanage are running on a different host.

If set to null - "" - all network addresses are used.

""

rmi-enabled

To enable the RMIConnectorServer, this must be true.

true

rmi-port

RMI registry port, a value in the range 0..65535.

1099

rmi-registry-enabled

If true, create an MX4J Naming MBean to serve as the RMI registry, and register the RMIConnector under the JNDI path /jmxconnector. More information is also available in the com.gemstone.gemfire.admin.jmx.Agent Javadocs.

true

rmi-server-port

Port to use for the RMIConnectorServer. If set to 0 (zero) the server socket uses a dynamically allocated port. You might want to specify the port to use when the JMX agent is behind the firewall, for example. Valid values are in the range 0..65535.

0

Example

Using the default settings, the SQLFire JMX Agent creates an RMI connector listening on available addresses at port 1099. JMX clients can connect to the process by specifying the JMX URL: service:jmx:rmi://address/jndi/rmi://address:1099/jmxconnector

For example, to access the SQLFire Agent using jconsole from the same machine on which the agent is running, you would specify localhost as the address:
jconsole service:jmx:rmi://localhost/jndi/rmi://localhost:1099/jmxconnector
Related Topics
Starting the JMX Agent