Home
Test Execution Specialist guide
A test executor automates 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 Web UI Test perspective
In this section, you will learn how to play back tests from the Web UI Test perspective.
Running Web UI tests
See the different ways to play back Web UI tests.
Testing with IBM® Cloud Private
You can automate your testing environment by using Docker container images of the workbench and agents on top of IBM® Cloud Private.
Configuring IBM® Cloud Private
To make use of automated workflows in IBM® Cloud Private, you can install it and push the Docker containers to it.

Test Execution Specialist guide
A test executor automates 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 Web UI Test perspective
  In this section, you will learn how to play back tests from the Web UI Test perspective.
  - Running Web UI tests
    See the different ways to play back Web UI tests.
    - Prerequisites to running Web UI tests
    - Running tests from an Android mobile test client
      You can run a test from an Android mobile device or emulator. After the run, the report is automatically uploaded to Rational® Functional Tester. You can also view the report on the mobile test client.
    - Running Web UI tests on BitBar mobile device cloud
      You can run Web UI tests on mobile devices available in BitBar cloud device from the test workbench and to view the execution reports in the BitBar cloud.
    - Running Web UI tests on Perfecto mobile cloud
      To check the connection between the application and mobile cloud device, ideally before the test execution, you can enter the Perfecto mobile cloud credentials and get it verified.
    - Running a test using industry-standard mobile browsers
      Starting with 9.2.1, you can use industry-standard mobile browsers, such as Chrome and Safari, to run Web UI tests for mobile web applications. You can run tests with Chrome on Android devices and emulators and with Safari on iOS devices and simulators. This capability uses Appium to actually run the tests. Before 9.2.1, you could only run tests on mobile devices using the generic browser that is bundled with Rational® Functional Tester.
    - Running a test recorded in Google Chrome Device Mode
      You can run a test that you recorded in Chrome Device Mode. Doing so allows you to emulate the testing of applications on the browser of a mobile device.
    - Testing with Docker images
      IBM® Rational® Performance Tester, IBM Rational Functional Tester, and IBM Rational Performance Tester Agents are available for download as Docker images. You can use them to fulfill the continuous testing aspects of your DevOps lifecycle.
    - Testing with IBM® Cloud Private
      You can automate your testing environment by using Docker container images of the workbench and agents on top of IBM® Cloud Private.
      - Configuring IBM® Cloud Private
        To make use of automated workflows in IBM® Cloud Private, you can install it and push the Docker containers to it.
      - Running automated tests with containerized agents on IBM® Cloud Private
        To adopt IBM® Cloud Private fully and manage the entire development to deployment workflow on cloud, you would want to start and stop capabilities with a few clicks. By providing the agents in containers, you can dynamically provision capability as required without procuring the machines and installing the agents.
      - Running automated tests with containerized workbench and agents on IBM® Cloud Private
        To adopt IBM® Cloud Private fully and manage the entire development to deployment workflow on the cloud, you would want to start and stop capabilities with fewer clicks. By providing both the workbench and agents in containers, you can dynamically provision capability as required and run the test automation suites without procuring the machines and installing the products.
    - Starting a new recording immediately after playback
      Starting from 9.1.1.1, you can keep the Google Chrome browser active after Web UI test playback is complete. This feature allows you to continue recording at the point where playback finished without the need to re-record the earlier steps.
    - Adding custom JavaScript code as a test step in a Web UI test
      You can manually add JavaScript files (*.js) to test scripts with defined functions. You might want to run your own JavaScript snippet such as retrieving some data from the application, doing some actions within the application, or validating some complex logic actions within the application for example. To be able to execute specific code in a test, write your own JavaScript code and insert the custom JavaScript statement as a new test step in your test script.
  - 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.
  - 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 Web 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 tests from Functional Test perspective
  In this section, you will learn how to play back tests from the Functional Test perspective.

Configuring IBM® Cloud Private

To make use of automated workflows in IBM® Cloud Private, you can install it and push the Docker containers to it.

About this task

You must use IBM® Cloud Private 2.1.0.3.

Procedure

Install and set up IBM® Cloud Private-CE.
For more information, see documentation.
Install the IBM® Cloud Private Command Line Interface (CLI).
For more information, see documentation.
Download the IBM® Rational® Functional Tester and IBM® Rational® Performance Tester Agent container images from the same location you downloaded the product bits.
The images are in the form of Passport Advantage (PPA) files. You can load the PPA files directly to IBM® Cloud Private instead of extracting the Docker image out of it.
Load the images into Docker repository:
For Windows, use the command in GitBash:
```
$ docker load -i "imageFileName.tar.gz"
```
For Linux, use the terminal:
```
tar --wildcards --to-command='docker load' -xzf imageName 'images/*'
```
Note: The imageName can be the agent image ibm-rpta-9.2.1.tar.gz or the workbench image.
When the image is loaded, following message is displayed - Loaded image: imageFileName:versionNumber
Before pushing the Docker image to IBM® Cloud Private cluster, configure the authentication from Docker CLI. For more information, see the documentation.
Load the images to the IBM® Cloud Private cluster by using any of the following methods:
1. Use Docker to log in to the cluster and push the image:
  1. To log in from your client system to the private image registry:
```
$ docker login cluster_CA_domain:8500
```
  2. To tag the images:
```
$ docker tag imagename:tagname cluster_CA_domain:8500/namespacename/imagename:tagname
```
  3. To push the images to the cluster:
```
docker push cluster_CA_domain:8500/namespacename/imagename:tagname
```
2. Use the IBM® Cloud Private CLI to push the images:
```
bx pr load-ppa-archive --archive ibm-rpta-imageVersion.tar.gz
```
```
bx pr load-ppa-archive --archive ibm-rtw-imageVersion.tar.gz
```

What to do next

You can now set up the playback environment in IBM® Cloud Private. See Running automated tests with containerized agents on IBM Cloud Private and Running automated tests with containerized workbench and agents on IBM Cloud Private.