IBM Support

Rational Test Automation Server Fix Pack 1 ( for 10.0.2



IBM Rational Test Automation Server V10.0.2, Fix Pack 1 was made generally available and contains fixes for customer-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 the documentation. You can view, browse, and search the online information.


Prerequisites include:

Review Prerequisites for installing the software on Linux or Prerequisites for installing the software on Windows in the IBM Knowledge Center prior to installing.

Installation Instructions

Review Installing the software on Windows or Installing the software on Linux in the IBM Knowledge Center.

Download Package

Click the FC link below to obtain the release from Fix Central.

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

Known Side Effects

Review the following list of known issues and open defects:

Review the following list of known issues.

Rational Test Automation Server is a component of IBM's comprehensive test solution, Rational Test Workbench. Fix packs are made available separately for each component of Rational Test Workbench.

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 issues in this release include:

New to this release
TP-63794 When you back up the server, large amounts of additional disk space can be used. To reduce the disk space used, you should first remove the execution container volumes. 
When you install Rational Test Automation Server on a Windows computer where the Git version is different from Git 2.19.0 or 2.22.0, the installation fails at the "Prepare Server" stage and the following error is displayed:

grep: -P supports only unibyte and UTF-8 locales 
./ line 53: [: : integer expression expected 
Error: Upgrade docker-compose to v1.21+. See

You can resolve this error in one of the following methods: 
Method 1: 
You can follow these steps to resolve the error: 
1. Downgrade Git either to V2.19.0 or 2.22.0.
2. Go to Add/Remove programs and uninstall the product. 
3. Install IBM Rational Test Automation Server again. 

Method 2: 
You can follow these steps to resolve the error: 
1. Open the inventory.yml file that is located in <install>/ibm-rtas/automation/execution/ 
2. Enter your license URL, for example, 27000@, in the RATIONAL_LICENSE_FILE field for both the API and workbench services. 
3. Save and close the file. 
4. Open Git Bash (regardless of the version of Git). 
5. Change the directory to your installation folder, which is by default "C:\Program Files\IBM\ibm-rtas" 
6. Run the following command: ./ <hostname> 
7. Run the following command: ./ ​​​
TP-63149 Intermediate <none>:<none> Docker images are represented as is and cannot be selected individually in Resource Monitoring counters. 
TP-63156 Docker images that are created with no tag are assigned the "latest" tag. As the "docker ps" command does not show the "latest" tag anymore since the Docker 19.03.05 release, the Docker images are not detected and not correctly monitored.
Previous known issues that still apply
TP-60737 Git repositories that contain projects at the root level and not under a subdirectory are notsupported and will not work currently with Rational Test Automation Server.
TP-61897 If you restore a backup, it fails due to existing execution containers. For a workaround, see Troubleshooting installation.
TP-62379 If you (as a user) request to join an orphaned project, a 404 not found error results.

To workaround this problem, ask your administrator to become the project owner, then request to join that project again.
TP-61311 When you archive a project that has a running test, that test is not stopped. The test completes execution even though it was suppose to stop.
TP-61494 If you unarchive a project that was archived while a test was running, the UI incorrectly shows that the test is still running after the unarchive.

To workaround this problem, make sure there are no tests running when you archive a project.
TP-61446 When you unregister a remote docker agent, running and schedule tests are not canceled.

To workaround this problem, stop any running tests and cancel any scheduled future executions for that agent before unregistering the remote docker agent.
If you back up a project with both API suites and stubs on Rational Test Automation Server V10.0.0, when you restore that backup on Rational Test Automation Server V10.0.2, the stubs are missing.
To workaround this problem, you can create a new project or you can move the existing GIT repository folder to a sub folder of the current repository and then move it back to the root directory.
For example, a project contains a Git repository called Calculator.git in the root (/) folder. When you edit the root folder, you can see several other Git repository folders:
You select another folder, for example Calculator, and save.
The Git repository called Calculator.git is now in the Calculator folder.
You edit the Calculator folder, select the root folder, and save.
The Git repository is now in the root (/) folder again.
If you want to add multiple repositories to a Rational Test Automation Server project, you cannot add another repository until the last repository completes its synchronization.
To workaround this problem, wait for the last repository to synchronize, then add another repository to your project.
TP-61153 The project search field is case-sensitive. For example, if your project is named MYPROJECT and you search for myproject, Rational Test Automation Server does not show any results.
When upgrading from a previous release to V10.0.2, users might see a 500 error when accessing datasets. This problem can be resolved by performing the following step:
Add the following environment variable to automation/docker-compose.yml in the Rational Test Automation Server installation directory. The line must go under the "datasets-app: environment:" section (located around line 128). Then reboot the server.


Note: Adding this environment variable will cause saved datasets options (for example, current row) to be reset to the default upon server startup. Other migrated data will be unaffected. The environment variable must be removed once the issue is resolved.
When you enter a URL for a test result directly into a browser or you click a link to a test result in the Jenkins console output from the Jenkins Rational Test Automation Server plugin, and you are not logged in to Rational Test Automation Server, you see the following message:
 "Request cannot be processed: Unauthorized" page.
To workaround this problem, log in to Rational Test Automation Server and then enter the URL or click the test result link to see the test result in a browser.
TP-62338 An IBM WebSphere MQ stub that is configured to use more than one transport does not appear on the Execution page of the Rational Test Automation Server.
TP-62417 A user who is no longer a member of a project might be displayed in the Secrets tab. If a user is removed from a project and then added back to that project, the user will have the same access to secrets as they had before being removed. 
TP-59139 During the installation of Rational Test Automation Server the following error message is shown and can be safely ignored:
139836115718592:error:2406F079:random number generator:RAND_load_file:Cannot open file:../crypto/rand/randfile.c:88:Filename=/root/.rnd
TP-60059 When you schedule a test run and click the "Time" field a list of times displays. If you enter a value in the "Time" field, you cannot move the cursor by using the left or right (<- , -> ) keyboard keys. This is a known issue with the following date picker:

To workaround this problem, use the cursor.
TP-59943 If you configure Keycloak to use an LDAP directory service, you should import and synchronize LDAP users to Keycloak. This is a known issue with Keycloak:

To workaround the problem in Keycloak, on the Add user federation provider page make sure the following settings are set as shown:

Import Users = ON, Sync Registrations = ON, and Cache Policy = DEFAULT
TP-58017 In case of a slow network, the cloning of a repository might fail with an error. In such a case, you can delete and add the repository again.
TP-58292 If you interrupt the installation or uninstallation of the Rational Test Automation Server software, the installation or uninstallation cannot complete. For a workaround, see Troubleshooting installation.
TP-57543 If the server hostname is changed, it is necessary to run ./ and log in to the Keycloak Admin Console to change the 'testserver' client URLs. Otherwise, you will see Invalid parameter: redirect_uri on the Login page.
TP-58104 When monitoring a test execution with the Statistical report, data might stop updating after about an hour. To get updated data, reload the page in your browser.
TP-58061 A server shutdown will not stop currently running executions. It is recommended to not shutdown the server if there are active executions running. If the server is shut down while assets are executing the reported status of those executions might be incorrect.
TP-58017 In case of a slow network, the cloning of a repository might fail with an error. In such a case, you can delete and add the repository again.
TP-57971 After adding a repository to a project, you see a GREEN status indicator. When you remove the ssh key from Github, the GREEN status changes to RED. When you update Github with a new ssh key and update the same for the repository in Rational Test Automation Server, the status indicator does not immediately change to GREEN but it does change to GREEN after a couple of minutes.

Rational Test Automation Server for Windows is provided for evaluation purposes. It is intended for non-production use, for exampletrials and demonstrations. It is neither supported nor recommended for production use due to insufficient stability and reliability of Docker for Windows while running Linux images at the time of release.

Rational Test Automation Server is tested on both Windows 10 and Windows Server 2016 Standard Edition and it operates correctly. However, it is suitable and supported for non-production use only.  If native Linux is unavailable, you can run Rational Test Automation Server for production use on a Linux virtual machine on their Windows host, provided that the Linux virtual machine is running a supported version of Linux.


When working in multiple Rational Test Automation Server tabs concurrently, a message “You are already logged in” might sometimes be displayed. This message occurs when your session has expired and you have since logged in again, but then attempt a navigation action in a browser tab other than the one in which you logged in.

This is a known Keycloak issue. For more information, see To workaround this problem, close the tab and open a new one.

TP-56453 After about 20 minutes of an inactive browser session for Rational Test Automation Server, if you attempt to use the existing browser session, you must authenticate again by providing your username and password. When you do so, the message "You took too long to log in. Try again.“ is displayed and you must enter your credentials again.
Rational Performance Tester Agent

With 10.0, you might expect a reduction in the number of Virtual Users (VUs) supported by IBM Rational Performance Tester Agent depending upon workload characteristics. This variation is the result of the product shipping with OpenJDK™ 8 with OpenJ9 instead of IBM JRE.

OpenJDK 8 with OpenJ9 JRE exhibits a higher utilization of CPU for the workload. Up to 30% or more decrease in the supported VUs capacity may be expected for CPU-bound workloads. However, for memory-bound workloads, a much smaller, if any reduction in VUs capacity may be expected.

If you need higher performance and have access to IBM JRE or later that contains the latest security fixes, you can switch from OpenJDK 8 with OpenJ9 to IBM JRE. For more information, see

Change History

What's new

Review the Release notes in the IBM Knowledge Center. 
As this release is a fix pack release, the IBM Knowledge Center is not refreshed. 

[{"DNLabel":"RTAS downloads and fixes","DNDate":"12 Mar 2020","DNLang":"English","DNSize":"250000000 B","DNPlat":{"label":"Windows","code":"PF033"},"DNURL":"","DNURL_FTP":"","DDURL":null}]

Technical Support


Tab navigation



IBM Rational Software Support Communities

  • Visit the IBM Support Portal to configure your support portal experience and review FAQs, lists of known problems, fixes, and a wealth of important support information.

  • Visit IBM Developer to access an online collection of tutorials, sample code, standards, forums and other resources provided by experts at IBM to assist software developers using Rational tools including access to the IBM RFE Community.

  • Visit the Jazz Community if you use a Rational product created using the Jazz platform to interact directly with the Jazz development team and other community members, download product trials and betas and track developement progress.

Helpful Hints For Obtaining Technical Assistance:


Before you contact IBM Rational Software Support, gather the background information that you need to describe the problem. When you describe a problem to an IBM software support specialist, be as specific as possible and include all relevant background information so that the specialist can help you solve the problem efficiently. To save time, know the answers to these questions:

  • What software versions were you running when the problem occurred?
  • Do you have logs, traces, or messages that are related to the problem?
  • Can you reproduce the problem? If so, what steps do you take to reproduce it?
  • Is there a workaround for the problem? If so, be prepared to describe the workaround.

If you have helpful information to diagnose or identify the problem on your system, you can provide this data by following the instructions to exchange information with IBM Technical Support.


[{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSBLQQ","label":"IBM Rational Test Workbench"},"Component":"Rational Test Automation Server","Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
17 November 2021