Installing a WebSphere SIP and XMPP proxy server

The IBM® WebSphere® SIP and XMPP proxy servers are the first point of contact, after the firewall, for messages that flow into and out of your enterprise. Install the proxy servers for both stand-alone or network deployment installations of Sametime® Gateway. For best results, install a WebSphere SIP and XMPP proxy server on its own node.

About this task

The WebSphere SIP and XMPP proxy server node installation creates a WebSphere Application Server node with two application servers installed. One server is a generic SIP proxy server provided by WebSphere Application Server, and the other is a standard application server onto which the XMPP proxy application is installed. The node does not function until it is federated to the Sametime Gateway cluster's deployment manager.

Procedure

  1. On the computer where you will install the Sametime Gateway server, log on as root (AIX® or Linux™) or as the system administrator (Windows™).
  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 folder where you extracted the Sametime Gateway package and run the following command to install Sametime Gateway:
    AIX or 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.

  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. Do one of the following:
    • If you are installing the WebSphere SIP and XMPP proxy servers on a Sametime Gateway node, click Next.

      The installation wizard adds a profile to existing instance of WebSphere Application Server.

    • If you are installing the WebSphere SIP and XMPP proxy servers on their own computer instead of on an existing Sametime Gateway node, complete the following substeps:
      1. Select SIP and XMPP proxy servers, and then click Next.
      2. On the installation directory page, type the root directory of the location where you extracted the Sametime Gateway package, and then click Next.

        This directory contains the \WAS and \JDK subdirectories. It is very important that you do not select a subdirectory.

      3. On the Location page, accept or change the installation location, and then click Next.
  12. Check the node name, cell name, and host name that are supplied by the installer and make sure that all three names are unique to this Sametime deployment, and then click Next.

    Table 1 describes the component names.

    Table 1. Component names needed for the new proxy server
    Component name Description
    Node Logical name for the node. For example, acmeNodeProxy.
    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, acmeCellProxy.
    Host name Fully qualified domain name of the computer on which you are installing WebSphere Application Server. For example: proxy.acme.com.
  13. Type the deployment manager's WebSphere administrator user ID and password, and then click Next.
  14. Review the installation summary, and then click Install.

    Click Back to make changes to installation settings.

  15. 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.