Lotus Domino Administrator 8 Help - Customizing STLinks files for tunneling or reverse proxy servers

INSTALLATION

Customizing STLinks files for tunneling or reverse proxy servers
If your IBM® Lotus® Sametime® server is configured for tunneling or if you are using reverse proxy servers in your environment, you may need to customize some files on both your IBM® Lotus® Domino™ Web Access server and your Sametime server.

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 Domino Web Access 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

2. Copy the following two lines from the Hostinfo.js file to the beginning of the stlinks.js file (by default, there are only 2 lines in the Hostinfo.js file):

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.

3. Save the updated stlinks.js file 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.

4. Copy the updated stlinks.js file from the Sametime server to the Domino Web Access server, replacing the existing stlinks.js file in <domino_data_directory>\domino\html\sametime\stlinks.

Note

If the Domino Web Access server is running on i5/OS, make sure that the owner of the stlinks.js file is set to QNOTES.

Using reverse proxy servers

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 Domino Web Access server and the Sametime server.

You must modify the stlinks.js file if you want Domino Web Access 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

Two variables that provide reverse proxy support are included in stlinks.js:

ll_RProxyName - the reverse proxy name

ll_AffinityId - the Sametime server affinity ID

To enable reverse proxy support, the server administrator must replace the defaults with appropriate values and uncomment the lines. For example:

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

var ll_AffinityId="st1";

Make sure you update the stlinks.js file on both the Domino Web Access server and the Sametime server.

For more information about reverse proxy support, see the IBM Lotus Sametime 7.5 Installation Guide (available on http://www.lotus.com/LDD/doc).

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 Domino Web Access-Sametime integration may stop working. This can occur when you upgrade Domino on either the Domino Web Access 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:
After you upgrade Domino on either the IBM® Lotus® Domino™ Web Access 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 IBM® 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 Domino Web Access 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.

Additional setting for the Domino Web Access Instant Contacts client

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

1. Open the servlets.properties file (in the Domino Web Access 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

3. Save and close the file, and then restart the server.

Glossary

Feedback on Help or Product Usability?

Help on Help

All Help Contents

Glossary