Access Keys:
Skip to content (Access Key - 0)


1 JMX Remote Adaptor M-Let

Print this page

What is the JMX Remote Adaptor?

The JMX Remote Adaptor m-let is a fundamental component of Rhino. All OpenCloud management tools use the JMX Remote Adaptor to connect to Rhino. This component must be present and active, or Rhino cannot be managed! The JMX Remote API is defined by the Java Management eXtensions (JMX) Remote API (jsr 160). The JMX Remote Adaptor uses the JMX Remote API to expose a management port at the following URL:

service:jmx:rmi:///jndi/rmi://<rhino host>:<rhino jmx-r port>/opencloud/rhino

JMX Remote and OpenCloud tools

All OpenCloud management tools (the command line console, the Rhino element manager, the stats client, the import-export tool) all use the JMX Remote API to connect to Rhino using the JMX Remote Adaptor. (See also 4 Building Custom OA&M Tools with Rhino Remote API.)

JMX Remote Adaptor configuration options

In normal conditions you should not need to change the configuration of this component!
<mlet enabled="true">
  <classpath>
    <jar-url>
      @FILE_URL@@RHINO_BASE@/lib/jmxr-adaptor.jar
    </jar-url>
    <security-permission-spec>
    ...
    </security-permission-spec>
  </classpath>
  <class>
    com.opencloud.slee.mlet.jmxr.JMXRAdaptor
  </class>
  <!-- the local rmi registry port -->
  <arg>
    <type>int</type>
    <value>@RMI_MBEAN_REGISTRY_PORT@</value>
  </arg>
  <!-- the local jmx connector port -->
  <arg>
    <type>int</type>
    <value>@JMX_SERVICE_PORT@</value>
  </arg>
  <!-- enable ssl -->
  <arg>
    <type>boolean</type>
    <value>true</value>
  </arg>
</mlet>

As Rhino starts, it pre-processes m-let configuration files, substitutes configuration variables and creates a working m-let configuration file in the node-XXX/work/config subdirectory. Note the following arguments:

Argument Description Default
1 rmi registry port The port of the RMI registry that the JMX Adaptor registers itself with. 1199
2 local JMX connector port The JRMP port the JMX Remote Adaptor listens on. 1202
3 enable SSL Whether SSL is enabled. true
Adaptavist Theme Builder Powered by Atlassian Confluence