Installing additional Global Mailbox and Sterling B2B Integrator nodes

To complete the Global Mailbox topology, you must install additional Global Mailbox and Sterling B2B Integrator nodes after installing the initial nodes.

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 for installation.
  • Complete Phase 1 and phase 2 tasks specified in Global Mailbox installation sequence.
  • For IBM SDK, download the 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 media 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
    • Common_Repo.zip
  • 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 along with Sterling B2B Integrator or on an existing installation of Sterling B2B Integrator, which is upgraded to V6.0 or later.

Global Mailbox is supported on these platforms:
  • Windows
  • UNIX or Linux
  • AIX
You install the additional Global Mailbox node for one of the following scenarios:
  • When you add a second or subsequent Sterling B2B Integrator and Global Mailbox node to a data center.
  • When you add the first Sterling B2B Integrator and Global Mailbox node to a second and subsequent data center.
Important: The following procedure provides the steps for installing additional Sterling B2B Integrator and Global Mailbox nodes. However, it does not cover detailed information about all the prerequisites and installation configuration that are required for Sterling B2B Integrator installation. For information about Sterling B2B Integrator prerequisites, installation configuration, and to manually apply the database schema, see IBM Sterling B2B Integrator on the IBM Knowledge Center.

To install additional Global Mailbox and Sterling B2B Integrator nodes with the user interface:

Procedure

  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 that is provided with the package.
      • 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.
    Attention: It is suggested that you record a response file when installing additional Sterling B2B Integrator and Global Mailbox. For more information, see Recording a response file.
  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 IBM Sterling B2B Integrator and Global Mailbox. This action selects the versions also. Click Next.
  4. Read the license agreement, accept it, and click Next.
  5. Click Browse and specify the installation directory for Sterling B2B Integrator and click Next. If required, you can choose to retain the default directory.

    The installation directory is used to store files specific to Sterling B2B Integrator.

  6. Select the translation (language) to install and click Next.

    The language selection is for the Installation Manager, or the installer only. Only English translation is supported for the first release of Global Mailbox.

  7. Select the required Sterling B2B Integrator features and Additional Global Mailbox Node. Click Next.
  8. Complete the following steps to define storage and data center for the additional nodes:
    1. Enter the Cassandra host name or IP address.
    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 2.
    6. Type the host name and port for the replication server:
      Local Host Name
      Default is the host name of the local machine.
      Secure Server Port
      Default is 33001.
    7. If present, click Continue to Step 3. Otherwise, go to step j.

      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.

    8. Select the replication server host name.
    9. Enter the user name and password for the replication server and click Next.
    10. Select the name of the data center where you are installing Sterling B2B Integrator and the additional Global Mailbox node. Click Next.
  9. Click Select Folder and specify the JDK directory for Sterling B2B Integrator installation.
  10. Specify configuration information for the Sterling B2B Integrator features you have opted to install and click Next.
  11. Click Select File and select the Java™ Cryptography Encryption (JCE) policy file. Click Next.
    Important: You must use the unrestricted JCE policy file to use Global Mailbox with Sterling B2B Integrator.
  12. If you want to override the default host name and IP address for Sterling B2B Integrator installation, specify the alternative host name and IP address, or else, you can choose to retain the default. Click Next.
  13. Type the system passphrase, confirm the passphrase, and click Next.
    Important: The system passphrase is used to secure your Sterling B2B Integrator node. Record your entry because you must provide the passphrase when starting Sterling B2B Integrator or when installing a patch. The system passphrase provided for Sterling B2B Integrator configuration is also used as the Global Mailbox storage passphrase initially.
  14. Type the following email information and click Next:
    1. Email address to which you want the system alert messages to be sent.
    2. The SMTP mail server (IP address or host name) that you want to use for system alert messages and other administrative notices.
  15. Specify the following database-related information and click Next:
    1. Select the database vendor.
    2. Select This installation is for a cluster node 2 or higher if you are installing a second or subsequent Sterling B2B Integrator node in the same data center. If you are installing the first Sterling B2B Integrator node in the second or subsequent data centers, then do not select the option.
    3. Select Apply database schema automatically to apply the database schema automatically. To manually create the database schema, clear the Apply database schema automatically check box and continue with the remaining installation steps.
      Important: If you manually apply the schema, the installation stops without error later in the installation process so that you can manually apply the schema.
  16. Specify the database connection information, add the JDBC driver, and click Next.
  17. Select Verbose install? if you want to generate a detailed installation log and click Next.
    Important: If you select Verbose install?, the details of the events that occur during the installation are recorded in the InstallSI.log file, or else, install events without much detail are recorded in the InstallSI.log file.
  18. Do not select This installation is an upgrade from a prior version because this is a new installation.
  19. Determine the performance configurations that apply to this installation and click Next. Accept the default value or type the appropriate value.
    1. Number of Processor Cores
    2. Physical Memory (MB) allocated to Sterling B2B Integrator
  20. Click Install.
  21. Review the installation package summary information. Notice the installation progress in the Repository Information section.
  22. Click Finish.
    Important: After you complete the installation of Sterling B2B Integrator and the additional Global Mailbox node, some warning messages are displayed. The warning messages are generated by the Cassandra drivers and can be ignored.