Default RMI Registry Feature

Overview

Provides RMI Registry functionality which may be used by dependent extensions to perform RMI registration, e.g. the JMX Server Feature.

Defining this Feature as a Dependency

To define this feature as a dependency within your deployment, paste the following element into the dependencies section of your deployment's POM, making sure to populate the version tag with the desired version (check repository for the latest available version). Note that if the feature is optional, i.e. if it's not absolutely required by your extension, set optional to 'true'.

<dependency>
  <groupId>org.bluestemsoftware.open.eoa.ext.feature.rmi.dfault</groupId>
  <artifactId>rmi-registry-default</artifactId>
  <version>VERSION</version>
  <scope>runtime</scope>
  <type>eoa-feature</type>
  <optional>false</optional>
</dependency>

Enabling this Feature Provider

If no provider is specified when feature is enabled and more than one implementation exists, an arbitrary implementation is selected by the alakai server. Enabling this specific provider requires the following entry within your server.xml file:

<feature type="org.bluestemsoftware.specification.eoa.ext.feature.rmi.RMIRegistryFeature">
  <provider impl="org.bluestemsoftware.open.eoa.ext.feature.rmi.dfault.RMIRegistryFeatureImpl"/>
</feature>

Features Required by this Provider

The following features must be explicitly enabled to use this provider:

  None

Optional Features Used by this Provider

This feature will employ the following optional features if they are enabled:

  None

Configuration Schema 

<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" targetNamespace="http://bluestemsoftware.org/open/eoa/ext/feature/rmi/registry/config/1.0" xmlns:tns="http://bluestemsoftware.org/open/eoa/ext/feature/rmi/registry/config/1.0" elementFormDefault="qualified">
  <xs:element name="config">
    <xs:complexType>
      <xs:sequence>
        <xs:element name="port" type="xs:int"/>
      </xs:sequence>
    </xs:complexType>
  </xs:element>
</xs:schema>

Default Configuration

The following configuration is implied when no configuration is specified within 'provider' element: 

<config xmlns="http://bluestemsoftware.org/open/eoa/ext/feature/rmi/registry/config/1.0">
  <port>1099</port>
</config>

Sample Configurations

The default configuration uses the well known port 1099. To change this port to, e.g. 1098, requires the following configuration:

<config xmlns="http://bluestemsoftware.org/open/eoa/ext/feature/rmi/registry/config/1.0">
  <port>1098</port>
</config>