Rational Test Automation Server V10.0.1

Download Description

*Table of Contents*
Sections	Description
What's new	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.
Impact assessment	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.
Prerequisites	The Prerequisites section provides important information to review prior to the installation of this release.
Download package	The Download package section provides the direct link to obtain the download package for installation in your environment.
Installation instructions	The Installation instructions section provides the installation instructions necessary to apply this release into your environment.
Known problems	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
Detailed System Requirements	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	IBM Knowledge Center provides an entry point to the documentation. You can view, browse, and search the online information.

Prerequisites

**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.

Back to top

Installation Instructions


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

Back to top

Download Package

*Download options*
Access type	Description
Passport Advantage	Passport Advantage and Passport Advantage Express clients are required to sign in to download the software package. If you are entitled for Rational Test Automation Server and need to download your software from Passport Advantage, perform the following steps: Logon to Passport Advantage. Select Software Downloads and Media Access. Select the Download Finder. Select Find by description or part number. Select the Product Description and All radio buttons and enter Rational Integration Tester in the description field. Select Continue. 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

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-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: https://github.com/Hacker0x01/react-datepicker/issues/1834 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: https://issues.jboss.org/browse/KEYCLOAK-11191 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-59774	When checking in a project without a root directory an error is thrown while at the Execution dialog box that does not allow you to select an environment, nor does it remember your selection of secrets. Do not check-in desktop projects to the root of the Git repository. All checked-in desktop projects must contain a parent directory within the Git repository. For example, if the desktop project contained the following assets: -MyProject/.project -MyProject/MyTest.testsuite Then the Git repository should contain -MyProject/.project -MyProject/MyTest.testsuite and not just /.project -> Will cause an error /MyTest.testsuite
TP-58572	Execution results with status "Complete with Error" or "Launch failed" are displayed with inconsistent colors. In verdict statistics views (in Overview and Results pages) they are displayed in blue, whereas in the detail tables they are displayed in red.
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.
Previous known issues that still apply
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 ./prepare.sh 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-58125	The Rational Test Automation Server does not currently remove Docker containers after they have exited. The containers will exist in a 'stopped' state but should consume only disk resources (not memory). The Docker command docker ps -a shows both running and stopped containers. This problem is normally not an issue but if the list grows large it consumes disk resources or might make it difficult to find other stopped containers. On Rational Test Automation Server (assuming Linux), to view stopped execution containers, use the following Docker command: docker ps --filter "status=exited" \| grep 'EC_[0-9]' \| awk ' {print $1}' To remove stopped execution containers from the system, use the following Docker command: docker ps --filter "status=exited" \| grep 'EC_[0-9]' \| awk '{print $1} ' \| xargs docker rm
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-58024	Rational Test Automation Server Login and Account Settings pages are only available in English.
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.
TP-57832	Rational Test Automation Server for Windows is provided for evaluation purposes. It is intended for non-production use, for example, trials 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.
TP-57198	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 https://issues.jboss.org/browse/KEYCLOAK-5179. 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 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.