About Test Agent

Applies to QAComplete 14.3, last modified on February 19, 2024

The Test Agent is a tool that allows you to communicate QAComplete and your automated testing tools.

You have to install and configure the Test Agent on each computer that you plan to use for automated tests, so the test result will be posted to the Test Library. The Test Agent is also necessary for scheduled automation runs.

Tip: When you install the test agent on a host machine, the host item will be automatically created in QAComplete.

Requirements

To install the Test Agent, your test machine must meet the following requirements:

  • An active Internet connection.

  • To run TestComplete automated tests:

    TestComplete or TestExecute version 9.0 or later installed.

    Note: If there are several TestComplete or TestExecute versions installed on the host, the Test Agent will use the latest version.
  • To run automated API tests:

    ReadyAPI version 1.2.0 or later installed.

    - OR -

    SoapUI OS version 5.1.2 or later installed.

  • To run tests with a Java unit testing framework:

    • Java Runtime Environment (JRE) 5 - 8 installed
    • Appropriate Java unit testing framework, JUnit or TestNG, installed and configured
    • For Selenium automated web tests:
      Selenium WebDriver modules installed and configured in your JUnit or TestNG framework
    • To use Maven for test runs:
      Maven 3.2.3 or later modules installed and configured
      The PATH environment variable on the test machine must specify the path to the Maven modules
  • To run tests with the NUnit testing framework:

    • NUnit unit testing framework installed and configured
    • For Selenium automated web tests:
      Selenium WebDriver modules installed and configured in your JUnit or TestNG framework

Active Directory authentication restriction (on-premises only)

To register the Test Agent on a computer, do not use an account with the Active Directory authentication. Use a non-Active Directory user account.

You can enable and disable the Active Directory authentication for a user in  > Setup > Security > Users in QAComplete.

Default ports

By default, the ports used by the Test Agent and related processes are:

  • TestComplete (and TestExecute) license manager: Port 1947.

  • For TestComplete and TestExecute Network Suite, the port depends on the product version:

    • In TestComplete (and TestExecute) versions 11 and 12: ports 6090-6092
    • In versions 10.20 - 10.60: ports 6020-6022
    • In versions 9.10 - 10.10: ports 6090-6092

    To find the ports used by Network Suite in TestComplete (or TestExecute), see the documentation for your version of TestComplete (TestExecute).

  • Test Agent: Ports 80 and 443.

See Also

About Automated Tests
Test Hosts
Active Directory Authentication

Highlight search results