TTsuite-IPv6 First Steps User s Guide

Transcription

1 TTsuite-IPv6 General Information This user s guide helps you to download and install TTworkbench, and guides you through configuring and running test cases of TTsuite-IPv6. For a successful proceeding please follow the instructions step by step! If you need any assistance, please contact Spirent s customer care department: Mr. Dirk Borowski Manager Support Services Phone: support@spirent.com spirent.com

2 Table of Content 1. Requirements Download Installation TTworkbench TTsuite-IPv Running My First Test Case Analysis Saving Configurations and Test Results Details Core Language Editor (CL Editor) TTthree (TTCN-3 Compiler) TTman (Test Execution Management) 9 6. Appendix...10 spirent.com i

3 1. Requirements Operating Systems: Microsoft Windows 7/8/10 Linux (GTK2, x86-32, x86-64) Java 2 Platform: Memory: Version 8 JDK or JRE Download at We strongly recommend using the above Java JDK. With the OpenJDK / IcedTea for Linux the TTworkbench license will not work correctly! 2 GB (4 GB recommended) License File Before you download TTworkbench and TTsuite-IPv6, make sure you received a valid license file. Otherwise, please contact our sales team at ttworkbench-sales@spirent.com. 2. Download Please use Spirent s Customer Service Center at Step 1 In case you are not registered yet, go to and fill in the registration form. The support team will check your data and notify you about your approval. Step 2 Login at Spirent s CSC and click on the download app tab on the left side. Step 3 Select the product line TTworkbench and filter for categories and operating system. Download the purchased TTworkbench version. Step 4 Select the release type Controlled Release, the Product Line TTworkbench and the Category TTsuites for TTworkbench. Download the TTsuite-IPv6. spirent.com 3/10

4 3. Installation 3.1. TTworkbench Step 1 Windows Platform: Double click on TTworkbench-xxx-installer.exe (to be found on desktop or selected directory). Linux Platform: Use command line java-jar TTworkbench-xxx-installer.jar Step 2 Follow the pop up installation wizard Browse for the valid license file license.dat already saved in your favored directory. (TTsuite-xxx and TTworkbench require a valid license file for execution.) Step 3 Start TTworkbench from created desktop icon or menu entry. Step 4 Start a new workspace by accepting the default workspace location on request or choose an existing one TTsuite- IPv6 Step 5 In the TTworkbench menu, click on menu item Help Install New Software Step 6 Click Add Archive. Choose the downloaded installation file TTsuite-IPv6_x.x.x-archived-site.zip, and type a name for this TTsuite. spirent.com 4/10

5 Choose the test suite, press Next Next. Accept the terms of license agreements. Finish and confirm the restart of TTworkbench. Step 7 After restart, please import the installed TTsuite. Close the welcome tab. In the project view, just click on the right mouse button, go to menu File Import TTCN-3 TTCN-3 Solution Projects. Select the installed TTsuite and click Finish. Step 8 To be able to use TTsuite-IPv6 on Windows platforms make sure that WinPcap is installed on the system. WinPcap3.1 can be downloaded from You can find further details about installation in Chapter 2 of the integrated Users Guide. Click on Help Help Contents Spirent TTworkbench Users Guide. 4. Running My First Test Case Please note! You need the administrator right to establish the socket communication. Therefore, please start/run your TTworkbench as administrator. Step 1 Open the TTsuite-IPv6 folder in the Package Explorer (TTCN-3 Development Perspective). Step 2 Open the folder ttcn3 and double click on the test campaign loader file AtsIPv6_Core_TestControl_Eval.clf. (The perspective will automatically switch into the TTCN-3 Execution Management.) Step 3 Start an IPv6 Media Gateway (MG) connected to the test PC. You can find further details about TTsuite-IPv6 in the built-in user s guide. Click on Help Help Contents Using TTsuite-IPv6. spirent.com 5/10

6 Step 4 Click on AtsIPv6_Core_TestControl to edit at least the following parameters in the Parameter View (below Management View): PX_NET_DEVICE_ID_1 ID for the first net device PX_MAC_UCA_IUT_1 Unicast MAC address of IUT If necessary: PX_MAX_UNICAST_SOLICIT_IUT Number of NUD neighbor solicitation Step 5* Execution: Select the test case TC_COR_1412_01 by single click and press the Execute tests button. *Further details about execution via command line you can find in the integrated Users Guide, Chapter Command-line Mode. Click on Help Help Contents Spirent TTworkbench Users Guide. spirent.com 6/10

7 4.1. Analysis Click on the TTCN-3 Graphical Logging tab. It shows the results of the execution as a graphical output. A single click on a send message arrow provides further details of the TTCN-3 template representation in the Test Data View. Double click on send and receive arrows for a coding in the Dump View. A single click on a match or mismatch box shows you the received message compared to the expected TTCN-3 template. Mismatched values are marked red. Management View Result Analyser Test Parametrization Graphical Online Logging 4.2. Saving Configurations and Test Results The current executed run of test cases can be saved in a *.tlz file by pressing the export button and selecting Export Log in the Management View. The generated *.tlz file contains the current configuration (CLF) and the executed log traces. For reviewing, this file can be imported by pressing the import button and selecting Import Log. To run configured test cases again, please press the import button and select Import Log As New Session. spirent.com 7/10

8 In order to generate a test report, use this button. Further details about execution and savings you can find in the integrated Users Guide, Chapter Using TTworkbench TTman. Click on Help Help Contents Spirent TTworkbench Users Guide. 5. Details 5.1. Core Language Editor (CL Editor) Each TTCN-3 file is view- and editable by double clicking in the CL Editor. As shown in Step 2 of 4. Running My First Test Case you find the TTCN-3 source code (*.ttcn3) for IPV6 Core Test Control test cases in folder ttcn3\ats\atsipv6\atscore. After opening the files, the source code will be syntactically checked and highlighted. In addition, an outline will be generated automatically and the go-to-declaration feature will be enabled. TTCN-3 Compiler/ Validate Buttons Outline Project View TTCN-3 CL Editor 5.2. TTthree (TTCN-3 Compiler) For recompiling all TTCN-3 files open AtsIpv6_Core_TestControl in the CL Editor and press the Rebuild button. Please note! Compilation is only necessary if changing test cases or creating new ones. Otherwise, the generated *.jar files from TTCN-3 source are already available for execution. spirent.com 8/10

9 5.3. TTman (Test Execution Management) In order to execute test cases and configure parameters, the CLF has to be loaded into the Test Execution Management. Beside a CLF containing a specific test campaign such as AtsIPv6_Core_TestControl_Eval.clf, the default CLF provides all 268 test cases. They are organized in specific group structures. Please note! You are able to execute all 610 test cases only, if you have purchased the IPV6 test suite. With your evaluation license file, you can exclusively run the following test cases: TC_COR_1412_01 TC_COR_1463_01 TC_COR_8150_01 TC_COR_8389_01 TC_COR_8417_01 TC_COR_8465_01 Further details you can find in the integrated Users Guide, Chapters Using TTworkbench CL Editor, Using TTworkbench TTthree and Using TTworkbench TTman. Click on Help Help Contents Spirent TTworkbench Users Guide. spirent.com 9/10

10 Spirent TTsuite-IPv6 6. Appendix Acronyms CL Editor CD CLF IUT MLF NUD TA TS Core Language Editor Codec Campaign Loader File Implementation Under Test Module Loader File Non-numerical Unstructured Data Test Adapter Test System Notes This document is subject to change without notice. Spirent Communications Michaelkirchstraße 17/ Berlin, Germany Phone Fax: ttworkbench-sales@spirent.com Internet: spirent.com/ttworkbench AMERICAS SPIRENT sales@spirent.com US Government & Defense info@spirentfederal.com spirentfederal.com EUROPE AND THE MIDDLE EAST +44 (0) emeainfo@spirent.com ASIA AND THE PACIFIC salesasia@spirent.com Spirent Communications, Inc. All of the company names and/or brand names and/or product names and/or logos referred to in this document, in particular the name Spirent and its logo device, are either registered trademarks or trademarks pending registration in accordance with relevant national laws. All rights reserved. Specifications subject to change without notice. Rev # 2017/04/06 10/10