Sie sind auf Seite 1von 9

TEMS UDP Server

User's Manual

Prepared by: Ascom Network Testing

Date: 18 October 2010

Document: 4421-0006 R1A

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 2
2.1 2.2 2.3

Introduction ................................................................ 1 Prerequisites .............................................................. 1


Operating System ...................................................................... 1 PC Configuration ....................................................................... 1 TEMS Investigation Version Compatibility .............................. 1

3
3.1 3.2

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


Performing the Installation ....................................................... 1 Verifying the Installation ........................................................... 2

4
4.1 4.2 4.3 4.4

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


Firewall Configuration ............................................................... 3 Service Recovery Settings ........................................................ 3 Starting TEMS UDP Server........................................................ 4 Retrieval of Configuration Data ................................................ 4

5
5.1 5.2 5.2.1

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


TEMS.Investigation.UDPServerSettings .................................. 5 TEMS.Investigation.UDPServerResultFileSettings ................. 6 Result File Example ..................................................................... 7

Ascom (2010)

Document: 4421-0006 R1A

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, released with TEMS Investigation 12.0.

2
2.1

Prerequisites
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
3.1

Installing TEMS UDP Server


Performing the Installation

The installation files are found on the TEMS Investigation CD.

Ascom (2010)

Document: 4421-0006 R1A

1(7)

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: 4421-0006 R1A

2(7)

4
4.1

TEMS UDP Server Start-up


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 servers 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: 4421-0006 R1A

3(7)

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: 4421-0006 R1A

4(7)

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

Editing the TEMS UDP Server Configuration


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.

TEMS UDP Server makes use of two settings files:

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: 4421-0006 R1A

5(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:

Ascom (2010)

Document: 4421-0006 R1A

6(7)

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: 4421-0006 R1A

7(7)