TEMS UDP Server User’s Manual

Prepared by: Date: Document:

Ascom Network Testing 10/18/2010 NT13-22830

© Ascom (2010)
TEMS is a trademark of Ascom. All other trademarks are the property of their respective holders.
No part of this document may be reproduced in any form without the written permission of the copyright holder.
The contents of this document are subject to revision without notice due to continued progress in methodology, design and
manufacturing. Ascom shall have no liability for any error or damage of any kind resulting from the use of this document.
 Contents
1  Introduction ................................................................ 1 

2  Prerequisites .............................................................. 1 
2.1  Operating System ...................................................................... 1 
2.2  PC Configuration ....................................................................... 1 
2.3  TEMS Investigation Version Compatibility .............................. 1 

3  Installing TEMS UDP Server ..................................... 1 

3.1  Performing the Installation ....................................................... 1 
3.2  Verifying the Installation ........................................................... 2 

4  TEMS UDP Server Start-up ....................................... 3 

4.1  Firewall Configuration ............................................................... 3 
4.2  Service Recovery Settings ........................................................ 3 
4.3  Starting TEMS UDP Server........................................................ 4 
4.4  Retrieval of Configuration Data ................................................ 4 

5  Editing the TEMS UDP Server Configuration .......... 5 

5.1  TEMS.Investigation.UDPServerSettings .................................. 5 
5.2  TEMS.Investigation.UDPServerResultFileSettings ................. 6 

6  Troubleshooting......................................................... 8 

© Ascom (2010) Document:

NT13-22830
 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.

© Ascom (2010) Document:

NT13-22830 1(8)
  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.
 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:

© Ascom (2010) Document:

NT13-22830 2(8)
 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
 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.

© Ascom (2010) Document:

NT13-22830 3(8)
 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.

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.

© Ascom (2010) Document:

NT13-22830 4(8)
 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:

© Ascom (2010) Document:

NT13-22830 5(8)
 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:

© Ascom (2010) Document:

NT13-22830 6(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).

© Ascom (2010) Document:

NT13-22830 7(8)
 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):
o Remove the internet cable. Start the service. Plug in the internet
cable.
OR
o Open a command prompt and type ipconfig/release. Start the
service. At the command prompt, type: ipconfig/renew.

© Ascom (2010) Document:

NT13-22830 8(8)