Setting tuning parameters for the Sametime Proxy Server

Refine the tuning parameters for the Sametime® Proxy Server for better performance.

Procedure

  1. On the Sametime Proxy Server, log in to the IBM® WebSphere® Integrated Solutions Console as the WebSphere administrator.
  2. Set JVM verbose garbage collection and heap sizes on the Sametime Proxy Server by completing the following steps:
    1. Click Servers > Server Types > WebSphere application servers > STProxyServer.
    2. In the Server Infrastructure section, click Java and process management > Process definition > Java Virtual Machine.
    3. Click Verbose garbage collection to enable verbose garbage collection on the Sametime Proxy Server. Be sure the Verbose garbage collection setting contains a check mark.
    4. Set the following heap size values according to operating system:
      • For a 32-bit operating system, set Initial heap size to 256 MB and set Maximum heap size to 1280 MB.
      • For a 64-bit operating system, set Initial heap size to 8192 MB and set Maximum heap size to 10240 MB.
    5. In the Generic JVM arguments field, enter the following generic JVM arguments:
      -Dclient.encoding.override=UTF-8
      -Xgcpolicy:gencon
      -Dsun.nio.MaxDirectMemorySize=1610612736
      -XX:NewSize=2048m
      -XX:MaxNewSize=2560m
    6. Click OK.
  3. Adjust web container transport settings for the Sametime Proxy Server by completing the following steps:
    1. In the container settings section, click Web Container Settings > Web container transport chains.
    2. Click HttpQueueInboundDefault > TCP inbound channel.
    3. In the Maximum open connections field, enter a value that is two times greater than the maximum number of expected concurrent users.
    4. In the Inactivity timeout field, enter 120 seconds.
    5. Click HttpQueueInboundDefaultSecure > TCP inbound channel .
    6. In the Maximum open connections field, enter a value that is two times greater than the maximum number of expected concurrent users.
    7. In the Inactivity timeout field, enter 120 seconds.
    8. Click OK.
  4. Set the object cache instance size for the Sametime Proxy Server by completing the following steps:
    1. Click Resources > Cache instances > Object cache instances.
    2. In the Scope list, select the STProxyServer or STProxyCluster to be modified.
    3. Click Access control objects and in the Cache size field, enter a value that is two times greater than the maximum number of expected concurrent users.
    4. Click Real Time Session Objects and in the Cache size field enter a value that is two times greater than the maximum number of expected concurrent users.
    5. Click STProxySTUserMap and in the Cache size field enter a value that is two times greater than the maximum number of expected concurrent users.
    6. Click OK.
  5. Increase web container threads by completing the following steps:
    1. Click Servers > Server Types > WebSphere application servers.
    2. In the list of application servers, click the STProxyServer link.
    3. In the Container Settings section of the STProxyServer Configuration page, click Web Container Settings > Web container > Session management.
    4. In the Maximum in-memory session count field, enter a value that is one greater than the maximum number of expected concurrent users.
  6. Increase log and trace file settings by completing the following steps:
    1. From the list of application servers, choose the Sametime Proxy Server you are configuring.
    2. In the Troubleshooting section, click Logging and Tracing > JVM Logs.
    3. In the System.out section, set File size - Maximum sizeto 10 MB and set Maximum Number of Historical Log Files to 20.
    4. In the System.err section, set File size - Maximum size to 10 MB and set Maximum Number of Historical Log Files to 20.
    5. Click OK.
  7. Increase the available TCP ports by completing the following steps according to platform:
    • Linux - Complete one of the following two steps:
      • Use the ulimit command on the Proxy Server. For example, enter the following command:

        ulimit -n 65535

      • In the nofile section of the /etc/security/limits.con file, set ulimit to 65535.

      For detailed information about using the ulimit command see the following Tech Note: Guidelines for setting ulimits (WebSphere Application Server).

    • Windows (32-bit)

      Enter the following regedit command:

      [HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip\Parameters] "TcpNumConnections"=dword:00fffffe

    • Windows (64-bit)

      Use the netsh int ipv4 show dynamicport tcp command, set to a maximum value of 60000. Enter the following command:

      netsh int ipv4 set dynamicport tcp start=1025 num=60000

  8. Modify the Web container - thread pools setting on every Sametime Proxy Server in your configuration by completing the following steps on each Sametime Proxy Server:
    1. Click Servers > Server Types > WebSphere application servers > STProxyServer.
    2. In the Additional Properties section, click Thread pools.
    3. Click WebContainer.
    4. In the Minimum Size field, enter 100 threads.
    5. In the Maximum Size field, enter 100 threads.
    6. Click OK.
    7. Save the change to the master configuration by clicking the Save link in the "Messages" box at the beginning of the page.

What to do next

AIX, Linux: AIO (Asynchronous Input/Output) native transport in WebSphere Application Server might result in limiting the number of concurrent users and unintended logouts. Disabling AIO will solve those issues. For more information, see the technote Disabling AIO (Asynchronous Input/Output) native transport in WebSphere Application Server.