Home
Rational® Functional Tester
Test Execution Specialist Guide
This guide describes how to automate the playback of the tests by using different methods such as Docker, IBM® Cloud Private, Jenkins and so on. The test results can be pushed to Rational® Test Control Panel.
Running tests from UI Test perspective
In this section, you will learn how to play back the Web UI, mobile and Windows tests from the UI Test perspective.
Running a test from a command line
You can run a test without opening the product by using the command-line interface.
Running a test from the command line on multiple browsers
In addition to running a Web UI test from the product interface, you can automate the test effort by running the test from the command line. To accelerate test execution, you can run a single Web UI test and/or a compound test containing Web UI tests on multiple browsers and devices simultaneously.

Rational® Functional Tester
- Release Notes
  This document contains information about what's new, installation instructions, known problems in and contact information of IBM Customer Support.
- System Requirements
  This document includes information about hardware and software requirements for IBM® Rational® Functional Tester.
- Getting Started Guide
  This guide provides an overview of Rational® Functional Tester. You can find the task flows to get you started with Rational Functional Tester. This guide is intended for new users.
- Tutorials
  This section contains the tutorials which explains the main features of Rational® Functional Tester.
- Samples
  This section describes about the sample project which can be used with Rational® Functional Tester to test the functionality of an application.
- Administrator Guide
  This guide describes how to install IBM® Rational® Functional Tester software. After you install the software, you can perform administration tasks such as license configuration and integration with other products. This guide is intended for administrators.
- Test Author Guide
  This guide describes how to create test scripts and enhances them by applying different test elements such as dataset, variables, and verification points.
- Test Execution Specialist Guide
  This guide describes how to automate the playback of the tests by using different methods such as Docker, IBM® Cloud Private, Jenkins and so on. The test results can be pushed to Rational® Test Control Panel.
  - Running tests from UI Test perspective
    In this section, you will learn how to play back the Web UI, mobile and Windows tests from the UI Test perspective.
    - Running Web UI tests
      See the different ways to play back Web UI tests.
    - Running mobile tests
      After you record the tests for mobile applications by using Rational® Functional Tester, you can play back the recorded tests by using Rational Functional Tester. The test reports help you to analyze the functional and performance issues in the mobile applications developed.
    - Running Windows tests
      You can run Windows tests that you created for Windows desktop applications in Rational® Functional Tester.
    - Configuration of AFT Suite runs
      When you create Web UI, mobile, or Windows tests, you must configure the play back of the recorded tests as AFT Suite runs before you can view their test results.
    - Running a test on multiple browsers and devices simultaneously
      Rather than run a Web UI test on one browser at a time, you can run a single Web UI test on multiple browsers simultaneously. Doing so can significantly speed up your test effort. You can also extend your test coverage by adding mobile devices to the test run. You can run the test from Rational® Functional Tester, from the command line, or from Rational Quality Manager. This topic describes how to run a test from the UI Test perspective.
    - Running a test from a command line
      You can run a test without opening the product by using the command-line interface.
      - Running a test from the command line
        You can run Web UI, mobile, and windows tests using the command-line interface of Rational® Functional Tester.
      - Creating a command-line config file
        Starting from V10.0.2, you can create command line config file from the product, which you can use while running tests from the command-line interface and Maven.
      - Running Web UI tests from the command-line
        You can run a Web UI test without using the desktop client by using the command-line interface. You must use the -varfile parameter that specifies the complete path to the XML file in the command. The XML file contains the name-value pairs of the variables. The variables file specifies the web browser on a computer, device, emulator, or device on a cloud on which to run the test.
      - Running a test from the command line on multiple browsers
        In addition to running a Web UI test from the product interface, you can automate the test effort by running the test from the command line. To accelerate test execution, you can run a single Web UI test and/or a compound test containing Web UI tests on multiple browsers and devices simultaneously.
      - Running multiple tests simultaneously from the command line
        You can use an XML file and the command line to run multiple Web UI tests and compound tests simultaneously on instances of Chrome and Firefox. You can also distribute these tests across multiple remote agent computers. Starting from 9.1.1.1, this feature is also available from the command line.
      - Running mobile tests for Android applications from the command-line
        You can run a mobile test without using the desktop client by using the command-line interface. You must use the -varfile parameter that specifies the complete path to the XML file in the command. The XML file contains the name-value pairs of the variables. The variables specify the path to the computer to which the Android device or emulator is connected, and the other configurations required to run the mobile test on the connected device.
      - Running mobile tests for iOS applications from the command-line
        You can run a mobile test without using the desktop client by using the command-line interface. You must use the -varfile parameter that specifies the complete path to the XML file in the command. The XML file contains the name-value pairs of the variables. The variables specify the path to the computer to which the iOS device or simulator is connected, and the other configurations required to run the mobile test on the connected device.
      - Playing back Windows tests from the command-line
        You can play back a Windows test without using the desktop client by using the command-line interface. You can either play back the Windows test on the local computer or on a remote computer.
  - Running tests from Functional Test perspective
    In this section, you will learn how to play back tests from the Functional Test perspective.
- Test Manager Guide
  This guide describes how to keep track of the performance of the application by evaluating the test results. Following topics cover how you can work with the test results.
- Troubleshooting
  This guide describes how to analyze and resolve some of the common problems that you might encounter while you work with Rational® Functional Tester.
- Reference Guide
  This guide describes the additional topics to gain more knowledge about Rational® Functional Tester.
- All Guides (PDF)
  You can find the link to view or download the content of the release notes, system requirements, and persona guides of IBM® Rational® Functional Tester as a PDF file.
- Security Considerations
  You can take certain actions to ensure that your installation is secure, customize your security settings, and set up user access controls.
- Notices
  This document provides information about copyright, trademarks, terms and conditions for the product documentation.

Running a Web UI test or compound test from the command line on multiple browsers

In addition to running a Web UI test from the product interface, you can automate the test effort by running the test from the command line. To accelerate test execution, you can run a single Web UI test and/or a compound test containing Web UI tests on multiple browsers and devices simultaneously.

About this task

Use the -vmargs command line argument to run the Web UI or compound test on multiple browsers or on all browsers and connected mobile devices simultaneously. Use variable names from the following table to specify the browsers to run the command on. To specify multiple browsers, separate the variable names with commas, for example, ff,chrome,ie. To run the test on all browsers and connected mobile devices, use the variable name all. Do not use spaces for the -vmargs arguments.

Browser	Variable
Mozilla Firefox	ff
Google Chrome	chrome
Internet Explorer v9 32-bit	ie
Internet Explorer v9 64-bit	ie64
Internet Explorer v10 and v11	ie
Microsoft Edge	edge
Apple Safari	safari

Procedure

To run a test from the command line, go to the directory that contains the cmdline.bat and cmdline.sh files. On Windows™ operating systems, this directory is typically productInstallationDirectory/cmdline, for example, C:\Program Files\__BRAND_NAME__\__SDP_PATH__\cmdline.
Issue the cmdline command, followed by the arguments defined in the Running a test from a command line topic.
To run the test simultaneously on all supported desktop browsers and connected mobile devices, use the -vmargs argument, as follows:
```
-vmargs "-Dall.available.targets.in.parallel=all" 
```
To run the test simultaneously on a selected set of browsers, use the -vmargs argument, as follows:
```
-vmargs "-Dall.available.targets.in.parallel=ie,ff,chrome"  
```

Example

cmdline -workspace D:\My Workspace -project myProject -eclipsehome C:\Program Files\IBM\SDP -plugins C:\Program Files\IBM\IBMIMShared\plugins -suite Tests\myWebUITest.testsuite -vmargs "-Dall.available.targets.in.parallel=ie,ff,chrome"