TTsuite-ITS-G5 First Steps User s Guide

Transcription

1 TTsuite-ITS-G5 General Information This user s guide helps you to download and install TTworkbench, and guides you through configuring and running test cases of TTsuite-ITS-G5. 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 Test Environment and Test Suite Hardware Requirements Upper Tester Implementation Get TTworkbench and TTsuite-ITS-G Installation TTworkbench TTsuite-ITS-G Load Test Campaign Configuration Parameter View (Module Parameters) Test Adapter Parameter View (Setting for Test Adapter) Running Test Cases Analysis Saving Configurations and Test Results 9 7. Details Core Language Editor (CL Editor) TTthree (TTCN-3 Compiler) TTman (Test Execution Management) Documents Appendix..12 spirent.com i

3 1. Requirements 1.1. Test Environment and Test Suite TTworkbench is the TTCN-3 execution platform needed to run the test solution TTsuite-ITS-G5. System 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 (8 GB recommended) 1.2. Hardware Requirements Communication via Ethernet Depending on your test environment configuration, you will need a G5 adapter for the radio interface access or connect directly via a network device using Ethernet to your SUT. spirent.com 3/12

4 1.3. Upper Tester Implementation For Upper Tester implementation requests, please refer to You will find the Upper Tester Message Format in Annex C. 2. Get TTworkbench and TTsuite-ITS-G5 License File Before you download TTworkbench and TTsuite-ITS-G5, make sure you received a valid license file. Otherwise please contact our sales team at ttworkbench-sales@spirent.com. 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-ITS-G5. 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 spirent.com 4/12

5 Step 2 Follow the pop up installation wizard Browse for the valid license file license.dat already saved in your favored directory. (TTsuite-ITS-G5xxx 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-ITS-G5 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_ITS_G5_x.x.x_archived-site.zip. Click Select All Next Next. Accept the terms of license agreements. Click Finish and confirm to restart TTworkbench. spirent.com 5/12

6 Step 7 After restart, you can import the installed TTsuite-ITS-G5. Close the welcome tab. In the project view, just click on the right mouse button, go to menu File Import TTCN-3 TTCN-3 Test Solution Projects. Select the installed test solution projects and choose TTsuite-ITS-G5 Finish. Further details about installation you can find in the integrated User s Guide. Click on Help Help Contents Spirent TTworkbench User's Guide. 4. Load Test Campaign Step 1 Open the TTsuite-ITS-G5 folder in the Package Explorer (TTCN-3 Development Perspective). Step 2 In the project root folder, double click on the test campaign loader file xxx.clf (with the icon ). (The perspective will automatically switch into the TTCN-3 Execution Management.) spirent.com 6/12

7 Take ItsGeoNetworking_TestControl.clf as example, and you will see the test cases listed as in the picture below. 5. Configuration Please configure your TTsuite-ITS-G5 according to the protocol and your local settings. You can use our MBS (Message Building System) to ease it up. For further details about Test Suite Parameters, please refer to the integrated user s guide. Click on Help Help Contents Spirent TTsuite-ITS-G Parameter View (including Module Parameters) In the Parameter View of the Execution Management you find different parameters to change the settings for your individual test configuration. Please click on the right mouse button over the parameter view or use the MBS button to open the Message Building System dialogue. spirent.com 7/12

8 You can access the single parameter and the attributes of single fields in the dialogue. When finished, just click on OK to save the change. The changed parameters are called by the test system during runtime. You can run your test campaign with the new configuration at once without recompilation of your test cases. Note: For GeoNetworking at least the following parameters need to be set subject to your local settings: Parameter LocalEthernetMAC UpperTesterSettings Description Defines the MAC address of the Ethernet interface of the test system connected to the G5 Adapter or the SUT device. Defines the IP address and UDP port used for the communication with the Upper Tester application on the SUT side. 5.2 Test Adapter Parameter View (Setting for Test Adapter) At least the following parameters need to be set subject to your local settings: Test Adapter Parameter PICS_GN_LOCAL_GN_ADDR Description GeoNetworking address of the GeoAdhoc router(sut). spirent.com 8/12

9 Spirent TTsuite-ITS-G5 6. Running Test Cases Execution: Double click on one test case or select one test case by single click and press the Execute tests button. For configuration details please refer to Chapter 8 Configuration Analysis After execution, 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 or receive message arrow provides further details of the TTCN-3 template representation in the Test Data View, which you see the received message compared to the expected TTCN-3 template. Mismatched values are marked red. Double click on send or receive arrows for the raw messages in the Dump View. Management View Test Parametrization Result Analyzer Graphical Online Logging 6.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 (with the icon ) contains the current configuration (CLF) and the executed log traces. spirent.com 9/12

10 For reviewing, this file can be imported by pressing the import button and selecting Import Log. 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 User's Guide. 7. Details (for Development) 7.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 1 of 4. Running My First Test Case you find the TTCN-3 source code (*.ttcn3) in folder ttcn3. 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 Core Language Editor spirent.com 10/12

11 7.2. TTthree (TTCN-3 Compiler) For recompiling all TTCN-3 files, please open the main module (with the icon double click. Press the Rebuild button. ) in the CL Editor by Please note: Compilation is only necessary if some test cases are changed or some new one is created. Otherwise, the generated *.jar files from TTCN-3 source are already available for execution TTman (Test Execution Management) In order to execute test cases and configure parameters, the CLF has to be loaded into the Test Execution Management. In the project root folder, you will find several CLF files (with the icon ). Please choose the clf for the testing group according to the name, like ItsGeoNetworking_TestControl.clf for Geo Networking testing. Further details can be found in the integrated Users Guide, Chapters Using TTworkbench CL Editor, Using TTworkbench TTthree and Using TTworkbench TTman. Click on Help Help Contents Spirent TTworkbench User's Guide. 8. Documents Please refer to following publications regarding ITS-G5. Base Specification ETSI TS : Intelligent Transport Systems (ITS); Vehicular Communications; GeoNetworking; Part 4: Geographical addressing and forwarding for point-to-point and point-tomultipoint communications; Sub-part 1: Media independent functionalities Test Specifications (Parts 1/2/3*) ETSI TS V1.2.1 ( ): Conformance test specifications for Transmission of IP packets over GeoNetworking (GN6) ETSI TS V1.3.1 ( ): Conformance test specification for Co-operative Awareness Messages (CAM) ETSI TS V1.4.1 ( ): Conformance test specification for Decentralized Environmental Notification Messages (DENM) ETSI TS V1.1.1 ( ): Conformance test specifications for GeoNetworking Basic Transport Protocol (BTP) ETSI TS V1.3.1 ( ): Conformance test specifications for GeoNetworking ITS-G5 (GN) ETSI TS V1.1.1 ( ): Conformance test specifications for Signal Phase And Timing (SPAT) and Map (MAP) ETSI TS V1.2.1 ( ): Conformance test specification for TS and TS Security Testing *Part 1: Test requirements and Protocol Implementation Conformance Statement (PICS) *Part 2: Test Suite Structure and Test Purposes (TSS&TP) *Part 3: Abstract Test Suite (ATS) and Protocol Implementation extra Information for Testing (PIXIT) spirent.com 11/12

12 9. Appendix Acronyms CL Editor CLF IUT MBS OS SUT TLZ Core Language Editor Campaign Loader File Implementation Under Test Message Building System Operating System System Under Test Test Logging Zip File 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/07 12/12