IBM Support

Rational Performance Test Server 8.5.1



Rational Performance Test Server 8.5.1 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.

This section provides information related to the impact of this release to allow you to assess how your environment may be affected.

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

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

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

The information center provides you with user assistance for the product. You can view, browse, and search online information related to the product. You can also visit IBM Product information page to browse for additional information centers.

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.


Prerequisites include:

Version of IBM Installation Manager required: IBM Installation Manager 1.7

Installation Instructions

Review the installation guide:

For instructions on how to install the Rational Performance Test Server 8.5.1, review the Install instructions linked below.

Additional information:

Important notes about upgrading to Rational Integration Tester 8.5.1 from earlier versions

  • If you are upgrading from an earlier version of GH Tester, GH Performance or GH VIE then you must read the upgrade instructions before installing the new versions. This details specific steps you must take and issues of which you should be aware. The upgrade instructions are in this technote: Upgrading from GH Tester, GH Performance and GH VIE

  • For Performance Testing and Service Virtualization you will require an installation of Rational Integration Tester Agent from the Rational Performance Test Server or Rational Test Virtualization Server products respectively. These are licensed separately from Rational Test Workbench. Please contact your sales team for detailed information.

  • It is not possible to upgrade to version 8.5.1 of Rational Integration Tester, Rational Test Control Panel, Rational Integration Tester Agent or Rational Integration Tester Platform Pack from any versions prior to 8.5.0. This is due to a significant upgrade in the version of the Eclipse framework used by the products in this release. If you already have a version prior to 8.5.0 of any of these products installed, then you must uninstall it before installing the new version.

The various components of Rational’s Virtualization Environment are designed to work together. In normal operation all components (RIT, RTCP, the Agents, proxies and exits) must all be at the same version otherwise version-mismatch errors will occur. However, in order to make the upgrade process easier, Rational Test Control Panel 8.5.1 will operate correctly with version 8.0.1.x of RIT, the Agents and proxies. The Agents and proxies will also operate correctly with 8.0.1.x versions of RIT. This allows an organization to upgrade RTCP instances to 8.5 first, then to upgrade agents and proxies and finally to upgrade individual instances of RIT. Careful planning must be given to the upgrade process.

Rational Integration Tester
For Rational Integration Tester your Library Manager settings and most user preferences should be preserved during this uninstall/reinstall process. During the installation of 8.5.1 you should choose to run Library Manager at the end of the process and confirm the settings are correct. Note that perspective and dialog layout preferences will have been reset.
Users of Rational’s floating license server will need to set-up the license server host name again after installation. To do this enter the Manage License area of Installation Manager and enter the floating license hostname details.

Rational Integration Tester Agent
The Agent’s Library Manager settings should be preserved during the uninstall/reinstall process. During the installation of 8.5.1 you should choose to run Library Manager at the end of the process and confirm the settings are correct. After installation you will also need to configure the Agent.config file (e.g. RTCP and RQM settings). You may find it useful to take a copy of this file prior to uninstallation so that you can copy over values.

Rational Test Control Panel
If you wish to preserve your Rational Test Control Panel workspace (published stubs, user configuration, domains and environments) then when uninstalling the previous version please ensure that you do not select the option to remove the workspace. When installing the 8.5.1 version please ensure that the workspace directory is set to the same location as your existing workspace. Later versions of the RTCP uninstallation process state the location of the workspace directory and you should make note of this. Earlier versions of the uninstaller do not provide this information in which case you should open the following file to determine the workspace location:

<RTCP install location>\webapps\RTCP\WEB-INF\classes\
And look for the line containing the ‘workingDirectory’ key.  

Rational Integration Tester Platform Pack
Before uninstalling the HTTP/TCP proxy you should take a copy of the registration.xml file (which contains RTCP location, https set-up and forwarding rules) so that these values can be re-applied after upgrading the proxy to the 8.5.1 version.
After installing the Platform Pack you should upgrade existing Tester JDBC driver installations by copying the new driver over the existing files.

  • Release 8.5.0 of Rational Integration Tester requires a new database schema for the Tester Results database (also known as the project database). Since version 5.4 of GH Tester (including versions 8.0.0 and 8.0.1 of Rational Integration Tester) the database schema in use has been version 1.9.24d. Version 8.5 requires schema 1.9.24e. Until the database schema has been upgrade it will not be possible to store results to the database. If you are upgrading from a version of Rational Integration Tester prior to 8.5.0 then you must perform the schema upgrade. If you already have version 8.5.0 installed, then no further schema updates are required.
  • This schema upgrade is required in order to provide Unicode compatibility for the Microsoft SQL Server database.

  • Previous versions of Rational Integration Tester (including GH Tester 5.4) will operate correctly against schema 1.9.24e. This means that the Results database can be upgraded first and then individual copies of Rational Integration Tester can be upgraded over time.

  • As with previous schema upgrades an upgrade script is provided for each of the four supported results databases. This script can only be run on a database that is already at version 1.9.24d. If your Results database is an older version than this then you must run previous upgrade scripts, in order, to get it to 1.9.24d before attempting the 1.9.24e upgrade.

  • Users should ensure that their Results database is backed up before attempting to run the upgrade scripts.

  • For Microsoft SQL Server every varchar column that could contain Unicode characters is changed to an nvarchar column (whilst preserving the contents). For DB2, Oracle and MySQL databases the 1.9.24e upgrade does not actually make any changes to the structure of the database. It simply marks the database as now being the 1.9.24e version in order to keep version numbers consistent across the four databases.

[{"INLabel":"Installing Rational Performance Test Server","INLang":"English","INSize":"2500","INURL":""}]

Download Package

Download options
Access type Description

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

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 of Rational Performance Test Server. 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 issues to report.

Problems Solved

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

The following reported defects were not resolved in this release:

Review the following list of open defects.


Rational Test Workbench Eclipse Client
Open file browser does not work while recording a JQuery WL app.
Mobile test generation takes a long time.
Record and playback double tap in Android app: Double tap actions are relative to gesture recognizer which are not yet supported
Rational Integration Tester

The following error message might be displayed when you work with database stubs in Rational Integration Tester, such as when you edit stored procedures or add tables to the stub.

The column name IS_AUTOINCREMENT is not valid.

This error is caused by an old version of the Microsoft JDBC Driver for SQL Server. To fix this, update the "Microsoft JDBC Driver 4.0 for SQL Server" field in Library Manager with the latest version of sqljdbc4.jar.

If a user installs Rational Integration Tester on any supported version of Microsoft Windows and another non-admin user attempts to run it then an error will occur when Library Manager or Tester is started. This is caused by the installation process setting security on a number of .ini files so that only the original installing user (or another admin user) can access them. This is documented in technical note

CICS DPL virtualization JVM process

When using the CICS DPL virtualization solution the CICS JVM process must be configured to have a maximum Java heap size of at least 512M. In IBM’s testing values of less than this led to JVM failures during recording or virtualization of CICS programs.


Side-by-side installation of different versions of Rational Integration Tester is not supported. If such installations are performed then users should note that the multiple versions will share the same start-up splash-screen cause confusion in the version numbering. Help/About must be used to determine the correct version number.


After uninstalling Rational Integration Tester Agent, Rational Test Control Panel or the Proxies on a Windows XP machine some users have reported seeing the error “Problem with executing "C:\Program Files\IBM\RIT-AgentNonDefault\prunsrv.exe" in the Installation Manager log. This problem has no functional impact; the product will still have correctly uninstalled.


If a performance test is configured to start a stub on RTCP and that stub is already running then another instance will be (correctly) started for the performance test. However, when the performance test stops, both instances of the stub will be stopped, not just the one that was started for the test. Note that this does not apply to stubs which are already running which are not configured to be used in the performance test; they will continue to run after the test ends.


When an RTCP scenario is loaded into RIT (via either the Test Suite scenario editor or the Performance Test configuration dialog), scenarios for all domains / environment are listed rather than just the domain/environment the user is currently working in. If the test is then executed in an environment in which the stubs in the scenario have not been published too they will fail to start.


Some users have reported that it can take a long time (up to two minutes) for Library Manager to display on Solaris SPARC systems.


On Windows installations the Rational Integration Tester Agent can write a logfile (derby.log) into the install directory at runtime. This will happen when the Agent cannot determine the ‘instance location’ which is normally set by the derby.system.home property. This file will be left on uninstall meaning the directories will not be entirely cleaned out.


If a user has run a stub from a project on an Agent via Rational Test Control Panel, stopped that stub (but left the project deployed to the agent – i..e has not run other stubs on that Agent yet) and then publishes a new version of the stub from the same project number to RTCP and then immediately attempts to start that stub then a failure will occur. This is because Rational Test Control Panel believes that the project already deployed to the Agent contains the new stub and instructs the Agent to start it without deploying the new version of the project file. A workaround to this is to use the Stop All Stubs option on the RTCP dashboard which forces all projects to be cleared out from Agents.

37942IBM WebSphere MQ queue manager permissions: For instructions on defining the user permissions required for using the MQ Exit with IBM Rational Test Workbench (RTW), see IBM WebSphere MQ Exit queue manager settings.


Users should note that JDBC database virtualization is not supported against IBM DB2 version 8.x. The oldest supported version of DB2 for JDBC virtualization is 9.5 (on distributed) and 9.1 (on System z).


If, when importing a .NET object into Rational Integration Tester’s Schema Library, a user chooses a file that is not a .NET assembly (e.g. an xml file) then errors can occur. These errors occur in Windows native libraries and cannot be handled by RIT. In the 8.5 release RIT does some additional checks before attempting to ask the native libraries to load the assembly to reduce the number of error conditions. However, errors may still occur if a user attempts to load a file that is not a .NET object into RIT.


If a Rational Integration Test suite scenario has a reference to a (local) stub as ‘blank’ in the References grid (i.e. not ‘Live System’ and not a specifically selected stub) and a stub is already running for the referenced operation then, when the test suite starts, the running stub will be stopped by RIT (thus reverting message to the live system). This may cause user confusion as they had not explicitly configured the scenario for ‘live system’. Note that this can be worked around by explicitly stating which stub should be used in the scenario editor.


Use of –clean argument when Tester or Library Manager will not start

Problems can sometimes occur when Rational Integration Tester does not properly resolve multiple versions of the same JAR file correctly. Multiple versions may be present within an installation because third party JAR files may each include a different version. If incorrect dependency information is stored within the Eclipce workspace cache then it will not correct itself. One common symptom of this problem is that when a user runs Tester, the splashscreen appears, then disappears but Tester never starts. The same issue can occur when running Library Manager, although in this case, as there is no splash screen, it will appear to the user as if Library Manager has just failed to start.

Although one workaround is to uninstall and re-install Tester it is possible for a user to force cached dependency information to be removed and re-evaluated and, in the majority of cases, the problem will then correct itself.
To force the Eclipse environment to delete dependency information GHTester.exe must be started from the command line with the -clean argument specified. i.e., from within the installed directory:
GHTester.exe –clean on Windows and ./GHTester –clean on Linux.
Rational Integration Tester will take longer than usual to start when -clean is specified.
For Library Manager use:
LibConfig.exe –clean on Windows and ./LibConfig –clean on Linux.
The same problem can occur in RTVS and RPTS installations with the RIT Agent. In this case diagnosis and remediation is more difficult as there are multiple executable files and the correct one must be used. In these cases IBM’s Support team should be contacted.

39739When upgrading the Rational Integration Tester Agent on the Windows Server 2008 platform then, if the existing Agent is installed as a Windows server it is advisable to stop the service before attempting to perform the upgrade otherwise errors may occur. To do this, open Control Panel to: Control Panel\System and Security\Administrative Tools, then stop the 'IBM RIT Agent' service.

38668When a user creates a subfolder under an operation in Rational Integration Tester, then creates a stub in that subfolder and then publishes the stub to Rational Test Control Panel, the stub will not be visible from the RTCP dashboard although the publish process will appear to have worked correctly. To avoid this problem, move the stub directly under the operation so that it is not within a subfolder.

38426On Microsoft Windows, if users attempt to uninstall, or rollback Rational Integration Tester Agent and Rational Test Control Panel components at the same time and both are installed as Windows services and both services are running and stubs have been run after the Agent service was started, uninstallation will fail, warning that prunsrv.exe could cannot deleted. If this occurs, user must delete the files from the installation directory manually before starting a new installation.

This problem may also occur when upgrading from 8.5.0 to or when rolling back an installation to 8.5.0.

To avoid this problem, users should either uninstall/rollback the components separately or stop both Windows services before starting the process.


Tester does not support WebSphere Application Server’s native JMS implementation if security has been enabled

Rational Integration Tester cannot currently access WAS’s JNDI (required for JMS) if security has been turned on. IBM is currently investigation how to configure RIT such that this works and expects to issue a TechNote once the problem has been resolved.


Slow Fail Execution Is Not Supported When Running ‘Now’ on a Remote Agent

Version 5.4 of Tester introduced the concept of ‘slow fail’ to Test Suites. When a suite is run with this option turned on tests will not immediately stop when an individual test action fails. Instead they will continue so that users can see if future test steps succeed. Although this functionality is supported (in 8.0.1) when scheduling a test for future execution via RTCP it is not supported if you run a test suite ‘now’ on a remote agent using the Run… dialog.


Using the Shutdown.bat file (or shortcut) will not stop RTCP running as a service

Startup and shutdown batch file scripts are provided with RTCP to start and stop it from the command line. On Windows shortcuts to these scripts are provided in the Start Menu. Note that, on Windows, if RTCP is running as a service then the shutdown batch script cannot be used to stop it. You must either using the control panel or issue a net stop IBMRTCP statement on the command line.


Overwrite Expected Field for Filters

Within the Message Difference Window, Overwrite Expected Field only works for filters (within stubs) when updating leaf nodes. Message structures cannot be copied when viewing filter actions. The whole message can be replaced while viewing the filter actions, using overwrite expected message, but overwriting part of a message currently only works for the validate field action.

AIX Performance Testing Does Not Support the sysstats Probe
The sysstats probe is not provided for AIX. If a user attempts to configure an AIX-based performance test to use this probe then the following error will be shown in the console : [Error] Probe ERROR: http://localhost:4476 - Probes failed to start - Failed to start probe: System Statistics - java.lang.UnsatisfiedLinkError: ghsystemstats (Not found in java.library.path). You must remove this probe from the configuration of the test.

Stopping an Agent Results In Windows Event Log Error
On some Windows installations IBM has seen errors raised in the Windows Application Event Log when the Rational Integration Tester Agent service is stopped. This error occurs during the shut-down process of the service and does not affect the functionality of the Agent.

Component Tree Does Not Show Complete Project In Test Factory
Some users have reported instances where the Test Factory Perspective does not show the complete list of project resources in the component tree. Rational Integration Tester has required re-starting to correctly display the tree. This problem has not yet been replicated within IBM’s labs and its cause is currently unknown.


User Interface Freeze

Some users have encountered software freezes on Windows, particularly when moving the Rational Integration Tester user interface from a laptop screen onto an external monitor. This is believed to be caused by problems between the Java Virtual Machine and the DirectX video drivers in use on the machine. If this problem affects you then please try to resolve it by adding the following line to the GHTester.ini file in the installation directory:


This tells the JVM not to use DirectX. This has resolved the problems in all cases IBM is aware of so far although the UI does run more slowly. This issue has been raised with the IBM Java team.

Note that users who experienced this problem while using computers with NVIDIA graphics cards found that upgrading to the most recent driver for their graphics card resolved the problem.

GHDotNetUtils Must Be In the .NET Global Assembly Cache
If you are using Rational Integration Tester’s .NET integration then the GHDotNetUtils.dll file (in the root installation folder) must be added to the .NET Global Assembly Cache before .NET objects can be parsed.

Users wishing to use the .Net functionality will need to install the .Net SDK from Microsoft and register the dll manually e.g : gacutil /i GHDotNetUtils.dll

Date Formatting Strings
Rational Integration Tester uses Java to format date strings for validation purposes. The IBM JRE acts differently from the Oracle/Sun JRE used by earlier versions of GHT Tester for one unusual format string.

Specifically, a date of "123" parsed using an input format of “yyy” with output format MMDDy will be formatted as “0101123” by the IBM JRE. Previous versions of GH Tester (using the Oracle JRE) would have formatted this as “010123”. This is unlikely to cause problems as it is unlikely customers will be using single-character year output format strings.

Launching the ‘Tools Application’ (Source Control option on Menu) Displays License Warning
If you are running Rational Integration Tester using an evaluation license then when you launch the “Tools Application”, by choosing the Source Control option in the menu or by creating/editing a data model, a dialog will appear warning that you are using a trial license. This dialog will not appear once you have installed a full license.

Silent Install of Rational Test Control Panel
Depending on how the silent installation response file has been generated the “Security Configuration” tool may still be launched at the end of the process. The imcl tool is known to work correctly and will suppress the dialog. As Rational Test Control Panel is a server-based product silent installations are not expected to be common but IBM will look to improve this in future releases.

To use imcl within the ${IM}/eclipse/tools directory run “./imcl-c”, specifying the response file when prompted.

The Agent Can Only be Started From its Installed Directory (Unix)
On Unix, if an attempt is made to start the agent from a directory other than the one it is installed in then it will fail to start. For example:

/opt/GH/RIT-Agent/Agent -consolelog

Whereas if you are within the installed directory then:

./Agent -consolelog
works correctly.

It is not possible to rename a project resource by simply changing case
Although project resources can be renamed, it is not possible to simply change the case. i.e. A rename that changes “simpletest” to “SimpleTest” will not actually rename. This is because Tester uses the Eclipse framework to manage its files and Eclipse does not recognize this type of change.

64038Issue with 8.5.0.x upgrades on Solaris

On Solaris machines that do not have any printers configured on them, using Installation Manager to upgrade an existing 8.5.x.x version of any of the components of Rational Integration Tester to 8.5.1 will fail. The installation process will hang after the selection of the Rational Integration Tester component for upgrade.

There are two workarounds for this issue:

1) Configure a printer on the machine. This will allow the installation to complete.

2) Perform the installation and upgrade in a single step using the Rational Test Workbench, Rational Test Virtualization Server, or Rational Performance Test Server launchpad from the 8.5.x.x release. If any Rational Integration Tester components are already installed, they must first be removed using Installation Manager. Then re-install the offering using the launchpad and associated images from Passport Advantage. At the start of the installation process, on the Install Packages page, Click Check for Other Versions, Fixes, and Extensions to find fixes, and select the 8.5.1 fix pack. This will cause Installation Manager to apply the fix pack as part of the initial installation, which does not have the issue with the printers (as described above).

This affects upgrades to Rational Integration Tester, Rational Integration Tester Agent, Rational Test Control Panel, and Rational Integration Tester Platform Pack.

The base 8.5.1 installation (from Passport Advantage) of these components is not affected.

37586Rational Integration Tester tests can be run via Ant. When running test suites, the URL of the results is output at the end of the test. With Ant 1.8.4 this URL is broken across 2 lines making it unusable as a hyper link. It works correctly in Ant version 1.8.2 and earlier. 1.8.2 of Ant and earlier results in: [GHTester] The results for this run can be viewed at http://localhost:7172/ResultsServer/results?resultType=scenario-executi…
Version 1.8.4 of Ant gives two lines: [GHTester] The results for this run can be viewed at http://localhost:7172/ResultsServer/results?resultType=scenario-exec [GHTester] ution-data&executionId=73. This is caused by a bug in Ant 1.8.4. Customers will need to use earlier versions if they require this functionality.

41196When components are upgraded using IBM's Installation Manager changes that users have made to configuration files (such as agent.config) will be lost. This is because the upgrade process does not merge changes that were made to the configuration files with the new version. Instead the upgrade process simply overwrites the user's configuration file with the new version. If users have modified configuration files after installation then these changes must be made again and it is suggested users take copies of the files before upgrade so that they can copy the changes across.

40501If Rational Test Control Panel has been started interactively (i.e. from the command line) rather than as a service, then it must be manually terminated before attempting to uninstall or upgrade using Installation Manager.

38451Some users have experienced problems when attempting to uninstall or upgrade Rational Test Control Panel when it is installed and running as a Windows service. Although the installation process is designed to stop the service before deleting the files there are circumstances where this doesn't happen correctly. Customers may find the process more reliable if they manually stop the Windows service for Rational Test Control Panel before attempting to uninstall or upgrade.

40374If Rational Integration Tester is being used with the "Run Resources : From memory" preference selected then when a stub is run it may be marked as dirty if the editor is open.

39396Rational Integration Tester's MQ API exit uses the default persistence mode defined by the queue to which it's putting the copies of messages. It is not possible to PUT a persistent message to a temporary queue. When using Dynamic Mirror Queue recording or recording an MQ transport RIT will use a temporary queue and this queue's default persistence is set according the the model queue configuration. If the model queue configuration is set to persistent then the recording will fail. The model queue being used by Rational Integration Tester can be changed to on the physical MQ transport.

40732Rational Integration Tester's JBDC Virtualization solution cannot learn SQL that uses the Oracle non-ANSI notation for JOINS. For example, if the driver sees (+) after the table/column to specify a left outer join then then nothing will be learnt.

41050A number of problems have been observed when using the OSLC user interface provided by Rational Test Control Panel within Rational Quality Manager on Internet Explorer:

1. With Internet Explorer 8 on Windows XP it is may not be possible to add Development plan and an error will be shown in the browser windows.

2. With Internet Explorer 9 Windows 7 it may not be possible to enter stub configuration (e.g. agent selection, response time, input tags) in the RTVS dialog from RQM. Only the "Start stub/Cancel" option will be shown.

3. Stub and Scenario icons may not show in the OSLC user-interface for Rational Test Control Panel displayed in Rational Quality Manager if the user is running Internet Explorer version 9. The icons do show correctly with other browsers.

41352When using the integrated database for JDBC database virtualization with WebSphere Application Server applications may fail to get database connections in WAS with the following text being reported in the in the WAS SystemOut.log:

"Missing property 'simulationConnectionURL' for data source. Define the value using a 'simulationConnectionURL' custom property on the data source"

There are two options to work around the issue:

a) Use the WAS admin console to define a custom property called simulationConnectionURL on the data source. The value of the property is not important. Note that each time Tester is used to disable and re-enable the data source for virtualization the workaround must be repeated.

b) Within Tester, go to the physical database resource, Stub Settings tab. Uncheck the 'use integrated database' check box, and fill in a dummy value for the database URL. Then re-select 'use integrated database' and click OK to close the resource. Then open the WAS physical resource, choose the Data Sources tab, and disable the GH JDBC Driver for each of the data sources. Re-enable the GH JDBC driver to push the new configuration onto WebSphere.

38005If a Rational Integration Tester project results database is created on MySQL on Linux, the MySQL system variable lower_case_table_names in the my.cnf file must be set to 1. On Linux systems, this is not the default setting.

37010When Rational Integration Tester is installed on Apple Mac systems running OS X 10.8.4, some users are still experiencing software hangs when running Rational Integration Tester or Library Manager.

The reason why the software hangs on some Mac systems and not on others is still being investigated.

36796In Recording Studio, the information window that displays details about warnings or errors that have occurred while recording truncates some information.

For example, recording rules used by the HTTP proxies will typically be truncated. This is by design. The full text can be see in the Rational Test Control Panel activity log.

37069When Rational Test Control Panel is started, a large number of JAX-RS warnings will be output to the stdout (console) output.

These will be of the form "WARNING: The class was already added to the JAX-RS runtime. The runtime is ignoring this value.

Check that this class was not returned in the subclass getSingletons() and getClasses() methods." These can be ignored because they do not indicate a problem.

Linux root/non-root Installation Notes

The 8.5 components can be installed on Linux as a non-root user. Alternatively, components can be installed as root and then run as non-root. The Network Capture (pcap) component of Rational Integration Tester requires root access and cannot be installed as a non-root user.
Most Linux administrators will be aware of file/directory ownership issues when performing these types of installation. The following known issues should be considered.

31329All users must be in the same group to be able to run/view reports
When a report is generated in Results Gallery Tester will create a directory called /tmp/ghtester5reports. This directory will be owned by the user that creates it (which may be root). When another user attempts to run a report then, if they’re not in the same group, they will be unable to write to the same directory and the report generation will fail. The workaround is to ensure that all users can write to this directory (for example, by making them all members of the same group)

30778If RTCP is installed as root but run as non-root then it will fail
This is caused because directories used at runtime for logging information have been created by root and therefore cannot be written into by a non-root user. This problem does not occur if RTCP was installed as a non-root user. If RTCP was installed as root and a user wishes to run it as non-root then directory permissions must be changed.

RTCP should now run as a non-root user. An alternative solution that may be preferred by some administrators, is to change the directory that RTCP writes information into. A Tech Note has been published here describing how to do this:

Globalization issues


Rational Integration Tester is a Swing based Java application. Java/Swing uses visual cursor movement when working with bi-directional text in user-editable fields. This means that the cursor arrow keys and the delete/backspace function will always operate visually (i.e. left moves left) which may not be the expected logical movement.


Not all Unicode characters (especially the glyph-style characters) can be rendered using all fonts. For example, very few fonts contain a glyph for the U+0904 (DEVANAGARI LETTER SHORT A) character. Rational Integration Tester’s default behavior means that it will not attempt to find a font that does contain that character. This means that messages containing this character will not render correctly. The workaround is for the user to use the RIT font preferences to select a font that is capable of rendering these characters.


Dates in ISO format in message nodes will not be rendered according to the preferred operating system date format (when not running in English) in the Message Difference Window. Changing this behavior would require making changes that could invalidate ‘expected messages’ in existing projects causing tests to fail. For this reason it has been decided not to change the rendering of these nodes.


Attempting to publish a message to a WebSphere MQ Queue Manager using a character set that MQ will not support will result in a failure. This is as-expected and is not a RIT fault. For example, it is possible to publish a message containing the string 叱る亜うぃんをいはるいうはにぽげきんぼ if the character set on the publish action is set to 33722 but not if it’s set to 29626 as MQ doesn’t support that.


When attempting to install multiple products at the same time (e.g. Rational Integration Tester and Rational Integration Tester Platform Pack) warning messages may be displayed in Installation Manager indicating that not all the products in the selected set provide the same set of languages. Both RIT and RTCP have been translated into the same set of 14 languages and this warning can be ignored.


Attempting to connect to a DB2 database using non-ASCII usernames may result in the error “cannot convert Unicode string to Ebcdic string” being displayed. For example, attempting to connect using the default Russian administrator username of "администратор" will show the error, but connecting using “administrator” will not. The workaround is to use the ASCII forms.


Arabic numbers pasted into a numeric control with up and down increment arrows (e.g. the Minimum length field when setting up length validation in the message editor) will revert to Western numerals when the up/down increment arrows are clicked.


When running Library Manager on a non-English operating system the network card information displayed may contain corrupted characters. This is due to a problem processing Unicode characters in 3rd party software used by Library Manager to access the network card details.

Known issues from GH Tester that are still relevant to Rational Integration Tester

Test Cycles and Coverage Reports
If you are using Test Cycles and want coverage reports, the applicable tests must still be executed from within a test suite (i.e. coverage reports will not be produced for tests that are executed outside of a test suite).

Column Level Validation Cannot be Displayed in the Message Differences Window
Validation on table rows and cells performed within the SQL Query action works as expected and is displayed in the console accurately. If column-level validation is used, however, any differences are displayed correctly in the console, but they are unable to be displayed in the Message Differences window as it is currently only able to display row-by-row and cell-by-cell validation issues.

Duplicated Physical Resources when Using Source Control
Rational Integration Tester now uses a different method of creating filenames for physical resources. For this reason, source control users may see duplicate items due to the way the project was updated/committed after the resource change. In this case, the newer/newly named resource should be kept.

webMethods Broker Events
When recording webMethods Broker events, some fields may be seen to contain null rather than their actual content. This occurs because elements wired to a byte-array by an IS to publish can only be un-wired by another IS, this is an internal mechanism of IS and cannot be overcome. This has been seen with the MQ adapter notifications for the “MsgBody” and “MsgBodyByteArray” fields, but may affect others. Further information can be found via Software AG support, incident number 5019024.

Logical View
Sometimes adding a service component to the logical view will not add it to the diagram.

10905: User Names Containing “#” Character
The Eclipse framework (and therefore Rational Integration Tester) does not support user names that contain the “#” symbol. This issue may result in the deletion of project files as Rational Integration Tester cannot interpret the full path to the user’s “Documents and Settings” directory for application preferences.
The workaround for this issue is to create a folder to use as a Rational Integration Tester workspace (for example,C:RIT) and edit TestEngine.ini (found in C:\Program Files\IBM\RationalIntegrationTester, by default) to point to it. The line below “-data” should be changed from “@user.home/.rit8/perf-workspace” to “C:/RIT/..rit8/perf-workspace”.

UNC Paths as Current Directory in Run Command Action
Cmd.exe, used by the Rational Integration Tester Run Command test action, may return an error when trying to process a UNC path. More information regarding the resolution is available at


Issue with SSL tab referencing one of a number of identity stores

In a project with multiple identity stores the GUI does not always correctly reflect the one selected.

If you select any identity store from the Identity Store drop down menu and click OK to close the transport window, Rational Integration Tester will select the correct identity store when processing the data. This can be seen when opening up the physical files in the Physical folder of the GH Project on your C drive. The HTTP file references the id of the selected Identity Store correctly.
Error scenario

If you select any identity store from the Identity Store drop down menu, but then reselect the Identity Store drop down menu it will not retain the selected id store and will default back to the first id store in the drop down menu. Clicking OK on the window will then rewrite the physical files on your drive to reference the first id store in the list. So this should be avoided until fixed.

Simultaneous Modifications
If a message is opened in a message editor (for example, a Subscribe action) and the message differences window at the same time, changes made in one window will be overwritten or reverted when closing the other window. More specifically, the content of the window that is closed last will overwrite the content of the window that was closed first.
This also applies if the message differences window is used to correct messages used in a stub if the stub editor window is open. Note that this problem can be avoided by selecting the user preference, “Run from Disk” as opposed to “Run from Memory”.

User Permissions on non-Windows Platforms
It is possible to perform actions in Rational Integration Tester that require the opening of IP ports less than number 1024. For example, if you create and run a stub configured to listen on port 80. On non-Windows platforms this operation requires the user to be an administrator. Before you can run Rational Integration Tester as an administrator, however, you must run the Library Manager as an administrator (this is due to the way the .rit8 directory is created under the user’s home directory). Similarly, if you want to run Rational Integration Tester as a non-admin user, you must first run Library Manager as that non-admin user.

Results Rendering
The third party rendering engine has performance issues when dealing with larger reports, this may be alleviated by increasing the amount of memory allocated to the application.

Invalid Schema Messages
Some message fields may be displayed as invalid (red “x”), even though they are valid fields/messages.

If a newer version of Rational Integration Tester is installed after adding team providers to SCM, the providers will have to be reinstalled unless their installation is outside of the Rational Integration install folder (detailed in Rational Integration Tester Installation Guide).

TIBCO BusinessWorks Private Processes
  • The BW private process transport uses HTTP as its primary communication method, but Rational Integration Tester’s “Publish” test action does not support HTTP. Therefore, the Send Request/Receive Reply action pair should be used for testing private processes.
  • Error schemas are not supported (for example, if a process outputs an error schema rather than an end schema, the error schema/output is not supported in Rational Integration Tester).
    • Rational Integration Tester does not support the following content in private process schemas:
    • A “Choice” content option at the root of the schema
    • Pointing to an AE message from anywhere (i.e. inner or at the root) causes a known deserialization issue
    • The “Java Object Reference” type is not supported at any level
    • The inline WSDL message content option is not supported
  • If you get a connection error when calling a private process, please check the network settings. If you open the Designer Engine Custom Properties in the Physical View of the Architecture School perspective, you will find the host and port number. The host/port in the Physical View menu must match the host/port in the GHEnable.proj design time library in the BW project. The BW host/port can be set when the project is deployed.

Data Transfer Objects (DTOs)
DTO support is currently limited to the following:
  • Classes with a default constructor and publicly visible member variables
  • Member variables must be primitives, wrapper objects, Strings or other objects within the JAR file
JMS providers who use the Context Class Loader to obtain message definitions

Change History

What's new

Rational Test Workbench 8.5.1 offers new features that are listed in What's new in Rational Test Workbench 8.5.1 in the information center.

Rational Integration Tester version 8.5.1 includes new features that are listed in What's new in Rational Integration Tester 8.5.1 in the information center.

Rational Integration Tester 8.5.1 also introduces a few RFEs as listed in Supplement to What's New in Rational Integration Tester 8.5.1.

Click the link in the Download Options column:

[{"DNLabel":"Rational Performance Test Server 8.5.1","DNDate":"19 Nov 2013","DNLang":"English","DNSize":"2705829396","DNPlat":{"label":"Windows","code":"PF033"},"DNURL":"","DNURL_FTP":" ","DDURL":null}]
[{"Product":{"code":"SSBLUB","label":"IBM Rational Performance Test Server"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Installation","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"8.5.1","Edition":"","Line of Business":{"code":"LOB36","label":"IBM Automation"}}]

Problems (APARS) fixed

Document Information

Modified date:
20 July 2018