IBM Support

Rational Performance Tester 10.2.2

Download


Abstract

IBM Rational Performance Tester 10.2.2 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

Prerequisites include:

The version of the IBM Installation Manager required:

Back to top

[{"PRLabel":"IBM Installation Manager 1.9.1","PRLang":"English","PRSize":"1 GB","PRPlat":{"label":"Windows","code":"PF033"},"PRURL":"https://www.ibm.com/support/pages/node/1077813"}]

Installation Instructions

Back to top

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.

Back to top

How critical is this fix?

Impact Assessment
Impact Description

Recommended

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

Test Results

Close [x]

Definitions

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

Notes:
  • 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.

Back to top

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
NA

When you install Rational Performance Tester in your preferred language, the following context-sensitive help pages display the content of 10.2.1:

  • Errors Report
  • HTTP Requests
  • Product welcome page
TP-80421
After you upgrade Rational Performance Tester from 10.2.0 or later to 10.2.2, you might notice a FrameworkEvent error when you open the existing workspace that you created in the previous version of the product or a new workspace.
To work around this problem, you can perform the steps by following any of the following methods:
Method 1:
  1. Uninstall all products managed by IBM Installation Manager.
  2. Uninstall Installation Manager.
  3. Install the latest version of Installation Manager.
  4. Install Rational Performance Tester by using Installation Manager.
Method 2:
  1. Uninstall Rational Performance Tester and any products that are shell-shared with Rational Performance Tester. Note: If other products are installed in the same packaged group, you need not uninstall those products.
  2. Open Installation Manager by changing the app data location.
  3. Perform one of the following steps based on the operating system to change the data location of Installation Manager:
On Windows:
  1. Open the command-line interface.
  2. Change the current directory to the eclipse directory of Installation Manager. For example, cd C:\Program Files\IBM\Installation Manager\eclipse
  3. Run the following command to change the data location of Installation Manager:
     IBMIM.exe -dataLocation C:\ProgramData\IBM\newIMloc
On Linux:
  1. Open the terminal.
  2. Change the current directory to the eclipse directory of Installation Manager. For example, cd /opt/IBM/InstallationManager/eclipse
  3. Run the following command to change the data location of Installation Manager:
     ./IBMIM -dataLocation /var/ibm/newIMloc
On Mac:
  1. Open the terminal.
  2. Change the current directory to the eclipse directory of Installation Manager. For example, cd /Application/IBM/InstallationManager/eclipse
  3. Run the following command to change the data location of Installation Manager:
     ./IBMIM -dataLocation /var/ibm/newIMloc
Note:  newIMloc is the name of the new folder that is being created to launch Installation Manager. You can provide a name of your choice to the folder.
 
Previous known issues that still apply
ID Description
TP-51357

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.
TP-76105

If your application uses TLS1.1 or TLS1, then Rational Performance Tester cannot record or run those test assets until you modify the java.security 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 java.security 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, TLSv1.1, from the code.
  5. Save the java.security 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.
TP-73105

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 9.7.0.2.
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 libnsl.so.1 on your computer for a successful installation of the product. Alternatively, you can create a soft link from libnsl.so.2 by running the following command on the command-line interface:
sudo ln -s /usr/lib64/libnsl.so.2 /usr/lib64/libnsl.so.1
TP-66551
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.
TP-66806
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.
TP-67514

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:

IBM\IBMIMShared\plugins\-com.ibm.rational.test.lt.cmdlineexecute_7.2.3200.v<YYYYMMDD_HHMM>
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 8.0.5.35 or later that contains the latest security fixes, you can switch from OpenJDK 8 with OpenJ9 to IBM JRE. For more information, see http://www.ibm.com/support/docview.wss?uid=ibm10956413.
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 com.ibm.rational.test.lt.licensing.RPTLicenseExceptionerror 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.

Back to top

Change History

What's new

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

Back to top

Click the link in the Download Options column:

Off
[{"DNLabel":"RPT downloads and fixes","DNDate":"01 Feb 2022","DNLang":"English","DNSize":"1.5 GB","DNPlat":{"label":"Windows","code":"PF033"},"DNURL":"http://www.ibm.com/support/fixcentral/swg/quickorder?parent=ibm%7ERational&product=ibm/Rational/Rational+Performance+Tester&release=All&platform=All&function=all&source=fc","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.


Back to top

[{"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.2.2"}]

Document Information

Modified date:
14 September 2022

UID

ibm16541186

Page Feedback