Running TestLeft Tests From Jenkins

Via Java Web Start

As Windows Service

To play back TestLeft tests, Jenkins nodes must have a running RESTful web service. In addition, an interactive user session must be open on it so that the test engine can interact with the GUI.

To meet these conditions, you can:

• (Recommended for unattended test runs) Use the SessionCreator utility. It creates an interactive user session and launches the web service.

• Run TestComplete or TestExecute with the REST API plugin enabled manually and not log out from the current session.

The SessionCreator utility is bundled with TestComplete, TestLeft, and TestExecute. You can find it in the <TestComplete/TestExecute/TestLeft>\Bin folder.

To run it, use the following command line:

To learn more about the utility, see SessionCreator.

1. On your Jenkins node, set the System properties > Remote > Remote Desktop option to:

   • In Windows 10 and Windows 8.1 – Allow remote connections to this computer.

   • In Windows 7 – Allow connections from computers running any version of Remote Desktop (less secure).

2. Add a user account under which you will run tests on a node to the Remote Desktop Users group.

3. Make sure that the user account has a non-empty password.

Otherwise, Jenkins will not be able to connect to the remote machine and run tests on it.

To be able to connect to a node and open a user session on it, configure the following group policies on the node:

1. On your Jenkins node, open the Group Policy editor (type gpedit.msc in the Search dialog and press Enter).

2. Disable the following policies:

   • Always prompt client for password upon connection

   • Prompt for credentials on the client computer

   To disable these policies

   To disable these policiesTo disable these policies

   1. In the tree on the left of the Group Policy editor, select the following category:

      On Windows 10, Windows 8.1, Windows 7 and Windows Server 2012:

      Local Computer Policy > Computer Configuration > Administrative Templates > All Settings

      On Windows Server 2008:

      Local Computer Policy > Computer Configuration > Administrative Templates > Windows Components > Remote Desktop Services > Remote Desktop Session Host > Security

   2. In the list on the right, double-click the Always prompt client for password upon connection item.

      Click Disabled and then click OK.

   3. Repeat step 2 for the Prompt for credentials on the client computer item.

   If the computer belongs to a domain, you may need to ask your system administrator to disable these policies on the domain controller as well.

3. If the node is running under Windows 10, enable the Require use of specific security layer for remote (RDP) connections group policy and set the security layer to Negotiate.

   To configure the group policy

   To configure the group policyTo configure the group policy

   1. In the tree on the left of the Group Policy editor, select Local Computer Policy > Computer Configuration > Administrative Templates > Windows Components > Remote Desktop Services > Remote Desktop Session Host > Security.

   2. In the Setting list on the right, double-click the Require use of specific security layer for remote (RDP) connections item.

   3. In the subsequent dialog, click Enabled.

   4. In the Security Layer drop-down list of the dialog, select Negotiate.

   5. Click OK to close the dialog and save the changes.

4. If the node is running under a non-server edition of Windows and it has other users logged in, log off those users.

5. If the computer is running under a server edition of Windows, enable the following policy:

   • Require use of specific security layer for remote (RDP) connections (on Windows Server 2016 or Windows Server 2019)

   • Restrict Remote Desktop Services users to a single Remote Desktop Services session (on Windows Server 2012 or Windows Server 2008)

   • Restrict Terminal Services users to a single remote session (on Windows Server 2003)

   To enable the needed policy on Windows Server 2016 or Windows Server 2019

   To enable the needed policy on Windows Server 2016 or Windows Server 2019To enable the needed policy on Windows Server 2016 or Windows Server 2019

   1. In the tree on the left of the Group Policy editor, select Local Computer Policy > Computer Configuration > Administrative Templates > Windows Components.

   2. Then, select Remote Desktop Services > Remote Desktop Session Host > Security.

   3. In the Setting list on the right, double-click the Require use of specific security layer for remote (RDP) connections item.

   4. In the subsequent dialog, click Enabled.

   5. In the Security Layer drop-down list of the dialog, select Negotiate.

   6. Click OK to close the dialog and save the changes.

   To enable the needed policy on Windows Server 2008 and later

   To enable the needed policy on Windows Server 2008 and laterTo enable the needed policy on Windows Server 2008 and later

   1. In the tree on the left of the Group Policy editor, select Computer Configuration > Administrative Templates > Windows Components.

   2. Then select Remote Desktop Services > Remote Desktop Session Host > Connections.

   3. In the list on the right, double-click the Restrict Remote Desktop Services users to a single Remote Desktop Services session item.

   4. Click Enabled and click OK.

   To enable the needed policy on Windows Server 2003

   To enable the needed policy on Windows Server 2003To enable the needed policy on Windows Server 2003

   1. In the tree on the left of the Group Policy editor, select Computer Configuration > Administrative Templates > Windows Components.

   2. Then select Terminal Services.

   3. In the list on the right, double-click the Restrict Terminal Services users to a single remote session item.

   4. Click Enabled and click OK.

   If the node is running in Remote Administration Server mode and there are user sessions opened on it, close unnecessary sessions.

6. If the node is configured to show a logon message when a user logs on, disable the message.

   To disable the message

   To disable the messageTo disable the message

   1. In the tree on the left of the Group Policy editor, select Configuration > Windows Settings > Security Settings > Local Policies > Security Options.

   2. In the list on the right, double-click the Interactive logon: Message title for users attempting to log on item.

   3. In the resulting dialog, set the title of the logon message to an empty string and click OK to save the changes.

   4. Then, right-click the Interactive logon: Message text for users attempting to log on item.

   5. Set the text of the logon message to an empty string and click OK.

   If the message persists

   If the message persistsIf the message persists

   1. On your Jenkins node, open the Registry editor (type regedit in the Search dialog and press Enter).

   2. Navigate to the following registry key:

      HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Winlogon

   3. Make sure that its LegalNoticeCaption and LegalNoticeText values are set to an empty string.

You can check whether the Jenkins node is configured correctly by connecting to it manually. If it does not show any additional messages or prompts, the group policies are configured correctly. Otherwise, you may need to ask your system administrator to disable those messages.

Sometimes, Windows is configured so that the user has to press Ctrl+Alt+Delete before signing in to prevent unwanted actions the software that simulates user behavior may perform. We recommend that you turn it off:

1. On the target PC, press Win+R to open the Run dialog.

2. Type control userpasswords2 and press Enter.

3. In the subsequent User Accounts dialog, switch to the Advanced tab.

4. Unselect the Require users to press Ctrl+Alt+Delete option.

5. Click OK or Apply.

To avoid issues during the testing, make sure that, when you connect to the remote machine, its desktop opens up immediately. That is, no additional screens appear (such as the login form, account selection window, or RDP Certificate Warning windows). To learn how to disable these additional screens, contact your IT department.

On Windows 8.1 and later, TestLeft requires elevated permissions for the run. Jenkins that is run through the Java Web Start agent application, cannot start TestLeft with required permissions, and will cause the test run to fail if it tries.

To run tests under Windows 8.1 and later, do any of the following:

• Install the Java Web Start agent as a service. In this case, the agent has the required permissions and can start TestLeft.

– or –

• Connect to the Jenkins node by using the "Let Jenkins control this Windows slave as a Windows service" launch method.