Before running tests from Jenkins, install the LoadComplete Jenkins plugin and configure your slave nodes.

Requirements

Jenkins version 2.121.1 or later.
One of the supported Windows versions installed on your Jenkins nodes.
LoadComplete version 4.95 or later installed on your Jenkins nodes.

A LoadComplete license must be available on your Jenkins nodes.

Note:

You can use a Floating User or a Node-Locked license. Select a Floating User license if you use a dynamic testing environment. You will activate the license on a computer in your network (a license server) and configure LoadComplete instances on Jenkins nodes to connect to this server.

Installing LoadComplete Jenkins Plugin

Online installation

In Jenkins, go to Manage Jenkins > Manage Plugins.
Switch to the Available tab.
Find LoadComplete support plugin and click Install without restart.

Tip: Press Ctrl+F and search through the page for LoadComplete keyword to find the plugin faster.

Offline installation

Download a LoadComplete Jenkins Plugin .hpi file from the Jenkins Wiki page.
In Jenkins, go to Manage Jenkins > Manage Plugins.
Switch to the Advanced tab.
Click Choose File in the Upload Plugin section.
Select the plugin file on your device.
Click Upload.

When the installation is finished, switch to the Installed tab to make sure that the LoadComplete plugin was installed successfully:

Click the image to enlarge it.

Configuring Jenkins Nodes

Before running LoadComplete tests on slave computers, configure them as Jenkins nodes:

Create a new Jenkins node.

See instructions
See instructionsSee instructions
1. In Jenkins, go to Manage Jenkins > Manage Nodes.
2. Specify your Node name and select Permanent Agent.
3. Click OK.
Connect to slave nodes. You can do it in one of the following ways:
- Launching Jenkins Slave Agent via Java Web Start
  
  See instructions
  See instructionsSee instructions
  To connect to a node via Java Web Start, launch the Jenkins agent on the slave machine:
  1. Log on to your slave computer.
  2. On the slave computer, open the http://<Master_Name>:8080/computer/<Node_Name>/ web page in the browser:
  3. Click Launch, or launch the slave agent using the command line provided by Jenkins.
- Launching Jenkins Slave Agent as Windows Service on Slave
  
  See instructions
  See instructionsSee instructions
  1. On the slave node settings page, select Let Jenkins control this Windows slave as Windows service.
  2. In the Run service as drop-down list, select Use Local System User.
  Click the image to enlarge it.
  
  Such connection does not require any preliminary setup on the slave node. However, this method has some issues:
  
  You may experience issues with connecting to the slave computer. If you do, refer to the following web page for the list of possible errors and ways to fix them:
  
  https://wiki.jenkins-ci.org/display/JENKINS/Windows+slaves+fail+to+start+via+DCOM
We recommend using Java Web Start to connect to slave nodes, because you may encounter a large number of issues when connecting them as a windows service.

Known Issues

Currently, you may be unable to apply LoadComplete settings (those that differ from the default ones) if you started LoadComplete from Jenkins. This happens because LoadComplete launched by the LoadComplete Jenkins plugin is run by the SYSTEM account, but if you change the settings directly in LoadComplete, it will save them to the User account. As a workaround, you can replace the file containing LoadComplete settings on your Jenkins node with the file containing previously configured LoadComplete settings:
1. Open LoadComplete on any of the machines and configure it as needed.
2. Close LoadComplete to save the changes. The settings are saved automatically to the following file:
  
  C:\Users\<User name>\AppData\Local\SmartBear\LoadComplete\4.0\tcSettings.xml
3. Replace the settings file on your Jenkins node with the settings file saved at the previous step.
  
  The settings that LoadComplete uses being launched under the SYSTEM account reside at:
  
  On a 64-bit version of Windows:
  
  %SYSTEMROOT%\SysWOW64\config\systemprofile\AppData\Local\SmartBear\LoadComplete\4.0\tcSettings.xml
  
  On a 32-bit version of Windows:
  
  %SYSTEMROOT%\system32\config\systemprofile\AppData\Local\SmartBear\LoadComplete\4.0\tcSettings.xml
  
  Note: You can do this manually, or you can add a build step to your Jenkins job that will do this automatically.
To get values of LoadComplete performance counters on your Jenkins node, the user account under which a Jenkins slave agent is running must have permissions to retrieve data on the monitored server. The data cannot be retrieved from performance counters if LoadComplete is running under the SYSTEM account.

Preparing for Running LoadComplete Tests