LoadRunner Enterprise Software Version: 2020 Installation Guide Go to HELP CENTER ONLINE http://admhelp.microfocus.com/pc/ Document Release Date: December 31, 2019 | Software Release Date: December 2019 Installation Guide Legal Notices Disclaimer Certain versions of software and/or documents (“Material”) accessible here may contain branding from Hewlett-Packard Company (now HP Inc.) and Hewlett Packard Enterprise Company. As of September 1, 2017, the Material is now offered by Micro Focus, a separately owned and operated company. Any reference to the HP and Hewlett Packard Enterprise/HPE marks is historical in nature, and the HP and Hewlett Packard Enterprise/HPE marks are the property of their respective owners. Warranty The only warranties for products and services of Micro Focus and its affiliates and licensors (“Micro Focus”) are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. Micro Focus 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 Contains Confidential Information. Except as specifically indicated otherwise, a valid license is 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 2001 - 2019 Micro Focus or one of its affiliates. LoadRunner Enterprise (2020) Page 2 of 147 Installation Guide Contents LoadRunner Enterprise 1 Part 1: Installation overview 7 Chapter 1: Before you install 8 LoadRunner Enterprise components and data flow 9 Architecture and components 9 Applications 11 Communication paths 12 Coexistence of installed components 15 Load considerations 15 Clustered configuration 17 System component considerations 19 Windows system locale considerations 22 Required services 22 LoadRunner Enterprise prerequisite software 23 Pre-installation prerequisites and considerations 27 Database prerequisites 28 Prerequisites: Oracle Database servers 29 Prerequisites: Microsoft - SQL Database servers 30 Installation package details 31 Part 2: Pre-installation project migration steps 32 Chapter 2: Project migration pre-installation activities 33 Pre-installation project migration considerations 33 Upgrade existing projects to ALM 12.6x 33 Back up projects in existing ALM installation 34 Overview of migration process 35 Part 3: Installation and configuration 36 Chapter 3: Install LoadRunner Enterprise 37 Installation flow 38 Install and configure LoadRunner Enterprise servers and hosts 39 Configure LoadRunner Enterprise 52 Configure LoadRunner Enterprise using the Configuration Wizard 52 Log on to LoadRunner Enterprise Administration 53 Perform site and lab administration tasks 53 Install LoadRunner Enterprise silently 55 Prerequisite software for silent installation 55 LoadRunner Enterprise (2020) Page 3 of 147 Installation Guide Customize silent installation 56 Silently install LoadRunner Enterprise server and hosts 58 Install standalone components (Windows) 61 Available standalone components for Windows 61 Install standalone components 62 Silently install standalone applications 63 Install Load Generator on Linux 65 Deploy dockerized load generators on Linux 65 Prerequisites 65 Run a dockerized load generator using the predefined image 65 Run a dockerized load generator using a custom image 66 After running the load generator containers 68 Build a custom Dockerfile image 68 Tips and guidelines 69 Deploy dockerized load generators or Controllers on Windows 70 Prerequisites 70 Run a dockerized load generator or Controller using the predefined image 71 Run a dockerized load generator using a custom image 71 Examples of customized content for Dockerfiles 73 After running the load generator containers 73 Tips and guidelines 74 Install additional components 74 Deploy LoadRunner Enterprise on AWS 75 Uninstall LoadRunner Enterprise server and hosts 76 Uninstall Load Generator from Linux 77 Chapter 4: Post installation verification 78 Chapter 5: LoadRunner Enterprise configuration options 80 Configure IIS on LoadRunner Enterprise machines to use SSL 81 Before you configure IIS 81 Configure the LoadRunner Enterprise server backend behind IIS reverse proxy 81 Configuring IIS to work over SSL 83 Configure LoadRunner Enterprise to support SSL 83 Configure secure communication with LoadRunner components using TLS (SSL) 92 Working with the LoadRunner Enterprise agent 92 Run the LoadRunner Enterprise agent as a process 92 Run the LoadRunner Enterprise agent as a service 92 Configure the agent on load generator machines 93 Map network drives when running the agent as service 93 LoadRunner Remote Management Agent 93 Recommended configuration for Linux load generators 94 Recommended change to the TEMP folder used by the load generator 94 Enable downloading standalone applications 95 LoadRunner Enterprise (2020) Page 4 of 147 Installation Guide Customize the Download Applications window 95 Enable MS-SQL Windows authentication 96 Configure SSL for load generators 96 Create and copy digital certificates 96 Enable SSL communication for load generators in LoadRunner Enterprise Administration 99 Part 4: Working with firewalls 100 Chapter 6: Using firewalls 101 About using firewalls in LoadRunner Enterprise 102 Example of over firewall deployment 104 Set up the system to use firewalls: basic steps 104 Install over firewall components 106 Initial configuration of the over firewall system 107 Set up your deployment (TCP or HTTPS) 107 Configure the firewall to allow agent access 109 TCP configuration 109 HTTPS configuration 109 Local System account configuration 109 Configure the MI Listener 109 Specify MI Listeners 110 Chapter 7: Run Vusers over a firewall 112 Run Vusers over a firewall: basic steps 113 Configure hosts to run Vusers over a firewall 114 Chapter 8: Monitor over a firewall 117 Monitor over a firewall: basic steps 118 Configure monitor settings 119 Clone a monitored server's properties 121 Add and remove measurements 121 Configure measurement frequency 122 Configure the project to receive monitor over firewall information 122 Edit monitor over firewall machines during a test run 123 Chapter 9: Configure the LoadRunner Enterprise agent 124 Configure LoadRunner Enterprise agents over the firewall: basic steps 125 Configure the Windows LoadRunner Enterprise agent 125 Configure and run the Linux LoadRunner Enterprise agent 126 Agent configuration settings 127 Check connectivity 129 Part 5: Troubleshooting 132 Chapter 10: Troubleshooting installation issues 133 Unable to load Windows 8 Explorer shell after installing LoadRunner Enterprise host 134 LoadRunner Enterprise (2020) Page 5 of 147 Installation Guide Host silent installation stops after installing .NET Framework 4.8 134 Working with LoadRunner Enterprise when Windows Firewall is enabled 134 LoadRunner Enterprise uninstall fails or freezes 136 Cannot log in to LoadRunner Enterprise via the client machine: JavaScript Error 136 Initializing Run page does not load when starting a test run 137 Unable to run the LoadRunner Enterprise component installation from a network drive 137 Unable to install LoadRunner Enterprise components from the installation directory 138 Unable to install a LoadRunner Enterprise component if the default port is in use 139 Unable to use non-default ports in Microsoft SQL 141 No error message when a test fails to start 142 Unable to display online topology monitors 142 Unable to configure LoadRunner Enterprise server or host when the process is used by another process 143 LoadRunner Enterprise configuration host fails to start the 'LoadRunner Center Data Service' 143 Configure LoadRunner Enterprise to work with secure cookies over a secure connection 143 Unable to log on to the database server 144 Incorrect time range displayed in online graph 145 Unable to install Network Virtualization (NV) components 145 Send Us Feedback 146 LoadRunner Enterprise (2020) Page 6 of 147 Part 1: Installation overview LoadRunner Enterprise (2020) Page 7 Chapter 1: Before you install This chapter provides information that will help you prepare for the LoadRunner Enterprise component installations. This chapter includes: • LoadRunner Enterprise components and data flow 9 • System component considerations 19 • Windows system locale considerations 22 • Required services 22 • LoadRunner Enterprise prerequisite software 23 • Pre-installation prerequisites and considerations 27 • Database prerequisites 28 • Installation package details 31 LoadRunner Enterprise (2020) Page 8 of 147 Installation Guide Chapter 1: Before you install LoadRunner Enterprise components and data flow This section describes the LoadRunner Enterprise system. This section includes: l "Architecture and components" below l "Applications " on page 11 l "Communication paths" on page 12 l "Coexistence of installed components" on page 15 l "Load considerations" on page 15 l "Clustered configuration" on page 17 Architecture and components This section describes the architecture and components of LoadRunner Enterprise. Architecture/Component Description Database server The database server stores three types of schemas: l Site Administration schema. Stores information related to the LoadRunner Enterprise system, such as domains, users, and site