Installation considerations for Rational Integration Tester

Rational® Integration Tester is installed as part of the IBM® Rational Test Workbench product offering.

Read the following information before you install Rational Integration Tester

Note: For performance testing and service virtualization, you must install Rational Integration Tester Agent from either theIBM Rational Performance Test Server or IBM Rational Test Virtualization Server offering. These products are licensed separately from IBM Rational Test Workbench. Contact your sales team for detailed information.

Hardware and software requirements

For a list of hardware and software requirements for Rational Integration Tester, see the system requirements document at http://www.ibm.com/software/reports/compatibility/clarity-reports/report/html/softwareReqsForProductByComponent?deliverableId=1390545654519&duComponent=Desktop_33E5C1A09F8C11E389FAED6C8DACE45F.

Security considerations

Ensure that you review the security considerations for installing the software. For more information, see Security considerations for Rational(r) Integration Tester.

HTTP messaging

To enable full HTTP function, the required packet capture libraries must be installed. For more information, see Testing Web services.

Single sign-on for project permissions

IBM Rational Integration Tester project permissions (Active Directory) use Kerberos for authentication. To set up the project permissions, you must provide the Kerberos realm and key distribution center to Rational Integration Tester. You can provide this information in either the krb5.ini or krb5.config file, or by applying the following JVM arguments in the Rational Integration Tester Library Manager:
  • -Djava.security.krb5.realm=<REALM>
  • -Djava.security.krb5.kdc=<KEY DISTRIBUTION CENTER>
On Microsoft Windows systems, these arguments are in the following environment variables:
  • <REALM> must be the value of USERDOMAIN.
  • <KEY DISTRIBUTION CENTER> must be the value of LOGONSERVER with any leading slashes removed (that is, DOMAIN_SERVER not \\DOMAIN_SERVER).
You can also add the following registry value:
  • allowtgtsessionkey must be a DWORD value with a value of 1.

On Microsoft Windows XP systems, add allowtgtsessionkey to the following variable:

HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Lsa\Kerberos

On Microsoft Windows 2000, Windows Vista, and Windows 7 systems, add allowtgtsessionkey to the following variable:

HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Lsa\Kerberos\Parameters

Installing systems, transports, and technologies supported by Rational Integration Tester

In Rational Integration Tester, you can test numerous messaging and governance implementations, workflow and Business Process Management (BPM) systems, and database providers. The system or technology that is being tested must be installed and available to Rational Integration Tester. Library Manager is an application that is installed with Rational Integration Tester to provide support for various middleware and messaging technologies.

Note: Library Manager writes some of its configuration details to the user’s home directory, .rit8, and to the Rational Integration Testerr installation directory. To ensure that Library Manager can write to the Rational Integration Tester installation directory, the user ID that is used to install Rational Integration Tester must be used when running Library Manager.

For information about Library Manager, see Working with the Library Manager.

Uninstalling and reinstalling

Library Manager settings and most user preferences are preserved during the uninstallation or reinstallation process. During the installation of V8.5 and V8.6, run Library Manager at the end of the process and confirm that the settings are correct. Perspective and dialog layout preferences are reset. Users of Rational's floating license server must set up the license server host name again after installation. To do this, enter the Manage License area of IBM Installation Manager, and enter the floating license host name details.

Upgrading the database schema

If you uninstall and reinstall the software, you must ensure that the database schema version is compatible with the version of the software that you install. Until the database schema is upgraded, it is not possible to store results to the database.

This schema upgrade is required to provide Unicode compatibility for the Microsoft SQL Server database. When you upgrade, for Microsoft SQL Server, every varchar column that could contain Unicode characters is changed to an nvarchar column (while preserving the contents). For IBM DB2®, Oracle and MySQL databases, the 1.9.24e upgrade does not change the structure of the database. Instead, it just marks the database as the 1.9.24e version to keep version numbers consistent across the four databases.

To upgrade the database schema, use the provided upgrade script for each of the four supported results databases. This script can be run only on a database that is already at version 1.9.24d. If your results database is an older version, you must run previous upgrade scripts to get it to 1.9.24d before you attempt the 1.9.24e upgrade.

Refer to the table to see the database scheme version for each version of the software

Important: Back up the results database before you run the upgrade scripts.
Rational Integration Tester version Database schema version
8.6 1.9.24e
8.5.x 1.9.24e
8.0.x 1.9.24d or 1.9.24e
Green Hat Tester 5.4 1.9.24d or 1.9.24e
Note: Previous versions of Rational Integration Tester (including GH Tester 5.4) 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.
Feedback