Home
Rational® Functional Tester
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.
Troubleshooting in the UI Test perspective
You can find information about the issues or problems that you might encounter while working with Rational® Functional Tester in the UI Test perspective. Details about issues, their causes and the resolutions that you can apply to fix the issues are described.

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
  You can learn to start using Rational® Functional Tester by reviewing the information in the Tutorials for the UI Test perspective and Functional Test perspective.
- Samples
  You can find the sample project that you can use 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.
- 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.
  - Troubleshooting in the UI Test perspective
    You can find information about the issues or problems that you might encounter while working with Rational® Functional Tester in the UI Test perspective. Details about issues, their causes and the resolutions that you can apply to fix the issues are described.
    - Frequently Asked Questions
      This document answers some of the common queries in mobile testing.
    - Unable to play back Web UI tests when certain web applications are redirected to a different URL
      When you record a Web UI test and enter the URL of the web application that you want to test, the application might be redirected to a different URL. When you play back this recorded Web UI test, the playback fails.
    - Unable to open a browser for the Web UI test playback
      When you play back a Web UI test, the test fails occasionally before Rational® Functional Tester opens a browser.
    - Unable to run a distributed test with the Save as option
      When you use Run Distributed Tests for Web UI tests, and you select the Save as option to save the test assets as an AFT Suite in an XML file, the playback does not initiate.
    - Unable to verify content in a Windows test
      When you play back a Windows test with a content verification point, the test fails to verify the text content.
    - Rational® Functional Tester error messages
      This section provides information about error messages that you might encounter with Rational® Functional Tester. This section lists the error messages by ID, explanation, system action and your response to correct the error message.
  - Troubleshooting in the Functional Test perspective
    In this section, you will learn how to troubleshoot the tests in the Functional Test perspective.
- 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.

Troubleshooting in the UI Test perspective

You can find information about the issues or problems that you might encounter while working with Rational® Functional Tester in the UI Test perspective. Details about issues, their causes and the resolutions that you can apply to fix the issues are described.

The troubleshooting issues are presented to you in the following table based on where or when you might encounter these issues:

Troubleshooting issues: test runs

Table 1. Troubleshooting issues: test runs
Problem	Cause	Solution
You are not able to run Web UI tests on a remote agent that runs on Linux because the browser fails to launch.	Browser launch is prevented when the remote agent runs as `root` or `sudo`.	To resolve this issue, you must perform the following steps after you have installed the remote agent: Stop the agent. Start the agent as the logged in user by performing the following steps: Open a terminal on Linux. Enter the following commands: cd /opt/IBM/SDP/Majordomo/ sudo ./MDStop.sh ./MDStart.sh