TEMS UDP Server User’s Manual

© Infovista Sweden AB. All rights reserved.

No part of this document may be reproduced in any form without the written permission of the copyright holder.
TEMS is a trademark owned by Infovista. All other trademarks belong to their respective owner.

The contents of this document are subject to revision without notice due to continued progress in methodology,
design and manufacturing. Infovista shall have no liability for any error or damage of any kind resulting from the
use of this document.

www.infovista.com | 1
Contents
1 Introduction....................................................................................................................................................... 3
2 Prerequisites .................................................................................................................................................... 3
2.1 Operating System...................................................................................................................................... 3
2.2 PC Configuration ....................................................................................................................................... 3
2.3 TEMS Investigation Version Compatibility................................................................................................. 3
3 Installing TEMS UDP Server ............................................................................................................................ 3
3.1 Performing the Installation ......................................................................................................................... 3
3.2 Verifying the Installation ............................................................................................................................ 4
4 TEMS UDP Server Start-up.............................................................................................................................. 4
4.1 Firewall Configuration................................................................................................................................ 4
4.2 Service Recovery Settings ........................................................................................................................ 5
4.3 Starting TEMS UDP Server ....................................................................................................................... 5
4.4 Retrieval of Configuration Data ................................................................................................................. 6
5 Editing the TEMS UDP Server Configuration ................................................................................................... 7
5.1 TEMS.Investigation.UDPServerSettings ................................................................................................... 7
5.2 TEMS.Investigation.UDPServerResultFileSettings .................................................................................... 8
5.2.1 Result File Example ........................................................................................................................... 9
6 Troubleshooting.............................................................................................................................................. 10

www.infovista.com | 2
1 Introduction
This document tells how to install, configure, and start the Windows service TEMS UDP Server. The present
revision of the document deals with TEMS UDP Server version 2.0, compatible with TEMS Investigation 12.0 and
later.

2 Prerequisites

2.1 Operating System

Windows Server 2008, Windows Server 2003, Windows 7, Windows Vista, or Windows XP is required.

2.2 PC Configuration
In Windows 7 and Windows Vista, either UAC must be disabled, or the current user must have administrator
privileges.

2.3 TEMS Investigation Version Compatibility

• TEMS Investigation versions 12.0 and later must run against TEMS UDP Server 2.0 or later.

• Pre-12.0 versions of TEMS Investigation must run against a pre-2.0 TEMS UDP Server.

3 Installing TEMS UDP Server

3.1 Performing the Installation

The installation files are found in the TEMS Investigation software package.

• Double-click on the file SetupUDPServer2.0.exe, and the installation will start automatically. The installation
will check if Microsoft .NET Framework 3.5 is installed on your computer. If not, that software will be installed
first. After this part of the installation a reboot is required.

www.infovista.com | 3
• At the end of the installation, the service “TEMS UDP Server 2.0” will be registered. In Windows 7 and
Windows Vista, this requires that UAC be disabled or that the current user have administrator privileges,
otherwise the registration of the service will fail.

3.2 Verifying the Installation

• To verify that the installation was successful, look in the Windows Task Manager under Services. You should
find a service named “TEMS UDP Server 2.0”:

• Alternatively, you can verify this under Control Panel → Administrative Tools → Services. Here, too, a
service named “TEMS UDP Server 2.0” should be present:

4 TEMS UDP Server Start-up

4.1 Firewall Configuration

Before starting TEMS UDP Server for the first time, you must open certain ports in your firewall. Specifically, the
following ports need to be opened in the firewall against the server:

• TCP Control Port

www.infovista.com | 4
• UDP Receive Ports

• UDP Send Ports

The reason that the UDP Send Ports need to be open is that the client will send a NAT open packet to the
server’s send port.

4.2 Service Recovery Settings

It may be desirable to have the TEMS UDP Server service restart itself in case it crashes. This is configured as
follows:

• Open the Control Panel and navigate to Administrative Tools → Services.

• Right-click the “TEMS UDP Server 2.0” service and choose Properties.

• In the service properties dialog, click the Recovery tab and enter values in the dialog as shown below.

4.3 Starting TEMS UDP Server

The first time around you need to start the TEMS UDP Server service manually:

• Right-click TEMS UDP Server 2.0 in one of the places indicated in section 3.2, then select the start command
(Start Service or Start).

On later occasions, TEMS UDP Server will start automatically when the computer boots up. Therefore, if for
instance a power failure occurs, the service will be up and running again once the computer has rebooted.

www.infovista.com | 5
4.4 Retrieval of Configuration Data
At start-up, TEMS UDP Server will search for configuration data in the following places (described in order of
precedence):

1. Start parameters entered directly in the service properties (Control Panel → Administrative Tools →
Services → right-click service). See the screenshot below.

2. Settings file. Such a file is provided with the application; see section 5.1.

www.infovista.com | 6
3. If neither start parameters nor a settings file is found, the following static parameter values will be used:

• TCP Control Port: 4035

• UDP Send Ports: 60101 ... 60150

• UDP Receive Ports: 60151 ... 60200

5 Editing the TEMS UDP Server Configuration

TEMS UDP Server makes use of two settings files:

• TEMS.Investigation.UDPServerSettings, specifying which ports the server should use;

• TEMS.Investigation.UDPServerResultFileSettings, controlling whether to save information about the session

in a text file.

5.1 TEMS.Investigation.UDPServerSettings
The file is very straightforward. The TCP Control Port is the port which the client first connects to and through
which the control information between the client and server is exchanged. The other (UDP) ports are used strictly
for data traffic between server and client. The default port numbers are as indicated below:

www.infovista.com | 7
5.2 TEMS.Investigation.UDPServerResultFileSettings
In this file you specify whether to save information about each UDP session in a text-format result file, and if so
the maximum size of that file. By default, result file logging is turned on, and the maximum file size is 5000 lines
(approx. 89 kB).

The result files will be stored in the location shown below, in folders that are named according to the current date:

www.infovista.com | 8
5.2.1 Result File Example
Below is an example of a result file produced when running a full duplex UDP session.

Each new session is headed by a line of asterisks (*).

The Generic Test Info section gives generic information such as which ports were used by server and client, what
packet size was used, and which UDP mode the client selected.

The sections that follow contain session performance data. What sections are present depends on the UDP mode
used (receive, send, or full duplex).

www.infovista.com | 9
6 Troubleshooting
• If the following error message appears when the server is starting up: “Error 1053: The service did not
respond to the start or control request in a timely fashion”, do one of the following (the two procedures have
the same effect):

• Remove the internet cable. Start the service. Plug in the internet cable.

OR

• Open a command prompt and type ipconfig/release. Start the service. At the command prompt, type:
ipconfig/renew.

www.infovista.com | 10