Installing an additional production node on Linux with the X Window System

Use this procedure for multiple node production installations when you are adding nodes after the initial installation.

Before you begin

Use the IBM® launchpad, IBM Installation Manager, and commands to install an additional node to a production installation of B2B Advanced Communications on Linux by using the X Window System.

You must install the additional node on a different server from other nodes that you installed in the cluster that includes this new node.

The configuration of the node depends on how you are using the node.

  • If you are using the node to bootstrap the data grid, you must import the message fabric, data grid, and data source properties files from the first node. This action applies to nodes that include a catalog member or the first container member of the cluster.
  • If you are not using the node to bootstrap the data grid, you must retrieve the configuration information from the data grid. Before you retrieve the configuration, you must start the nodes that bootstrap the data grid.

Do the following to set up your launchpad and Installation Manager environment:

  • Install the X Window System in your Linux installation.
    Important: Launchpad does not start and run the Install Manager if the X Window System is incorrectly configured or missing certain libraries: libXtst, libXmu, and xorg-x11-xauth. For more information about troubleshooting the X Window System to install B2B Advanced Communications, see Problems and solutions for opening the Install Manager during an installation on Linux.
  • Install the Mozilla Firefox browser. For more information about the supported level of Firefox, see the system requirements.

If you are installing multiple informational members on different servers with different URLs, IBM recommends that you use load-balancing technologies so that users access only a single URL.

About this task

This procedure can be used to increase the availability of B2B Advanced Communications.

Most fields require user input. Those fields that are not required are designated as optional. If you do not enter information for a required field, and you click Next to go to the next screen, the installation stops. The fields that need information are identified with red X marks.

Important: If you are installing B2B Advanced Communications and Sterling B2B Integrator together on one server that has less than 16 GB of random access memory (RAM), you must start each application separately.

Procedure

  1. Start the installation launchpad by performing the following task:
    1. Open the directory where you extracted the downloaded installation files.
    2. To start the launchpad, enter launchpad.sh.
    The Product Overview window of the launchpad is displayed.
  2. Click Install IBM B2B Advanced Communications. The Installation Manager is displayed.
  3. Click Install.
  4. Select the installation package for your version of B2B Advanced Communications and click Next.
  5. Accept your user's license by checking the option I accept the terms in the license agreement and clicking Next.
    Important: This license is a general license that applies to all installations of B2B Advanced Communications. A different and unique license determines your type of installation.
  6. Select a shared resources directory and click Next.
  7. Select or create an installation directory and click Next.
    Restriction:
    • The installation directory must not contain any files.
    • Do not use non-ASCII characters like é or ö in the directory path. You cannot start or uninstall B2B Advanced Communications if the installation directory path includes non-ASCII characters.
    A screen is displayed that shows the available features and the available disk space for your installation.
  8. Select the Production - Extend an existing cluster feature and click Next.
  9. Click Install.
  10. Choose one of the following types of configuration:
    • If you are bootstrapping the data grid, import the configuration from message fabric, data grid, and data source properties files of the first node.

      Browse for the SystemConfigurationMFLoader.properties, SystemConfigurationXSLoader.properties, and SystemConfigurationDSLoader.properties files that were installed in the first node. These files are in the install_dir/Members/resources directory.

    • If you are not bootstrapping the data grid, retrieve the configuration from the data grid.

      Enter the following information from the first node:

      • Catalog server host
      • Catalog server port
      • WebSphere® eXtreme Scale data grid user name
      • WebSphere eXtreme Scale data grid password
  11. Click Next.
  12. Select the database that you used for the existing nodes.
  13. Optional: If you want to automatically create the database schema in the specified data sources, select the box for that feature.
  14. Optional: If you are automatically creating the database schema, specify whether you want to drop existing tables before you create the schema.
  15. If you are using the Oracle or the SQL Server database, select the database JDBC driver that you used for the existing nodes and click Next. If you are using the DB2® database, you do not need to select a JDBC driver.
  16. Decide what members to deploy on the node that you are installing. Configure a member by first checking the Deploy member_type member check box of the member. Then, configure the information that is displayed under the member.
    Important: The member names have default values for only the first node that you install. The member names on additional nodes must be unique.
    • Operational
      • Member name
      • JMX port (defaults to 9443)
    • Informational
      • Member name
      • HTTP(S)/JMX port (defaults to 19443)
    • Container
      • Member name
      • JMX port (defaults to 18443)
      • Grid zone name
        Important: Each container member in a high availability installation must be in a uniquely named zone.
    • Catalog
      • Member name

        This name must be different from the names of the catalog members on other nodes. This name must match the name of one of the catalog names that you created when you set up the data grid.

      • JMX port (defaults to 17443)
  17. Enter and confirm a system passphrase that is used to start the system, access protected system information, and create the keystore.

    You can later change this passphrase by using the passphrase set command.

  18. Decide whether you want to use the default JCE file that is included in the installation or the stronger JCE file that you must download from IBM.
    Attention: The default JCE file does not provide strong encryption.
    • If you want to use the default JCE file, do not check the box at the Install Java Cryptography Extension (JCE) Unlimited Strength Jurisdictional Policy field.
    • If you want to use the stronger JCE file, select the box at the Install Java Cryptography Extension (JCE) Unlimited Strength Jurisdictional Policy field and access the JCE file at the JCE file field.
  19. If you want to install a custom system certificate for securing the user interface and Java™ Management Extensions (JMX), select the box for that feature. Then, complete the following fields.

    If you do not select the box, a self-signed certificate is generated for securing the user interface and JMX.

    1. In the PKCS12 system certificate archive field, select the PKCS12 file.
    2. Enter a password for the PKCS12 file.
    3. Enter a certificate alias for the PKCS12 file (defaults to System).

    After you enter the security information, click Next.

    The Install Packages page is displayed.
  20. Click Install to populate the installation directory with the configuration information.

    When the installation finishes, click Finish.

    • All of the installation files are in the installation directory.
    • The members have all been enabled. Start the members from a command line.
  21. Close the Installation Manager by clicking File > Exit.
  22. If you are manually creating queues, see Manually creating queues in WebSphere MQ.
  23. Open a command-line window.
  24. Navigate to the [Installation directory]/Members/bin directory.
  25. To start the node, type execute member start all.
  26. To configure the storage system, type execute storage -provision -a.

    For more information about provisioning storage, see Provisioning storage from the command line.

  27. Access the installation at https://[Installation Hostname or IP address]:[Informational port number]/advcomm.
  28. Log in to the installation with the default account that you were assigned. The two default accounts are System Administrator, sysadmin, and Master Account Administrator, maccountadmin. For more information about default account credentials, see Configuring default account credentials.

What to do next

You can now configure the rest of B2B Advanced Communications, including organizations, user credentials, and exchange profiles.