Share this page

# LoadRunner Enterprise and TeamCity

The TeamCity plugin enables you to run tests as part of your CI/CD process.

In this topic:

## Install and deploy the TeamCity plugin (Performance Center CI)

This task describes how to install and deploy the TeamCity plugin.

1. Verify that your TeamCity server is up and running. Refer to the product documentation for more details.

   For the supported server versions, see the Integrations section of the System Requirements guide.

2. Download the plugin extension file which is available from: https://plugins.jetbrains.com/plugin/10694-performance-center-ci

3. Install the LoadRunner Enterprise plugin.

   1. From TeamCity > Administration, under Server Administration click Plugins List.

   2. In the Plugins List page, click Available plugins and search for "Performance Center".

   3. The External plugins page opens and displays the Performance Center CI plugin. Click Download plugin.
   4. After downloading the plugin, in the Plugins List page click Upload plugin zip to upload the Performance Center CI plugin.
   5. Restart your TeamCity server.

Back to top

## Add a LoadRunner Enterprise test to your build step in TeamCity

This task describes how to test to your build step in TeamCity.

1. In your TeamCity project, create a new build and enter the required configuration details.

2. For the build you created, select Build Steps and click Add build step.

3. Select the Performance Center Test build runner type.

4. Add the following step details:

   Argument | Description
   --- | ---
   Runner type | Displays Performance Center Test, the build runner type you selected in the previous step.
   Step name | (Optional) Enter a name to distinguish this build step from other steps.
   Parameters
   PC Server | Enter the hostname or IP address of a LoadRunner Enterprise server. Example: If the LoadRunner Enterprise server URL is `http://MY_SERVER/loadtest`, enter `MY_SERVER`.
   Use HTTPS Protocol | Select this option if you are running the TeamCity build over a secured LoadRunner Enterprise server.
   <LRE credentials> | Depending on the authentication type required by your LoadRunner Enterprise server, credentials can be a username and password, or an API key for SSO or LDAP authentication. Username and password: User name. Enter the user name required to connect to the LoadRunner Enterprise server. Password. Enter the password required to connect to the LoadRunner Enterprise server. SSO or LDAP authentication: Select Authenticate with token. Enter the Client ID and Secret key obtained from your LoadRunner Enterprise site administrator in the Id Key and Secret key fields. For details, see Set up API access.
   Domain | Enter the LoadRunner Enterprise domain.
   PC Project | Enter the name of the LoadRunner Enterprise project.
   Test ID | Enter the Test ID. You can get the ID from LoadRunner Enterprise > Test Management > Test Plan view. Select your test and find the ID in the General Details: ID <number>.
   Test Instance ID | Select an option for adding the Test Instance ID: Automatically select existing or create new if none exists. If you select this option, LoadRunner Enterprise creates a test instance or locates the existing test instance. Manual selection. Enter the Test Instance ID from the Assign and Select Test Set dialog box. For details, see To edit a test set:.
   Local Proxy | Choose whether to use a local proxy (leave empty if not using a local proxy). If you use a proxy, enter a proxy in the format `http(s)://host:port`, and enter the user name and password. Note: PAC (proxy auto-config) or Automatic configuration script are not supported.
   Post Run Action | Choose a Post Run Action: Collate Results, Collate and Analyze, or Do Not Collate.
   Trending | Select a trend report option: Do Not Trend. No trend report is created. Use trend report associated with the test. If Auto Trending is selected in the Load Test, select this option to automatically publish trend results. Add run to trend report with ID. If you select this option, enter the trend report ID.
   Timeslot Duration | Enter a duration for the Ad-Hoc timeslot. Maximum: 480 hours Minimum: 30 minutes
   Use VUFDs | Choose whether to use a Virtual User Flex Days (VUFD) license. This provides you with a specified number of Vusers (VUFDs) that you can run an unlimited number of times within a 24 hour period. Before using this option, make sure that VUFD licenses are applied in your LoadRunner Enterprise environment.
   Set step status according to SLA | Select this option to set the build-step status according to a predefined SLA (Service Level Agreement) configured within your performance test. If you do not select this option, the build-step is labeled as "Passed" as long as no failures occurred.
   On Timeslot creation failure | Choose an action to perform if the timeslot cannot be created: Do not repeat (the task ends), or Repeat with the following parameters: Delay between attempts. Amount of time, in minutes, to wait between a failed attempt and the next attempt (the minimum is 1 and the maximum is 10). Number of attempts. The number of attempts to run the test (the minimum is 2 and the maximum is 10).

5. Save your build step settings.

Back to top

## View test results

After a test run, LoadRunner Enterprise automatically saves the run results as an artifact with the build.

Navigate to the build artifacts specified in the Artifact path and locate the Report.html file to view the test results. You can also review the Trend reports if selected.

Back to top

See also:

- Blog: Performance Center Integration with TeamCity

https://admhelp.microfocus.com LoadRunner Enterprise 8942
Tips to improve your search results... LoadRunner Enterprise Help Center LoadRunner Enterprise Help LR Enterprise Help 2023-2023 R1 All View Local Help Center View Online Help Center back Go back in browser history forward Go forward in browser history Remove search highlights next topic Go to next topic previous topic Go to previous topic Print the current topic Version: