Lotus Sametime on Windows Server 2000 or Later

Last update: 2022-10-04
  • Created for:
  • User

Read more about Data Workbench’s End-of-life announcement.

Instructions about how to install and configure Sensor for Lotus Sametime for Windows 3.1 or later running under Microsoft Windows Server 2000 or later.

The program files for Sensor are packaged in an installation file that you obtain from the Adobe download site. If you do not already have the Sensor installation file for your particular web server, download it (or obtain it from your Adobe representative) before you begin the following procedures.

To install and configure Sensor, you must perform the following high-level steps:

Install the Program Files

When running Sensor on Sametime, the program files and the disk queue file must reside in the same directory.

Therefore, before installing the program files, you must determine where you want to maintain the disk queue, because that is also where you must install the program files.

Use the following procedure to extract and install the program files for Sensor.

  1. Stop the Lotus Domino Server and the Sametime Chat Logging service.
  2. On your Windows machine, in the Lotus Domino directory, delete or backup the file named StChatLog.dll.
  3. Extract the contents of the installation file into the Lotus Domino directory. During this step, Sensor installs the following files:
File Description
EventMessages.dll Event Viewer messages
stchatlog.dll The collector module


An Excel spreadsheet file that architects can use to configure a controlled experiment

Sensor does not use this file.

trust_ca_cert.pem The certificate used to validate the digital certificate that Insight Server presents during the connection process
TXLog.exe The transmitter program


The Sensor configuration file

The installation package contains a spreadsheet file called TestExperiment.xls. This spreadsheet is a tool that architects use to configure a controlled experiment. Sensor itself does not use this file, so it is not necessary to install the file on the machine where Sensor is running (although you can choose to do so). You might want to, instead, copy the file to a location where your architects can access it or simply extract the file from the installation package as needed. For more information about controlled experimentation, see the Insight Controlled Experiments Guide.

Enable Logging on the Sametime Server

Steps that allow you to log on to the Sametime Server.

  1. Use the Lotus Domino Administrator client to connect to the Lotus Domino server that is running Sametime.
  2. In the Lotus Domino Administrator, click the Files tab, then double-click Sametime Configuration - stconfig.nsf to open the Sametime Configuration file.
  3. In the Sametime Configuration file, open the Community Services form and double-click anywhere on the form to enter edit mode.
  4. Set Chat Logging Flag to “strict” and Capture Service Type to “0x1000.”
  5. Save and close the Community Services form, then close the Sametime Configuration file.
  6. Restart the Sametime server.

Edit the Sensor Configuration File

The txlogd.conf file contains the configuration parameters for Sensor.

You must edit this file to specify, among other things, the size and location of the disk queue file, the address of the Insight Server, and the ID that will be attached to the event data produced by this sensor.

The configuration file contains required parameters and optional parameters.

  • Required parameters are settings that you must specify when you install Sensor. Without these settings, Sensor does not run successfully.
  • Optional parameters are settings that default to pre-defined values (which you can modify) or enable optional features.

To edit the Sensor configuration file

  • Open the <Sensor directory>/txlogd.conf file in a text editor and set the required parameters as well as any desired optional parameters.
  • Save and close the file.

Start the Transmitter and Create the Disk Queue

After you configure the txlogd.conf file, you can start the transmitter program, register it as a Windows service, and create the disk queue.

  1. From the Start menu in Windows, select Accessories > Command Prompt.

  2. In the command prompt window, navigate to the directory in which you installed Sensor and execute the following command:

    txlog /regserver

    This command starts the transmitter, creates the disk queue, and registers Sensor as a Windows service.

  3. To confirm that the transmitter is running correctly, click Start > Control Panel > Administrative Tools > Services.


    This command sequence might vary depending on which version of Windows you are using.

    1. In the service list, locate the entry for Sensor and confirm that its status is Started and its startup type is Automatic.
    2. Close the Services control panel.
  4. To check whether transmitter experienced any errors during start-up, click Start > Control Panel > Administrative Tools > Event Viewer to open the Event Viewer.


    This command sequence might vary depending on which version of Windows you are using.

    1. In the left pane of the Event Viewer window, select the Applications log.
    2. In the right pane, look for events with “Adobe” in the Source column.
    3. If you find an error from “Adobe,” double-click the error to display the Event Properties window. This window provides detailed information about the error.
  5. When you finish examining the Applications log, close the Event Viewer.

  6. Verify that the transmitter has created the disk queue (Diskq2000.log) in the directory where you installed the Sensor program files and that it is the size that you specified in the QueueSize parameter in the txlogd.conf file.

    If the queue has not been created correctly:

    1. Examine the txtlogd.conf file and verify that the QueueSize parameter is set correctly.

    2. Check that the device on which you installed Sensor has sufficient space available to hold a file of the size specified in the QueueSize parameter.

    3. Using the Services control panel in Windows, stop the transmitter.

    4. Delete the queue file.

    5. Re-register Sensor as a Windows service: from the Start menu in Windows, select Accessories > Command Prompt. In the command prompt window, navigate to the directory in which you installed Sensor and execute the following command:

      txlog /regserver

      The transmitter is designed to run continuously. If you restart the machine, the transmitter restarts automatically. If you need to start and stop the transmitter manually, you can do so using the Services control panel in Windows.

  7. Restart the Lotus Domino Server and the Sametime Chat Logging service.

On this page