LoadRunner Readme

1 of 21

file:///D:/HPSoftware/LR_PC_SIS/PC/PC.12.53/Docs/LR_12.53_Readm...

HP LoadRunner Readme Software Version: 12.53

Publication date: May 08, 2016

You can view the most recent LoadRunner Help Center at http://lrhelp.saas.hpe.com/en/12.53/. This file provides information about LoadRunner 12.53, such as new features, system requirements, and known issues. What's New in LoadRunner 12.53 Installation and Configuration Information Notes and Limitations Additional Resources Legal Notices

What's New in LoadRunner 12.53 For information about the features in previous versions, click the following links. Version 12.00 Version 12.01 Version 12.02 Version 12.50

Highlights Git integration in VuGen 64-bit replay support in various Java protocols and C Vuser protocol New PCoIP (remote access) protocol Enhanced SAPUI5 recording in TruClient HTTP Video Streaming (HTML5, HLS) support HTTP/2 support REST step-builder editor in VuGen JSON manipulation APIs Web - HTTP/HTML and Mobile Application - HTTP/HTML protocol unification Linux load generator improvements Enhancements to Java-based protocols

New Supported Technologies and Platforms 7/22/2016 10:39 AM

LoadRunner Readme

2 of 21

file:///D:/HPSoftware/LR_PC_SIS/PC/PC.12.53/Docs/LR_12.53_Readm...

Windows 10 Microsoft Edge browser Visual Studio 2013 add-in Visual Studio 2015 add-in Upgraded Eclipse IDE add-in SUSE Linux Enterprise Server 12 Red Hat Enterprise Linux 7.2 hLinux (HPE’s Debian-derivative)

VuGen Enhancements Integration with Git, enabling you to store scripts in a Git repository, improving team collaboration for Agile groups. For details, see Managing Scripts with Git - Overview in the LoadRunner Help Center. REST GUI API editor, enabling you to create and test REST API steps in scripts. For details, see How to Create a Script for a REST API in the LoadRunner Help Center.

Improved support for instant traffic capture files (including PCAP, HAR, SAZ). For details, see How to Create a Vuser Script by Analyzing a Captured Traffic File in the LoadRunner Help Center. Ability to check script compatibility for Linux. For details, see Check Linux Compatibility in the LoadRunner Help Center. New comparison and merging tool. For details, see Options Dialog Box in the LoadRunner Help Center. Optional data collection program, compiling VuGen usage analytics to help improve VuGen quality. For details, see the LoadRunner Installation Guide. Improved VuGen user interface, including new Start page, and revamped Tools > Options dialog box. Multiple usability improvements in the following areas: Correlations, parameterization and data import, NV Analytics report, menus, and more.

TruClient Enhancements All referenced TruClient Help topics can be found in the TruClient Help Center at http://tchelp.saas.hpe.com /en/12.53/. Changes to browser version support:

Chromium 46 Firefox 40.0.3 Internet Explorer 10 and 11 (Internet Explorer 9 is no longer supported) Improvements to step end events, including:

New end event – Object Exists. Automatic end event per browser. Reset automatic end event.

7/22/2016 10:39 AM

LoadRunner Readme

3 of 21

file:///D:/HPSoftware/LR_PC_SIS/PC/PC.12.53/Docs/LR_12.53_Readm...

For details, see Understanding End Events in the TruClient Help Center. Improvements to object identification:

Automatic object identification now includes a built-in fallback mechanism. For details, see Resolve Object Identification Issues in the TruClient Help Center. Random object identification using Descriptors. For details, see Descriptors in the TruClient Help Center. Improvements to interactive script development:

Control actions during recording. For details, see Record a TruClient Script in the TruClient Help Center. Ability to skip Wait steps during script replay. For details, see Debug TruClient scripts in the TruClient Help Center. Ability to disable the Watch panel from the Interactive Options tab of the General Settings. TruClient Standalone: Revamped TruClient Launcher. Support for non-zipped script folders. Ability to export script to zips containing runtime files only. For details, see TruClient Editions in the TruClient Help Center. TruClient Chromium: Support for NV Emulation integration. Support for NV Analytics Report in VuGen. Support for Speed Simulation, available under the Network section in the Run-Time Settings. Support for IP Spoofing. Support for HP Diagnostics integration. TruClient Internet Explorer: Improved support for Internet Explorer 10 and 11 cache mechanism. Stability fixes. General TruClient enhancements: Improved ability to record SAPUI5 applications. Recording is supported with all browsers and with increased usability. Ability to call the parameter’s name directly as an input in the Step Arguments section. Support Continue to the next step as additional Action on Error, under the Load section in the Run-Time Settings. Support for additional VTS (Virtual Table Server) APIs. For details, see TruClient Functions in the TruClient Help Center. New Generic API Action step, providing a UI for TruClient JavaScript APIs, available from the Toolbox. For

7/22/2016 10:39 AM

LoadRunner Readme

4 of 21

file:///D:/HPSoftware/LR_PC_SIS/PC/PC.12.53/Docs/LR_12.53_Readm...

details, see TruClient Toolbox in the TruClient Help Center. Title argument added to Activate Browser Window step, enabling activation of browser window using the window title. For details, see TruClient Step Arguments in the TruClient Help Center. Activate tab/window steps now have a retry mechanism with timeout. For details, see TruClient Step Arguments in the TruClient Help Center.

General Protocol Enhancements Citrix:

Optical Character Recognition (OCR) text trapping. For details, see the Function Reference. Support for user activity simulation in idle session, available from the runtime settings Citrix Synchronization View. For details, see Citrix - Troubleshooting and Limitations in the LoadRunner Help Center. C Vuser:

Support for 64-bit replay for C Vuser scripts. Update to C scripting backend, providing 64-bit integers support (long long, unsigned long long). Switched C Interpreter to the latest Microsoft C Runtime. For details, see the Function Reference. Flex: Support for Java serialized objects. For details, see Data Format Extension List in the LoadRunner Help Center. FTP:

Support for 64-bit recording. Java-based protocols:

Support for Java 8 in the following protocols: Java over HTTP, Java Record Replay (recording RMI and custom hooks sub-protocols only), Java Vuser Support for 64-bit recording with Java 8 in the Java Record Replay protocol Support for 64-bit replay with Java 8 in the following protocols: Java Record Replay, Java Vuser General Java-based protocols usability improvements. Changes to the Java VTC API (lrapi.vts.Vtc), to support 64-bit replay mode. The Vtc handler is now long instead of int. For details, see the Function Reference. Oracle - 2-Tier:

Support for Oracle Database 12c. Teradici PCoIP:

New VuGen protocol, PCoIP (remote access), based on Teradici’s PC-over-IP technology; providing ability to record and replay scripts, load test, and perform analysis. For details, see Teradici PCoIP Protocol in the LoadRunner Help Center.

7/22/2016 10:39 AM

LoadRunner Readme

5 of 21

file:///D:/HPSoftware/LR_PC_SIS/PC/PC.12.53/Docs/LR_12.53_Readm...

SAP GUI: Support for SAPGUI 7.40. Web – HTTP/HTML & Mobile Application - HTTP/HTML:

Support for recording HTTP video streaming (on HTML5 and HLS), providing unified APIs to perform common video player actions, and providing streaming metrics (lagging, buffering, and more). For details, see How to record streaming media in Web - HTTP/HTML in the LoadRunner Help Center. Support for HTTP/2 recording and replay, including multiplexing. For details, see How to Record HTTP/2 in the LoadRunner Help Center. Support for the Microsoft Edge browser. For details, see Start Recording Dialog Box in the LoadRunner Help Center. Support for Server Name Indication (SNI). For details, see How To Record and Replay on servers with SNI Enabled in the LoadRunner Help Center. New APIs to manipulate and edit JSON data (similar to existing XML API). For details, see the Function Reference. The Web - HTTP/HTML protocol was unified with the Mobile Application - HTTP/HTML protocol (and the Mobile Application - HTTP/HTML protocol removed from VuGen). The unified protocol includes support for parsing capture files generated by mobile devices. For details, see Web - HTTP/HTML - Recording Methods for Mobile Applications in the LoadRunner Help Center. Web Services:

Support selection of a certificate file for web services. For details, see Security Tokens and Encryption in the LoadRunner Help Center. Improved support for CDATA sections. For details, see How to Add Content in the LoadRunner Help Center. New web_service_set_option API for controlling different web service call options. For details, see the Function Reference.

Controller Enhancements New cloud provider – DigitalOcean. You can now provision load generators with Amazon EC2, Microsoft Azure, Google Compute Engine, and DigitalOcean. For details, see Custom Cloud Images for LoadRunner 12.53 in the HPLN LoadRunner File Repository. Compatibility check for script version to load generator version. For details, see How to Run a Scenario in the LoadRunner Help Center.

Analysis Enhancements Improved Analysis user interface, including new look for the HTML report. Analysis Summary report includes breakdown per location, enabling you to analyze and compare the transaction behavior between different virtual locations. For details, see Summary Report Overview in the LoadRunner Help Center.

Virtual Table Server (VTS) Enhancements Improved VTS server security, using CLI tool. For details, see the VTS Help.

7/22/2016 10:39 AM

LoadRunner Readme

6 of 21

file:///D:/HPSoftware/LR_PC_SIS/PC/PC.12.53/Docs/LR_12.53_Readm...

Security Enhancements A new certificate manager tool enabling improved handling of CA and SSL certificates. For details, see How To Configure Client-Server Authentication in the LoadRunner Help Center.

Installation Enhancements Installation process now performs a compatibility check for required Windows updates. For details, see Windows Updates.

Help Center Enhancements Standalone TruClient and VuGen Help Centers available online. Improved user experience for the Help Centers – LoadRunner Help Center. Improved switch between online and local Help Centers.

Integrations with latest HPE product versions Integration with recent versions of the following products: Mobile Center: Additional configuration options for TruClient – Native Mobile scripts. For details, select the relevant version in the Mobile Center Help and see the Performance Testing section. Service Virtualization: Support for Windows 10 Diagnostics SiteScope Network Virtualization Unified Functional Testing (UFT) Application Lifecycle Management (ALM) Performance Center Business Process Monitor (BPM) Jenkins plugin:

HP Application and Automation Tools integration with Jenkins version 4.01. Jenkins SLA and report improvements. For details, see the Jenkins Wiki page.

For more details about the supported integrations for LoadRunner, see the Integration Support Matrices. For details about the supported versions, see the Product Availability Matrix.

Installation and Configuration Information Permission Requirements

7/22/2016 10:39 AM

LoadRunner Readme

7 of 21

file:///D:/HPSoftware/LR_PC_SIS/PC/PC.12.53/Docs/LR_12.53_Readm...

The Installation process, for all components, requires a full administrator account (root account for Linux systems) for all operating systems. After installation, all of the LoadRunner applications and components can run under a standard user account (an administrator account is not required), with UAC and DEP enabled. See Notes and Limitations , below, for additional restrictions.

Language Packs To install a language pack, at the completion of the LoadRunner installation, run the language pack setup from the LoadRunner DVD lrunner/ folder.

System Requirements The following sections describe the system requirements: Windows Updates System Requirements for LoadRunner, or VuGen, Analysis, and TruClient Standalones System Requirements for Load Generators Running TruClient Vusers System Requirements for Load Generators and MI Listener on Windows machines System Requirements for Load Generators on Linux machines Supported Linux Distributions LoadRunner Component Coexistence Matrix

Windows Updates Before you install any LoadRunner components, either make sure that the full set of Windows updates has been installed, or install the Windows updates listed in the table below. Note: Before you install any of the Windows updates, disable UAC (User Account Control) and restart the computer. For details on how to disable UAC, refer to your Microsoft Windows documentation.

Windows Version

Required Updates

Windows 7 SP1 Windows 2008 R2 Update for Universal C Runtime in Windows (Also known as UCRT, also known as KB2999226. See https://support.microsoft.com/en-us/kb/2999226)

7/22/2016 10:39 AM

LoadRunner Readme

8 of 21

Windows Version

file:///D:/HPSoftware/LR_PC_SIS/PC/PC.12.53/Docs/LR_12.53_Readm...

Required Updates

Windows 8.1

March 2014 servicing stack update for Windows 8.1 and Windows Server 2012 R2

Windows 2012 R2 (See: https://support.microsoft.com/en-us/kb/2919442. Includes the KB2919442 update.) Windows 8.1 and Windows Server 2012 R2 update: April 2014 (See https://support.microsoft.com/en-us/kb/2919355. Includes the following updates: KB2932046, KB2937592, KB2938439, KB2934018, KB2959977, KB2919355) Update for Universal C Runtime in Windows (Also known as UCRT, also known as KB2999226. See https://support.microsoft.com/en-us/kb/2999226) Windows 10 No updates required

System Requirements for LoadRunner, or VuGen, Analysis, and TruClient Standalones The following table describes the system requirements for installing the full version of LoadRunner, VuGen standalone, Analysis standalone, and TruClient standalone. Memory and CPU requirements vary per protocol and system under test. Note: Windows 8.1 and Windows 2012 R2 can only be used in conjunction with Internet Explorer 11; earlier

versions cannot be installed. Requirement

Value

Processor speed

Dual-Core 2.2 GHZ or faster

Operating system (See Windows Updates above)

Windows Server 2008 R2 SP1 64-bit Windows Server 2012 R2 64-bit (recommended) Windows 7 SP1 64-bit Windows 8.1 64-bit (recommended) Windows 10 64-bit

Memory (RAM)

Recommended: 8 GB

Screen resolution

Minimum: 1366x768

7/22/2016 10:39 AM

LoadRunner Readme

9 of 21

file:///D:/HPSoftware/LR_PC_SIS/PC/PC.12.53/Docs/LR_12.53_Readm...

Browser LoadRunner, VuGen, Analysis: Microsoft IE (Internet Explorer) 10 or 11; Microsoft Edge TruClient: Microsoft IE 10, or 11

(It is recommended to keep the default IE settings) Available hard disk space

Minimum: 50 GB

System Requirements for Load Generators Running TruClient Vusers The following table describes the system requirements for load generator machines running TruClient Vusers. Requirement

Value

Processor speed

8 cores 2.2 GHz each or faster

Memory (RAM)

16 GB or higher

System Requirements for Load Generators and MI Listener on Windows machines The following table describes the system requirements for installing a load generator or MI Listener on a Windows machine. Memory and CPU requirements vary per protocol and system under test. Note: Windows 8.1 and Windows 2012 R2 can only be used in conjunction with Internet Explorer 11 — earlier versions cannot be installed.

Requirement

Value

Processor speed

Dual-Core 2.2 GHZ or faster

Operating system (See Windows Updates above)

Windows Server 2008 R2 SP1 64-bit (recommended especially for TruClient Vusers) Windows Server 2012 R2 64-bit (recommended) Windows 7 SP1 64-bit Windows 8.1 64-bit Windows 10 64-bit

Memory (RAM)

Recommended: 8 GB

Screen resolution

Minimum: 1366x768

Browser

Microsoft Internet Explorer 10, or 11; Microsoft Edge

Available hard disk space

Minimum: 40 GB

7/22/2016 10:39 AM

LoadRunner Readme

10 of 21

file:///D:/HPSoftware/LR_PC_SIS/PC/PC.12.53/Docs/LR_12.53_Readm...

System Requirements for Load Generators on Linux machines The following table lists the system requirements for installing a load generator on a Linux machine. Memory and CPU requirements vary per protocol and system under test. Requirement

Value

Processor speed

1.6 GHZ or faster

Memory (RAM)

Recommended: 4GB

Available hard disk space

Minimum: 500 MB

Supported Linux Distributions The following table lists the Linux distributions on which you can install a load generator on a Linux machine. Distribution

Version

Red Hat Enterprise Linux Red Hat Enterprise Linux 32-bit 6.5 Red Hat Enterprise Linux 64-bit 6.6, 7, 7.2 Oracle Enterprise Linux

Oracle Enterprise Linux 64-bit 6.5 UEK, 7

Ubuntu Server

Ubuntu Server Linux 64-bit 12.04 LTS, 14.04 LTS

SUSE SLES (Linux Server Enterprise)

64-bit version 12

hLinux (HPE Linux)

20160128 64-bit

Note: Load generators support all X Servers.

Prerequisite packages for 64-bit installations The following table lists the packages that must be installed on Linux machines before installing the 64-bit version of a load generator. See the sections below this table for more details about installing the packages. Prerequisites Distribution

How to check if it is installed

How to install

7/22/2016 10:39 AM

LoadRunner Readme

11 of 21

file:///D:/HPSoftware/LR_PC_SIS/PC/PC.12.53/Docs/LR_12.53_Readm...

Prerequisites Distribution

Red Hat family including Oracle Linux

glibc.i686 glib2.i686 keyutils-libs.i686

How to check if it is installed rpm -qa --qf '%{NAME}.% {ARCH}\n' | grep -E 'glibc\.(i686|i386)' rpm -qa --qf '%{NAME}.% {ARCH}\n' | grep -E 'glib2\.(i686|i386)' rpm -qa --qf '%{NAME}.% {ARCH}\n' | grep -E 'keyutils-libs\. (i686|i386)'

libstdc++.i686(Oralce Linux 6) libstdc++47.i686 (Amazon Linux)

How to install yum install yum install keyutilslibs.i686 Note: If your machine

already has glib 64-bit (such as OEL7), make sure to update it to the latest version to avoid conflicts before installing glib2 32- bit.

rpm -qa --qf '%{NAME}.% {ARCH}\n' | grep -E 'libstdc\+\+[0-9]* \.(i686|i386)'

ncurses-libs.i686 (required by SecurityConsole)

rpm -qa --qf '%{NAME}.% {ARCH}\n' | grep -E 'ncurses(-libs)?\. (i686|i386)'

libc6-i386

dpkg -l libc6-i386

libglib2.0-0

dpkg -l libglib2.0-0

lib32stdc++6

dpkg -l lib32stdc++6

libkeyutils1:i386

dpkg -l libkeyutils1:i386

Ubuntu Server apt-get install apt-get install libkeyutils1:i386

lib32ncurses5 (required by SecurityConsole)

7/22/2016 10:39 AM

LoadRunner Readme

12 of 21

file:///D:/HPSoftware/LR_PC_SIS/PC/PC.12.53/Docs/LR_12.53_Readm...

Prerequisites Distribution

SUSE Linux Enterprise Server (SLES) 64-bit

How to check if it is installed

lincurses5 32-bit glibc 32-bit libglib-2_0-0-32bit libstdc++6 32-bit keyutils-libs-32bit

How to install

rpm -qa --qf '%{NAME}.% {ARCH}\n' | grep -E 'ncurses[0-9]*-32bit'

zypper install libncurses5-32-bit

rpm -qa --qf '%{NAME}.% {ARCH}\n' | grep -E 'glibc-32bit'

zypper install libglib2_0-0-32bit

rpm -qa --qf '%{NAME}.% {ARCH}\n' | grep -E 'libglib-2_0-0-32bit'

zypper install glibc-32-bit

zypper install libstdc++6-32-bit zypper install libkeyutils1-32bit

rpm -qa --qf '%{NAME}.% {ARCH}\n' | grep -E 'libstdc\+\+6-32bit' rpm -qa --qf '%{NAME}.% {ARCH}\n' | grep -E 'keyutils-libs-32bit' hLinux (HPE Linux)

libc6-i386

dpkg -l libc6-i386 | grep 'ii

libglib2.0-0 lib32stdc++6 lib32ncurses5 libkeyutils1:i386

dpkg -l lib32stdc++6 | grep 'ii' dpkg -l lib32ncurses5 | grep 'ii' dpkg -l libkeyutils1:i386 | grep 'ii' dpkg -l libglib2.0-0:i386 | grep 'ii'

Try package manager: apt-get install If package is not available, download relevant deb package and its dependencies from official Debian repository. Install it using command: dpkg -i --forcearchitecture .deb (e.g. dpkg -i --force-architecture gcc-4.9base_4.9.2-10_i386.deb);

LoadRunner Component Coexistence Matrix The following table describes which LoadRunner products can coexist on the same machine:

7/22/2016 10:39 AM

LoadRunner Readme

13 of 21

file:///D:/HPSoftware/LR_PC_SIS/PC/PC.12.53/Docs/LR_12.53_Readm...

First Installation / LoadRunner Full

VuGen Standalone

Analysis Standalone

Load Generator

Monitor Over Firewall

MI Listener

TruClient Standalone

LR Full

--

No

No

No

No

No

No

VuGen Standalone

No

--

Yes

No

No

No

No

Analysis Standalone

No

Yes

--

No

No

No

Yes

Load Generator

No

No

No

--

No

No

No

Monitor over Firewall

No

No

No

No

--

No

No

MI Listener

No

No

No

No

No

--

No

TruClient Standalone

No

No

Yes

No

No

No

--

Second Installation

Additional Installation and Upgrade Information All of the standalone installations (for example, for the load generator) can be found on the DVD's Standalone Applications folder. All of the additional components (such as the Citrix Agent and so forth) can be found on the DVD's Additional Components folder. You can install LoadRunner 12.53 over an existing, earlier version of LoadRunner. If, however, you have a pre-11.00 version of LoadRunner, you must uninstall it before installing LoadRunner 12.53. If you install Network Virtualization as part of the LoadRunner installation, you may need to restart the machine after setup. If you have an older version of VTS, uninstall it and reinstall the latest version from the Additional Components folder on the DVD. Protocol SDK is now an extension to Visual Studio 2015, and no longer an extension to Visual Studio 2012. Consequently, all projects created with LoadRunner 12.50 and earlier must be upgraded. For details, see Protocol SDK in the LoadRunner Help Center. To replay ODBC Protocol scripts on Linux machines, unixODBC v.2.3.1 or higher is required. Virtual Environments: The architectures provided by virtualization vendors are rapidly evolving. LoadRunner is expected to function as designed in these changing environments, as long as the third-party vendor guarantees full compatibility of the virtualized environment with the LoadRunner-approved hardware requirements. If you follow LoadRunner system requirements and support matrix to create the virtual machine, LoadRunner will work correctly. Working on top of a virtual machine may require access to the virtualization server hardware/monitoring

7/22/2016 10:39 AM

LoadRunner Readme

14 of 21

file:///D:/HPSoftware/LR_PC_SIS/PC/PC.12.53/Docs/LR_12.53_Readm...

environment, to ensure the virtualization server is not saturated; otherwise, this might obscure the virtual machines measurements and lead to false results.

Notes and Limitations This section includes pre-installation notes, issues, and workarounds for LoadRunner version 12.53. For additional limitations and workarounds, see the Troubleshooting and Limitations sections in the Help Centers. Installation Permissions VuGen and Protocols TruClient Controller and General Help and PDFs Non-English Operating Systems Integrations Deprecated Protocols and Features

Installation Windows

When you have multiple LoadRunner components installed on a machine for example, both VuGen and Analysis (standalone versions) and you uninstall one of the components—after the uninstall, you must run Repair on the remaining components. If you install a language pack after you have already generated an Analysis session, you will not be able to open the session file (.lra). You can only open it on a machine with the same regional settings as the machine upon which it was generated. You can, however, open the raw results, the .lrr file. If you have VuGen standalone and BPM installed together on a single machine, and you remove BPM, you should run a Repair installation on VuGen. Linux

When uninstalling a load generator on a Linux machine, the uninstall process may fail and the following message may appear: "Error: failed & because &: cannot restore segment port after reloc: permission denied." Workaround: Use the setenforce 0 command to disable SE Linux before uninstalling the load generator. When the uninstall is complete, use the setenforce 1 command to enable SE Linux. Coexistence with Unified Functional Testing (UFT)

If you install or uninstall LoadRunner on a machine where UFT is installed, at the end of the process a warning message is displayed: "Cannot load resource file /mdrv_res.e2 (/mdrv_res.j2)." Ignore this message. If you install LoadRunner and UFT on the same machine, and then uninstall one of them, the remaining software program may not function correctly.

7/22/2016 10:39 AM

LoadRunner Readme

15 of 21

file:///D:/HPSoftware/LR_PC_SIS/PC/PC.12.53/Docs/LR_12.53_Readm...

Workaround: Run a Repair of the software program you want to use on the machine.

A machine with LoadRunner and UFT, in which UFT was installed after LoadRunner, may not allow the recording of certain protocols, such as Ajax Click & Script. Workaround: Uninstall UFT and run a Repair on the LoadRunner installation. If you install UFT on a load generator machine when the load generator agent is running, the remote Controller may not be able to run UFT scripts on the load generator machine. Workaround: After installing UFT, restart the load generator agent using the Agent Configuration utility, or alternatively reboot the machine.

Permissions The TruClient browser for Internet Explorer requires Read access to the HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Internet Explorer registry key and Write access to the HKEY_CURRENT_USER\SOFTWARE\Hewlett-Packard\TruClient registry key. Issue: When running the LoadRunner License utility with UAC enabled, LoadRunner prompts you for administrator credentials. Resolution: Run the utility as administrator. Issue: When recording and replaying TruClient - Web scripts (and recording Web protocol scripts) on a

Window Server operating system, it is recommended to turn off Internet Explorer Enhanced Security Configuration (IE ESC). Resolution: In Windows 2012 R2: Server Manager > Local Server > Internet Explorer Enhanced Security Configuration. In Windows 2008 R2: Server Manager > Security Information > Configure IE ESC. Issue: When using the Visual Studio and add-ins to create C# and VB .NET scripts: Visual Studio creates

.NET assemblies that need to be registered in the system before their run. Registration of the .NET assembly requires administrative permissions. Resolution: Enable UAC and register the .NET assembly before running the test using one of these methods: Run Visual Studio "As Administrator" and provide administrative credentials when prompted. In Project Settings, ensure that the Register for COM interop option is set (Project > Properties > Build > Register for COM interop). Visual Studio will automatically register the test DLL as a .NET assembly every time it builds the project. Run Visual Studio without administrative permissions, and manually register the test DLL after it is built. To do so, run Windows Console with administrative permissions and run the following command: %WINDIR%\Microsoft.NET\Framework\v4.0.30319\RegAsm.exe /codebase

(ignore the warning issued when you run this command). For example, you might replace with c:\users\qatest\documents\visual studio 2015\Projects\LoadRunnerUser1\LoadRunnerUser1\LoadRunnerUser1.dll. You do not need to register the DLL after every build. It is enough to register it once after making changes in the COM interfaces defined in the DLL. Issue: The IP Wizard does not function for a Limited user. Resolution: Run the IP Wizard with administrator permissions. The IP Wizard uses raw sockets to

communicate with remote machines. Therefore, administrative privileges are required for opening and using raw sockets in socket-based communication. For more information, see http://msdn.microsoft.com/en-us /library/windows/desktop/ms740548%28v=vs.85%29.aspx. Alternatively, you can set the IP Wizard settings locally on the target machine. Issue: When recording a Web-based protocol script, the recording may fail in certain installations, if Data

Execution Prevention (DEP) is enabled.

7/22/2016 10:39 AM

LoadRunner Readme

16 of 21

file:///D:/HPSoftware/LR_PC_SIS/PC/PC.12.53/Docs/LR_12.53_Readm...

Resolution: Disable DEP on your VuGen machine. For details, see How to Record a Vuser Script in the

User Guide. Issue: The network settings for load generators on Linux machines cannot be configured by a standard (non-administrator) user account. Resolution: When working on a Linux operating system, run lr_agent_settings with administrator permissions.

VuGen and Protocols Issue: When you run a Java script, the replay status may be Script Not Run and some errors may appear in the mdrv.log file. However, due to Java internal architecture, these errors may not be included in the VuGen Output and Errors panes. This occurs when VuGen fails to initialize a Java Vuser, and JVM then terminates the replay process. Workaround: Look for errors directly in the mdrv.log file (you can find this in the script’s folder). If the entry

in the log is due to a memory-related issue, try using different memory options for Java in the runtime settings. Issue: When recording mstsc.exe on Windows 10, if the RDP server side enables FIPS, the default

recording will produce the following error: "Because of an error in data encryption, this session will end. Please try connecting to the remote computer again." Workaround: Either turn off FIPS on the server side, or perform the following procedure to enable recording using the SSL mode:

a. Open mstsc, enter the IP address of the RDP server, click Show Options to expand the dialog box, and then click Save As to save the configuration to a file. Name the file RDPConfig.RDP. b. Open RDPConfig.RDP with Notepad, add enablecredsspsupport:i:0 at the bottom. Search for authentication level in the same file, make sure this line is authentication level:i:2. c. Go to LoadRunner's dat folder, open rdp_ro.ini with Wordpad or Notepad++ (do not use Notepad because of the new line characters issue), add SupportSSL=1 at the bottom. d. In VuGen, click Start Recording. In the Remote Desktop Connection dialog box, click Show Options. Click Open, and choose the RDPConfig.RDP file that you saved above. Then click Connect. Issue: When recording a script, some applications may be unable to connect to a server using SSL. Errors such as "Invalid certificate" and "SSL Handshake Failed" may appear. This is because VuGen now uses SHA-256-signed certificates for recording of SSL-encrypted communication instead of the older SHA-1signed certificates. Workaround:

Instruct VuGen to use SHA-1-signed certificates, as follows: a. Add the following lines to \config\vugen.ini: [WebRecorder] ProxyCertificateHash=sha1 b. Delete the following files from \bin\certs\: wplusCA_Expiration_2022.crt wplusCAOnly_Expiration_2022.crt

7/22/2016 10:39 AM

LoadRunner Readme

17 of 21

file:///D:/HPSoftware/LR_PC_SIS/PC/PC.12.53/Docs/LR_12.53_Readm...

wplusCert_Expiration_2022.crt c. Restart VuGen and record the application again. In order for LoadRunner to work correctly with SAPGUI 7.40, patch gui740_05_1-10013011 (or later) must be applied to the SAPGUI installation. 64-bit replay for C Vuser scripts is not supported on Linux-based load generators. Java-based technologies are not yet supported by Microsoft Edge browser. Therefore, we do not recommend selecting this browser emulation for the replay of Java-based protocols (Flex, Java over HTTP, Oracle NCA). If you encounter issues with connecting to HPLN for the HPLN integration, you can try the following link: https://softwaresupport.hpe.com/group/softwaresupport/search-result/-/facetsearch/document/KM02133819 When running a LoadRunner component on a Windows 10 machine, using Microsoft Edge as the default browser, some links within the component may not work if UAC is disabled. Network Virtualization is not supported for scripts using HTTP/2 protocol. Web Page Diagnostics are not supported for scripts using HTTP/2 protocol. Disable Web Page Diagnostics in Controller > Diagnostics > Configuration > Diagnostics Distribution dialog box. Uploading a buffer (request body) larger than 64 KB is not supported for scripts using HTTP/2 protocol. Debugging features such as step-by-step replay and breakpoints, and debugging in Eclipse, are not enabled in Java-based protocols with Java 8. When you use VuGen to create a scenario, if the Controller is open [and was opened by double-clicking on a .lrs scenario file], you will not be given the option to add the script to the current scenario, and the Controller will be closed, losing any unsaved changes. When you correlate a value from a snapshot, VuGen may create a boundary-based correlation, even though the recording correlation option is set to use regular expressions. If you open an HPE site in the embedded browser and the site is not included in the trusted sites list, you will be prompted to add the site to the trusted site list. After adding the site, you may receive a Web site scripting error. Close the error and continue working as you normally would. Runtime errors generated during the replay of VBScript scripts, may not be handled properly. It is recommended that you port existing VBScript scripts to C. Possible Workaround: Enable the Continue on Error option in the Runtime setting. When adding a conditional breakpoint based on a parameter value, the value is not updated immediately. Therefore, in the script step that follows, the condition may be ignored even though the argument value has been updated.

TruClient TruClient is not supported for Chromium on 32-bit operating systems. If you added custom configurations to the pref.js or user.js files for TruClient scripts recorded with LoadRunner 11.52, you will need to re-add them to the LoadRunner 12.xx script files. Tip: it is recommended that you back up existing files before you begin editing scripts with custom configurations in LoadRunner 12.xx. Execution time of TruClient scripts replayed with Chromium will appear slower than those replayed on TruClient Firefox/Internet Explorer. This is a result of the TruClient instrumentation on the Chromium

7/22/2016 10:39 AM

LoadRunner Readme

18 of 21

file:///D:/HPSoftware/LR_PC_SIS/PC/PC.12.53/Docs/LR_12.53_Readm...

browser. This will primarily impact the throughput generated by the Vusers. Tip: Run additional TruClient Vusers on more load generator machines than you would with TruClient Firefox/Internet Explorer. TruClient script conversion to Web - HTTP/HTML is not supported for converting to a JavaScript language script. The new Generic API Action step is not supported for Chromium. Use Evaluate JavaScript instead.

Controller and General When using a Unified Functional Testing (UFT) script in the Controller, the runtime settings cannot be opened for editing. The Controller may stop functioning if you try to access the runtime settings. Workaround: See this Knowledge Base article: KM02290342 When using the SiteScope monitor, you cannot change the counters already saved with scenario. Workaround: Remove all existing SiteScope counters, close the dialog box and re-add them. When you stop a named VTS instance, the instance may continue to run until you restart the VTS Windows service, which will block you from creating an instance with the same name or port. Workaround: Restart the VTSService Windows service. For example, use the “net stop vtsservice” to stop the service, and “net start vtsservice” to restart it. The XSS and Remedy DFEs are supported only on Windows load generators. Webtrace is not supported with -proto tcp" and "-proto udp in the following Linux environments: RHEL 7, OEL 7, and Ubuntu 14.04.

Help and PDFs For LoadRunner installed on a Windows Server operating system, Internet Explorer Enhanced Security Configuration must be disabled in order to view Help Center content. It is enabled by default (Control Panel > Administrative tools > Server manager > Configure IE ESC). In certain machines with high level security settings, you need to trust the domain (lrhelp.saas.hpe.com, vugenhelp.saas.hpe.com, tchelp.saas.hpe.com) in order to view the Help Center. To do this, open the Help Center in Internet Explorer, and accept the site as a trusted domain. Then you will be able to use the context sensitive and menu help from the product. On Windows 8.1 and higher, disabling UAC may block Acrobat Reader from opening PDF files. Follow the Windows Help instructions to enable UAC and trust Acrobat.

Non-English Operating Systems For script recording with Web – HTTP/HTML protocol: If you are using an operating system with one of these languages—ru/ptbr/kor/ita—then recording a .pcap file with SSL recording is not supported. On non-English operating systems, several components may contain untranslated items, such as the Print Preview page in VuGen, log files, and installation screens. LoadRunner cannot record a Vuser script for certain protocols if the LoadRunner installation is on a Chinese operating system, and the installation path contains Chinese characters. Path names cannot be in multi-byte format. If you need to use non-English symbols in paths to scripts, scenarios, results, or analysis sessions, make sure to select the appropriate locale in the your machine's Region and Language settings. Script names, however, must be in English.

Integrations 7/22/2016 10:39 AM

LoadRunner Readme

19 of 21

file:///D:/HPSoftware/LR_PC_SIS/PC/PC.12.53/Docs/LR_12.53_Readm...

HPE Service Virtualization: A Service Virtualization project cannot be correctly imported to a scenario, if the Service Virtualization server uses credentials for both SSL and monitors. Workaround: Configure the Service Virtualization server to use credentials only for SSL.

Deprecated Protocols and Features This section provides information about protocols and features whose support was discontinued, or will be discontinued in future versions of LoadRunner and Performance Center. Note: In version 12.53, Mobile Application - HTTP/HTML protocol was unified with the Web - HTTP/HTML protocol. All functionality for generating Vuser scripts for mobile applications is now provided with the Web HTTP/HTML protocol. For details, see Web - HTTP/HTML - Recording Methods for Mobile Applications in the LoadRunner Help Center.

The following protocols are still supported in version 12.53, but support will be discontinued in upcoming versions of LoadRunner and Performance Center: Ajax Click & Script Silverlight COM/DCOM We recommend that you do not use these protocols for new scripts. You can migrate your existing Ajax Click & Script scripts to another Web protocol such as TruClient - Web or Web - HTTP/HTML. For the following protocols: Replay is available. Creation of new scripts and recording are no longer available. These protocols will be completely removed in future versions. Removed from version 12.53:

SAP (Click & Script) MMS (Media Player) MMS (Multimedia messaging service) Removed from version 12.00:

EJB (Enterprise Java Beans) PeopleSoft -Tuxedo PeopleSoft Enterprise Tuxedo VBScript Vuser JavaScript Vuser Web - Click and Script

7/22/2016 10:39 AM

LoadRunner Readme

20 of 21

file:///D:/HPSoftware/LR_PC_SIS/PC/PC.12.53/Docs/LR_12.53_Readm...

Removed from version 11.50:

SQL Server WAP Real Removed from version 11.00:

Siebel - DB2 CLI i-mode Sybase Dblib Sybase Ctlib Informix Completely removed from version 11.50 (no record or replay):

VB Vuser Features removed from LoadRunner 12.53:

VuGen Protocol Advisor VuGen Test Results report and the corresponding Generate report during script execution option. ----------------------------------------------------------------------------------------------------------------------------

Additional Resources The HPE Usage Hub allows you to view license information and usage of all HPE Software products and solutions that are installed in your environment. The Usage Hub is a central server that runs in the background. It collects, maintains, and provides a centralized view of software deployments, license assets, and the product features. In addition, follow these links to learn more about LoadRunner and other HPE products. HPE Software Support Online HPE Live Network (HPLN) LoadRunner Support Forum LoadRunner Blog LoadRunner Community Forums LoadRunner Knowledge Base LoadRunner on Facebook LoadRunner on LinkedIn

Legal Notices Warranty The only warranties for Hewlett Packard Enterprise Development LP products and services are set forth in the express warranty

7/22/2016 10:39 AM

LoadRunner Readme

21 of 21

file:///D:/HPSoftware/LR_PC_SIS/PC/PC.12.53/Docs/LR_12.53_Readm...

statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HPE shall not be liable for technical or editorial errors or omissions contained herein. The information contained herein is subject to change without notice. Restricted Rights Legend Confidential computer software. Valid license from HPE required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. Copyright Notice © Copyright 1993-2016 Hewlett Packard Enterprise Development LP Trademark Notices Adobe® is a trademark of Adobe Systems Incorporated. Microsoft® and Windows® are U.S. registered trademarks of Microsoft Corporation. Oracle and Java are registered trademarks of Oracle and/or its affiliates. UNIX® is a registered trademark of The Open Group.

Send documentation feedback

7/22/2016 10:39 AM