Integration with LoadRunner Enterprise

LoadRunner Enterprise (LRE) uses scripts to emulate real user activities on your application. You can upload and download scripts from VuGen to LRE, and open and edit scripts that are in an LRE project.

For information about LRE, see the LoadRunner Enterprise Help Center.

Connect to LRE

When connecting to an LRE server, you select the relevant domain, project, and folder.

Available from version 2021 R1: SSO login is supported from version 2021 R1.

After connecting, VuGen stays connected to LRE until you disconnect or end the session. You can connect to only one LRE server and tenant at a time.

To connect to an LRE server:

  1. Select Integrations > LoadRunner Enterprise. The VuGen - LoadRunner Enterprise Integration window opens.
  2. On the Server account tab, enter the LoadRunner Enterprise server address. If the server supports tenants, include the tenant ID (shown in the URL), in the format: <server address>\<tenant ID>

    For example:

    Note: If the server has a default tenant, or only one tenant, then you do not need to include the tenant ID. The login will automatically connect to that tenant.

  3. Click Connect. VuGen attempts to connect to the LRE server. If successful, you continue with SSO login (if supported). If SSO is not supported, the Login and Password fields are enabled.
  4. Enter your Login and Password details, and click Authenticate.

    Note: If authentication failed behind a proxy, try defining the following environment variables on the VuGen machine (then restart VuGen):



    (For proxy with authentication: http://[user]:[pass]@[proxy_ip]:[proxy_port]/)



    (For proxy with authentication: http://[user]:[pass]@[proxy_ip]:[proxy_port]/)

  5. If login succeeds, the Domain and Project fields are enabled. Select the required Domain and Project from the dropdown lists.
  6. Available from Version 2021 R1: If you want to automatically reconnect to the LRE server when restarting VuGen, select the Restore connection on startup check box.
  7. Click Login. VuGen logs into the specified LRE project and displays the Script management tab, where you can select the relevant project folder.

Tip: When VuGen is connected to LRE, a shortcut icon is displayed in the VuGen status bar. Hover over the icon to view connection details. (Supported from version 2021 R1.)

Back to top

Edit LRE scripts inside VuGen

You can open scripts that are saved in an LRE project, and edit them with the VuGen script editor.

Tip: After opening an LRE script, it is included in the Recent Activity area on the Start Page, providing a shortcut to quickly reopen the script.

To edit LRE scripts:

  1. In the Scripts Management tab of the LRE integrations window, select the required project folder in the LoadRunner Enterprise folder field.

    The scripts contained in the selected folder are displayed in the script table. The table includes information on the script zip files, such as script type, and whether the zip file content included all files for the script, or only the runtime files. (The Date modified and Content columns are included from version 2021 R1.)

    Tip: Use the Refresh folders button to update the folder structure. Use the Refresh list button to update changes to the scripts (supported from version 2021 R1).

  2. In the script table, select the check boxes for the scripts you want to open.

  3. Click Open scripts. The VuGen - LoadRunner Enterprise Integration window closes, and the scripts are displayed in Solution Explorer, below the currently open scripts.
  4. Edit the scripts in VuGen.


    • A warning message is displayed if the connection to the LRE server is lost. In this case, you can save the script locally until the connection is restored.
    • You must close all open LRE scripts before you disconnect from the server.

Back to top

Upload scripts to LRE

You can upload script files from VuGen to the selected project on the LRE server.

You can upload only zipped files to LRE; VuGen automatically zips the files before uploading.

To upload scripts to LRE:

  1. Open the script or scripts you want to upload in Solution Explorer.
  2. Connect to the relevant project and folder on the LRE server. See Connect to LRE.
  3. Click Upload scripts. The Upload scripts from Solution Explorer dialog box is displayed, listing the scripts you have open.
  4. Select whether to upload All files for each script, or only the Runtime files required by LRE.
  5. Select the check boxes for the scripts you want to upload.
  6. By default, the zip file will be given the same name as the script. If the zip file name already exists in the target folder, this is indicated in red, and the Overwrite check box is enabled. You have two options:

    • If you want to overwrite the script file on the target, select the Overwrite check box for that script (or select Overwrite for all scripts).
    • Alternatively, change the default name in the File name (zip) column.
  7. Click Upload. The dialog box indicates whether the upload to LRE succeeded for each script.
  8. Click Close. The uploaded scripts are added to the list of scripts on the Script management tab.

Back to top

Download scripts from LRE

You can download script zip files from LRE to the VuGen machine.

To download scripts from LRE:

  1. Connect to the relevant project and folder on the LRE server. See Connect to LRE.
  2. In the script table, select the check boxes for the scripts you want to download.
  3. Click Download scripts. The Browse for Folder dialog box is displayed.
  4. Browse to the required folder and click OK. (If a file with the same name already exists, VuGen asks whether to overwrite the file.)

    The dialog box indicates if the download succeeded for each script.

Back to top

See also: