IBM Support

Rational Test Workbench Eclipse Client 8.7



Rational Test Workbench Eclipse Client (RTWec) 8.7 has been made generally available and contains new features as well as fixes for client-reported and internally found defects

Download Description

Table of Contents
Sections Description

The Change history section provides an overview on what is new in this release with a description of any new functions or enhancements when applicable.

The How critical is this fix section provides information related to the impact of this release to allow you to assess how your environment may be affected.

The Prerequisites section provides important information to review prior to the installation of this release.

The Download package section provides the direct link to obtain the download package for installation in your environment.

The Installation instructions section provides the installation instructions necessary to apply this release into your environment.

The Known side effects section contains a link to the known problems (open defects) identified at the time of this release.

Supporting Documentation
Document Description

Click to review the detailed system requirements information for a complete list of hardware requirements, supported operating systems, prerequisites and optional supported software, with component-level details and operating system restrictions.

IBM Knowledge Center provides an entry point to product documentation. You can view, browse, and search online information related to the product.

Click to review a complete list of the defects (APARs) resolved in this release including a list of resolved defects for the entire version family.

Find technical developer content and resources.


Prerequisites include:

Version of IBM Installation Manager required: IBM Installation Manager 1.7.3 or later.

Installation Instructions

Review the Installing page in the IBM Knowledge Center.

Download the software from Fix Central.

  1. After download completes, open the Installation Manager, click File, and select Preferences.
  2. Click Add Repository and browse to the location of the folder that contains the downloaded files.
  3. Start the IBM Installation Manager.
  4. Click Update and follow the instructions in the wizard.

Download Package

Download options
Access type Description

Passport Advantage and Passport Advantage Express clients are required to sign in to download the software package.

If you are entitled for Rational Test Workbench Eclipse Client and need to download your software from Passport Advantage, perform the following steps:

  1. Logon to Passport Advantage.
  2. Select Software Downloads and Media Access.
  3. Select the Download Finder.
  4. Select Find by description or part number.
  5. Select the Product Description and All radio buttons and enter Rational Test Workbench Eclipse Client in the description field.
  6. Select Continue.
  7. Expand the eAssemblies and you will see your entitled software.

IBM Software Group OEM offerings are designed for partners who develop and sell business solutions with embedded or bundled IBM middleware software. Clients with Flexible Contract Type (FCT) license purchases and IBM Business Partners must sign in to download the software package.

Fix Central provides fixes and updates for your system's software, hardware, and operating system.

How critical is this fix?

Impact Assessment
Impact Description

This is a service release. It contains new features as well as fixes for client-reported and internally found defects.

Test Results


Regression: An error in the Maintenance Delivery Vehicle (MDV) that produces incorrect or unexpected behavior causing a supported feature to stop functioning as designed.
This includes:

  • Coding errors that cause a regression
  • Documentation or packaging problems that cause a regression
  • Errors reported in a new function delivered in a MDV that cause a regression

Incomplete: An error in the MDV has not regressed, but does not work as designed.
This includes:

  • Fixed APARs which did not solve the original problem but did not break anything new
  • APARs reporting documentation errors, such as readme errors, that cause problems applying an MDV but do not lead to a regression

  • Regression and incomplete APARs are considered fix-in-error or MDV-in-error
  • Definitions above apply only to valid APARs that result in product fixes (APARs returned as working-as-designed are not assessed for being fix-in-error)
  • Issues in major releases due to new functionality do not apply in this definition

There are no known regressions to report.

Problems Solved

Defects resolved

Click the Fix List link in the table of contents above to review a list of the problems solved in this release.

Known Side Effects

Review the following list of known issues and open defects:

Open defects

Review the following list of open defects for Rational Test Workbench on the IBM Support Portal page.

Review technote 1461170: Open APARs for Rational products available on the Web for information on how to configure your MyNotifications subscription account and subscribe to the APARs you are interested in following.

Known Limitations


If you install Rational Test Workbench Eclipse Client on Macintosh OS, the IBM Rational Quality Manager and IBM Rational Team Concert Jazz clients are not available with the installer. To use the Jazz clients on Macintosh, you must download the P2 update site compressed files from and install them using the native Eclipse client.

Ability to initiate Rational Test Workbench tests from IBM UrbanCode Deploy is supported only for Microsoft Windows and Linux computers. The feature is not supported on Macintosh computers.

Limitations in Mobile extension

Limitations with iOS 8 support:

iOS 8 support on physical devices is currently limited to manual tests of a single app. This iOS limitation exists on iOS 8, iOS 8.0.1, and iOS 8.0.2. You can implement test automation scenarios using the native client running in an iOS Simulator or upgrade the device to iOS 8.1.1 or later. Full support for automated testing on iOS 8 devices is dependent on Apple's response to a defect filed against iOS 8.

Windows users must use the command line or iTunes to install instrumented apps on iOS 8 or later devices. Installing instrumented apps using the test workbench UI on a Windows computer is not currently supported on iOS 8 or later devices.

Web app testing on iOS 8 devices and simulators require at least the 8.6.1 version of the IBM Rational Mobile Web Recorder.

iOS 8 support requires the most recent version of iTunes.

When you use the Rational Test Workbench Mobile Test Client on iOS simulators, the mobile test client do not display the iOS version. Instead, it displays the version number of Macintosh operating system.

Mobile performance testing limitations:

Resource monitoring is supported only when the test run is initiated from the Rational Test Workbench Eclipse client.

Resource monitoring is not supported with the iOS native client of Rational Test Workbench Mobile Client on simulators. However, iOS web client can be used to test on both devices and simulators.

Resource monitoring is not supported for apps that invoke other apps or processes during test execution.

Mobile performance resource monitoring counters limitations:

A counter indicating battery level is available only at the device level.

A counter indicating virtual memory is available only for the application being tested.

Application-specific network data for Android apps is supported on Android 4.4.2 and later on only mobile devices.

Application-specific network data for iOS apps is captured based only on the most commonly used network communication APIs, and not all APIs.

Limitations in Web UI extension

The following actions are not supported in both Web UI recording and playback:

Controls inside frames are not supported for web browsers accessed from a computer

Shortcut keyboard keys

Scroll bar action in the web browser

Context menu action

Native browser dialog boxes

The following actions are not supported in Web UI recording, but you can add them manually in the test editor for a successful playback:

Back and Forward browser navigation action

JavaScript alert dialog boxes such as confirmation and prompt messages

Mouse hover action

Playback is not supported on a browser window that is launched with the showModalDialog API.

Sometimes the playback of a multiwindow test fails to execute on Internet Explorer. This limitation is observed primarily after you switch from the second window to the first and click a link in the first window.

Sometimes the playback on the Google Chrome browser displays an Internal Error. The Problem Determination log in Eclipse has references to "StaleElementException."

Sometimes the playback on Internet Explorer shows an Internal Error. The Problem Determination log in Eclipse has references to "Unable to get browser."

Sometimes the application under test becomes unresponsive during record/playback time. This happens primarily if the application refreshes regularly using Ajax requests.

The Web UI extension is not supported on a Turkish Macintosh computer.

Recording and playback for multiple windows in the Apple Safari browser is not supported.

Using multiple monitors with workbench running on one monitor and browser on another for an extended view is not supported.

Due to a limitation in the Selenium web driver, the Web UI extension does not support JavaScript alerts in the Apple Safari web browser.

If a Web UI test with loop is played back in a mobile device on the Chrome browser, after the first loop completes, the browser opens an empty tab due to which the Rational Test Workbench web client switches to non-passive state. For the next loop to start, the user has to manually set the device to passive mode.

Change History

What's new


Support for running workbench tests from IBM UrbanCode Deploy. For more information, see: IBM Rational Test Workbench Eclipse Client plugin.

Support for working with IBM Rational Functional Tester tests in IBM Rational Test Workbench Eclipse Client. See Working with functional tests.


Support for simultaneous test execution on multiple devices. See Running tests on multiple devices in parallel.

Support for USB-tethered Android devices, testing Android applications in secure environments, and silent installation on all versions of Android OS. See Installing and configuring the Android client with the USB Controller.

Support for testing pre-installed apps on Android devices. See Testing pre-installed applications on Android devices.

Support for measuring response times at the application, server, and network level. See Evaluating response time results.

Additional features include improved support for orientation changes and verification points.

Web UI

Enhanced browser support, including support for the Apple Safari browser and the ability to record and play back Web content inside an iFrame. See Enabling the Apple Safari web browser on a Macintosh computer.

Enhanced recognition for recording complex objects with dynamic controls.

Click the link in the Download Options column:

[{"DNLabel":"RTWec 8.7","DNDate":"13 Mar 2015","DNLang":"English","DNSize":"1","DNPlat":{"label":"Windows","code":"PF033"},"DNURL":"","DNURL_FTP":" ","DDURL":null}]
[{"Product":{"code":"SSBLQQ","label":"Rational Test Workbench"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Eclipse Client","Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"8.7","Edition":"","Line of Business":{"code":"LOB36","label":"IBM Automation"}}]

Problems (APARS) fixed

Document Information

Modified date:
20 July 2018