IBM Support

Rational Performance Tester 10.5.0



IBM Rational Performance Tester 10.5.0 has been made generally available and contains new features as well as fixes for customer-reported and internally found defects.

Download Description

Table of Contents
Sections Description

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

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 Product Documentation provides an entry point to the 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:

The version of the IBM Installation Manager required:

[{"PRLabel":"IBM Installation Manager 1.9.1","PRLang":"English","PRSize":"1 GB","PRPlat":{"label":"Windows","code":"PF033"},"PRURL":""}]

Installation Instructions

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 to Rational Performance Tester 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 Performance Tester in the description field.
  6. Select Continue.
  7. Expand the eAssemblies and you will see your entitled software.

IBM OEM 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.

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:
New to this release
ID Description

When you install Rational Performance Tester Agent on AIX operating systems, you cannot select that Agent to run tests on Rational Test Automation Server.


When you install Rational Performance Tester on Windows systems, and then open a performance test report by using an internal browser, the icons are not displayed in the performance report.

To work around this problem, you must perform the following steps:

  1. Close Rational Performance Tester.
  2. Open Internet Explorer.
  3. Click Settings - Internet options, and then select the Security tab.
  4. Select Internet from the Select a zone to view or change security settings pane.
  5. Click Custom level, and then choose Enable for Downloads - Font download.
  6. Click OK to accept the changes made to the security settings.
  7. Click Apply, and then click OK to save the changes.
  8. Close Internet Explorer.
  9. Open Rational Performance Tester, and then access the performance test report.
TP-84064 The Browser tab in the Protocol Data pane does not display the recorded web pages when you perform the following tasks:
  • Install Rational Performance Tester on Ubuntu 22.04.1 LTS
  • Highlight any page from the recorded test
Previous known issues that still apply
ID Description
TP-82960 When you want to install Rational Functional Tester, Rational Integration Tester, or Rational Performance Tester on Mac OS Big Sur (11.x), you must download all of the product offerings that are contained in the Rational Test Workbench package to prevent installation errors.
TP-82022 You cannot shell share Rational Performance Tester with Rational Software Architect 9.8.0. An error message is displayed when you try to open Rational Performance Tester which is shell shared with Rational Software Architect.

To work around this problem, you must install Rational Performance Tester and Rational Software Architect in separate package groups.
TP-79188 When you use the double quotation marks ("") for the Labels or User comments options to run the test by using integration plugins, then the labels in the test result or the User Comments row of a report do not include the double quotation marks.

The integration plugins that do not support double quotation marks ("") for the Labels or User comments options are as follows:
  • Ant
  • Azure DevOps
  • MicroFocus ALM
  • UrbanCode Deploy
  • Jenkins
  • Maven
To work around this problem, you must create a command-line config file, and then run the test by using the Configfile option.

When you use the double quotation marks ("") for the labels or usercomments parameters and then run tests from the command-line interface, the command-line interface does not accept values for these parameters.

To work around this problem, you must perform the following actions based on the operating system that you used to install Rational Performance Tester:

On the Windows operating system:

1. Open the command-line interface.

2. Change the directory to a location that contains the CommandLine.exe file.

    You can locate the directory in the following location:


3. Run the test by using valid parameters.

On Windows, Linux, and Mac operating systems:

1. Create a command-line config file by using Rational Performance Tester. See Creating a command-line config file.

2. Run the test by using the -configfile parameter.


When you playback a Citrix test asset with Citrix Receiver 4.11 or later, the test asset fails to run.
To work around this problem, you must install Citrix Receiver 4.9.


If your application uses TLS1.1 or TLS1, then Rational Performance Tester cannot record or run those test assets until you modify the file. This issue is because TLS 1.1 and TLS1 are not supported by Java.
To work around this problem, you must perform the following steps:

  1. Navigate to <location_of_the_product>\ IBM\SDP\jdk\jre\lib\security.
  2. Open the file in any of the text-editing programs to edit the content. 
  3. Locate the following line of code: tls.disabledAlgorithms=SSLv3, TLSv1, TLSv1.1, RC4, DES, MD5withRSA
  4. Remove TLSv1 and TLSv1.1 from the code.
  5. Save the file.
  6. Restart Rational Performance Tester.
TP-72726 When you use a calendar dialog box to select a value in an SAP transaction session and record the SAP test in your product, the Test Generation page and the Error Log page display a warning message.
The warning message states that the SAP calendar object has an unpredictable behavior when you play back the test and you must set the date in the value fields by using the string format.
Therefore, when you select the Hide GUI during the execution option from the SAP Options tab in the Test Details section to play back the SAP test, the product is unable to create a calendar object. Hence the test run fails.
To work around this problem, you must perform the following steps:
1. Open the SAP test.
2. Perform the following actions to set the calendar date in a text format:
    a. Expand an SAP transaction, and then expand the test element (For example, IDoc List/WE05) that has the calendar control data.
    b. Select Set focus on <date>.
    c. Right-click the date from SAP Protocol Data, and then click Create Element.
       The Create Element page is displayed.
    d. Select Set text, and then enter the date in the Input value text field.
    e. Click Finish.
3. Right-click the calendar control (For example, Calendar/WE05), and then click Disable to disable the test elements that have the calendar control.
4. Save the changes, and then run the test.

You cannot shell share Rational Performance Tester with any versions of Rational Application Developer or Rational Software Architect at this moment.

If shell sharing Rational Performance Tester with Rational Application Developer or Rational Software Architect is essential, then you must use Rational Performance Tester 10.1.2 with Rational Application Developer 9.7.02 or Rational Software Architect

TP-70696 When you record an SAP test by selecting the Record from a running session started with the SAP logon option, then the schedule run fails with the following error message on the Test Log page or Execution Event Console log page:

Connection with the existing SAP GUI session or shortcut is not allowed during schedule execution

To work around this problem, you must perform the following steps:

  1. Record an SAP test that has a logon session.
  2. Place the transaction session that you created by using the Record from a running session started with the SAP Logon option.
  3. Record an SAP test that has the logoff session.
  4. Save and run the schedule to verify the transaction details.
Note: The session created by the first test is considered as the current session.
TP-69141 You must decrypt and encrypt each dataset by using the CSV Editor to apply the strongest encryption on each dataset that you used in the earlier version of the product.
TP-62667 When you install Rational Performance Tester 10.1.0 on Red Hat Linux Enterprise 8.0 or later, the installation fails with an error message.
To work around this problem, you must first install on your computer for a successful installation of the product. Alternatively, you can create a soft link from by running the following command on the command-line interface:
sudo ln -s /usr/lib64/ /usr/lib64/
When you record a Citrix test by using an ICA file, the recording fails with an error message.
You must first verify the values for the parameters DesiredHRES and DesiredVRES in the ICA file because the values for these parameters are set to 0 instead of a valid number.
To resolve this issue, you must first set a value for the parameters to record the Citrix test by using the ICA file.
On Windows Server operating systems, when you use Rational Performance Tester to run a VU schedule that has Citrix test, sometimes the playback fails because an action from the test is incorrectly played back by the Citrix receiver.
To resolve this issue, you must install Rational Performance Tester and Rational Performance Tester Agent on Windows 10 operating systems when you want to run the VU schedule that has Citrix test.
TP-67053 On Windows, there is an incompatibility between the version of Java packaged with the product (OpenJDK OpenJ9 V1.8.0_252) and AdoptOpenJDK14 when Symantec Endpoint Protection is installed.
To work around this problem, uninstall the AdoptOpenJDK14 product or remove it from the PATH before using the product.

When you run tests or schedules that have a file name with non-English characters from the command-line interface, then the test run fails with an error message.

To work around this problem, you must use CommandLine.exe to run tests or schedules from the command-line interface. You can locate CommandLine.exe in the following folder path:


TP-57089 In Rational Performance Tester 10.0.0 and later, when you set the environment variable, JAVA_HOME, to the bundled JDK that is shipped with the product, tests that run from Jenkins show a java.lang.OutOfMemoryError: Java heap space error after completion of the test run.
With 10.0.0 and later, 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 which contains the latest security fixes, you can switch from OpenJDK 8 with OpenJ9 to IBM JRE. For more information, see
When you do performance monitoring of the resources of a remote Windows computer, you specify the credentials of that computer in Rational Performance Tester. The credentials are stored in a Windows file. If the credentials of the remote computer change and you updated the credentials from Rational Performance Tester, the test run with Windows Performance Monitoring will still fail. You must restart the workbench computer and then change the credentials from Rational Performance Tester.
When you playback a test remotely such as from the command line or Jenkins, the log file in the workspace displays IllegalStateException: Workbench has not been created yet. error message. The test will execute successfully.
On Mac OS X, if you have Rational Performance Tester configured for a floating license or Authorized User License, you will get a the first time you run a schedule. The exception forces the schedule to stop the execution with a failure. After the initial failure, all subsequent runs of schedules would pass without the above-mentioned error.

Open defects

Review the following list of open defects for Rational Performance Tester on the IBM Support Portal.

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.

Change History

What's new

Review the Release notes for IBM® Rational® Performance Tester to find information about the new features.

Click the link in the Download Options column:

[{"DNLabel":"RPT downloads and fixes","DNDate":"15 Sep 2022","DNLang":"English","DNSize":"1.5 GB","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 developerWorks 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 development 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.

[{"Type":"MASTER","Line of Business":{"code":"LOB45","label":"Automation"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSMMM5","label":"IBM Rational Performance Tester"},"ARM Category":[{"code":"a8m0z000000boAZAAY","label":"Documentation"}],"ARM Case Number":"","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF017","label":"Mac OS"},{"code":"PF033","label":"Windows"}],"Version":"10.5.0"}]

Document Information

Modified date:
15 September 2022