Manage licenses

To run tests from LoadRunner Enterprise, you must install the appropriate LoadRunner Enterprise server and host licenses. Use the Licenses page in LoadRunner Enterprise Administration to view the details of licenses that are currently installed and to install additional licenses.

License bundles

There are several types of license bundles available.

The Community license is free of charge, and is automatically installed with your LoadRunner Enterprise installation during setup. The bundle includes:

1 Controller allowing 1 concurrent run
Free use of Network Virtualization (except for the Global Library feature)
Mobile UI (unlimited Vusers)
50 permanent Vusers, valid for all protocols except for GUI (UFT), COM/DCOM, and template protocols.

Other bundles allow you to run additional Vusers on selected protocols. For more information on available bundles, see the License Bundles documentation.

To obtain and install additional licenses, see Set LoadRunner Enterprise license keys.

Note:

The community license bundle does not include support.
After installing LoadRunner Enterprise 2020, you will have a Community license only. If you are upgrading your LAB project, your previous licenses will be removed and you will need to upload new licenses.

License types

To work with LoadRunner Enterprise, each of the following licenses must be defined:

License	Description
LoadRunner Enterprise	The LoadRunner Enterprise license is limited by the total number of concurrent runs or Vusers, and may have an expiration date.
VUDS	A Virtual User Day (VUD) license provides you with a specified number of Vusers (VUDs) that you can run an unlimited number of times within a 24 hour period (the Virtual User Day). At the end of a Virtual User Day, the remaining number of licensed VUDs is calculated by subtracting the number of used VUDs, or in the case of concurrent usage, the maximum number of concurrent running VUDs, from the total number of licensed VUDs. VUD licenses are considered Term Licenses valid for 24 hours after the first execution. VUDS also expire one (1) year after the date of purchase if not consumed. Support is not provided for VUDs, meaning that there are no version updates, and no rehosting of the licenses. Example of VUD license usage: A user has a license that allows him to run 1,000 VUDs. He creates a performance test that requires 200 Vusers and runs for 45 minutes. He runs the test at 8:00 am, 10:00 am, 2:00 pm, and at 4:00 pm. In each case, the test finishes before the next one begins. Because there is no concurrent Vuser usage, he can re-use the same 200 VUDs for each test run, meaning that at the end of the 24-hour period, only 200 VUDs are deducted from the license, leaving 800 for future use. However, if the user starts the second run at 8:30 am, the first test is still running before the second test initializes. This overlap requires 400 Vusers to run concurrently (200 for each test). At the end of the day, 400 VUDs are deducted from the license, because that is the highest number of concurrent Vusers. The total left for future use is 600 VUDs.
Host	The Host license defines the limits of Vuser use per protocol on the host. There are two host license Vuser types: <bundle type> Bundle. Each bundle contains a collection of protocols. When you select a protocol bundle, this section displays a list of included protocols. Global. The global license lets you run all Vuser types, provided you stay within the total limit. The number following "Global" indicates the total number of Vusers purchased.

License

Description

LoadRunner Enterprise

The LoadRunner Enterprise license is limited by the total number of concurrent runs or Vusers, and may have an expiration date.

VUDS

A Virtual User Day (VUD) license provides you with a specified number of Vusers (VUDs) that you can run an unlimited number of times within a 24 hour period (the Virtual User Day). At the end of a Virtual User Day, the remaining number of licensed VUDs is calculated by subtracting the number of used VUDs, or in the case of concurrent usage, the maximum number of concurrent running VUDs, from the total number of licensed VUDs.

VUD licenses are considered Term Licenses valid for 24 hours after the first execution. VUDS also expire one (1) year after the date of purchase if not consumed. Support is not provided for VUDs, meaning that there are no version updates, and no rehosting of the licenses.

Example of VUD license usage: A user has a license that allows him to run 1,000 VUDs. He creates a performance test that requires 200 Vusers and runs for 45 minutes. He runs the test at 8:00 am, 10:00 am, 2:00 pm, and at 4:00 pm. In each case, the test finishes before the next one begins. Because there is no concurrent Vuser usage, he can re-use the same 200 VUDs for each test run, meaning that at the end of the 24-hour period, only 200 VUDs are deducted from the license, leaving 800 for future use.

However, if the user starts the second run at 8:30 am, the first test is still running before the second test initializes. This overlap requires 400 Vusers to run concurrently (200 for each test). At the end of the day, 400 VUDs are deducted from the license, because that is the highest number of concurrent Vusers. The total left for future use is 600 VUDs.

Host

The Host license defines the limits of Vuser use per protocol on the host. There are two host license Vuser types:

<bundle type> Bundle. Each bundle contains a collection of protocols. When you select a protocol bundle, this section displays a list of included protocols.

Global. The global license lets you run all Vuser types, provided you stay within the total limit. The number following "Global" indicates the total number of Vusers purchased.

Note:

The LoadRunner Enterprise and Host licenses are configured directly after installation of the LoadRunner Enterprise server. For details, see View the Licenses page below.
You can run VUDs on Micro Focus developed protocols, with the exception of: COM/DCOM, VB Com, VB Vuser, VB Script Vuser, VB.NET Vuser, and VB.NET Template.
You cannot run VUDs on SDK protocols.
You cannot run VUDs on a GUI Vuser script, such as UFT Professional scripts.
When using a VUD based LoadRunner Enterprise license, a Host license is not relevant.

Set LoadRunner Enterprise license keys

This section describes how to set LoadRunner Enterprise license keys.

Obtain your license keys.

When upgrading to version 2020 or 2020 SP1, you need to replace your current license to work with the upgraded LoadRunner Enterprise installation.

To obtain a LoadRunner Enterprise license:
- If you have a valid order number or subscription name (SAID), go to Software Licenses and Downloads Portal to get software downloads and license keys for LoadRunner Enterprise 2020 or 2020 SP1.
- If you are an existing customer, click the Update link available on the portal to get new license key(s) required for version 2020 or 2020 SP1.
For more information, see the instructions provided in the portal's Contact Us / Self Help page, or click Contact Licensing Delivery Center to request assistance if required.

Tip: Use the Micro Focus Usage Hub tool to track license usage across your network.
Activate your license keys.

Select your account in the Software Licenses and Downloads Portal, and follow the on screen instructions to activate your licenses.

Note: If you are using the community license bundle installed with LoadRunner Enterprise, license activation is not required.
Set your license keys.

You can set the licenses from the following areas:
1. In LoadRunner Enterprise Administration, select Configuration > Licenses. The Licenses page opens. For details, see View the Licenses page.
2. Click Add License and select one of the following options:
  - Load License. Adds a single license key.
  - Load from File. Adds multiple license keys simultaneously.

View license status on LoadRunner Enterprise hosts

When you add a new host license, the process that sets the new license on all of the hosts runs asynchronously as a separate background process. This means that the Add License operation completes immediately and successfully, even if there are failures setting the new license on some of the hosts.

If there is no event log entry, it means that the operation has not yet been performed on that machine.

View the Licenses page

In LoadRunner Enterprise Administration, select Configuration > Licenses.

User interface elements are described below:

UI Elements	Description
LoadRunner Enterprise	Displays details for all valid LoadRunner Enterprise licenses. Total Vusers. Total Vusers of all licenses. Total Concurrent Runs. The total number of test runs that can run simultaneously. For details, see Manage licenses.
VUDs	Displays details for all VUD-based licenses. Total Purchased VUDs. Total number of purchased VUDs. Total Remaining. Total number of remaining VUDs. Unassigned to Projects. Total number of unassigned VUDs.
Host	Displays protocol bundles and capacity details for all valid host licenses.
	Add License. Enables you to add a license (provided you have the required permissions). Load License. Enables you to type a new license key. You can add a single license key at a time. Load from File. Enables you to install multiple license keys simultaneously from a file.
	Show/Hide Expired. Click to display all licenses or to hide expired licenses.
	License Details. Displays the license type, license key, and the date the license was added to the system. To export this information to Excel, see Manage licenses.
LoadRunner Enterprise Licenses	Expiration Date. The expiration date of the license. Vusers. The number of Vusers. Concurrent Runs. The maximum number of test runs that can run simultaneously. Click to display the license details. Date Assigned. The date the license was added to the system. Valid From. The date from which the license is valid. License Key. The license key.
Host Licenses	[filter]. Click the drop-down arrow to select a license bundle. Expiration Date. The expiration date and time of the license License Bundle. Indicates the name of the Vuser protocol bundle to which the license applies. The license enables the Controller to run Vusers of any protocol that is included in the protocol bundle. Capacity. Indicates the limit for running Vusers on LoadRunner Controller applicable for this license. Click to display the license details. Date Assigned. The date the license was added to the system. Valid From. The date from which the license is valid. License Key. The license key.