|Information in this topic applies to desktop and web applications.|
Each computer (whether master or remote) used in distributed testing must be configured as follows:
TestComplete 12 or TestExecute 12 must be installed on the computer.
|Use the same version of TestComplete and TestExecute on all computers.|
TestComplete 12 Service must be running on the computer (by default, the service is launched automatically at Windows startup).
If a firewall or antivirus is installed on the computer:
Add TestComplete 12, TestExecute 12 and TestComplete 12 Service to the list of trusted applications. To learn how to allow TestComplete through the built-in Windows Firewall, see TestComplete and Windows Firewall.
Allow traffic through the TCP ports used by TestComplete and TestComplete Service. By default, these ports are 6090-6092. You can change the ports in the Network Suite Options dialog.
The TCP ports for remote connections in the Network Suite Options must be the same on all computers.
On Windows XP and Windows Server 2003, install the Remote Desktop Connection 6.0 client from here:
To run distributed tests on remote computers, you need to enable remote desktop connections to them. You also need to add the user accounts for remote login to the Remote Desktop Users group on the remote computers. To do this:
Open the Control Panel | System applet.
On Windows 10, Windows 8 and Windows Server 2012:
In the left part of the System window, click Remote settings.
In the dialog that opens, select Allow remote connections to this computer.
Clear the Allow connections only for computers running Remote Desktop with Network Level Authentication (recommended) check box.
On Windows Vista, Windows 7 and Windows Server 2008:
On the left of the System window, click Remote settings.
In the dialog that opens, select the Allow connections from computers running any version of Remote Desktop (less secure) check box (or similar).
On Windows XP and Windows Server 2003:
In the System Properties dialog, switch to the Remote page.
Select the Allow users to connect remotely to this computer check box (or similar).
Click Select Users. The Remote Desktop Users dialog opens.
Specify the user accounts allowed to access the computer, and click OK.
You will use these accounts in your master test project to log in to the remote computers.
These user accounts must have non-empty passwords.
Click OK to close the System properties and save the changes.
On remote computers with Windows Vista, Windows 7, Windows Server 2008 and later operating systems, choose whether to run TestComplete (TestExecute) with administrator privileges:
If TestComplete (TestExecute) does not need administrator privileges to run the slave project, configure TestComplete (TestExecute) to run without them. To do this:
On the remote computer, open Windows Explorer or any other file manager and find the executable file of TestComplete (TestExecute). The file name is <TestComplete 12>\Bin\TestComplete.exe for TestComplete and <TestExecute 12>\Bin\TestExecute.exe for TestExecute.
Right-click the TestComplete (TestExecute) file and select Properties from the context menu.
In the file properties dialog, switch to the Compatibility tabbed page.
Uncheck the Run this program as an administrator option.
If TestComplete (TestExecute) needs administrator privileges to run the slave project, disable User Account Control (UAC) on the remote computer. To learn how to disable UAC, see Using TestComplete With Administrator Privileges.
|Disabling UAC reduces Windows security.|
If a remote computer is running a server edition of Windows, restrict users to one remote session:
On the remote computer, open Group Policy (to do this, type gpedit.msc in the Search dialog and press Enter).
In the Group Policy editor:
Select Computer Configuration | Administrative Templates | Windows Components.
Then select Remote Desktop Services | Remote Desktop Session Host | Connections.
In the list on the right, double-click the Restrict Remote Desktop Services users to a single Remote Desktop Services session item.
Select Enabled and click OK.
Select Computer Configurations | Administrative Templates | Windows Components.
Then select Terminal Services.
In the list on the right, double-click the Restrict Terminal Services users to a single remote session item.
Select Enabled and click OK.
In addition, if a remote computer is running in the Remote Administration Server mode and there are user sessions opened on it, you need to close unnecessary sessions. To do this:
Log on to the remote computer locally.
Click Start | Administrative Tools | Remote Desktop Services | Remote Desktop Services Manager. This will open the Remote Desktop Services Manager window.
Select the server in the left pane of the window. In the right pane of the window, switch to the Users tabbed page.
If there are several remote sessions, select one of the users with the Remote Desktop Protocol session, right-click it and select Log Off in the context menu.
Click Start, select Run, type
gpedit.msc and press Enter. This will open the Group Policy Editor.
In the editor:
Disable the following group policies on the remote computers:
Always prompt client for password upon connection
Prompt for credentials on the client computer (on Windows Vista and later)
|Note:||If the remote computer belongs to a domain, these group policies must also be disabled on the domain controller. Ask your system administrator to do this.|
To disable these policies:
In the tree on the left, select the following category:
On Windows 10, Windows 8, Windows 7 and Windows Server 2012:
Local Computer Policy | Computer Configuration | Administrative Templates | All Settings
On Windows Vista and Windows Server 2008:
Local Computer Policy | Computer Configuration | Administrative Templates | Windows Components | Remote Desktop Services | Remote Desktop Session Host | Security
On Windows XP and Windows Server 2003:
Local Computer Policy | Computer Configuration | Administrative Templates | Windows Components | Terminal Services | Encryption and Security
In the list on the right, double-click the Always prompt client for password upon connection item.
Select Disabled and click OK.
If the remote computer runs Windows Vista, Windows 7, Windows Server 2008 and later operating systems, also do the following:
In the tree on the left, select Local Computer Policy | Computer Configuration | Administrative Templates | All Settings.
In the list on the right, double-click the Prompt for credentials on the client computer item.
Select Disabled and click OK.
If the remote computer runs Windows 10, also do the following:
In the tree on the left, select Local Computer Policy | Computer Configuration | Administrative Templates | Windows Components | Remote Desktop Services | Remote Desktop Session Host | Security.
In the Setting list on the right, double-click the Require use of specific security layer for remote (RDP) connections item.
In the subsequent dialog, select Enabled.
In the Security Layer drop-down list of the dialog, select Negotiate.
Click OK to close the dialog and save the changes.
If the remote computer is configured to show a logon message when a user logs on, disable the message:
In the tree on the left of the Group Policy editor, select Configuration | Windows Settings | Security Settings | Local Policies | Security Options.
In the list on the right, double-click the Interactive logon: Message title for users attempting to log on item.
In the resulting dialog, set the title of the logon message to an empty string and click OK to save the changes.
Then, right-click the Interactive logon: Message text for users attempting to log on item.
Set the text of the logon message to an empty string and click OK.
If the message persists:
On your remote computer, open the Registry editor (click the operating system Start or Windows button, select Run, type regedit and press Enter).
Navigate to the following registry key:
Make sure that its
LegalNoticeText values are set to an empty string.
For each computer in the master project’s Hosts collection, you must specify the user account (domain, user name and password) to log in to that computer.
Alternatively, you can specify a common user account for multiple hosts in the network suite properties of the master project.
|Note:||User accounts must have non-blank passwords.|
Remote computers must have access to the projects they will run:
Place the projects in folders on the remote computers where they will run.
If the tests belong to your master project or to other projects residing on the master computer, you can configure the master project to copy them to the appropriate remote computers automatically or you can copy them manually. See Copying Slave Projects to Remote Computers.
If your slave project or project suite has external project items or projects that reside outside its folder, TestComplete will not copy them. Move them to the appropriate folder or copy them to the remote computers manually by using any file manager. Make sure that the resulting project or project suite on the remote computer contains valid paths to those external items.
If you use the Network Suite wizard to create distributed tests, your master project is configured to copy the corresponding tests from the master project to the remote computers automatically.
– or –
Place the projects in a shared network folder. In this case, the user accounts used to log in to the remote computers must have read and write permissions for this shared folder.
|Note:||We do not recommend that you share the same project or project suite among several computers, as the computers may fail to open the shared project or project suite simultaneously.|
The distributed testing functionality is implemented by the following plugins. They are installed and enabled automatically during TestComplete installation.
|Network Suite||Provides the NetworkSuite project item (which must be added to projects manually) and the
|Host List Editor||Provides the Hosts editor that lets you configure the list of hosts (i.e. computers that can take part in distributed testing controlled from the given project), and set up properties of individual hosts.|
|Job List Editor||Provides the Jobs editor that lets you configure the list of jobs (collections of tasks) that belong to the network suite of the given project, and set up properties of individual jobs.|
|Task List Editor||Provides the Tasks editor that lets you configure the list of tasks that belong to the given job in the network suite, and set up properties of individual tasks.|
|Run State||Provides the Run State page for the NetworkSuite project item editor, which lets you monitor the network suite, job or task run.|
Note that the Network Suite plugin must be enabled in TestComplete (TestExecute) on both master and remote computers.
If you experience issues when working with network suites, you can check whether the plugins are enabled in the File | Install Extensions dialog.
Projects Participating in Distributed Testing
Copying Slave Projects to Remote Computers
Opening User Sessions on Remote Computers
Creating and Running Distributed Tests
Running the Network Suite, Jobs and Tasks