Deploying Rational Test RealTime using Rational Build Forge script samples

You can install IBM® Rational® Test RealTime on a remote computer using IBM Rational Quality Manager and IBM Rational Buildforge. Use the Build Forge sample projects that are provided with Rational Test RealTime to install Rational Test RealTime on a remote computer and configure the Rational Test RealTime adapter for Rational Quality Manager integration.

You can import the Build Forge sample projects on the Rational Build Forge® server and specify the parameters for installing Rational Test RealTime, configuring the adapter for Rational Quality Manager integration, and uninstalling Rational Test RealTime on a remote computer.

Prerequisites

Importing Rational Build Forge samples

The Build Forge sample projects are located in: [Rational Test RealTime installation directory]/RQMAdapter/RTLM_BuildForgeScripts

For Windows®, the Rational Build Forge scripts location contains the following projects:
  • Install_TestRT_Win32.xml
  • Uninstall_TestRT_Win32.xml
For Linux, the Rational Build Forge scripts location contains the following projects:
  • Install_TestRT_Linux.xml

Perform the following steps to import the Build Forge sample projects into your Rational Build Forge Management Console.

  1. Locate the bfimport.exe file located in the Rational Build Forger server installation directory.
  2. Copy all the XML files into the same directory as bfimport.exe.
  3. Run the the following commands:
    4. Command Action
    bfimport.exe -p -S -e -r Install_TestRT_Win32.xml Install Rational Test RealTime on a Windows remote computer
    bfimport.exe -p -S -e -r Uninstall_TestRT_Win32.xml Uninstall Rational Test RealTime from a Windows remote computer
    bfimport.exe -p -S -e -r Install_TestRT_Linux.xml Install Rational Test RealTime on a Linux remote computer
  4. Delete the XML files.

Creating server authentication

Create server authentication entries for server and test machines. For more information, refer to Rational Build Forge documentation.

Setting up environment variables for Windows® remote test computers

To install Rational Test RealTime on a remote computer that runs Windows®, set up the environment variables from Rational Quality Manager as follows:

  1. Log in to Rational Quality Manager.
  2. In the left pane of the window, click Environments. The environment variables are listed in the right pane of the window.
  3. Set up the following environment variables:
    • testrt-release-area-share-folder: The complete path to a release area that is created using the siteprep command. For example: //myShareFolder/myReleaseArea)
    • testrt-win32-response-file: The name of the response file that is created during generation of the release area. For example: sitedefs.dat
    • testrt-path-to-install-log-file: The complete path and filename of the IBM Rational Test RealTime installation log file on the remote computer.
    • testrt-path-to-uninstall-log-file: The complete path and filename of the IBM Rational Test RealTime uninstallation log file on the remote computer.
    • testrt-path-to-msi-scripts-install-log-file: The complete path and filename of the Msi Scripts Engine installation log file on the remote computer.
    • testrt-release-area-username: A user name that has permission to mount a drive to the release area on the remote computer.
    • testrt-release-area-password: The password associated with the user.

Setting up environment variables for Linux remote test computers

To install Rational Test RealTime on a remote computer that runs Linux, perform the following steps to set up the the environment variables from Rational Quality Manager:

  1. Log in to Rational Quality Manager.
  2. In the left pane of the window, click Environments. The environment variables are listed in the right pane of the window.
  3. Set up the following environment variables:
    • testrt-linux-response-file: The complete path and filename of the response file that is created for installing IBM Rational Test RealTime on Linux (Created using the rs_install -record command).
    • testrt-path-to-rs-install: The complete path to the cdrom or folder containing the cdrom content of IBM Rational Test RealTime.

Running the Rational Build Forge scripts from Rational Quality Manager

After configuring the environment variables, you can run the Rational Build Forge scripts from Rational Quality Manager.

  1. Start the agent service on the test machine that has the Rational Build Forge agent installed.
  2. Run the Rational Build Forge scripts from Rational Quality Manager to install Rational Test RealTime.