Using a custom port for tunneling

If the Sametime server is configured for tunneling on port other than 8082, you must modify the stlinks.js file on both the Sametime server and the Lotus iNotes server.

1. Locate the following directory on your Sametime server. This directory contains both the stlinks.js file and the hostinfo.js file.

<Sametime_data_directory>\domino\html\sametime\stlinks

var HTTP_TUNNELING_PORT=xx;

var TUNNELING_ADDRESS="";

The values you see for these variables in the hostinfo.js file should match your Sametime server tunneling configuration. For releases after 2.5, Sametime normally creates and automatically updates the content of these files on the Sametime server.

Note When you upgrade your Sametime server to a later release, the stlinks.js file is replaced with the default version and you must perform steps 1-3 again to update the file. It is also possible that installing a Sametime fix pack may make it necessary to restore the updates.

Note If the Lotus iNotes server is running on IBM® i, make sure that the owner of the stlinks.js file is set to QNOTES.

If your network environment uses reverse proxy servers to protect the identities of servers behind a firewall, you may need to modify the stlinks.js file on both the Lotus iNotes server and the Sametime server.

You must modify the stlinks.js file if you want Lotus iNotes users to be able to connect to the Sametime community inside the Intranet even if they are outside the firewall. Stlinks.js is located in the following directory on each server:

<Domino_data_directory>\domino\html\sametime\stlinks

ll_RProxyName - the reverse proxy name

ll_AffinityId - the Sametime server affinity ID

var ll_RProxyName="https://proxy.ibm.com";

var ll_AffinityId="st1";

For more information about reverse proxy support, see the IBM Lotus Sametime 8.0.x Information Center.

Once you have customized the contents of the stlinks.js files, there are some issues related to future server upgrades that you need to be aware of:

• When you upgrade Domino to a new release, the customized STLinks files may be replaced, and Lotus iNotes-Sametime integration may stop working. This can occur when you upgrade Domino on either the Lotus iNotes server or the Sametime server.

  In recent Domino releases, the original contents of the STlinks directory are backed up to the following directory before the files are replaced:

  
  Microsoft® Windows®: <Domino_data_directory>\domino\html\sametime\stlinks.save

  IBM® AIX® and Solaris: <Domino_data_directory>/domino/html/sametime/stlinks.save

  IBM® i: <Domino_data_directory>/domino/html/sametime/stlinks/stlinks.sav

  
  After you upgrade Domino on either the Lotus iNotes server or the Sametime server, restore any stlinks.js customizations from the file in the backup directory to the file in the stlinks directory.
• When you update the level of Lotus Sametime by installing a newer release of Sametime or applying a fix pack, it is possible that you will also need to copy the newer version of the stlinks directory to your Lotus iNotes server. Make sure you check the documentation that accompanies the Sametime update to determine if this is necessary. If this occurs, you will need to reapply your stlinks.js customizations on each of the servers.

If you are using a reverse proxy servers in your environment, you need to edit the servlets.properties file installed in the Lotus iNotes server's data directory and specify the name of the Sametime server.

1. Open the servlets.properties file (in the Lotus iNotes server's data directory), using a text editor.

2. Add the line below, where sametime.yourdomain.com is the name of the Sametime server. You can also specify IP address instead of the fully qualified domain name (FQDN).

servlet.DWABuddyList.initArgs=stserver=sametime.yourdomain.com

Related topics

Additional documentation resources
Setting up Lotus iNotes with Sametime

Glossary