TestExecute and Windows Firewall

Applies to TestExecute 15.40, last modified on May 21, 2024

Windows includes a built-in firewall that controls data transfers between your computer and other computers on the network or Internet. The firewall lets users specify trusted programs that are allowed to transfer information between the local computer and certain remote computers, while blocking requests that come from other programs and computers.

TestExecute uses TCP and UDP protocols and port 1947 to communicate with the License Manager PC (the computer where your license is activated). These protocols and this port must not be blocked so that TestExecute can access the License Manager PC and exchange the licensing data.

In addition, TestExecute and TestComplete Service exchange data with computers during distributed testing, so you need to allow these programs through the firewall to run distributed tests.

Notes
  • To allow TestExecute to exchange licensing data with the License Manager PC, configure the firewall settings both on your License Manager PC and on your TestExecute workstation.

  • To run distributed tests, configure the firewall settings on all the computers that participate in distributed testing and where Windows Firewall runs.

  • You may be unable to change some of the firewall settings if your computer is connected to a domain and the settings are controlled by your system administrator. In this case, ask your system administrator to allow TestExecute and its utilities through the firewall.

Check if Firewall Is Running

  • Open Control Panel by clicking Start and then clicking Control Panel.

  • In the search box, type Firewall and then select the Windows Firewall applet. The Windows Firewall window will open.

Windows 7 Firewall Window

If a green check mark is displayed next to the network location that includes your License Manager PC or computers participating in distributed testing, it means that Windows Firewall is running and controlling data transfers. In this case, configure Firewall to allow TestExecute network activities (see below).

If there is no green check mark, Windows Firewall is disabled and it does not block any network requests. In this case, there is no need to change the firewall settings.

Configure Firewall

To access the license

If Windows Firewall is on for network locations where your License Manager PC is located, make sure that TCP and UDP traffic through port 1947 is allowed:

  1. In the left part of the Windows Firewall window, click Advanced settings.

  2. In the resulting Windows Firewall and Advanced Security window, select Inbound Rules and then click New Rule.

  3. In the resulting wizard, click Port and then click Next.

  4. Click TCP. Then click Specific local ports and enter 1947. Click Next.

  5. Click Allow the connection and then click Next.

  6. Select the needed scope and click Next.

  7. Enter a name for the rule and click Finish.

Repeat the steps for the UPD protocol. Then repeat the steps to create outbound rules that will allow TCP and UDP traffic through port 1947.

To run distributed tests

Creating and running distributed tests will be deprecated in one of the future releases. We recommend that you use a CI/CD system to manage test runs. To learn more, see Migrating Distributed Tests to CI/CD Systems.

If Windows Firewall is on for a network location that includes your distributed testing workstations, add TestExecute and its utilities to the firewall’s list of exceptions in order to allow their network activities:

  1. On the left of the Windows Firewall window, click Allow a program through Windows Firewall. The Allowed Programs panel will appear.

  2. Locate TestExecute 15 in the list of programs and tick the check box for each network location where you need TestExecute to have access through the firewall.

    If TestExecute is not in the list:

    • Click the Add another program button. The Add a Program dialog will open.

    • Select TestExecute 15 in the Programs list.

      If it is not in the list, click Browse and browse for TestExecute’s executable -- TestExecute.exe.

    • Click the Network location types button and check the network locations for which you want to allow TestExecute activities.

    • Click Add to close the dialog and add TestExecute to the firewall’s list of exceptions.

  3. Repeat step 3 to add TestComplete Service’s executable -- TestCompleteService15.exe (<TestExecute>\Bin\TestCompleteService15.exe) to the firewall’s list of exceptions.

  4. Press OK to close the Allowed Programs panel.

Also, you need to create firewall rules that will open ports used by TestExecute and TestComplete Service to exchange data with projects participating in distributed testing.

The ports used by TestExecute and TestComplete Service are specified by the TCP ports for remote connections option. By default, ports 6095 - 6097 are used.

  1. On the left of the Windows Firewall window, click Advanced settings. The Windows Firewall with Advanced Settings window will open.

  2. In the tree on the left of the window, click Inbound Rules.

  3. Create a new rule:

    • In the Actions panel of the window, click New Rule. The New Inbound Rule Wizard will appear.

    • On the Rule Type page of the wizard, select Port. Click Next.

    • On the Protocol and Ports page of the wizard, select Port. In the Specific local ports edit box, specify the port number. Click Next.

    • On the Action page of the wizard, select Allow the connection and click Next.

    • On the Profile page of the wizard, select the network location for which you want to open a port and click Next.

    • On the Name page of the wizard, in the Name field, specify the rule name and press Finish.

  4. In the tree on the left of the Windows Firewall with Advanced Security window, select Outbound Rules.

  5. Repeat step 3 to open the same port for outbound connections.

  6. Repeat steps 1-4 to open other ports.

Once you are done, close the Windows Firewall window.

See Also

Specifics of Using TestExecute on Various Windows Operating Systems

Highlight search results