Running the adapter against a CIS on a different subnet

When the CIS agent and CIS adapters are running on a different subnet from the Adapter for i2, you need to tell the CIS agent and CIS adapter the fully qualified name or IP address that the RMI Server Hostname is using.

You will need to set the JVM argument when starting the CIS agent and any installed adapter.

Perform the following steps to set the instance ID and RMI Server Hostname.

Note:
Henceforth, Hostname is the machine name or the IP address of the machine that the CIS agent and CIS adapters are running. You can use the IP address if it will not change.
  1. If you have installed the adapter, uninstall it by running uninstallAdapter.py.
  2. Change the Metadata file Bindings.xml for the CIS adapter by inserting <bindings instanceID=Hostname> as an attribute to the Bindings element.
  3. Reinstall the adapter with this JVM argument:
    installAdapter.py -j-Djava.rmi.server.hostname=<hostname> -m
     <metadatabinding file>
    
  4. Start the CIS agent giving the same JVM argument:
    -j-Djava.rmi.server.hostname=<hostname>
    
  5. Restart the CIS agent stating the RMI Server Hostname as a JVM argument property.
  6. Start the newly configured adapter stating the RMI Server Hostname as a JVM argument property.
  7. To enable the CIS agent to send event notifications to the machine that the Adapter for i2 is running, you need to tell it the fully qualified hostname of the machine where the Adapter for i2 is running. To do this, add the line:
    MACHINE_NAME=mymachine.company.com
    

    to the file [i2_CIS_install]/{cis-sdk}/properties/cisclient.properties

    where, mymachine.company.com is the fully qualified name of the machine where the Adapter for i2 is running. This tells the CIS Client (Adapter for i2) to use the machine name specified in the cisclient.properties file as its machine name when running remotely.

  8. In some cases, you will need to state the machine name of the CIS agent when the machine name of the CIS agent cannot be resolved from a remote machine running the Adapter for i2. To do this:
    1. Set the IP address of the CIS agent machine as the value in the <MACHINE_NAME> element in the settings.xml file for your CIS agent.
    2. Run configure.py to make the changes.
    3. Restart the agent and all adapters.

For more information on running the CIS on different subnets, see your CIS guide.

Copyright IBM Corp. 1997, 2004