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
- On the computer where you will install the TURN Server,
log on as root (Linux™) or as
the system administrator (Windows™).
- 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.
- 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
- Create a new directory, where you will install the TURN
Server files.
For example, on Windows you might call the directory: C:\TURN.
- 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.
- 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.
- 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.
- Run the batch file to start the TURN Server:
Linux
run.sh
Windows
run.bat
- 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.