Installing multiple SOAP Gateway server instances that share one JVM

Multiple SOAP Gateway server instances can share a single instance of the Java™ Virtual Machine (JVM). This option reduces the amount of storage required for each additional server instance and improves the serviceability because a SDK service update needs to be installed only once to apply to all SOAP Gateway servers sharing that SDK.

Every server instance must have access to the directory where the IBM® SDK is installed.

To install multiple SOAP Gateway server instances that share one JVM:

  1. Install the first SOAP Gateway server.
  2. Install the subsequent instances of the SOAP Gateway server, but exclude the IBM Java SDK from installation. .
  3. Issue the command iogmgmt -prop -u -java -h SDK_path.
    You must issue this command to the SOAP Gateway in the install_dir/imsserver/deploy directory of the new server instance. Each SOAP Gateway server instance has an independent SOAP Gateway management utility.

    This command binds the new SOAP Gateway server instance to the existing IBM SDK. You must issue this command before you can issue other SOAP Gateway management utility commands.

    You can view the current Java home directory with the following command:
    iogmgmt -view -java -h
  4. Use the SOAP Gateway management utility to configure the new server instance.