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

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

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 and the Tenant ID (if the server supports tenants).

    If the server address URL includes the tenant ID (for example: http://myserver.mycomp.net/?tenant=fa123a56-789-123b-4abc-5f67bb89abc), then the ID is automatically moved to the Tenant field.

    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):

    HTTPS_PROXY:

    http://<my-proxy>:[port]/

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

    HTTP_PROXY:

    http://<my-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. 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.

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.

    Tip: You can use the Refresh folders refresh button to update the folder structure.

    The scripts contained in the selected folder are displayed in the script table.

    UI element Description
    Upload scripts Enables you to upload your open scripts to LRE. For details, see Upload scripts to LRE.
    Download scripts

    Enables you to download scripts from LRE to VuGen. For details, see Download scripts from LRE.

    Open scripts Enables you to open the scripts currently selected in the table.

    File name [zip]

    Lists the scripts in the selected LRE folder. These are the names of the zip files containing the scripts (which may differ from the actual script name).
    Created by Displays the login name of the user that created the zip file.
    Script type

    Displays the protocol or tool used for the scripts, for example, Web -HTTP/HTML.

    File modified Displays the date and time of the last update to the file contents.
    Content Indicates whether the zip file content includes all files for the script, or only the runtime files required by LRE to run the script.
    Lock status Displays a lock icon if the file is locked by another user. If a script is locked, you can open it in read-only mode only, to avoid conflicts.

    Tip: Use the Refresh list refresh button to update changes to the scripts.

  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

    Note: If the script is locked for editing, VuGen will state at the top of the Editor that the script is in read-only mode. When the script is released, close and reopen it to edit it.

  4. Edit the scripts in VuGen.

    Note:

    • 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.

    Note: You cannot upload a script if it is currently locked by another user.

  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: