Collecting data about network congestion problems

To diagnose network problems that affect performance and stability of the Sametime® Community Server, add data collection settings to the sametime.ini file. These settings collect data related to network traffic that you can then send to IBM® Support for evaluation.

Procedure

  1. Edit the sametime.ini file located in the Community Server installation directory. For example, the default directory in Windows® is C:\Program Files\IBM\Domino.
  2. Add one or more of the following settings to the [Debug] section.
    Table 1. Recommended settings for network diagnostics
    Recommended Setting Description
    UCM_TRANSFER_RATE_SAMPLE_INTERVAL=5 Use this setting to investigate delays and slow traffic. A value of 5 samples the transfer rates of all Sametime TCP connections every 5 seconds.

    Set the value to 0 if you do not want to sample transfer rates.

    UCM_TRANSFER_RATE_TRACE_ALL_SAMPLES=1 Use this setting to investigate delays and slow traffic. Set the value to 1 to print all transfer rate samples to debug trace files.
    VPS_SERVER_TRANSFER_RATE_REPORT_FREQ=8

    Use this setting to capture transfer rates of server-to-server TCP connections. A value of 8 generates a report 8 times a day (every 3 hours). Reports are generated in the sametime.log file.

    Set the value to 0 if you do not want to generate reports.

    UCM_DELAY_THRESHOLD=10 Use this setting to investigate delays. The value is the threshold, in seconds, when data that is queued for sending but not yet sent is reported as "delayed" in the socket layer.

    Set the value to 0 if you do not want to detect delays in the socket layer.

    UCM_DELAY_SNIFF=0 This setting is useful only in a few special cases. The recommended setting is 0.

    If needed, set this value to 1 to dump buffer contents to the debug trace files when a delay is detected by UCM_DELAY_THRESHOLD.

    VP_DELAY_THRESHOLD=10 Use this setting to investigate delays. The value is the threshold, in seconds, when encrypted data that is queued for sending but not yet sent is reported as "delayed" in the encryption layer.

    Set the value to 0 if you do not want to detect delays in the encryption layer.

    VP_DELAY_SNIFF=0 This setting is useful only in a few special cases. The recommended setting is 0.

    If needed, set this value to 1 to dump buffer contents to the debug trace files when a delay is detected by VP_DELAY_THRESHOLD.

  3. Save the sametime.ini file and then restart the Community Server.

What to do next

When you no longer need to collect the data, set the values back to 0 and restart the server.