Setting up the Sametime TURN Server installation files

Deploying the IBM® Sametime® TURN Server involves installing a Java™ Run-time Environment (JRE) plus some additional files. Unlike other Sametime servers, the TURN Server does not require the IBM WebSphere® Application Server. It has no dependencies on other processes or other Sametime servers. The Sametime Connect Client, Sametime browser-based meetings, and the Media Manager can use the TURN server if they detect its presence.

About this task

The TURN server can be installed on its own computer or on a computer shared with another service. The only requirement is that you reserve port 3478 for connecting with the clients.

Procedure

  1. On the computer where you will install the TURN Server, log on as root (Linux™) or as the system administrator (Windows™).
  2. Install IBM JRE 1.6 (or later) on the server.

    JRE 1.6 is installed with IBM WebSphere Application Server on every Media Manager component that runs on WebSphere Application Server. You can copy the \jre directory from any of those servers to the TURN server.

  3. If Java is in your system path, skip this step.

    If Java is not in the system path, edit the run batch file and insert the path to the Java executable.

    Insert the path immediately before the "java.exe" reference in the command; for example in the Windows version (run.bat):

    C:\Program Files\Java\jreX.XX.XXX\bin\java.exe
  4. Create a new directory, where you will install the TURN Server files.

    For example, on Windows you might call the directory: C:\TURN.

  5. Copy the files from SametimeMediaManager/TURN_Server into the new directory.

    The Sametime TURN Server is packaged with the Sametime Media Manager; you can copy the files from any computer where you downloaded the Media Manager package.

  6. Locate the sharedEncKey1.txt and sharedEncKey2.txt files in the Media Manager's WebSphere profile directory in the paths shown here and copy both files to the directory in which other TURN files are stored when they are installed:

    /opt/IBM/media/profiles/mediaSTMSPNProfile1/properties/sharedEncKey1.txt

    /opt/IBM/media/profiles/mediaSTMSPNProfile1/etc/sharedEncKey2.txt

    These files are required by the TURN server to enable the server to start correctly.

  7. On the Conference Manager server, locate the secret key file specified in the stavconfig.xml file as the value for the key SecretKeyPathForTurnAuthToken and copy the secret key file to the TURN server directory.
  8. Run the batch file to start the TURN Server:

    Linux

    run.sh

    Windows

    run.bat
  9. Several lines are printed along with the IP address that the TURN server is listening on. Verify that the IP address is correct and accessible from the clients (and not a private network IP address).
    Note: Leave the process window open. The TURN server is not a background process. Pressing any additional keys will end the TURN server process. If you see the command prompt, the TURN server process has ended.