Test run considerations for AFT Suites or Functional tests

Before you configure an AFT Suite or a Functional test run, you must first read the considerations that you need to take into account.

When you want to run an AFT Suite or Functional test in a project on Rational® Test Automation Server, you can check if the AFT Suite or Functional test meets any of the following conditions:
If... Then...
The AFT Suite or Functional test 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 or Functional test 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.
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.
Before you configure the run for an AFT Suite or a Functional test, 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 a performance agent to a project.
  • 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.

    You can then select the remote agent as the location to run the AFT Suite or Functional test 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 when you are configuring the test run.

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