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 in this section.
Unable to run Web UI tests on a remote agent on Linux
When you run Web UI tests on a remote agent that runs on Linux, the browser fails to launch.

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 in this section.
    - 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.
    - The AUT displays the 403 forbidden error
      When you record or play back a Web UI test, the application under test (AUT) fails to open and displays the 403 forbidden error.
    - 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.
    - Unable to run Web UI tests on a remote agent on Linux
      When you run Web UI tests on a remote agent that runs on Linux, the browser fails to launch.
    - Unable to record or run Web UI tests on Chrome 111 or Edge 112
      When Rational® Functional Tester opens Google Chrome 111 or Microsoft Edge 112 to record or play back a Web UI test, the browser opens with a blank page and fails to record or run the test.
    - Unable to run Web UI tests on an Android 13 device or emulator
      When you run Web UI tests in Google Chrome versions that are earlier than 110 on an Android 13 device or emulator, the browser fails to open.
    - Unable to generate tests in a Linux or Mac operating system
      When you install Rational® Functional Tester on a Linux or Mac operating system and create a test, occasionally, the test generation fails with NullPointerException.
    - 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.
    - Frequently Asked Questions
      This document answers some of the common queries in mobile testing.
  - 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.

Unable to run Web UI tests on a remote agent on Linux

When you run Web UI tests on a remote agent that runs on Linux, the browser fails to launch.

Cause

Browser launch is prevented when the remote agent runs as root or sudo.

Resolution

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:
1. Open a terminal on Linux.
2. Enter the following commands:
  cd /opt/IBM/SDP/Majordomo/
  sudo ./MDStop.sh
  ./MDStart.sh