Verifying Tasks, Jobs, Hosts and Network Suites

Before TestComplete runs a distributed test, it verifies the network suite. The verification procedure includes numerous checks and if any of them fails, TestComplete informs you about it so that you can fix the problem quickly.

The verification procedure confirms the following:

• On the master computer:

  • The user account under which TestComplete is running has permissions to share the folder specified by the Shared path property of the master project.

  • The remote computers defined in the master project’s Hosts collection have a network name or IP address specified in the Address property.

  • The remote computers defined in the master project’s Hosts collection are available on the network.

  • The login information (user name, password and domain) for each remote computer is specified in the Hosts editor or in the Network Suite Editor - Properties Page.

• On a remote computer:

  The following checkups are performed only on remote computers available on the network.

  • If no user is logged in to the computer, TestComplete ensures that the provided user account can successfully log in.

    If there is an open user session, TestComplete ensures that the provided user account is the same as the logged in user. (This way TestComplete will be able to connect to that session from the master computer).

    Note:

    Server editions of the Windows operating system support multiple concurrent user sessions. If several user sessions are open on a remote host, the network suite will close all those sessions and open a new session for the needed user.

  • TestComplete 14 (or TestExecute 14) is installed.

  • TestComplete 14 Service is registered and can start (if it is not already running).

  • TestComplete (TestExecute) can start (if it is not already running).

  • The slave project or project suite specified by the task’s Project file name property exists and is available to the logged on user. (A limited user account may have no permissions to access the project file.)

  • TestComplete (TestExecute) can open the needed project on the remote host.

  • The slave project contains the NetworkSuite project item.

  • The slave project contains the test specified by the task’s Test property.

    Note:

    An empty Test value corresponds to the entire slave project suite.

To ensure that the network suite is configured correctly without running it, open your master project and verify the network suite or its individual hosts, tasks and jobs.

To verify a remote host

To verify a task

To verify a job

To verify the entire network suite

You can add network suite verification commands to your keyword and script tests:

• Host.Verify - verifies a specific remote host,

• Task.Verify - verifies a specific task,

• Job.Verify - verifies all the tasks in a specific job,

• NetworkSuite.Verify - verifies the entire network suite, that is, all the hosts and tasks.

To call these methods from a keyword test, use the Call Object Method or Run Code Snippet operation. For more information, see Calling Object Methods.

If a network suite, job or task is currently running, the Verify method will wait until it finishes running and becomes idle. For example, take a look at the script below that runs two tasks:

The Task1.Run(False) method commands TestComplete not to wait for Task1 to finish before continuing running the test, however, Task2 will run only after Task1 is over. This happens because the Task2.Verify method waits for Task1 to finish before verifying Task2.