Installing a single Sametime Gateway server on IBM i

Install IBM® Sametime® Gateway as a single, non-clustered server on IBM i.

About this task

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

Procedure

On the computer where you will install Sametime Gateway, log on as user with the *ALLOBJ and *SECADM authorities.
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:
  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.
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 Standalone server, and then click Next.
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.

Provide database properties for the Sametime Gateway database hosted on DB2, , and then click Next.

Table 1. 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 AIX® or 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

Choose whether to connect to the LDAP server now, or to defer that task until after installation is complete, and then click Next.
- Configure LDAP now
  Configure the LDAP connection now if you will not require an SSL connection. If you choose to configure the connection now, continue to the next step.
- Configure LDAP after the installation
  Configure the LDAP connection later if you will use SSL, if you do not know the host name and port number used by LDAP, or if there is a firewall between the LDAP server and this new Sametime Gateway server. If you choose to configure the LDAP connection later, skip to step 22.
Select an LDAP host name from list of Registered host names and ports in your domain, or select Other and type a host name or IP address in the Host name field. Accept the default port or change it now, and then click Next.
Choose whether to allow anonymous access, and then click Next..
If your LDAP server is not configured to allow anonymous access, you will not see this option.
- Anonymous access
  Select this option if you don't need authenticated access to the LDAP server, and skip to step 22.
- Authenticated access
  Select this option if your LDAP server requires authenticated access, and continue to the next step. You must provide an authentication identity, including a bind distinguished name and password from the LDAP administrator.
Enter the Bind distinguished name (DN) and Bind password values, and then click Next..
- Bind distinguished name
  The bind distinguished name can be any user with read access to the LDAP server; this user does not have to be the LDAP administrator. For example:
```
uid=ldapadmin,cn=users,l=shipley,st=kansas,c=us,ou=example,o=medical,DC=EXAMPLE,DC=COM
```
- Bind password
  For example: 8M96l02CxyP
In the Base distinguished name field, select a base distinguished name from the list of Suggested base distinguished names in your LDAP or provide one, and then click Next.
Note: This page does not display if you are connecting to an IBM Domino® LDAP.
The base distinguished name indicates the starting point for LDAP searches. For example, for the bind distinguished name given as an example in the previous step, you can specify the base DN as: DC=EXAMPLE,DC=COM. For authorization purposes, this field is case sensitive.
On the Sametime Gateway Server installation summary page, 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.

Results

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

What to do next

IBM i allows multiple instances of Sametime Gateway Server to be installed on a single IBM i system. If a Sametime Gateway Server is running while you install a new Sametime Gateway Server, restart the original instance of Sametime Gateway.