Capture & Replay First Steps User s Guide

Transcription

1 Capture & Replay General Information This user s guide helps you to download and install TTworkbench, and guides you through the capture and replay process. 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 CaptureAddressBook Example Test Case Generation Capture & Replay Configuration Capture / Select Trace Decode Events Group Events in Scenarios Configure Test Cases Generate TTCN Executing Generated Tests Importing Trace Files Captors Capture & Replay Preferences Capture Steps Terminal Capture Appendix...11 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) Reference ID and License File Before you download TTworkbench, 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 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. Login at Spirent s CSC and click on the download app tab on the left side. Select the product line TTworkbench and filter for categories and operating system. Download the purchased TTworkbench version. spirent.com 3/11

4 3. Installation 3.1. TTworkbench 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 Follow the pop up installation wizard Browse for the valid license file license.dat already saved in your favored directory. 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 CaptureAddressBook Example Step 5 In the menu, click File Import TTCN-3 Example Projects Capture and Replay Example CaptureAddressBook. Afterwards you will find the provided example as tree structure in the Package Explorer. Further details about installation you can find in Chapter 2 of the built-in Users Guide. Click on Help Help Contents Spirent TTworkbench Users Guide. spirent.com 4/11

5 4. Test Case Generation 4.1. Capture & Replay Configuration Click on File New Capture Replay Session. Select CaptureAddressBook as parent folder and click Finish Capture / Select Trace A new Capture & Reply Editor will be opened. The Capture Configuration tab is shown. This tab can be used to capture new traces. For more details, please refer to Chapter 6. Step 4 If a trace is already available, switch to the Trace Selection tab to use it. Click on the button Browse under Select Trace details to select the trace folder. Step 5 In this example, a trace file can be found under CaptureAndReplayExample\Traces\Example_Capture. Go there and click OK. In the available traces field Local Jcap is shown Decode Events Step 6 In the Protocols used for event decoding section click the button Add Step 7 Select AddressBookExample and click OK. spirent.com 5/11

6 Step 8 Switch to the Select Events tab. The events from the trace section will contain all those being decoded. Selecting an event will update the Dump View and Message View beneath. You can then check the message as a plain text or as a decoded data structure Group Events in Scenarios Step 9 In the Events from the trace section right click on any event and select Check conversation(s) containing selected events. 0 Click on Add in the Events from the trace section to add all selected events to a scenario (one will be created automatically). 1 Switch to the Test Case Configuration tab Configure Test Cases 2 Click on Add in the Test Cases section to create a new test case. 3 Select TestCase2, and in the Component mapping section checkbox : Type in ttcn3\generated in the Output Folder field as target folder for generated TTCN-3 code. spirent.com 6/11

7 4.6. Generate TTCN-3 5 Click on the button Generate Test Suite, the TTCN-3 code will be generated. Two TTCN-3 files will be shown under ttcn3/generated: SC1.ttcn3 testsuite_configuration.ttcn3 5. Executing Generated Tests Compile testsuite_configuration.ttcn3. (Open the file and click the button Build or Rebuild from the toolbar). Start the AddressBook server (SUT) by using LaunchServer.bat / LaunchServe.sh in command line. In the TTCN-3 Projects view, right click on testsuite_configuration.ttcn3 and select Generate Default Test Campaign Recursively. Step 4 Open testsuite_configuration.clf in the root directory of the project. It can be configured to any other destination in TTworkbench. Please refer to Help Help Contents Spirent TTworkbench Users Guide. Step 5 The Execution Perspective opens. In the Management View, select TestCase1 and click on Execute Tests to run the test. Step 6 Observe the test result using the TTCN-3 Graphical Logging view. spirent.com 7/11

8 6. Importing Trace Files A trace folder shall contain one or more trace files (e.g. pcap files) and must be in the workspace. The folder can either be created manually and you copy the trace files into it, or can be generated automatically when using the import wizard. All trace files are stored by default in a trace folder. Click on File New Capture & Replay Session. Select a project to import to and click Next. Click on Browse (from directory) and select the folder from where trace files will be imported. Step 4 Select the files to import and click Finish. The Capture & Replay Editor will open with the active Trace Selection tab. 7. Captors In Chapter 6 it is described how to import some trace files created with other tools such as Wireshark. TTworkbench provides also capture function with its built-in captors Capture & Replay Preferences Captor Selection Open Window Preferences TTCN-3 Capture & Replay to enable/disable captors. Enabled captors will appear in the Capture & Replay Editor as capture sources. The trace output folder determines the default location for saving new traces. spirent.com 8/11

9 Remote Jpcap The Remote Service is used to capture events on remote machines running the Capture Server. The Capture Server can be started by launching CaptureServer.bat / CaptureServer.sh in the TTworkbench install folder. In order to connect the remote service, the Service port and Service host need to be defined. Test Connection can be used to verify the connection. *Administrator rights are required for the Capture Server to function correctly. Terminal Connectors Terminal capture records terminal communication. Terminal Connectors store often used connection settings such as user, password, host, etc. Current connection types are: SSH, Telnet, Local (only on Linux and MacOSX) and Serial (RS232). Local Captor The local captor does not require any settings, if active it will list all available local interfaces. On Linux and MacOSX administrator rights are required to use the local captor, it is recommended to use the Remote Service for local capture Capture Steps Open the Capture & Replay Wizard by clicking on File New Capture & Replay Session. Enter a file name that does not exist in the selected project and click Finish. The Capture & Reply Editor will open with the Capture Configuration page selected. Choose a capture name and select the desired captors. In case no captor is shown, click on the button Refresh, otherwise just click on the button Capture to begin capturing. The Terminal Capture view will be opened automatically if the Terminal Captor is selected (see 5.3 for details). spirent.com 9/11

10 Step 4 To end the capture, click Stop. The Trace Selection tab will be opened automatically. The captured traces are shown. The Terminal Capture view is still open. However, no more events will be recorded until capture is started again. Step 5 To see the captured events a protocol must be added. Click on Add in the Protocols used for event decoding section. The Add Protocol dialog will open. Step 6 Select the appropriate protocol and click OK. Step 7 Switch to the Select Events tab. All the captured events will be listed Terminal Capture Terminal Capture View The Terminal Capture view is used to capture input / output from terminal connections such as SSH, Telnet and Local Terminal (only available on Linux and MacOSX). Initially no terminals are open, to open a terminal click on the drop down in the right corner and select one of the available Terminal Connectors (which were set in the preference page). More than one tab can be opened for a Terminal Connector, and several connectors can be used in parallel. The new terminal connection option allows temporary Terminal Connectors to be created. spirent.com 10/11

11 8. Appendix Acronyms CL Editor CLF IUT MBS PCAP MLF OS SUT TLZ Core Language Editor Campaign Loader File Implementation Under Test Message Building System Packet Capture (e.g. used by Wireshark) Module Loader File 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/06 11/11