Test run considerations for AFT Suites

Before you configure an AFT Suite run, you must read the considerations you must take into account.

When you want to run an AFT Suite from a project on Rational® Test Automation Server, you can check if the AFT Suite meets any of the following conditions:
If... Then...
The AFT Suite uses the settings configured in an AFT XML file for a remote agent

You must ensure that you have configured the location element in the AFT XML to point to a remote agent.

For more information about setting the location element, refer to Using an XML file to run multiple Web UI tests and compound tests simultaneously.
You want to run an AFT Suite on a remote agent

You must run the test on the remote agent before you commit the test asset to the remote repository.

When you run the test on the remote agent, the following events occur:
  • The agent is added as the location in the AFT XML file, on which the test is to be run.
  • The agent is displayed as the agent on which the test is to be run, under the Host column within the Location tab in the Execute test asset dialog box.
You commit the test asset to the remote repository without running the test on the remote agent

The agent is not displayed under the Host column within the Location tab in the Execute test asset dialog box.
Before you configure the run for an AFT Suite, you must complete the following tasks, if they are applicable:
  • Add the remote agents, on which the test is to be run, to the project on Rational® Test Automation Server. See Adding an agent to the project for running tests.
  • After you add the agent, you can select the agent configured in the AFT XML file as the location for the test run or select the remote agents that you add to the project, when you configure a run for an AFT Suite.

    The remote agents are shown as the agents available for selection under the Override column within the Location tab in the Execute test asset dialog box.

    You can then select the remote agent as the location to run the AFT Suite when you are configuring the test run. Alternatively, you can enter the argument -swaplocation <configured_agent_location>:<overriding_agent_location> in the Program Arguments field in the Advanced Setting dialog box when you are configuring the test run.

For running an AFT Suite, see Configuring an AFT Suite run.