IBM Support

Rational Test Virtualization Server Fix Pack 3 ( for 8.0

Downloadable files


IBM Rational Test Virtualization Server has been made generally available and contains fixes to version 8.0 including all predecessor fix packs.

Download Description

Table of Contents
Sections Description
This 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.
This 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.
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.


Installation Instructions

Install the Rational Test Virtualization Server Fix Pack update using the Update wizard in IBM Installation Manager.

  1. Download the software from Fix Central.
  2. Open Installation Manager, click File, and select Preferences.
  3. Click Add Repository and browse to the location of the folder that contains the downloaded files.
  4. Start the IBM Installation Manager.
  5. Click Update and follow the instructions in the wizard.

Download package

The following sections provide detailed information related to this release.

How critical is this fix?

Impact Assessment
Impact Description
This release is a maintenance release of Rational Test Virtualization Server 8.0. It contains fixes for client-reported and internally found defects.

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 defects were not resolved in this release.

Defect title
Services Must Be Stopped Before Upgrading Packages Although in some cases the upgrade process for the various packages will automatically stop any installed services before attempting to upgrade there are scenarios when this doesn’t occur. This results in a failure to uninstall the service (for example, the agent.exe file). It is therefore recommended that you manually stop services before attempting to upgrade.
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 -
© Copyright IBM Corp. 2001, 2012 24
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.
Stubs Will Not Automatically Detect Port In Use On Stub Start-up A change made in the Java 7 runtimes means that an exception is no longer passed back to Rational Integration Tester when an attempt is made to bind to an IP port that is already in use. Previously this exception was used by the stub engine to automatically allocate another port and configure the environment appropriately. This automatic use of an alternative port will no longer occur. Instead the stub will fail to start. This problem is most commonly experienced when a user attempts to start a stub on the same machine as the live system is running on. There are two workarounds for this problem.

The first option is to configure the stub to use a different port. Traffic will be automatically routed to the new port so no client-reconfiguration is required.

The second option is to use JVM arguments to try and replicate previous behavior. The Rational Integration Tester products have not been fully tested with these options enabled so customers are advised to use them with caution. The following two –D options must be specified in either the GHTester.ini file (for Rational Integration Tester) or the RunTests.ini file (for Rational Integration Tester Agent) in order for stubs to detect the port-in-use scenario:
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.
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.
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. This is a manual step and is documented in the Rational Integration Tester Microsoft .NET Reference Guide.
Automatic Project Login Doesn’t Work on Windows On the Windows platform the Automatic Login project option does not work correctly. This means that secured projects run from the command line or from QC cannot be opened. Please note that this problem has been resolved in fix pack
Left-to-Right and Right-To-Left Strings If a message element is a string that contains both left-to-right and right-to-left text in the same element then the string may not be displayed properly in the user interface. It will be published correctly.
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.
Library Manager ‘Browse For File’ dialog When you first open the browse/edit dialog from the Library Manager application (to select a file) the directory ‘up’ button will not work. If a different directory is selected the ‘up’ button will then work. This has been confirmed as bug in the IBM JRE.
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.
Blank Panel Appears During Solaris Installation During installation of Rational Integration Tester, Rational Integration Tester Agent and the Rational Integration Tester Platform Pack on Solaris (32 bit) a blank panel will appear during the Installation Manager install process. This has no adverse effects on the installation process and the user can simply click Next.
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.
The Full Path to RunTests executable Must Be Given In RQM Configuration When Using RQM to Run Tests on an Linux Based Agent If integration between Rational Integration Tester and Rational Quality Manager has been set-up such that the Agent that a test is to be run on is running on a non-Windows platform then the full path to RunTests must be provided in the RQM block of the agent.conf file in the RIT-A installation.
To make this change, locate the agent.conf file in the RIT-A installation, open in an editor and locate the rqm element which will contain information similar to the following:

<rqm enabled="true">
<username value="rqmconnector"/>
<password value="*****"/>
<url value=""/>
<rqmproject value="P1"/>
<ghtprojectbaselocation value="/opt/GH/workspaces"/>
<runtests value="./RunTests"/>

Modify the runtests value to reference the full path. E.g.

<runtests value="/opt/GH/RIT-Agent/RunTests"/>

Restart the agent. A test initiated from RQM should now run correctly.
Test Cycles and Coverage Reports If you are using Test Cycles and want coverage reports, the applicable tests must be executed from within a test suite. 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. However, if column-level validation is used, any differences are displayed correctly in the console, but they are not displayed in the Message Differences window, where only row-by-row and cell-by-cell validation issues are displayed.
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 might see duplicate items, due to the way the project was updated or committed after the resource change. In this case, the newer or newly named resource should be kept.
webMethods Broker Events When recording webMethods Broker events, some fields might appear 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 might affect other fields as well. For more information, see via Software AG support, incident number 5019024.
Logical View Sometimes adding a service component to the logical view does not add it to the corresponding diagram.

If there are a small number of objects in the logical view, the zoom level might automatically set itself to a very high level.

10905: User Names Containing “#” Character The Eclipse framework (and therefore Rational Integration Tester) does not support user names that contain the “#” symbol. This issue could 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

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. For information about the resolution, see
10766: Performance tests when running multiple test engines on one agent Various issues with performance tests if running multiple test engines on one agent.
10158: 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 that is 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 selects 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 does not retain the selected id store and defaults back to the first id store in the drop down menu. Clicking OK on the window rewrites 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 in 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 overwrites the content of the window that is 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. To avoid this issue, select the user preference, “Run from Disk” as opposed to “Run from Memory”.

User Permissions on Linux The user of the Recording Studio perspective on the Linux platform requires administrative privileges. 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.
WS Security Only outbound actions are supported in the WS-Security node processor.
Results Rendering The third party rendering engine has performance issues when processing large reports. To improve performance, increase 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 or messages.
SCM If a newer version of Rational Integration Tester is installed after adding team providers to SCM, the providers must 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, check the network settings. Open the Designer Engine Custom Properties in the Physical View of the Architecture School perspective to find the host and port number. The host and port numbers in the Physical View menu must match the host and port numbers in the GHEnable.proj design time library in the BW project. The BW host and port numbers 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 is the third fix pack for Rational Test Workbench, Rational Performance Tester Server, and Rational Test Virtualization Server offerings. The same fix pack updates components on all three offerings. Existing 8.0.0, and installations can be updated to by using IBM Installation Manager’s update facility. It is also possible to install directly by checking for updates before starting an 8.0.0 installation within Installation Manager.

A small number of enhancements have been added to

  • Added a preference to limit the number of optional fields created from a schema to prevent memory issues with huge schemas.
  • Support has been added for extended feature codes to enable additional capabilities.

Download RELEASE DATE LANGUAGE SIZE(Bytes) Download Options
What is Fix Central(FC)?
Rational Test Virtualization Server 2 Nov 2012 English 11 FC

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 developement progress.

Helpful Hints For Obtaining Technical Assistance:

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

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

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

Follow IBM Rational Client Support on Twitter | Facebook | YouTube | devWorks Blog

Document information

More support for: Rational Test Virtualization Server

Software version:

Operating system(s): AIX, Linux, Solaris, Windows

Reference #: 4033746

Modified date: 05 November 2012