/7 GPS )1 4PGUXBSF Manual

Transcription

1 / 7 GPS )1 4PGUXBSF Manual v v 8.6 /7 GPS )1 4PGUXBSF Manual /7 GPS )1 4PGUXBSF Manual v 61 /FUXPSL 7JSUVBMJ[BUJPO GPS 4PGUX /FUXPSL 7JSUVBMJ[BUJPO GPS 4PGUXBSF /FUXPSL 7JSUVBMJ[BUJPO GPS 4PGUXBSF 5FTUJOH /7 GPS )1 4PGUXBSF Manual v /FUXPSL 7JSUVBMJ[BUJPO GPS 4PGUXBSF 5FTUJOH

2 NV for HP Software Manual Copyright Notice 2013 Shunra Software Ltd. Shunra is a trademark of Shunra Software Ltd. All rights reserved. This document is for information purposes only. Shunra Software Ltd. makes no warranties, expressed or implied. Shunra, the Shunra logo, PerformanceSuite, vcat and all other Shunra product or technology names are trademarks or registered trademarks of Shunra Software Ltd. Microsoft, Visio and Windows are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries. Other brand and product names are trademarks or registered trademarks of their respective holders. Information in this document is subject to change without notice and does not represent a commitment on the part of Shunra Software Ltd. The software described in this document is furnished under license agreement. The software may be used only in accordance with the terms of this agreement. No part of this manual may be reproduced or transmitted in any form or by any means, for any purposes other than the purchaser's personal use, without the express written permission of Shunra Software Ltd. Legal notice of related license agreements is located in the Installation folder. Corporate Headquarters 1800 JFK Boulevard Philadelphia PA USA Tel: (215) Fax: (215) Sales: Support: info@shunra.com European Office 73 Watling Street London EC4M 9BJ Main: +44 (0) Fax: +44 (0) Sales: +44 (0) Support: +44 (0) saleseurope@shunra.com Israel Office PO Box 7372 Hod Ha sharon Israel Tel: Fax: Sales: Support: info@shunra.com NV for HP Software v8.61 (6.0)

3 vcat Manual 1 Table of Contents Chapter 1: Introduction Integration with HP Software Licensing for Shunra NV for HP Software Integrated Network Virtualization for HP Software Chapter 2: Installing, Configuring and Licensing Shunra NV for HP Software Components. 2-1 System Requirements Installing Shunra NV for HP Software Upgrading Shunra NV for HP Software Uninstalling Shunra Components on HP Software Silent Installation and Uninstallation Silent Uninstall Setting the Active Adapter Shunra NV for HP Software Licenses Customizing Shunra NV for HP Software Chapter 3: Conducting Network Virtualization in HP Software Defining Global Settings Incorporating Network Virtualization Viewing Runtime Statistics Viewing Analysis Utilizing Shunra NV Analytics Chapter 4: Using the Shunra NV Editor Installing the NV Editor Opening the NV Editor Creating Shunra Emulation Profiles

4 vcat Manual 2 Chapter 5: Shunra NV for HP Software Web Service API 5-1 Emulation Services Configuration Services Transaction Manager Shunra Licensing Chapter 6: Command Line Interface Commands Chapter 7: WAN Emulation Specifications.. 7-1

5 Introduction Chapter Introduction 1: Shunra's Network Virtualization enables an effective software testing and application performance engineering methodology. Shunra provides the capabilities to virtualize real-world network conditions in the test environment; analyze test results in order to isolate potential bottlenecks, and automatically deliver custom performance optimization recommendations. Network virtualization tests consist of a number of pre-defined parameters. The network conditions can be defined, or captured from production networks using an additional Shunra product, the NetworkCatcher, or can be downloaded from Shunra s Global Library. Shunra's integration with HP Software includes the following components: Shunra NV for HP Performance Center This component provides the user interface which is used to define the network virtualization settings within the HP Performance Center tests. Shunra NV for HP Controller This component provides the user interface which is used to define the network virtualization settings within the HP LoadRunner tests. This component also provides an integrated license management mechanism required to include network virtualization within HP LoadRunner. Shunra NV for HP Load Generator Shunra NV for HP Load Generator is the component that runs on each HP Load Generator. During a load test you do not access the Shunra NV for HP Load Generator user interface, as all configuration is done centrally via the HP LoadRunner Controller or HP Performance Center. The Shunra NV for HP Load Generator includes a Shunra network virtualization driver that applies selective traffic impairments for traffic flows between

6 1-2 Shunra NV for HP Software Manual Chapter 1 the load generator and the application servers being tested. The Shunra NVcomponent can also run independently if required for troubleshooting or specific test scenarios. Shunra Global Library Shunra NV Global Library contains a rich collection of mobile and landline network conditions between various locations on the globe. These conditions include latency, packet loss and bandwidth. This regularly updated library, built on millions of data points, provides real world point-to-point network conditions recorded around the world and can be accessed from both the HP Performance Center and HP LoadRunner. Shunra NV Editor The NV Editor can define complex network scenarios which can also include recorded data. The NV Editor is contained in the Shunra NV for HP Load Generator component. The conditions can be saved in a file that can be used when defining a Virtual Location. Shunra NV Analytics Shunra NV Analytics conducts an analysis based on emulation results which assists in pinpointing factors that negatively impact an application's operation across a network. Shunra Analytics conducts an analysis based on packet list data, then displays the resulting data in informative reports that provide insight into an application's operation. NetworkCatcher NetworkCatcher captures and records production network parameters including latency, packet loss and bandwidth availability directly from the enterprise environment. These network conditions can then be used when defining Virtual Locations and in the NV Editor; for more details refer to the NetworkCatcher Manual. NetworkCatcher requires a separate license. Integration with HP Software: (page 1-3) how Shunra NV for HP Software applies network impairments within load testing scenarios Licensing for Shunra NV for HP Software: (page 1-4) how to obtain and install licenses for Shunra NV for HP Software Integrated Network Virtualization for HP Software: (page 1-4) explains the flow when network impairments are integrated into HP Software tests

7 Introduction Chapter Integration with HP Software Shunra Network Virtualization integrates seamlessly into HP Software enhancing testing accuracy by incorporating real-world network conditions into the load and performance test environment. Shunra's integration with HP Load- Runner and HP Performance Center applications provides a software-based solution that emulates a wide area network link from each HP Load Generator, or in many virtualized locations on the same HP Load Generator to the server(s) of the application undergoing the performance test. HP LoadRunner and HP Performance Center generate the application transaction load while the Shunra component augments the performance test by applying the anticipated production network conditions to the test. As a result, the performance test presents a realistic network virtualization of load and network conditions. Shunra Integration with HP Performance Center The Shunra NV components for HP Performance Center provide an integrated user interface that controls the Shunra network virtualization capabilities from within the HP Performance Center. The Shunra NV for HP Performance Center component must be installed on the HP Performance Center. In addition, every HP LoadRunner Controller and the HP Load Generators that are configured with it per HP Performance Center, must be configured with the components listed in Shunra Integration with HP LoadRunner. The flow is the same on the HP Performance Center as on the HP LoadRunner Controller, except that the test is configured on the HP Performance Center. Shunra NV Analytics can be installed on a machine that meets the requirements. Shunra for HP Performance Center includes the following components: Licensing for Shunra NV for HP Software (page 1-4) Shunra NV for HP Controller (page 1-1) Shunra NV for HP Load Generator (page 1-1) which also includes the Shunra NV Editor (page 1-2)

8 1-4 Shunra NV for HP Software Manual Chapter 1 Shunra Integration with HP LoadRunner The network virtualization parameters can be defined within the HP LoadRunner Controller user interface for each Virtual Location or HP Load Generator during configuration of the performance test. Shunra NV includes specialized integration interfaces to work seamlessly within the HP LoadRunner environment. Shunra for HP LoadRunner includes the following components: Shunra NV for HP Controller (page 1-1) Shunra NV for HP Load Generator (page 1-1) which also includes the Shunra NV Editor (page 1-2) Licensing for Shunra NV for HP Software Licensing is managed by the Shunra NV for HP Controller component, using a floating or a node-locked license. Shunra NV for HP Software installs with an unrestricted, 2-day license. Integrated Network Virtualization for HP Software You can add network virtualization parameters to the test environment on both the HP Controller and the HP Performance Center; the same functionality can be obtained on both systems. Network Virtualization on HP Performance Center 1 Install the Shunra NV for HP Performance Center on the HP Performance Center. 2 Install the Shunra components for each HP Controller and HP Load Generator in the configuration. 3 On the HP Performance Center create a new test including network virtualization settings. 4 Start the test; the HP Controller checks the status of the license.

9 Introduction Chapter On the HP Performance Center, you can view runtime statistics that are automatically collected from the Shunra monitors in the HP Software graphs. 6 The HP Controller stops the load test on the HP Load Generators. 7 In the HP Analysis, view the reaction of the test transactions with the network virtualization conditions. Network Virtualization on HP LoadRunner 1 Install the Shunra NV for HP Controller on the HP LoadRunner Controller(s). 2 Install the Shunra NV for HP Load Generator on the HP Load Generator(s). 3 On the HP Controller start a test that includes network virtualization. The Shunra License Manager verifies that the license requirements are met. 4 On the HP Controller, view the runtime statistics that are automatically collected from the Shunra monitors on each HP Load Generator. 5 The HP Controller stops the load test on the HP Load Generators. 6 In the HP LoadRunner Analysis, view the reaction of the HP LoadRunner transactions with the network virtualization conditions.

10 1-6 Shunra NV for HP Software Manual Chapter 1

11 Installing, Configuring and Licensing Shunra NV for HP Software Components Chapter Installing, Configuring and Licensing Shunra NV for HP Software Components 2: If your configuration includes HP Performance Center: 1 On the HP Performance Center install and configure the Shunra NV for HP Performance Center (page 2-4). 2 On the HP LoadRunner Controller(s), install and configure the Shunra NV for HP Controller (see page 2-5). 3 On the HP Load Generators(s), install Shunra NV for HP Load Generator (see page 2-5). If your configuration includes HP LoadRunner: 1 On the HP LoadRunner Controller(s), install and configure the Shunra NV for HP Controller (see page 2-5). 2 On the HP Load Generators(s), install Shunra NV for HP Load Generator (see page 2-5). Shunra NV Analytics and NetworkCatcher are optional components that can be installed on any machine that meet the system requirements. This section describes: Setting the Active Adapter (page 2-10) System Requirements (page 2-2) Installing the Shunra Component on HP Performance Center (page 2-4) Installing the Shunra Components on HP LoadRunner Controller (page 2-5) Installing the Shunra Component on HP Load Generator (page 2-5) Uninstalling Shunra Components on HP Software (page 2-5)

12 2-2 Shunra NV for HP Software Manual Chapter 2 Silent Installation and Uninstallation (page 2-6) Shunra NV for HP Software Licenses (page 2-10) Customizing Shunra NV for HP Software System Requirements The minimum requirements for Shunra components on HP Performance Center and HP LoadRunner Controller are as follows: Processor Memory Hard Disk Desktop Operating System (English, French, German versions only) Dual core processor or higher 2 GB RAM or more 1 GB of free disk space Win 7 SP1 (32/64 bit) Server 2008 SP2 (32/ 64 bit) Server 2008 R2 SP1 (64 bit) Server 2003 SP2 (32/64 bit) Server 2003 R2 SP2 (32/64 bit) XP Professional SP3 (32 bit) Screen Resolution Minimum: 1024 x 768 Browsers HP LoadRunner HP Performance Center Virtual Machine Internet Explorer 8.0 and higher HP LoadRunner Controller 11.5 SP2 HP Performance Center 11.5 SP2 VMware Workstation 7.0 and above VMware ESX 4.0 and above VMware ESXi 5.1 The minimum requirements for Shunra components on HP Load Generator are as follows: Processor Memory (RAM) Dual core processor or higher 2 GB RAM

13 Installing, Configuring and Licensing Shunra NV for HP Software Components Chapter Free Hard Disk Space Network Adapter 1 GB of free disk space Gigabit Ethernet Screen Resolution Minimum: 1024 x 768 Desktop Operating System (English, French, German versions only) Browsers HP LoadRunner Virtual Machine Win 7 SP1 (32/64 bit) Server 2008 SP2 (32/ 64 bit) Server 2008 R2 SP1 (64 bit) Server 2003 SP2 (32/64 bit) Server 2003 R2 SP2 (32/64 bit) XP Professional SP3 (32 bit) NV Editor requires IE 9.0 and higher HP LoadRunner 11.5 SP2 and higher VMware Workstation 7.0 and above VMware ESX 4.0 and above VMware ESXi 5.1 Third-Party Components The following third-party components are installed during installation of the Shunra NV for HP Performance Center and Shunra NV for HP Load Generator if not present on the host: Java 2 Runtime Environment, Standard Edition 1.6.0_38(x86) Microsoft.NET Framework 4.0 Full The following third-party components are installed during installation of the Shunra NV for HP Load Generator if not present on the host: Java 2 Runtime Environment, Standard Edition 1.6.0_38(x86) Microsoft.NET Framework 4.0 Full Installing Shunra NV for HP Software Shunra NV for HP Software installation components can all be installed using the Shunra NV for HP Software setup wizard. Note: You must restart your computer after installing each component.

14 2-4 Shunra NV for HP Software Manual Chapter 2 For full instructions for the Shunra NV Analytics, refer to the Shunra NV Analytics Manual v8.6. For full instructions for the NetworkCatcher, refer to the NetworkCatcher Manual v7.1. Installing the Shunra Component on HP Performance Center To install the Shunra NV for HP Performance Center: 1 On the HP Performance Center, open the S4H PSetupWizard.exe; select Shunra NV for HP Performance Center and follow the instructions in the wizard. 2 Click Finish to complete the installation process.

15 Installing, Configuring and Licensing Shunra NV for HP Software Components Chapter Installing the Shunra Components on HP Load- Runner Controller To install Shunra NV for HP Controller: 1 On the HP LoadRunner Controller, open the S4H PSetupWizard.exe; select the Shunra NV for HP Controller and follow the instructions in the wizard. 2 Click Finish to complete the installation process. Installing the Shunra Component on HP Load Generator To install the Shunra NV for HP Load Generator: 1 On the HP Load Generator, open the S4H PSetupWizard.exe, select Shunra NV for HP Load Generator and follow the instructions in the Installation wizard. 2 Click Finish to complete the installation process. Upgrading Shunra NV for HP Software Shunra NV for HP Software v8.6 utilizes a new license mechanism; contact your HP Softwarerepresentative to obtain a new license. To upgrade Shunra NV for HP Software: 1 On each HP Software software host where Shunra for HP Software was installed, remove the Shunra NV for HP Software component (Control Panel > Add Remove Programs). 2 Follow the instructions for Shunra NV for HP Software components installation. Uninstalling Shunra Components on HP Software To retain Shunra results, during the uninstallation select the option to save existing data.

16 2-6 Shunra NV for HP Software Manual Chapter 2 To uninstall Shunra components on HP Software: 1 In the Control Panel > Add/Remove programs, select the Shunra component and choose Remove. Silent Installation and Uninstallation Shunra NV for HP Load Generator, Shunra NV for HP Controller and Shunra NV for HP Performance Center can all be installed and uninstalled silently. To install and uninstall Shunra NV Analytics silently, refer to the Shunra NV Analytics Manual v8.6. Note: To perform silent installation use elevated privileges, (Run as Administrator or equivalent). Verify that all system requirements are met and third party prerequisites are installed before beginning installation. You will not be notified if silent installation fails. Silent Install of Shunra NV for HP Performance Center To silently install Shunra NV for HP Performance Center: 1 Copy the file SNV4HPPCSetup.exe to a convenient location on the HP Performance Center. 2 With elevated privileges (Run as Administrator or equivalent), from the Start menu, choose Run; then type CMD. 3 In the Command window, navigate to the location of the file copied in step 1, and type: SNV4HPPCSetup.exe /s /v"/qn PORT=<port number>" (default=8182) The following are optional: [INSTALLDIR=\"<path to install dir>\"] [ENABLE_REMOTE=TRUE FALSE](default is true) [REBOOT_IF_NEED=TRUE FALSE](default is false) [DATA_FOLDER=\"<path to data dir>\"]" (default \common Application folder\ Shunra) Example:

17 Installing, Configuring and Licensing Shunra NV for HP Software Components Chapter SNV4HPPCSetup.exe /s /v"/qn PORT=8182 ENABLE_REMOTE=TRUE" Note: Even if the REBOOT_IF_NEED=FALSE option is used during installation, the machine will need to be rebooted before Shunra NV for HP Performance Center is operational. Silent Install of Shunra NV for HP Controller To silently install Shunra NV for HP Controller: 1 Copy the file SNV4HPControllerSetup.exe to a convenient location on the HP LoadRunner Controller. 2 With elevated privileges, (Run as Administrator or equivalent), from the Start menu, choose Run; then type CMD. 3 In the Command window, navigate to the location of the file copied in step 1, and type: SNV4HPControllerSetup.exe /s /v"/qn PORT=<port number> [INSTALLDIR=\"<path to install dir>\"] (default=8182) The following are optional: [NET_LICENSE_ADDRESS="ADDRESS"](the address of the Shunra Local License Server when floating licenses are used with the Shunra License Manager) [ENABLE_REMOTE=TRUE FALSE](default is true) [REBOOT_IF_NEED=TRUE FALSE](default is false) [DATA_FOLDER=\"<path to data dir>\"]" (default \common Application folder\ Shunra) Example: SNV4HPLGSetup.exe /s /v"/qn PORT=8182 ENABLE_REMOTE=TRUE" NET_LICENSE_ADDRESS=il-test Note: Even if the REBOOT_IF_NEED=FALSE option is used during installation, the machine will need to be rebooted before Shunra NV for HP Controller is operational.enable_remote creates a firewall rule for the selected port; required to be able to access the Shunra License Manager remotely.

18 2-8 Shunra NV for HP Software Manual Chapter 2 Silent Install of Shunra NV for HP Load Generator To silently install Shunra NV for HP Load Generator: 1 Copy the file SNV4HPLGSetup.exe to a convenient location on the HP Load Generator. 2 With elevated privileges, (Run as Administrator or equivalent), from the Start menu, choose Run; then type CMD. 3 In the Command window, navigate to the location of the file copied in step 1, and type: SNV4HPLGSetup.exe /s v"/qn PORT=<port number> The following are optional: [INSTALLDIR=\"<path to install dir>\"] [ENABLE_REMOTE=TRUE FALSE](default is true) [REBOOT_IF_NEED=TRUE FALSE](default is false) [DATA_FOLDER=\"<path to data dir>\"]" (default \common Application folder\ Shunra) Example: SNV4HPLGSetup.exe /s /v"/qn PORT=8182 ENABLE_REMOTE=TRUE" Note: Even if the REBOOT_IF_NEED=FALSE option is used during installation, the machine will need to be rebooted before Shunra NV for HP Load Generator is operational. *ENABLE_REMOTE creates a firewall rule for the selected port; required to enable display of Shunra statistics in tests, and also for remote access to the Network Editor. Silent Uninstall Note: When performing silent uninstallation, you must be logged in as a local Administrator. Even if the REBOOT_IF_NEED=FALSE option is used during installation, the machine will need to be rebooted before Shunra NV for HP Software is operational.

19 Installing, Configuring and Licensing Shunra NV for HP Software Components Chapter Silent Uninstall of Shunra NV for HP Performance Center To silently uninstall Shunra NV for HP Performance Center: 1 From the Start menu, choose Run; then type CMD. 2 Type: SNV4HPControllerSetup.exe /s /removeonly /v"/qn [PORT=<port number>] [REBOOT_IF_NEED=TRUE FALSE]" PORT - optional, removes the port from the firewall Silent Uninstall of Shunra NV for HP Controller To silently uninstall Shunra NV for HP Controller: 1 From the Start menu, choose Run; then type CMD. 2 Type: SNV4HPControllerSetup.exe /s /removeonly /v"/qn [PORT=<port number>] [REBOOT_IF_NEED=TRUE FALSE]" PORT - optional, removes the port from the firewall Silent Uninstall of Shunra NV for HP Load Generator To silently uninstall Shunra NV for HP Load Generator: 1 From the Start menu, choose Run; then type CMD. 2 Type: SNV4HPLGSetup.exe /s /removeonly /v"/qn [PORT=<port number>] [REBOOT_IF_NEED=TRUE FALSE]" PORT - optional, removes the port from the firewall

20 2-10 Shunra NV for HP Software Manual Chapter 2 Setting the Active Adapter The Active Adapter determines the NIC through which impairments are applied to the traffic and packets are captured. To view and set the Active Adapter: 1 Open the Shunra NV for HP Load Generator (Start > Programs > Shunra > Shunra NV for HP Load Generator and select the Shunra NV Agent. Note: The Shunra NV Agent is located in the Notifications and Icons area in the taskbar when active. 2 In the Shunra NV for HP Load Generator, select Set Active Adapter. 3 Select the required NIC. 4 Select the Server side. Shunra NV for HP Software Licenses Shunra NV for HP Software comes with a fully-featured evaluation license of 2 days. After the evaluation period has expired, please contact license@shunra.com. If Shunra products were purchased from HP Software, contact the HP representative. License information is visible in the Shunra License Manager (Start > Programs Shunra > Shunra License). Shunra NV for HP Controller must be licensed to run scenarios. It implements the license agreement that determines the number of HP Load Generators

21 Installing, Configuring and Licensing Shunra NV for HP Software Components Chapter participating in a test, the number of Vusers participating in a test, and the number of Virtual Locations per test. For troubleshooting and other purposes, the HP Load Generator can run in standalone mode using a license from the Shunra License Manager that is installed with Shunra NV for HP Load Generator. Note: Any adjustments to the HP LoadRunner Controller system date and time may invalidate the Shunra License. Any virtual machines running Shunra products should not be cloned after the Trial License has started. Depending upon your license agreement, you can: Upload a node-locked license (see To upload a license file:) Enable Shunra NV for HP Controller to automatically check out a license from the Shunra Local License Server for the duration of a test (see To enable automatic check out and check in:) Check out (and check in) a license manually for a selected period from the Shunra Local License Server (To check out a license from the Shunra Local License Server (online):/to check in a license from the Shunra Local License Server (online): For information about installing the Shunra Local License Server refer to the Shunra License Server Installation and Configuration document. To access the Shunra License Manager on the HP Controller: 1 From the Start menu (Start > Programs > Shunra) select Shunra License. The status of the license is displayed.

22 2-12 Shunra NV for HP Software Manual Chapter 2 T To upload a license file: 1 Select the Update License button. 2 In the Update via, select the File radio button. 3 Select Download product key and save the fingerprint file (.c2v) on the local machine.

23 Installing, Configuring and Licensing Shunra NV for HP Software Components Chapter Attach the product key file (.c2v) to an message and sent to license@shunra.com Or Select Send Shunra your customer details and attach product key to attach the license file. 5 After the license file (.V2C) is received from Shunra, save the updated key file on the local machine. 6 Select the folder icon beside the File box and download the (.V2C) file. 7 Click Update. The updated license details are displayed in the Shunra License Manager main page. To enable automatic check out and check in: This feature checks out a license automatically when a test starts and the license is automatically checked in when the test completes. 1 On the Shunra NV for HP Controller host, from Start > Programs > Shunra, open the Shunra License Manager (localhost:8182/shunra/license). 2 Select the Update License button. 3 Select Local licensing server radio button. 4 Select the "Enable Automatic from..." checkbox. 5 Select the Licensing Server machine from the list, or type its name or IP manually if it does not appear. Note: The license client must be able to communicate with the Shunra Local License Server using TCP port To check out a license from the Shunra Local License Server (online): Note: The offline method must be used when the license client cannot communicate with the licensing server using TCP port 1947; refer to the Shunra License Server Installation and Configuration Guide. 1 From Start > Programs > Shunra, open the Shunra License Manager (localhost:8182/shunra/license). 2 Select the Update License button. 3 Select Local licensing server radio button. 4 In the Local server address, select the machine on which the license server is installed. If the License Server does not appear in the list, but is reach-

24 2-14 Shunra NV for HP Software Manual Chapter 2 able using TCP port 1947, type the license server hostname or IP in the Local server address box. 5 Enter the number of days required in the License duration box, and click Checkout license. The updated license details are displayed in the Shunra License Manager main page. To check in a license from the Shunra Local License Server (online): 1 On the From Start > Programs > Shunra, open the Shunra License Manager (localhost:8182/shunra/license). 2 Select the Update License button. 3 Select Local licensing server radio button. 4 Click Return license. Customizing Shunra NV for HP Software Certain settings can be modified in the configuration files.

25 Installing, Configuring and Licensing Shunra NV for HP Software Components Chapter Changing the Port for Shunra NV for HP Controller To change the port for Shunra NV for HP Controller: 1 Ensure that no emulations are currently running. 2 Open the config.properties 3 Change: com.shunra.bootstrapper.port="x" 4 Save the file. 5 Restart the service: Shunra Watchdog 6 To access Shunra NV for HP Load Generator applications, in the browser and in shortcuts, change the port for License Manager. Changing the Port for Shunra NV for HP Load Generator To change the port for Shunra NV for HP Load Generator: 1 Ensure that no emulations are currently running. 2 Open the configuration folder, by default C:\Program Files\Shunra\conf 3 Open the file: vcat.properties 4 Change: com.shunra.vcat.port=8182 to com.shunra.vcat.port ="X" 5 Save the file. 6 Open the config.properties 7 Change: com.shunra.bootstrapper.port="x" 8 Open the folder, by default C:\Program Files\Shunra\lib\shunra\vcat 9 Open the file: ShunravCatAgent.exe.config 10 Locate the port and change it to the new port. 11 Restart the service: Shunra Watchdog 12 To access Shunra NV for HP Load Generator applications, in the browser and in shortcuts, change the port for the Network Editor and License Manager.

26 2-16 Shunra NV for HP Software Manual Chapter 2 The Cleanup Threshold The Cleanup Threshold is a mechanism for deleting network virtualization results saved on the NV for HP Load Generator to free up disk space. Test results are saved in the NV for HP Load Generator, Data folder, as defined during setup (by default in \%appdata%\shunra\emulation\runs or \%programdata%\shunra\emulation\runs). When starting a test, if the defined free disk threshold on the NV for HP Load Generator isn't met, the results folders will be deleted one by one from the oldest until the threshold is restored, or until only two folders are left. If only two folders are left and the threshold wasn't restored and the test does not start on the HP Load Generator, consider deleting unnecessary data or reducing the threshold. By default the Cleanup Threshold mechanism is disabled. To activate the Cleanup Threshold on each NV for HP Load Generator: 1 Ensure that no emulations are currently running. 2 Open the configuration folder, by default C:\Program Files\Shunra\conf 3 Open the file: userconfiguration.xml 4 Change IsCleanupEnabled to true. 5 Save the file. 6 Restart the service: Shunra Watchdog The Cleanup Threshold is 3 times of the defined Packet List size. The Packet List capture includes all tests and flows running on the NV for HP Load Generator. When starting a test with HP Software, the Packet List size is defined in the Network Virtualization Global Settings. For Network Virtualizations running on the HP Load Generator in standalone mode, use the following procedure. To define the Packet List size: 1 Ensure that no emulations are currently running. 2 Open the configuration folder, by default C:\Program Files\Shunra\conf 3 Open the file: userconfiguration.xml 4 Set PacketListMaxSizeMB to the required value.

27 Installing, Configuring and Licensing Shunra NV for HP Software Components Chapter Save the file. 6 Restart the service: Shunra Watchdog

28 2-18 Shunra NV for HP Software Manual Chapter 2

29 Conducting Network Virtualization in HP Software Chapter Conducting Network Virtualization in HP Software 3: Within HP Software you can virtualize network conditions when configuring HP LoadRunner and HP Performance Center tests. Network Virtualization is enabled in HP Performance Center Test Designer window in the Workload tab, and in the HP Controller in the Scenario window see Incorporating Network Virtualization (page 3-4). Using Shunra s Network Virtualization, you set the network conditions between a client and a server in a Virtual Location. These Virtual Locations can be assigned to Groups or HP Load Generators in HP Software tests. Shunra s Network Virtualization can be conducted in these modes: Per Virtual Location: to assign multiple Virtualized Locations per HP Load Generator; recommended option. Per Load Generator: to assign a single Virtualized Location per HP Load Generator; all Groups running on that HP Load Generator will have the same network conditions. HP Software Scenarios from previous releases (for example, after upgrade), are imported into this mode. Note: If a HP Load Generator contains more than one NIC, refer to Setting the Active Adapter in Chapter 2. Defining Global Settings These settings control options for all HP Load Generators participating in a test.

30 3-2 Shunra for HP Software Manual Chapter 3 Packet Capture Packet capture is required to conduct analysis in the Shunra NV Analytics. Use of capture packets is only relevant when a Group contains a single Vuser. The default maximum size is 100 MB per the HP Load Generator. Note that the packet list size cannot be more than 25% of the RAM of the HP Load Generator. Note: In addition, packet capture has to be enabled for each Virtual Location in the Options tab. To enable the packet capture option for all HP Load Generators: 1 In the HP Controller, Network Virtualization Settings window, select the Global Settings button. And In HP Performance Center click the Global Settings link. 2 In the Allow packet capture, select the ON button.

31 Conducting Network Virtualization in HP Software Chapter T 3 To modify the size of the packet list capture, type the required value. 4 Select OK to save the settings. Configuring IP Filters This setting excludes specific IP addresses from all Virtual Locations. To exclude an IP address from a specific Virtual Location see Excluding IP Addresses on page To exclude IP addresses from all Virtualized Locations: 1 In the Network Virtualization Setting window, select the Global Settings button. 2 In the Global Settings window, in the IP Filter area, type the required IP address and click the "+" sign.

32 3-4 Shunra for HP Software Manual Chapter 3 3 Repeat all the IP addresses you wish to exclude. Note: IP Address that have been excluded in the Global Settings are displayed in gray in the Options tab. 4 To remove an IP address click "X". 5 Select OK to save the settings. Incorporating Network Virtualization To exclude specific machines from undergoing network emulation, refer to Configuring IP Filters (page 3-3). Incorporating Network Virtualization in HP Performance Center To incorporate Network Virtualization in HP Performance Center: 1 In HP Performance Center Test Designer window > Workload tab, select the Network Virtualization icon. 2 In the Network Virtualization Settings dialog, select the Enable Network Virtualization checkbox.

33 Conducting Network Virtualization in HP Software Chapter Select one of the following options: Per Group: each Group can use its own Virtual Location (network conditions). Per Load Generator: assigns a Virtual Location per HP Load Generator. All Groups running on that HP Load Generator will receive the same network conditions. 4 In the Add new Virtual Location: area, type the Location name. You can add, modify, duplicate, or delete a Virtual Location. You can also import Virtual Locations after they have been previously exported and saved. Note: For Virtual Location names, use the ANSI standard format. You cannot use the following characters: \ / :? < > * % ^,! { } ( ) ; 5 In the Shunra Network Virtualization window, select one of the following options to provide network conditions: Import from Library Settings (page 3-8) Custom Settings (page 3-10) Advanced Settings (page 3-12) 6 If required, update the IP Filter and Packet List settings in the Options tab. 7 Select OK. 8 Using the Per Group option: in the Virtual Location column, assign Virtual Locations to the required Groups.

34 3-6 Shunra for HP Software Manual Chapter 3 9 Using the Per Load Generator option: select the "Details" for each of the required HP Load Generators. In the Network Virtualization tab, select the required Virtual Location. Incorporating Network Virtualization in HP LoadRunner To incorporate Network Virtualization in HP LoadRunner: 1 In the HP Controller Scenario window toolbar, select the Network Virtualization icon. 2 Select one of the following options: Per Group: assigns each Virtual Location its own network conditions (recommended option).

35 Conducting Network Virtualization in HP Software Chapter Per Load Generator: assigns a single Virtual Location per HP Load Generator. All Groups running on that HP Load Generator will receive the same network conditions. 3 In the Virtual Location column, type the Location name (Description is optional). 4 Select a Virtual Location and then choose Configure. You can add, modify, duplicate, or delete a Virtual Location; in addition, you can also import a Virtual Location after it has been previously exported and saved to a repository. Note: For Virtual Location names, use the ANSI standard format. You cannot use the following characters: \ / :? < > * % ^,! { } ( ) ; 5 In the Shunra Network Virtualization window, select one of the following options to provide network conditions: Import from Library Settings (page 3-8) Custom Settings (page 3-10) Advanced Settings (page 3-12) 6 If required, update the IP Filter and Packet List settings in the Options tab. 7 Select OK. 8 Using the Per Group option: in the Virtual Location column, assign Virtual Locations to the required Groups. 9 Using the Per Load Generator option: select the "Details" for each of the required HP Load Generators. In the Network Virtualization tab, select the required Virtual Location.

36 3-8 Shunra for HP Software Manual Chapter 3 Import from Library Settings You can import recordings of mobile and broadband network conditions from Shunra s Global Library. The Global Library is comprised of a regularly updated, pre-populated set of more than 20 million real-world data points of point-to-point network conditions, recorded around the world. Additional licensing may be required. To import a recording: 1 In the Shunra Network Virtualization window > Virtualization tab, select the Import from Shunra s Global Library radio button. 2 In the From-To, select the Client and Server Location, such as the name of a city or state.

37 Conducting Network Virtualization in HP Software Chapter In the Connection Properties, define the Technology, Carrier and Time of day. Note: These properties are related to the Client Location. 4 Select the forward arrows and choose one of the Communication quality options. 5 If a WiFi connection was selected, select the required bandwidth.

38 3-10 Shunra for HP Software Manual Chapter 3 6 Select the check mark to import the Profile. 7 To view a summary of the settings, click Summary. Custom Settings Use the Custom settings to manually define the network conditions for latency, packet loss and the Client s bandwidth. To define a Custom Network Profile: 1 In the Shunra Network Virtualization window > Virtualization tab, select the Custom radio button.

39 Conducting Network Virtualization in HP Software Chapter Enter values for some or all of the Virtualization properties: Latency: defines the time it takes an IP packet to cross the WAN. The valid range is msec. Packet Loss: defines the chance of losing IP packets while data travels though the WAN. The valid range is 0 90% 3 Upload and Download Bandwidth: to limit the aggregate bandwidth to the capacity of a specific WAN link, select a bandwidth from the Bandwidth Limitation drop-down list, or type a range from ,000,000 kbps. 4 To view a summary of the settings, click Summary.

40 3-12 Shunra for HP Software Manual Chapter 3 Advanced Settings Network Scenario files contain network virtualization parameters including latency, bandwidth and packet loss. These files may originate in Shunra s NetworkCatcher and can be modified in the NV Editor, or created entirely in the NV Editor (refer to the Using the Shunra NV Editor, page 3-1). Once imported, the file automatically configures the required network virtualization parameters which, when played, are applied to all traffic entering and leaving the local NIC. An imported.ntxx file may contain multiple flows created on the WAN Cloud or Gateway shapes in Shunra s NV Editor. These flows can be selected individually to apply conditions for specific Location. Recording files of up to 900 latency and packet loss samples, and/or 900 bandwidth samples can be imported; the imported file is validated, so that files with an invalid number of samples are not saved. To import a Network Scenario File: 1 In the Shunra Network Virtualization window > Virtualization tab, select the Advanced radio button. Note: Excluded IP addresses are not retained in the imported file. For more information, see Configuring IP Filters on page 3-3.

41 Conducting Network Virtualization in HP Software Chapter Click the Browse icon to import an.ntx or.ntxx file from a shared network drive and select the file from the Browse window. 3 If required, select a flow for specific Location. 4 To view a summary of the settings, click Summary.

42 3-14 Shunra for HP Software Manual Chapter 3 Defining Bandwidth Allocation Bandwidth can be shared between all Vusers, or assigned to each Vuser individually. 1 In the Shunra Network Virtualization window > Options tab, select one of the radio buttons:

43 Conducting Network Virtualization in HP Software Chapter Each Vuser is allocated the Bandwidth as defined in the Profile settings (Virtualization tab) independently Bandwidth as defined in the Profile settings (Virtualization tab) is shared between all Vusers 2 Select OK to save the settings. Enabling Packet Capture Packet capture is required for Shunra NV Analytics which provide in-depth analysis and optimization recommendations. When Shunra NV Analytics is not required, it is recommended not to enable Packet Capture because it requires a substantial memory allocation and disc space. To enable capture of the packet list per Virtualized Location: 1 In the Shunra Network Virtualization window > Options tab, select ON. Note: This option is only present if Packet Capture has been enabled in the Global Settings (page 3-2). 2 Select OK to save the settings. Excluding IP Addresses Use the IP Filter to exclude certain machines that would be adversely affected by network virtualization. When a machine is excluded from the network virtualization, network traffic to that machine does not suffer any network effects and will not be included in the network virtualization results. To exclude a specific IP addresses per Virtual Location: 1 In the Shunra Network Virtualization window > Options tab, in the IP Filter area, type the required IP address and click the "+" sign. 2 Repeat all the IP addresses you wish to exclude. Note: IP Address that have been excluded in the Global Settings are displayed in gray. 3 To remove an IP address click "X". 4 Select OK to save the settings.

44 3-16 Shunra for HP Software Manual Chapter 3 Viewing Runtime Statistics When a test is running in HP Software, Shunra statistics can be viewed in the graphs area. To view runtime statistics: 1 On the HP Performance Center, select the required metrics in the Available Graphs, Shunra Network Virtualization. 1 On the HP Controller, select the required metrics in the Available Graphs, Shunra Network Virtualization graphs. The following statistics are displayed: Average latency: Displays the average recorded time required for a packet of data to travel from the source designated point to the required destination, measured in milliseconds.

45 Conducting Network Virtualization in HP Software Chapter Packet loss: Lists the number of packets lost during the last second. Packet loss occurs when data packets fail to reach their destination. It can result from gateway overload, signal degradation, channel congestion and faulty hardware software. Average Throughput: Displays the average data traffic passing from and to the virtualized location, measured in kbps. Average Bandwidth Utilization: The average bandwidth utilized by a virtual user or a virtualized location from the maximal available bandwidth allocated for it during the last second, measured in percentages. Total Throughput: Displays the total data traffic passing from and to the virtualized location, measured in Kb. Viewing Analysis The HP LoadRunner Analysis also incorporates Shunra statistics. Utilizing Shunra NV Analytics Shunra Analytics conducts an analysis based on packet list data, then displays the resulting data in informative reports and optimization recommendations that provide insight into an application's operation. To conduct analysis, certain customizations of the test are required. Scenario Configuration Guidelines A Group used for transaction marking should consist of a single Vuser.

46 3-18 Shunra for HP Software Manual Chapter 3 Turn on Packet Capture in the Network Vitualization Global Settings and for the Virtual Location. A Group used for transaction marking should run alone on a HP Load Generator. To adapt the HP LoadRunner script: 1 In the beginning of the script, before "Action ()" add the following: //Shunra - send REST request SendRequest(char *requesttype, char *uri,char *request_json_base){ char *request_type; char *request_json; lr_save_string(lr_eval_string(uri), "URL_Param"); request_json = lr_eval_string(request_json_base); lr_save_string(request_json, "REQUEST_JSON_PARAM"); request_type=lr_eval_string(requesttype); lr_save_string(request_type,"req_type"); web_add_header("content-type", "application/ json"); web_reg_save_param("responce", "Notfound=warning", "LB=", "RB=", "Search=Body", "IgnoreRedirections=Yes", LAST); web_custom_request("request", "URL={URL_Param}", "Method={REQ_TYPE}", "TargetFrame=", "Resource=0", "Referer=", "Mode=", "Body={REQUEST_JSON_PARAM}", LAST); return 0; } //Shunra - start transaction manager session ConnectTM(){

47 Conducting Network Virtualization in HP Software Chapter char *request_json_base; char *temp; char *temp2; char *URL = " transactionmanager"; request_json_base= "{" "\"endpointidentifier\":\"id_client_flows_1\"," "\"overwriteexistingconnection\":\"true\"" "}"; SendRequest("POST",URL, request_json_base); temp=lr_eval_string("{responce}"); temp2=temp+1; lr_save_string(temp2,"transactionmanagersessionident ifiers"); return 0; } //Shunra - end transaction manager session DisconnectTM(){ char *request_json_base; char *temp; char *temp2; char *URL = " transactionmanager"; request_json_base= "{" "{transactionmanagersessionidentifiers}"; SendRequest("PUT",URL, request_json_base); return 0; } //Shunra - mark start transaction StartTransaction(char *TransactionName){ char *request_json_base; char *temp; char *temp2; char *URL = " transactionmanager/transaction"; lr_save_string(lr_eval_string(transactionname),"tran SACTION_NAME");

48 3-20 Shunra for HP Software Manual Chapter 3 request_json_base="{" "\"transactionname\":\"" "{TRANSACTION_NAME}" "\"," "{transactionmanagersessionidentifiers}"; SendRequest("POST",URL, request_json_base); temp=lr_eval_string("{responce}"); memmove(temp, temp+1, (strlen(temp)-2)); temp[(strlen(temp)-2)]=0; lr_save_string(temp,"transactionidentifiers"); return 0; } //Shunra - mark stop transaction StopTransaction(char *TransactionDescription){ char *temp; char *temp2; char *request_json_base; char *URL = " transactionmanager/transaction"; lr_save_string(lr_eval_string(transactiondescription ),"TRANSACTION_Description"); request_json_base="{" "\"transactiondescription\":\"" "{TRANSACTION_Description}" "\"," "\"passed\":\"true\"," "{transactionidentifiers}" "," "{transactionmanagersessionidentifiers}"; SendRequest("PUT",URL, request_json_base); temp=lr_eval_string("{responce}"); temp2=temp+1; lr_save_string(temp2,"transactionstop"); return 0; } 2 At the beginning of "Action ()" add : ConnectTM(); 3 Before each HP LoadRunner start transaction, add: StartTransaction("transaction name");

49 Conducting Network Virtualization in HP Software Chapter After each HP LoadRunner stop transaction add: StopTransaction("transaction name"); 5 At the end of "Action ()" add: DisconnectTM(); 6 Add HP LoadRunner script parameters (custom type): IP port 7 Define the required SNV LG IP and port (installation default is 8182). Note: Save a copy of the script with the required IP address and port for each NV for HP Load Generator upon which the script will run. Example of script structure: //Shunra - send REST request SendRequest(char *requesttype, char *uri,char *request_json_base){ char *request_type; char *request_json; lr_save_string(lr_eval_string(uri), "URL_Param"); request_json = lr_eval_string(request_json_base); lr_save_string(request_json, "REQUEST_JSON_PARAM"); request_type=lr_eval_string(requesttype); lr_save_string(request_type,"req_type"); web_add_header("content-type", "application/json"); web_reg_save_param("responce", "Notfound=warning", "LB=", "RB=", "Search=Body", "IgnoreRedirections=Yes", LAST); web_custom_request("request", "URL={URL_Param}", "Method={REQ_TYPE}", "TargetFrame=", "Resource=0", "Referer=", "Mode=", "Body={REQUEST_JSON_PARAM}", LAST); return 0; }

50 3-22 Shunra for HP Software Manual Chapter 3 //Shunra - start transaction manager session ConnectTM(){ char *request_json_base; char *temp; char *temp2; char *URL = " transactionmanager"; request_json_base= "{" "\"endpointidentifier\":\"id_client_flows_1\"," "\"overwriteexistingconnection\":\"true\"" "}"; SendRequest("POST",URL, request_json_base); temp=lr_eval_string("{responce}"); temp2=temp+1; } lr_save_string(temp2,"transactionmanagersessionident ifiers"); return 0; //Shunra - mark start transaction StartTransaction(char *TransactionName){ char *request_json_base; char *temp; char *temp2; char *URL = " transactionmanager/transaction"; } lr_save_string(lr_eval_string(transactionname),"tran SACTION_NAME"); request_json_base="{" "\"transactionname\":\"" "{TRANSACTION_NAME}" "\"," "{transactionmanagersessionidentifiers}"; SendRequest("POST",URL, request_json_base); temp=lr_eval_string("{responce}"); memmove(temp, temp+1, (strlen(temp)-2)); temp[(strlen(temp)-2)]=0; lr_save_string(temp,"transactionidentifiers"); return 0;

51 Conducting Network Virtualization in HP Software Chapter //Shunra - mark stop transaction StopTransaction(char *TransactionDescription){ char *temp; char *temp2; char *request_json_base; char *URL = " transactionmanager/transaction"; lr_save_string(lr_eval_string(transactiondescription ),"TRANSACTION_Description"); request_json_base="{" "\"transactiondescription\":\"" "{TRANSACTION_Description}" "\"," "\"passed\":\"true\"," "{transactionidentifiers}" "," "{transactionmanagersessionidentifiers}"; SendRequest("PUT",URL, request_json_base); temp=lr_eval_string("{responce}"); temp2=temp+1; lr_save_string(temp2,"transactionstop"); return 0; } Action() { ConnectTM(); StartTransaction("first transaction name"); lr_start_transaction("first transaction name"); // first transaction lr_end_transaction("first transaction name",lr_auto); StopTransaction("first transaction name"); StartTransaction("second transaction name"); lr_start_transaction("second transaction name"); // second transaction lr_end_transaction("second transaction name",lr_auto); StopTransaction("second transaction name"); StartTransaction("third transaction name");

52 3-24 Shunra for HP Software Manual Chapter 3 lr_start_transaction("third transaction name"); // third transaction lr_end_transaction("third transaction name",lr_auto); StopTransaction("third transaction name"); return 0; DisconnectTM(); } Conducting Analysis with Shunra NV Analytics To utilize Shunra NV Analytics, first download the test results on the HP Load Generator, and then import them into Shunra NV Analytics which may be installed on a separate machine. To save the test results: 1 After the test has completed, on the Load Generator go to: \%ProgramData%\Shunra\Emulation\Runs or \%AppData%\Shunra\Emulation\Runs. 2 Locate the required test folder (to locate the required test, the 'Date modified' of the folder should be the HP LoadRunner Scenario start time). 3 If Shunra NV Analytics is not installed on the HP Load Generator, copy the.shunra file from the folder to the remote machine where Shunra NV Analytics is installed. 4 Open the.shunra file in Shunra NV Analytics.

53 Using the Shunra NV Editor Chapter Using the Shunra NV Editor 4: The Shunra NV Editor is used to create and edit network scenariofiles. Each network scenario file can contain multiple flows, in which each flow represents traffic between two locations orf different networks. The NV Editor is installed with the Shunra NV for HP LoadGenerator component. The NV Editor model is based upon a network in which the client and server are each adjacent to a gateway. For easy identification, the network file editor calls these gateways "Server Gateway" and "Client Gateway." Data flows between the Client Gateway and the Server Gateway through the WAN. These values can be: Imported from the Shunra Global Library Manually set in the various parameter tabs of the NV Editor (page 4-9) Imported from NetworkCatcher recordings Installing the NV Editor The Network Editor is installed as part of the Shunra NV for HP LoadGenerator installation, see Chapter 2 Installing, Configuring and Licensing Shunra NV for HP Software Components. For the integration with HP Software, the NV Editor can be installed on the HP LoadRunner or HP Performance Center components, or as standalone on any another computer.

54 4-2 Shunra for HP Software Manual Chapter 4 Opening the NV Editor To open the NV Editor: In a browser, type: NV for HP LoadGenerator host IP>:8182/shunra/networkeditor/ Creating Shunra Emulation Profiles A network scenario file emulates network conditions with parameters such as packet loss, latency and bandwidth limitation of the virtualized network. The network scenario file defines the network conditions between two endpoints. You can set a series of parameters that characterize the gateways and the WAN. For example, you can set values that represent network phenomena such as latency and packet loss, or hardware settings such as the size of the queues allowed on the gateway. The output of the NV Editor is stored in a.ntxx file. use by Shunra NV for HP LoadGenerator For HP LoadRunner users incorporating network virtualization, the network files need to be accessible by the HP LoadRunner Controller or HP Performance Center server.the appropriate file is sent to each load generator as part of load test initialization. Thus, the individual load generators do not need to be configured to access a shared directory of files. Note: The.ntxx files created by the NV Editor cannot be imported into Shunra PerformanceSuite. To create a Shunra Emulation Profile (.ntxx file): Note: Each file can contain multiple flows provided that the IPs do not overlap. 1 On the home page, select New. 2 Click Add new flow.

55 Using the Shunra NV Editor Chapter In the New Flow page, set the following parameters as described below: Setting Client and Server IP Ranges: (page 4-4) these settings are overriden by the HP Controller; these settings only apply when running tests directly on the Shunra NV for HP LoadGenerator Configuring Gateway Parameters: (page 4-6) the gateway and its parameters including bandwidth limitations, and packet overhead using configured data or imported values Configuring the WAN Shape: (page 4-9): set latency and packet loss parameters using imported data, or by configuring values 4 After selecting the required options, click Done. The Flow Summary displays all Flows. To edit a file click the pencil icon; to delete a file click the "x"; to delete all files select the table icon.

56 4-4 Shunra for HP Software Manual Chapter 4 5 Select Save to download the network profile to the browser's default download folder. Note: It is highly recommended to configure the browser to prompt the user to choose the folder at download time. 6 The file can be used to conduct a network virtualization. Setting Client and Server IP Ranges Network impairments can be limited to and from specified IP addresses (to "include" them) or to refrain from affecting traffic to certain addresses ("exclude" them). For example, in the configuration with HP Software, the IP address of the HP LoadRunner Controller is automatically excluded so that traffic between the HP Load Generators and the HP LoadRunner Controller is not tested. Network traffic that is not included in the emulation will not be impaired, and will not be included in monitoring reports. Included or excluded IP addresses are overriden by the HP Controller; these settings only apply when running tests directly on the Shunra NV for HP Load- Generator. Packet list capture is enabled by default. In Shunra NV for HP Software this setting is overriden.

57 Using the Shunra NV Editor Chapter To include or exclude IP addresses: 1 In the Client IP Ranges tab, click the "+" icon. 2 Enter the IP addresses to include or exclude. Enter a complete IP address, as subnets or IP ranges are not supported. You can use the duplicate option to assist when typing similar addresses, but duplicate IPs are not permitted. Note: Exclude the address of the machine on which the Network Editor is installed. 3 Set the IP range ("From IP" and "To IP"). 4 Select a Port and Protocol (optional) 5 Repeat steps 2-3 to add other excluded or included ranges as required; all the excluded ranges must be within the included range. Note: An IP address can be modified by selecting it and clicking the pencil icon; an IP address can be removed from the list by selecting it and clicking the "x" icon. The Server s Sync button includes the IP Range and excludes the flow's Client ranges to prevent ambiguous routes. To exclude specific IP Ranges in all running tests: 1 Ensure that no emulations are currently running. 2 Use the Web Services API or the CLI (refer to Shunra NV for HP Software Web Service API and Command Line Interface). 3 Restart the service: Shunra Watchdog

58 4-6 Shunra for HP Software Manual Chapter 4 Defining Packet List Settings The packet list is essential for Shunra NV Analytics, which use the packet list data to produce the analytics reports and recommendations. These settings are overriden by the HP Controller; these settings only apply when running tests directly on the Shunra NV for HP LoadGenerator. To enable Packet List capture: In the Packet List icon (located between the Client and Client Gateway), select Enable packet list capture, then click Close. Configuring Gateway Parameters Gateway parameters emulate the behavior of access gateways on real networks. For example, you can specify the bandwidth or queue limitation a specific gateway imposes on the network. Entering gateway parameters is optional., and the options are the same for both the Client and the Server gateways. The gateway element represents an actual gateway that can be separately configured for incoming and outgoing traffic. Click the Client and Server Gateway tabs to configure the parameter settings. Bandwidth Settings Queue Settings: (page 4-7) Bandwidth Settings Bandwidth values can be defined or imported from a recording file; upstream and downstream may each have different values. Note: The following instructions are valid for both the upstream and downstream settings. To define the bandwidth values: 1 Select Predefined, then choose a preset value (these settings corresponds to common bandwidth settings such as T1, etc.), OR Select Custom, then type a value to select a specific bandwidth (values between 2.4 and 10,000,000 Kbps).

59 Using the Shunra NV Editor Chapter Click Done. Importing Bandwidth Settings Bandwidth recordings of up to 900 samples can be imported; the imported file is validated, so that incorrect values are not saved. To import recorded bandwidth parameters: 1 In the Client and/or Server Gateway tab, select Recorded then click Choose file. 2 In the Browse window, select the relevant file. Files which do not contain valid bandwidth parameters are not imported. Queue Settings The Queue Settings define the queue limitations and packet overhead.