Known issues

You can find the known issues that are identified, if any, in this version of IBM® DevOps Test Integrations and APIs (Test Integrations and APIs). You can also find the known issues identified in the earlier versions of Test Integrations and APIs. DevOps Test Integrations and APIs is the new name of Rational® Integration Tester from 11.0.0 onwards.

Known issues in DevOps Test Integrations and APIs 2024.09 (11.0.3)

No known issues are identified in DevOps Test Integrations and APIs 2024.09 (11.0.3).

Known issues from earlier versions

The known issues identified in the earlier versions of Test Integrations and APIs, Test Performance Test Server, and Test Virtualization that are still applicable are as follows:

Table 1. Known issues from earlier versions
ID Description Identified in version Applicable in and until version

TP-93088

The Integration Tester-based Maven goals are only supported in the Java 8-based environment.

11.0.2

TP-91200

The Flatten XML option in the Field Editor sometimes does not flatten the XML contents.

11.0.1

TP-90094

When installing a version of the HTTP Proxy or Agent older than 11.0 and registering against a version 11 of Test Virtualization Control Panel then registration will fail with a NOTSSUP error as it is unable to generate a persistent token.

If a token is required, this must be manually generated through the user interface and then used in the configuration file.

11.0.0

TP-52974

When you use the Rational Test Control Panel Environments dashboard, if a stub is republished while it is in a Stopped state, no entry is made in the Activity log to indicate that a republish occurred.

10.5.2

TP-85208

After you upgrade to Rational Integration Tester 10.5.1, the topology discovery might fail with the following error:
java.lang.NoClassDefFoundError: com.hp.hpl.jena.rdf.model.ModelFactory
To work around the problem, you must restart Rational Integration Tester by using the -clean argument.

10.5.1

TP-62518

You might see an exception thrown when you stop a stub for a Kafka transport from a command line, this can be ignored.

10.5.1

TP-83019

When you use the Java Agent HTTP inject proxy method to record the HTTP traffic, you might notice that Rational Integration Tester does not record all events.

The workaround to enable Rational Integration Tester to record all events is to not use the / in the resource path that you specify for the transport.

10.5.0

TP-49282

When you change the options for formatting or encoding an XML message by using the Field Properties dialog box for an operation, the changes will not be saved.

10.5.0

TP-82960

When you want to install Rational Functional Tester, Rational Integration Tester, Rational Performance Tester, Rational Performance Test Server, or Rational Test Virtualization Server 10.2.3 or later, on Mac OS Big Sur (11.x) by using the IBM Rational Test Workbench Setup,IBM Rational Performance Test Server Setup, or IBM Rational Test Virtualization Server Setup, you must download all the product offerings contained in the corresponding product package before you start the installation to prevent installation errors.

10.2.3

10.2.3

TP-61292

When you configure the security settings for Rational Test Control Panel and use LDAP, you can test the validity of the user by using the Test Logon button. An error Authentication was rejected for an unknown reason is displayed for both valid and invalid users. This error can be ignored.

10.2.3

TP-58746

In Rational Integration Tester, Project Settings can be slow to load when Rational Test Control Panel cannot be contacted. The editing of the Server Settings Rational Test Control Panel URL can be slow to respond as Rational Integration Tester attempts to connect by using the partially entered URL.

10.2.2

TP-76963

In Rational Integration Tester, when you resynchronize using a swagger definition that contains operations, which specify an operationId field and the operations have a different parent path than the path used during the previous synchronization, then the existing Rational Integration Tester Operation resource in Architecture School is not moved to reflect the new path.

10.2.1

TP-76525

In Rational Integration Tester, after resynchronizing with a swagger definition or other sources of JSON Schemas, where the root of a message schema has changed from JSON Object to JSON Array or vice versa, the Overwrite Expected Message repair action and Overwrite Expected Field repair action, when used on the expanded root message node, will not produce an expected message that will pass validation.

To work around this problem, you must reapply the correct updated schema root to the expanded root of the message.

10.2.1

TP-69419

In Rational Integration Tester, when an XSD imports a namespace without a prefix assigned to the imported namespace, it is possible that the default message created by using that schema will use the same prefix as another namespace in the schema that can result in incorrect QNames for elements and types.

To work around this issue, you can either add a namespace declaration for the imported schema to the XSD/WSDL or add a child xmlns:<prefix> attribute to the appropriate element node when you edit the message.

10.2.1

TP-75762

JMS-based transports support three different methods of correlating replies to requests. The Use JMSMessageID mapped to JMSCorrelationID to match responses to requests setting does not work reliably with Topics. Instead, you can consider using Queues for request/reply messaging. If you must use Topics, either of the other two settings will work reliably.

10.2.0

TP-75610

The recent level of the Db2 JDBC driver that is included with Rational Integration Tester causes the following message to be displayed at the start of Rational Test Control Panel: The manifest classpath pdq.jar cannot be found in jar file: /C:/Program%20Files/IBM/RationalTestControlPanel/usr/servers/defaultServer/apps/RTCP.war/WEB-INF/lib/db2jcc4-4.28.11.jar

You can ignore this message.

10.2.0

10.2.0

TP-69088

The Rational Integration Tester maven plugin only supports Java 8.

10.2.0

TP-69085

The Rational Integration Tester Ant task only supports Java 8.

10.2.0

TP-49406

When Rational Integration Tester attempts to log Test Suite results to a results database and if the database is physically located far from the client or if there are other network latency problems, you can notice performance issues that result in test timeouts.

Rational Integration Tester now displays a warning about potential performance issues in the test console when a results database is in use.

10.2.0

TP-49401

When you create a FIX stub that sends messages in a loop to a client from Rational Integration Tester, the stub works correctly until the client logs off. At this point, the stub is stuck and you cannot connect to the stub unless you restart the stub.

10.2.0

TP-48979

The JDBC driver that is used for database virtualization is not currently compatible with WebSphere Message Broker or IBM Integration Bus because of limitations in the way that they access third-party drivers.

10.2.0

TP-72846

When you configure a proxy server for the file transport that uses FTP, you cannot authenticate the connection by using a user name and password.

10.1.3

TP-71096

When you simulate FETCH calls from a z/OS program to Db2 on z/OS, the performance decreases significantly when the number of columns to fetch increases. This problem is detailed in IBM z/OS Debugger.

10.1.2

TP-48577

Interactions between SoftwareAG webMethods adaptors and Integration Server can utilize an optimization that prevents the data from being accessible to pipeline processing. This might result in some fields to not be present in captured messages that are displayed in Recording Studio and Tests.

10.1.2

TP-47281

In some circumstances, the Default Network Device drop-down menu in Library Manager does not show interfaces that only have IPv6 addresses. Configuring an additional IPv4 address will allow the interface to be shown.

10.1.2

TP-48768

User Defined Types are not supported while virtualizing databases.

10.1.1

TP-66878

Some versions of the IBM WebSphere MQ client JAR files can cause spurious output to stderr when a subscribe-type action is canceled. The version of the JAR files pre-installed with the software do not exhibit this behavior.

10.1.0

TP-64328

When you use an existing project that has tests that use the Email transport, you might see duplicate header fields when you edit the test steps or when you run those tests in the latest version of Rational Integration Tester. You can ignore the duplicate headers or manually remove the duplicate headers when editing the tests.

10.1.0

TP-64225

When resource monitoring JVM arguments were added to Library Manager, you could not run stubs in Rational Test Control Panel. When a new software component that uses Library Manager is installed the corresponding copy of Library Manager is assigned the same JVM arguments as those set in previously installed software components.

To work around this problem, change the corresponding JVM arguments in the installed software component to reflect necessary circumstances. This change avoids any clashes, for example, two software components that use the same port, that were created by the duplication of the JVM arguments.

10.1.0

TP-62667

When you install Rational Integration Tester V10.1.0 on Red Hat Linux Enterprise 8.0 and 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

10.1.0

TP-62478

The Environments, Infrastructure, and Network pages of Rational Test Control Panel do not detect user activity and will log the user out after 12 hours.

10.1.0

TP-58766

The Message Differences window does not replace the expected value when the actual value is NULL if the target field does not exist in the expected message.

10.1.0

TP-50744

Stub execution results shown in the Results page of Rational Test Control Panel can take a long time to load when there is a very large set of executions.

10.1.0

TP-49400

SOAP messages whose definitions are from XSDs with multiple namespaces might result in the incorrect selection of message elements when creating tests from those definitions.

10.0.2.1

TP-60140

When you select Help from Rational Test Control Panel V10.0.2 or V10.0.2.1 or Rational Integration Tester V10.0.2 or V10.0.2.1, you see help content for the 10.0.1 release. To workaround this problem, either change 10.0.1 to 10.0.2 in the current Help URL or copy and paste the following new URL in to your browser. https://www.ibm.com/support/knowledgecenter/SSBLQQ_10.0.2/com.ibm.rational.rit.accessibility.doc/helpindex_rit.html

10.0.2

10.0.2.1

TP-59378

On the Environments dashboard in Rational Test Control Panel, Stop all Stubs will stop all the running stubs but you must refresh the browser to see it was successful.

10.0.2

TP-58844

On the Environments dashboard in Rational Test Control Panel, the Available stub count does not refresh consistently without manually refreshing the browser.

10.0.2

TP-58843

On the Rational Test Control Panel Network dashboard, if you are viewing a large number of rules, use the Chrome browser for a faster response. Firefox and Edge browsers take longer to render this information.

10.0.2

TP-48096

Due to issues in third-party libraries, a keystore containing a key and certificate sharing the same certificate might throw an error: Cannot find key for alias when encrypting and decrypting using WS-Security.

10.0.2

TP-59757

In Recording Studio, after importing events from an rsh file, that file cannot be overwritten until all of the imported events are removed from Recording Studio. Even after removing the events it might not be immediately possible to overwrite the file. Attempting to write to the file will result in a message similar to: my-events.rsh (The requested operation cannot be performed on a file with a user-mapped section open)

To workaround this issue, export the events to a different file.

10.0.1

TP-59642

The CSDL synchronization in Rational Integration Tester parses the CSDL definition to use the entity sets and entity set items within the definition. Bound actions and functions are then mapped depending on the entity type of the items so that they can be tested. Where the CSDL definition contains a more complex structure that links additional entity types, you must create the URL manually.

10.0.1

TP-58335

During the installation of Rational Integration Tester Agent by using console mode, when you are shown the URL of Rational Test Control Panel, you can edit the value by using Other Options 1..

10.0.1

TP-55960

Using Git integration in Rational Integration Tester increases the memory consumption of the tool.

10.0.0

TP-55398

The Status column of the Scheduling page for Rational Test Control Panel shows a running scheduled test as scheduled.

10.0.0

TP-52613

In some circumstances, from the routing rules that are shown on the Network dashboard, it is not possible to determine the agent on which a virtual service is running.

9.5

TP-49289

If a stub event passes its guard condition, only single values are saved to tags on repeating elements. With no guard condition, tags are correctly populated with multiple values.

9.5

TP-52872

Newly created transient environments, as used by the IBM UrbanCode™ Deploy plug-in, currently do not include the new managed stub instances.

9.2.1.1

10.5.4

TP-52776

Maven pom files generated from an earlier version of Rational Integration Tester do not run with Rational Integration Tester 9.2.1 or later.

To workaround this problem, for pom files generated from Rational Integration Tester 9.2.1.1 or later, run the Maven command mvn versions:update-property -Dproperty=it-plugin-version -f <name of pom file> to discover the new version from Rational Test Control Panel and update the version value. Otherwise, for pom files generated from earlier versions of Rational Integration Tester, generate a new pom file or edit the earlier pom file by replacing the version number in the old pom file (for example, 1.911.1 for Rational Test Control Panel 9.1.1) with the version number from Rational Test Control Panel 9.2.1 (for example, 1.921.0).

9.2.1.1

TP-52763

The Engine identity in the Rational Test Control Panel Infrastructure dashboard displays the project name and version, which may be duplicated if that project is deployed to more than one engine simultaneously.

9.2.1.1

TP-52681

When you work with the Rational Test Control Panel dashboards while Rational Test Control Panel security is enabled, when the browser session times out, you are redirected to the Login page. After you log back in, you are redirected to the Rational Test Control Panel landing page, instead of the page listed in your browser URL.

9.2.1.1

TP-52028

In the stub's Activity tab in Rational Test Control Panel Environments dashboard, the User field may sometimes display Unknown user instead of a system account.

9.2.1.1

TP-53755

Proxy recording of AMQP messages on operations or an Ad Hoc monitor targets a proxy queue, rather than an exchange + a routing key, to consume all the messages that are sent by the user application to the proxy queue (denoted by combining the actual queue name with the Queue Suffix defined into the RabbitMQ Transport). As a result when the configuration of the operation or the Ad Hoc monitor does not express a Queue, for example, an empty exchange and the name of the queue as the routing key, the start of the recording is prevented with an exception and a message that indicates the expected configuration.

9.2.1

TP-52845

When Domain Level Security is enabled and a security token is created for the Rational Test Control Panel system administrator, this security token does not allow Agent and Proxy processes to register with Rational Test Control Panel.

To workaround this issue, add the Rational Test Control Panel system administrator as a user of one of your domains.

9.2.1

TP-52782

In the Environments dashboard of Rational Test Control Panel, there can be only one instance of a running stub for each stub type that is published into a specific environment in a domain. The option to clone a stub from the Environments page available in 9.2 is removed in 9.2.1.

9.2.1

TP-51803

When you first start an information center, you might see an error that indicates Eclipse is unable to acquire a PluginConverter service. You can safely ignore the "Unable to acquire PluginConverter service during generation for:" error messages. Stop the information center and then restart it.

9.2.1

TP-50254

Topology discovery for WebSphere MQ is not available for WebSphere MQ on z/OS.

9.2.0

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.

Prior to 9.2.0

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 TesterAgent service is stopped. This error occurs during the shut-down process of the service and does not affect the functionality of the Agent.

Prior to 9.2.0

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. For example, 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.

Prior to 9.2.0

GHDotNetUtils Must Be In the .NET Global Assembly Cache

If you are using .NET integration in Rational Integration Tester 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

Prior to 9.2.0

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.

Prior to 9.2.0

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.

Prior to 9.2.0

66725

When you use the Maven plug-in, if resources other than tests and stubs are run (specifically suites or performance tests), then the environment attribute in the pom.xml is ignored. To work around this problem, add an environment argument (-environment arg) in the pom.xml.

If you do not use this workaround, then the result is either an UnsupportedOperationException being thrown, or if the project was opened on the workstation before, the most recently used environment is used instead.

Prior to 9.2.0

65943

In 9.1.1 the protocol that is used to communicate with Rational Test Control Panel changed to be HTTPS (by default). When recording messages in Recording Studio often these messages are sent direct from the agent/proxy to Rational Integration Tester. The transport that is used is agent/proxy specific and not usually encrypted.

Prior to 9.2.0

65940

Rational Test Control Panel and Rational Integration Tester, by default, use an SSL certificate and private key shorter than 2048 bits. As such they are not in compliance with industry standards set by the Certification Authority/Browser (CA/B) Forum. Rational Test Control Panel can be configured to use the compliant 2048 versions by changing the keystore path in the server.custom.xml file to the available 2048 bit greenhat2048.jks keystore. In Rational Integration Tester, the compliant Inbuilt Certificate Authority can be selected in the Project Settings.

Prior to 9.2.0

62051

The proxy cannot be used to record Kerberos authenticated HTTP traffic when forward bind rules are used in the proxy's registration.xml configuration file. This traffic can be recorded using a normal proxy configuration.

Prior to 9.2.0

60633

When synchronizing a WSDL or Swagger document and creating a stub, optional fields are not included automatically in the stub unless you have set the workspace preference to include optional fields. Set this preference under Workspace > Preferences > Messages > Include optional fields.

Prior to 9.2.0

60573

The JDBC driver that is used for database virtualization doe not currently support stored procedures within WebSphere Liberty because of limitations in the way that they access third-party drivers.

Prior to 9.2.0

60251

The CICS agent might not handle DPL requests if the size of container is more than 70 KB.

Prior to 9.2.0

59591

Parameters for CALL statements for the JDBC proxy must be enclosed within parentheses.

Prior to 9.2.0

58945

When testing functions using scripting languages other than ECMAScript, the results window might not show any output and might fail to display a success notification. However, the underlying script will run correctly as part of the test.

Prior to 9.2.0

58555

DB2/z virtualization of PL/I applications requires that all variables are uniquely named irrespective of whether they are qualified within a containing structure.

Prior to 9.2.0

58472

When using the ISO20022XSDDownloader utility, some download errors may be encountered. If this happens, open the URL specified in the console log and manually download the schema, unpackage it and place it into the download folder. If the URL is not accessible for the schemas you are interested in, acquire a copy of them from your organization and manually copy it into the download folder.

Prior to 9.2.0

58044

When pasting a link to a Swagger file into the Logical View of Architecture School, the path is correctly recognized only if it ends with "swagger.json" which is in line with the implied standards. The workaround is to specify the full path in a manually created Swagger resource when the source is named differently.

Prior to 9.2.0

57695

The Java agent has been updated to support Java version 8 JVMs, however, Java 8 language features are still not supported.

Prior to 9.2.0

57605

When DBCLOBs are interpreted as a single-byte CCSID containing an odd number of characters, a garbage character might be appended at the end. DBCLOB values in PL/I applications might be truncated to half of their original lengths.

Prior to 9.2.0

57042

Synchronization with IBM Integration Bus version 9 happens using WebSphere MQ. However, only the username from the configuration is used by the libraries, and so an error will be encountered when connecting to a secured queue manager.

Prior to 9.2.0

53246

Virtualization of Oracle stored procedures in TIBCO BusinessWorks using the Derby database is not possible, because TIBCO BusinessWorks uses Oracle-specific SQL statements only.

To work around the issue, use an Oracle schema for the stub.

Prior to 9.2.0

51534

Although, in general, Rational Integration Tester now supports the Software AG webMethods Integration Server (wmIS) 9.7, JDBC Virtualization from within wmIS where the database connections are defined using JDBC Connection Pools or used directly via DriverManager is not supported and does not work with this specific version of wmIS.

Prior to 9.2.0

49825

If a username/password value in the WebSphere MQ transport is used with WebSphere MQ version 8.0, and the password is longer than 12 characters, then the WebSphere MQ version 8.0 client jar files must be used. In other words, passwords longer than 12 characters do not work with WebSphere MQ version 8.0 when using the version 7 client jar files.

Prior to 9.2.0

47744

When using the command line installer for Rational Test Control Panel (imcl -c), the user cannot modify the default security permissions. Two workarounds are available:
  1. Copy the correct security.config file to the new system.
  2. Create the quiet installation file a different system, then run the quiet installation on the intended server by using the generated quiet installation settings file.

Prior to 9.2.0

45716

When a user attempts to open a Rational Integration Tester project as Project Administrator, the username field in the login dialog is disabled. The reason is that Rational Integration Tester authenticates based purely on the password for the project administrator. However, if the Rational Integration Tester project is configured to use Rational Test Control Panel for authentication, then Rational Integration Tester also attempts to authenticate the user against Rational Test Control Panel, based on the user's Windows account name. If the user cannot be authenticated by Rational Test Control Panel, then the user will not be able to open the project as an administrator.

Prior to 9.2.0

45214

When installing software using IBM Installation Manager, input validation is performed when moving both backward and forward through the installation wizard. This means users might see validation warnings when clicking the Back button. This behavior is expected.

Prior to 9.2.0

44474

If a stub is created from recorded X12/EDIFACT messages, and a user then edits the message (request or response) in the stub editor and attempts to modify a non-expanded parent element (rather than the children), then Rational Integration Tester raises an exception.

This problem can be avoided by editing the expanded child elements. Note that it is usual to edit child elements as these elements contain the parsed fields. Editing the parent requires the user to edit the original string rather than the parsed version.

Prior to 9.2.0

44280

Some transports do not differentiate message types between "requests" and "responses". This means that when Rational Integration Tester records messages from these transports they will all appear as "Publish" type messages. The user must find another way (usually using header or body values or specific queue or topic names) to determine which is the "response" message. If a user creates a stub using the Recording Studio Wizard, then the stub will not work correctly "out of the box" as it will have incorrectly created a subscribe action for the response rather than a publish. The user must correct this by using the stub editor after it has been created. The user will also need to update the operations created by the wizard.

Prior to 9.2.0

41196

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

Prior to 9.2.0

41193

The Rational Test Virtualization Server and Rational Performance Test Server Launchpads are not supported on the zLinux platforms and do not run correctly there. Users who want to install components of Rational Test Virtualization Server or Rational Performance Test Server must use IBM Installation Manager to install those components directly.

Prior to 9.2.0

40568

A Windows process that was launched via the Run Command action is not terminated when the test or suite is cancelled, even if the user specified that the Run Command action should kill the task at the end of the test, scenario, suite, or execution. This issue exists because Windows (unlike UNIX or /Linux) does not track parent/child processes. The problem is documented in a Java bug at the following URL:http://bugs.java.com/bugdatabase/view_bug.do?bug_id=4770092

This problem cannot be resolved by Rational Integration Tester and is a permanent limitation.

Prior to 9.2.0

39739

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

Prior to 9.2.0

39436

Packet capture recording does not work due to the retirement of WinPcap support. As an alternative solution, users can uninstall WinPcap and install https://www.win10pcap.org/ instead.

Prior to 9.2.0

38668

When 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 Rational Test Control Panel 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.

Prior to 9.2.0

38005

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

Prior to 9.2.0

36796

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

Prior to 9.2.0

36387

When an Rational Test Control Panel scenario is loaded into Rational Integration Tester (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.

Prior to 9.2.0

36069

If a performance test is configured to start a stub on Rational Test Control Panel 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.

Prior to 9.2.0

35645

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 third-party software used by Library Manager to access the network card details.

Prior to 9.2.0

35142

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.

Prior to 9.2.0

34696

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.

Prior to 9.2.0

32139

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 Rational Test Virtualization Server and Rational Performance Test Server installations with the Rational Integration Tester 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.

Prior to 9.2.0

31770

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

Prior to 9.2.0

31329

All 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)

Prior to 9.2.0

30752

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.

Prior to 9.2.0

29672

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.

Prior to 9.2.0

28214

Although it is possible to roll back an installation of Rational Test Control Panel using Installation Manager the workspace (containing all published stubs and other information) will not work with an earlier version of Rational Test Control Panel once it has been upgraded and run.

When a new version of Rational Test Control Panel is installed and run it upgrades the workspace to the new version. If the installation of Rational Test Control Panel is subsequently downgraded then it will not start because the workspace remains at the higher version.

To avoid this problem users must back-up the workspace directory before upgrading Rational Test Control Panel. If it is subsequently downgraded again then the workspace must be restored from back-up.

Prior to 9.2.0

14321

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.

Prior to 9.2.0

13968

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. The 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 Rational Integration Tester font preferences to select a font that is capable of rendering these characters.

Prior to 9.2.0

13932

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.

Prior to 9.2.0

Table 2. Known issues from GH Tester that are still relevant to Rational Integration Tester
Known issues from GH 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.

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.

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

Cmd.exe

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 http://support.microsoft.com/kb/156276/EN-US.

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.

TIBCO BusinessWorks

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 must use the Context Class Loader to obtain message definitions.