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
- On the computer where you will install Sametime Gateway, log on
as user with the *ALLOBJ and *SECADM authorities.
- Find the
software packages you need to download.
- Download
the packages.
- Extract all downloaded packages.
- Install IBM Installation Manager.
-
Install IBM
WebSphere Network Deployment.
- 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:
- Copy the directory containing the extracted Sametime Gateway package
(for example,
/TMP/SametimeGateway
) to the IFS of
the IBM i system.
- Start a QSHELL session.
- 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.
- Select the language for the installation wizard, and the
click OK.
- On the Welcome page, click Next.
- On the Software License Agreement page,
read the license agreement carefully, click Agree,
and then click Next.
- Select SIP and XMPP proxy servers as
the type of installation, and then click Next.
- 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.
Option | Description |
---|
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. |
- 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:
;*!?"/<>|+&'`[]%^
- 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.
- Review the installation settings, change them if needed,
and then click Install.
Click Back to
make changes to installation settings.
- 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
.