Installing additional Global Mailbox nodes on Sterling B2B Integrator

Install additional Global Mailbox node on Sterling B2B Integrator V6.0 or later to complete the data center setup.

Before you begin

Complete the following tasks before you install an additional Global Mailbox node with the user interface:
  • Complete your topology and installation planning and keep it ready for reference. For more information on topology planning, see Planning the topology and Planning your installation.
  • Complete Phase 1 and Phase 2 tasks specified in Global Mailbox installation sequence.
  • For IBM SDK, download unrestricted Java™ Cryptography Encryption (JCE) policy file from Unrestricted SDK JCE policy. If you are using non-IBM SDK, obtain the JCE files from your SDK vendor.
  • Download IBM® JDK from IBM Fix Central or IBM Passport Advantage and install.
  • Set the appropriate path for the JDK. For more information, see Setting Java variables on Linux, Setting Java variables on Windows, and Setting Java variables on AIX.
  • Download the Sterling B2B Integrator V6.0 or later package from IBM Fix Central or IBM Passport Advantage.
  • Extract the package to a folder, go to the media directory and locate the following files:
    • IM_<operating system>.zip in the InstallationManager folder
  • Extract the files to a common directory. After you extract the files, the directory must have the following sub directories:
    • IM_<operating system>
    • b2birepo
    • gmrepo
  • For UNIX or Linux operating systems, set the ulimit and language as follows:
    • ulimit -n 4096
    • ulimit -u 16000
    • export LANG=en_US
  • If you are using GPFS server as a shared storage in your setup, ensure that all instances of GPFS are up and running in the setup before installing.

About this task

You can install the additional Global Mailbox node on an existing installation of Sterling B2B Integrator V6.0 or later.

Global Mailbox is supported on these platforms:
  • Windows
  • UNIX or Linux
  • AIX
The Global Mailbox instance that you install on an existing Sterling B2B Integrator is registered with Sterling B2B Integrator, similar to the automatic registration when both are installed together. If the adapter containers are installed and configured on the existing Sterling B2B Integrator instance, the same are used after installing Global Mailbox. You install an additional Global Mailbox node for one of the following scenarios:
  • When you add a second or subsequent Global Mailbox node to a data center.
  • When you add the first Global Mailbox node to a second or subsequent data center.

To install an additional Global Mailbox node on an existing Sterling B2B Integrator V6.0 or later instance with the user interface:


  1. Open a command prompt and do one of the following tasks to start the Installation Manager:
    1. Go to the IM_<operating_system> directory and type ./userinst or userinst.exe (Windows) for the following scenarios:
      • If you do not have the Installation Manager installed and are using the Installation Manager agent provided with V6.0 or later.
      • If you have a 64-bit Installation Manager installed.
      • If you have the Installation Manager installed on a platform that has only one download available for Installation Manager. For example, AIX, HP, zLinux.
    2. Go to <installation directory>/Installation Manager/eclipse (for Windows system, replace / with \) and type ./IBMIM or IBMIM.exe (Windows), if you have 32-bit Installation Manager installed on a Linux or Windows system.
  2. On the Installation Manager home page, click Install.
    Important: If IM_<operating_system>, gmrepo, and b2birepo directories are not in the same directory or if you already have Installation Manager installed, then you get a message saying that there no packages to install or Installation Manager could not connect to the repositories. You must add the Global Mailbox and Sterling B2B Integrator repository files to the Installation Manager repository. For more information about adding repository files, see Repository preferences in the IBM Installation Manager Knowledge Center.
  3. On the Install Packages screen, select Global Mailbox. This action selects the versions also. Click Next.
    Important: Ignore the message that Global Mailbox package is already installed. That message is for Cassandra and ZooKeeper installation and not for the initial Global Mailbox node.
  4. From the list of installation directories, select the directory where Sterling B2B Integrator is installed and click Next.
    Restriction: Installation directory for the initial Global Mailbox node and Sterling B2B Integrator must be the same. You cannot proceed with the installation if you select another installation directory.
  5. Select Additional Global Mailbox Node and click Next.
  6. Complete the following steps to define storage and data center for the additional node:
    1. Step 1 - Specify Storage Location:
      1. Click Browse and specify the location for Global Mailbox payload storage and click Next.
      2. Enter and confirm B2Bi System Passphrase to protect the storage data.
      3. Enter and confirm your B2Bi admin password for gmbx_user account.
      4. Click Continue to Step 2.
    2. Step 2 - Select Current Data Center:
      1. Enter the data store host name or IP address of the current data center (Cassandra server).
      2. Enter the client port number. Default is 9042.
      3. Click Connect and Retrieve Configuration. The installer connects to the data center and retrieves configuration information.
      4. Select the data center that this node belongs to.
      5. Click Continue to Step 3.
    3. Step 3 - Configure Replication Server for this node:
      1. Type the Local Host Name for the replication server. Default is the host name of the local machine.
      2. Type the Secure Server Port for the replication server. Default is 33001.
      3. If present, click Continue to Step 4. Otherwise, go to step d.(iii).
    4. Step 4 - Retrieve Configuration from another server:
      This step is used to retrieve configuration information from another data center. If the selected data center already has a replication server defined, this step is not needed.
      1. Select the replication server host name.
      2. Enter the user name and password (root user credentials are permitted) for the replication server and click Next.
      3. Select the name of the data center where you are installing the additional Global Mailbox node. Click Next.
  7. Click Install.
  8. Review the installation package summary information. Notice the installation progress in the Repository Information section.
  9. Click Finish.