IBM Support

Sametime STMux fails to work with Domino HTTP URL redirection documents on a tunneled server

Technote (FAQ)


Question

Can a Lotus® Sametime® server use Domino® HTTP redirection documents if the server has been set up for tunneling over port 80?

Answer

When a Sametime server has been set up for tunneling over port 80, the Sametime MUX (STMux) is listening for port 80 traffic. There are several situations where HTTP redirection is needed (STMux located on a separate machine or when a reverse proxy is enabled).

Traditionally, STMux handles HTTP redirect responses by stripping the Location host and keeping only the path. Using a redirect Location URL without a Location host is supported by most HTTP implementations. It is done here in order to avoid cases where redirections might direct the client so that it does not come through STMux. In some cases, however, the "guessed" complete URL is not the correct one. As a result, the browser on the client appears to be in an infinite loop where the web page never loads.

For Sametime releases prior to 7.5 Cumulative Fix Pack 1 (CF1), the only way for HTTP redirection documents to work correctly on a Sametime server is to not set up the Sametime server for tunneling over port 80.

A fix is available in Sametime 7.5 CF1 and later Sametime releases that offers an alternative approach. Instead of stripping the host[:port] from the URL, the administrator can provide rules for translation from a list of host[:port] names to the host[:port] name which should be used instead.

In order to take advantage of the fix, the administrator must add the following settings to the [Config] section of the sametime.ini file (located in the server data directory):

  • VPMX_HTTP_REDIRECT_ENABLE_RELATIVE

    1: Keep the old behavior, which changes redirect URLs to relative ones by removing the Location host.

    0: Disable the old behavior and instead perform URL translations as defined by settings described below.

    Default: 1. To enable the new behavior, this must be set to 0.

  • VPMX_HTTP_REDIRECT_TRANS_FROM_HOSTPORTS

    This setting is only used if VPMX_HTTP_REDIRECT_ENABLE_RELATIVE=0.

    Provide a list of host or host:port values (separated by commas) for redirection response URLs which should be translated as defined by setting below.

    Default: no translation. All redirection URLs are passed unchanged.

  • VPMX_HTTP_REDIRECT_TRANS_TO_HOSTPORT

    This setting is only used if VPMX_HTTP_REDIRECT_ENABLE_RELATIVE=0.

    Host or host:port to which any values in the previous setting should be translated.

    Default: no translation. All redirection URLs are passed unchanged.


Example:

Assumptions -

  • Your Domino server is known as: maindomino.your.org, domino1.your.org and domino2.your.org
  • Your STMux installation is known as stmux.your.org
  • Domino HTTP server serves on port 8088
  • STMux serves and tunnels HTTP on port 80


For this example, add the following settings to the [Config] section of the sametime.ini to enable the appropriate translation:

[Config]
VPMX_HTTP_REDIRECT_ENABLE_RELATIVE=0
VPMX_HTTP_REDIRECT_TRANS_FROM_HOSTPORTS=maindomino.your.org:8088, domino1.your.org:8088, domino2.your.org:8088
VPMX_HTTP_REDIRECT_TRANS_TO_HOSTPORT=stmux.your.org

If STMux encounters any redirect response URLs for which the Location host is found in the list provided by the VPMX_HTTP_REDIRECT_TRANS_FROM_HOSTPORTS setting, the Location host is translated to stmux.your.org.

If STMux encounters a redirect response URL with a Location host that is not in the list provided by the VPMX_HTTP_REDIRECT_TRANS_FROM_HOSTPORTS setting, the URL is passed through without translation.

Document information

More support for: IBM Sametime
Install/Configuration

Software version: 7.0, 7.5, 7.5.1, 7.5.1.1, 7.5.1.2, 8.0, 8.0.1, 8.0.2, 8.5, 8.5.1, 8.5.1.1, 8.5.1.2, 8.5.2, 8.5.2.1, 9.0, 9.0.0.1

Operating system(s): AIX, IBM i, Linux, Solaris, Windows

Reference #: 1176728

Modified date: 08 July 2009


Translate this page: