Installing the primary node for a Sametime Gateway cluster

Install the primary node in the IBM® Sametime® Gateway cluster.

About this task

Use IBM Installation Manager to install IBM WebSphere® Network Deployment on the computer before installing Sametime Gateway with the Primary Node profile.

Procedure

  1. On the computer where you will install the Sametime Gateway server, log on as root (Linux™) or as the system administrator (Windows™).
  2. On Linux only: Refer to the following list of required Linux packages/libraries and install the appropriate packages for your operating system.
    Note: The .rpm file versions of some of these packages as available on actual OS installation media might differ from the following. If you have a newer version of a specific package that is listed here, you do not need to replace it with the older version
    For any Linux platform, the following libraries are required:
    • libstdc++.so.5
    • libstdc++-libc6.1-1.so.2 is
    For RHEL 6.x 64-bit only, 64-bit versions of the following packages are required:
    • compat-libstdc++-33-3.2.3-69
    • compat-db-4.6.21-15
    • libXp-1.0.0-15.1
    • libXmu-1.0.5-1
    • libXtst-1.0.99.2-3
    • libXft-2.1.13-4.1
    • pam-1.1.1-4
    • gtk2-2.18.9-4
    • gtk2-engines-2.18.4-5
    • rpm-build-4.8.0-12
    • elfutils-0.148-1
    • elfutils-libs-0.148-1
    • ksh-20100621-2
    For RHEL 6.x 64-bit only, 32-bit versions of the following packages are also required:
    • compat-libstdc++-33-3.2.3-69
    • compat-db-4.6.21-15
    • libXp-1.0.0-15.1
    • libXmu-1.0.5-1
    • libXtst-1.0.99.2-3
    • libXft-2.1.13-4.1
    • pam-1.1.1-4
    • gtk2-2.18.9-4
    • gtk2-engines-2.18.4-5
    • glibc-2.12-1.7
    • libgcc-4.4.4-13
    • libstdc++-4.4.4-13
    • libXi-1.3-3
    For RHEL 6.x 64-bit Silent Install only:
    • glibc-2.12-1.7
    • libgcc-4.4.4-13
    • libstdc++-4.4.4-13
    • libXp-1.0.0-15.1
    • libXmu-1.0.5-1
    • libXtst-1.0.99.2-3
    • libXft-2.1.13-4.1
    • libXi-1.3-3
    • Required RPM: compat-libstdc++-33
    • Required library: libstdc++.so.5 & libstdc++-libc6.1-1.so.2
  3. Find the software packages you need to download.
  4. Download the packages.
  5. Extract all downloaded packages.
  6. Install IBM Installation Manager.
  7. Install IBM WebSphere Network Deployment.
    Note: Sametime Gateway requires WebSphere Application Server Network Deployment 8.8.5.x and is not supported on V9.
  8. Navigate to the folder where you extracted the Sametime Gateway package and run the following command to install Sametime Gateway:
    Linux
    install.sh -console
    Attention: If one or more of the DNS addresses in your environment (for example: WebSphere Application Server installation host name, DB2® host name, or LDAP host name) refers to an IPv6-format address, add the following option to your install command to work around an IPv6-related issue with the installer:
    install.sh -console -V BypassWasInfoCheck=true

    Because your input will not be verified during installation, you should take extra care when typing values.

    Windows
    • For wizard mode: install.bat
    • For console mode: install.bat -console
    Attention: If one or more of the DNS addresses in your environment (for example: WebSphere Application Server installation host name, DB2 host name, or LDAP host name) refers to an IPv6-format address, add the following option to your install command to work around an IPv6-related issue with the installer:
    install.bat -V BypassWasInfoCheck=true

    Because your input will not be verified during installation, you should take extra care when typing values.

  9. Select the language for the installation wizard, and the click OK.
  10. On the Welcome page, click Next.
  11. On the Software License Agreement page, read the license agreement carefully, click Agree, and then click Next.
  12. Select Primary Node, and then click Next.
  13. Check the node name, cell name, and host name that are supplied by the installer. Make sure that the cell and node names do not match the cell and node names you used when installing the deployment manager. Choose a unique node name and cell name for this installation. If the supplied information is okay, click Next.
    Table 1. Primary Node values
    Field Value
    Node The logical name for the node. For example, exampleNodePrimary.
    Cell A name for the cell. Every WebSphere Application Server is created on a node inside a cell. A cell is a collection of nodes for administration and workload management. For example, exampleCellPrimary.
    Host name The fully qualified domain name of the computer where you are installing WebSphere Application Server. For example: server1.example.com
  14. Create a WebSphere administrator account by supplying a new user ID and password, and then click Next.
    The user must not exist in the LDAP directory. The password must not contain accented characters or any of the following characters: 
    ;*!?"/<>|+&'`[]%^
  15. Review the default directory path where Sametime Gateway Server will be installed, change it if necessary, and then click Next.

    To change the location, click Browse and select a location, or type a new path.

  16. Provide database properties for the Sametime Gateway database hosted on DB2 and then click Next.
    Table 2. Database properties for the Sametime Gateway database
    Database Properties Value
    Host name Fully qualified host name or TCP/IP address of the DB2 server.
    Port Port number of the DB2 server (typically 50000 on Windows and 50001 on Linux).
    Database name The name of the database that you created (the name is not case sensitive). If you used the default database name, type STGW.
    Application user ID The user ID of the DB2 administrator.
    Application password The password of the DB2 administrator.
    Schema user ID The ID for the user that has appropriate permissions to create tables in the database; typically the DB2 administrator.
    Schema password The password for the schema owner.
  17. Review the installation settings, change them if needed, and then click Install.

    Click Back to make changes to installation settings.

  18. Read the installation summary, optionally click View log file to review the log, and then click Finish to close the wizard.

Results

To view the installation log after the wizard is closed, open the log file at stgw_server_root\logs\installlog.txt.