XCAL Iperf Operation Handbook v.2.0

This document contains confidential information and/or trade secrets that are the exclusive property of Accuver Corporation, Ltd. This document may not be photocopied, altered, or reproduced in any kind without prior consent from Accuver Corporation, Ltd. This document may NOT be distributed outside the company without approval from Accuver Corporation, Ltd. Page 1 of 13

XCAL / Iperf Quick Operation Handbook v.1.4

Confidential

Quick Operation Handbook iperf measurement Feature

XCAL

25th.February 2010

Version. 25Feb10_v1.4

Presented by Accuver EMEA Ltd.

Congress House 14 Lyon Road

Middlesex UK

T +44 (0)208 863 2962 F +44 (0)208 863 1688

[email protected]



Contents

XCAL / Iperf test System Configuration and Concept .............................. 4 System configuration ............................................................................................................... 4

Daemon Server Configuration .................................................................. 5 XCAL auto call Configuration ................................................................... 6 Information available - iperfDaemon ...................................................... 10 Information available - XCAL ................................................................. 11 Iperf Statistics ........................................................................................................................ 11 XCAL measured iperf metrics ................................................................................................ 12 Iperf Daemon measured iperf metrics ................................................................................... 13

Notices ................................................................................................... 14 Appendix.1 iperf Daemon in manual control .......................................... 15



Preamble This XCAL / Iperf Operation Handbook intends to be read by the potential users who are trying to install, configure and perform any measurements using Iperf measurement features implemented in XCAL product. All the contents are described sequentially and can be followed one by one. Any questions concerning this document should be addressed to technical support: Technical support T +44 (0) 208 863 1118 E [email protected] Needless to say, our aim is to best support the users so, please don’t hesitate to contact us for any enquiries.



XCAL / Iperf test System Configuration and Concept System configuration

XCAL have an auto call feature to initiate iperf traffic and communicate iperf Daemon Server part installed on the server side. The key features can be summarised as below.

1. All the iperf test can be configured and performed by using XCAL auto call feature - both uplink and downlink.

2. Daemon server application shall be used to communicate with XCAL and control iperf on server side. It will configure iperf server configuration as indicated by XCAL automatically – so, no need to configure nor initiate iperf application on server side separately

3. The iperf test results measured in XCAL side shall be displayed in graphic format and will be saved in the log file together with all the other network parameters

4. The iperf test results measured in Daemon Server side shall be transferred to XCAL using separate TCP/IP packets. XCAL will display this iperf server measurement results in real time (optional) and save in the log file with the other network parameters.

5. iperfDaemon supports multiple number of iperf XCAL traffics – we recommend maximum 4 even in this case.



Daemon Server Configuration Before initiating any iperf call from XCAL side, the iperf Daemon should be running. The way how to configure the iperf Daemon is explained below.

1. Prepare a Windows OS based PC with IP address. 2. Copy ‘iperf.exe’ and ‘iperfDaemon.exe’ in any folder on the PC. The two files should be in the

same folder. 3. Please double click ‘iperfDaemon.exe’.

4. Iperf Daemon shall be automatically activated. 5. If you want to deactivate the iperfDaemon, please press ‘Deactivate’ button. If you see

‘deactivate’ sign in the menu button, IT MEANS IT IS NOW RUNNING AND IT SHOULD BE CONFIGURED LIKE THIS.

6. If you deactivate it, you can activate it again by pushing ‘activate’ button again.

There are some other buttons which you can just IGNORE at the moment which can be used for manual iperf testing without XCAL. It shall be explained later as an Appendix.

<Please just INGONRE these Buttons >



XCAL auto call Configuration XCAL version should be the same of later than XCAL 3.2.9.97 to use this feature.

To use iperf feature, you should have iperf feature option in your XCAL. If your XCAL do not show iperf option, you may not be in Annual maintenance cover. If you do so but if you cannot see this option, please contact [email protected]. The way how to configure iperf call is described below.

1. Run XCAL > Auto Call

2. Create new scenario

3. Select ‘Iperf’ auto call tab from the call type tabs.

4. Type the name of the call script alias – iperf down in this specific example



5. Configure Auto Call basic settings – timer, etc

All the explanation below are based on the values given in this example.

Idle time : the UE shall wait 5 seconds Setup Time : the UE shall initiate network attach. If the network attach fails by 10 seconds

configured in this example, the UE shall return to Idle time and will wait 5 seconds again and shall try next call. In this case, call statistics report will show the user that there was a call setup failure. This counter shall be given to the user during the measurement.

T. Setup time : means traffic setup time. this timer will begin when network attach succeeds

and shall stop the timer when the traffic (iperf) begins to exchange between the server and XCAL

Traffic Time : the timer runs during the iperf traffic Call count : when the 1st call finishes, it will release the call and goes to idle mode, after idle

second expires, initiate next call, etc. this shall be repeated 10 times. 6. Configure ‘iperf’ setting to be performed.

All the iperf setting parameters are based on original iperf application.



Daemon : the IP address where the iperfDaemon.exe are running Mode : UDP/TCP Direction : Down/Up/Dual Packet size, Buffer Size, UDP Throughput, etc Log Payload : if you check this, all the payloads of UDP packets shall be saved on the PC.

the default value is NOT to activate it as the log file size will become very big. Daemon Postpone Notify : if deactivated, all the iperfDaemon.exe (server side) measured

data shall be transferred to XCAL every second (once a second) so that you can monitor those measurement results in real time. if Activated, those data shall be transferred when the specific iperf call finishes. This will minimize the effects of any additional TCP/IP packets for the reporting of the iperfDaemon data to XCAL. Default value is to deactivate it.

7. Push OK button then a new scenario shall be created in the ‘Scenario list’

8. Drag the scenario to the work space in the right side as the screenshot below.



Then, it shall begin the iperf call scenario as configured by the user.



Information available - iperfDaemon When XCAL initiates iperf auto call, you can see in iperfDaemon Server creates a new task as can be seen from the screenshot below. You can monitor the iperf status by double clicking the tack. There shall be multiple number of Tasks when there are multiple number of iperf calls initiated by multiple XCAL.



Information available - XCAL Iperf Statistics You can monitor both XCAL and iperfDaemon status at the same time IN ONE WINDOW.

<XCAL > Statistics/Status > iperf Statistics >



XCAL measured iperf metrics You can monitor both XCAL and iperfDaemon measurement status at the same time IN ONE WINDOW.

<XCAL > Statistics/Status > iperf Graph >

Iperf Throughput (bps) Iperf Delay Jitter (ms) Iperf Transfer Bytes (bytes) Iperf Packet Loss (Rate (%)



Iperf Daemon measured iperf metrics You can monitor both XCAL and iperfDaemon measurement status at the same time IN ONE WINDOW.

<XCAL > Statistics/Status > iperf Graph >

Iperf Daemon Throughput (bps) Iperf Daemon Delay Jitter (ms) Iperf Daemon Transfer Bytes (bytes) Iperf Daemon Packet Loss (Rate (%)



Notices 1. The CPU load of the Daemon PC can affect the throughput values when configured more

than 4 calls at the same time. it shall be dependent of the PC specification of the Daemon PC and the data rates the user configure.

2. Please close Packet message viewer in XCAL to reduce the CPU load of the XCAL 3. The Daemon measured iperf metrics display can be delayed according to the traffic and the

CPU load of both Daemon and XCAL because the this information has to come through TCP/IP packets which shall share the same bandwidth with the test UDP packets.



Appendix.1 iperf Daemon in manual control Iperf Daemon can provides additional iperf traffics manually. It can be regarded as the graphical user interface for the DOS command prompt based iperf. If you use this option, it shall not communicate with XCAL to delivery iperf measured data but just works as normal iperf application. 1. Add

2. Configure iperf parameters accordingly

In configuring this, the user MUST NOT use the port number 39682 – 39999 as this can

conflict with XCAL configured iperf calls. XCAL shall uses these port numbers.

3. Then, it will begin iperf test as configured

END

XCAL Iperf Operation Handbook v.2.0

Documents

iperf graph

iperfdaemon

1 iperf daemon

iperf daemon

log file

statisticsstatus

server side

daemon pc