Integrating with Rational Test RealTime

Integration with Rational Test RealTime is implemented through the use of an adapter. The adapter serves as a bridge between Test RealTime and Engineering Test Management. The Test RealTime adapter is installed by default when you install Test RealTime and is configured on the workstation where Test RealTime is installed.

For more information about the adapter, see the Rational Test RealTime documentation in the IBM Documentation.


  • The Rational Test RealTime adapter for Engineering Test Management must meet the minimum Test RealTime version requirements. For details, see Test tool adapters.
  • Before running the adapter, ensure that the PATH environment variable is properly set on your computer to use a Java™ Runtime Environment (JRE) version 1.5 or later.
  • When you run the adapter for the first time, you are asked to type configuration information in the console window.
  • The adapter uses Test RealTime projects as Engineering Test Management test scripts. When you run a Test RealTime test from Engineering Test Management, the adapter runs the Test RealTime project with the default Target Deployment Port (TDP) that is selected in the project. If you want to run a Test RealTime project with various TDPs, you must create a test environment in Engineering Test Management for each TDP.

Starting the adapter

To start the adapter:

  1. Run the appropriate adapter command:
    • On Windows, run the startTestRTAdapter.bat file that is installed by default into <installation directory>\RQMAdapter\TestRTadapter.

      Alternatively, from the Start menu, select IBM Rational > IBM Rational Test RealTime > Tools > Start Rational Test RealTime Adapter for Rational Quality Manager..

    • On UNIX, run the script that is installed by default into <installation directory>/releases/TestRealTime. Adapter.
  2. If this is the first time you run the adapter, you must type the following information in the console window:
    • Server URL: Type the URL of the Engineering Test Management server.
    • Login: Type the login used to connect to Engineering Test Management.
    • Password: Type your password.
    • Project Area: (Optional) Type the name of the Engineering Test Management project area.
    • Enter adapter name: Type the name of the Test RealTime adapter on the current computer as it will appear in the Engineering Test Management web UI to identify this instance of the adapter. By default the name is TestRT on <hostname>.

The adapter only asks these questions the first time it is run. If you need to change the server URL and login information, run the adapter with the -reconfigure command line option.

The adapter runs as long as the console window is open. To stop the adapter, close the console window or press CTRL-C.

Importing a Test RealTime project

To import a Test RealTime project into Engineering Test Management:

  1. Log in to Engineering Test Management, click Construction > Import test script.
  2. In Script type, select Rational Test RealTime.
  3. Select Use test resources that are local to a test machine and click Select Adapter.
  4. Select the Test RealTime adapter that you want to use.
  5. In Project Path, specify the directory where the Test RealTime RTP project file is located, and click Go. The adapter will parse all the subdirectories under the selected directory.
  6. Select one or several RTP project files, click OK and Import.

Associating Target Deployment Ports with test environments

To create a test case execution record with a specific TDP:

  1. Log in to Engineering Test Management, click Lab Management > Create Test Environment.
  2. Type a name for the test environment that applies to the name of the Test RealTime TDP configuration. The name must be exactly the same as the configuration name in Test RealTime, for example: C Win32 - GNU. Click Save.
  3. Click Construction > Create Test Case Execution Record and type a name for the new test case execution record.
  4. Select the Test Case and the Default Test Script.
  5. In Available Test Environments, select the test environment with the name of the TDP that you want to use. Click Save.