Installing the primary node for a Sametime Gateway cluster on IBM i

Install the primary node for an IBM® Sametime® Gateway cluster on IBM i.

About this task

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

Procedure

  1. On the computer where you will install Sametime Gateway, log on as user with the *ALLOBJ and *SECADM authorities.
  2. Find the software packages you need to download.
  3. Download the packages.
  4. Extract all downloaded packages.
  5. Install IBM Installation Manager.
  6. Install IBM WebSphere Network Deployment.
  7. Navigate to the directory where you extracted the Sametime Gateway package and start the installation:
    • To run the installer in wizard mode, type the following command: installi5OS.bat
    • To run the installer in console mode, perform these steps:
      1. Copy the directory containing the extracted Sametime Gateway package (for example, /TMP/SametimeGateway) to the IFS of the IBM i system.
      2. Start a QSHELL session.
      3. Navigate to the directory containing the extracted Sametime Gateway package and type the following command: 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.

  8. Select the language for the installation wizard, and the click OK.
  9. On the Welcome page, click Next.
  10. On the Software License Agreement page, read the license agreement carefully, click Agree, and then click Next.
  11. Select Primary Node as the type of installation, and then click Next.
  12. Type the node name, cell name, host name, profile name, and starting port value for the WebSphere Application Server as follows, and then click Next.
    OptionDescription
    Node Logical name for the node. For example, exampleNode.
    Cell 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, exampleCell.
    Host name Fully qualified domain name of the computer on which you are installing WebSphere Application Server. For example: server1.example.com
    Profile name Name of the WebSphere Application Server profile that will be created and be installed with the Sametime Gateway Server. For example: STGW_Profile
    Starting port IBM i supports running multiple profiles and instances of WebSphere Application Server at the same time; to avoid port conflicts the profile created will not use the default ports. Select a port range of 50 consecutive unused ports on your system, and enter the first port number as your starting port. For example: 10000.
  13. 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: 
    ;*!?"/<>|+&'`[]%^
  14. 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.

  15. Provide database properties for the Sametime Gateway database hosted on DB2, , and then click Next.
    OptionDescription
    Host name Fully qualified host name or TCP/IP address of the DB2 server.
    Schema name The name of the schema you created when preparing the Sametime Gateway environment. For example, STGW.
    Application user ID The user ID of the DB2 administrator.
    Application password The password of the DB2 administrator.
  16. Review the installation settings, change them if needed, and then click Install.

    Click Back to make changes to installation settings.

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

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