Configuring the sametime.ini file for the Sametime Community Mux

Review the sametime.ini settings on the IBM® Sametime® Community Mux to confirm that they are appropriate for your site.

About this task

Follow these steps to configure the Sametime Community Mux.

Procedure

  1. Open a text editor on the stand-alone Sametime Community Mux server.
  2. Open the sametime.ini file located in the Sametime Community Mux installation directory.
  3. In the [Connectivity] section, confirm the host name (VPS_HOST) of the Sametime Community Server to which the Sametime Community Mux connects (specified during the Sametime Community Mux installation and in the Sametime Community Server's stconfig.nsf database.
  4. If you are not using the default port of 1516, add the port (VPS_PORT) that the Sametime Community Mux uses to establish a connection with the Sametime Community Server.
  5. If TLS is enabled on the Sametime Community Server, complete these steps:
    1. Add the TLS port, VPS_TLS_PORT setting, that the Sametime Community Mux uses to establish a connection with the Sametime Community Server, typically port 1516.
    2. If the Sametime Community Server port is in strict TLS mode, disable legacy Sametime encryption, by setting VPS_PORT=0 in the sametime.ini file.
    3. Copy the TLS configuration settings from the Sametime Community Server to the Sametime Community Mux. In the sametime.ini file of the Sametime Community Server, in the [Config] section, locate all entries that begin with ST_TLS_ or STMUX_TLS_ and copy them to the sametime.ini file of the Sametime Community Mux.
    4. If any of the following settings exist in sametime.ini under the [Config] section, copy the referenced file or files to the stand-alone Sametime Community Mux:
      ST_TLS_TRUST_STORE_FILE
ST_TLS_TRUST_STORE_PASSWORD_STASH_FILE
ST_TLS_KEY_STORE_FILE
ST_TLS_KEY_STORE_PASSWORD_STASH_FILE
STMUX_TLS_TRUST_STORE_FILE
STMUX_TLS_TRUST_STORE_PASSWORD_STASH_FILE
STMUX_TLS_KEY_STORE_FILE
STMUX_TLS_KEY_STORE_PASSWORD_STASH_FILE
  6. The Maximum user and server connections to the Community Server setting in the Sametime System Console for the Sametime Community Server does not apply to a stand-alone multiplexer. Instead, the VPMX_CAPACITY= parameter in the Sametime Community Mux server's own sametime.ini file controls the maximum number of connections.

    In the [Config] section, confirm or change the maximum number of simultaneous connections allowed to the Sametime Community Mux. The default value is 20,000 connections.

    VPMX_CAPACITY=20000

  7. If the Sametime Community Mux connects to Sametime servers running version earlier than Sametime 8.0.2, add the following setting with a value of 1:

    VPMX_ASSUME_COMMUNITY_ISFUNC=1

    This setting enables the Sametime Community Mux to connect to the older server.

  8. Save the sametime.ini file.