Deploying Rational Robot using Rational Build Forge script samples

You can install IBM® Rational® Robot on a remote computer using IBM Rational Quality Manager. Use the BuildForgeScripts project that is provided with Rational Robot to install Rational Robot on a remote computer and configure the Rational Robot adapter for Rational Quality Manager integration.

You can import the BuildForgeScripts project on the Rational Build Forge® server and specify the parameters for installing Rational Robot, configuring the adapter for Rational Quality Manager integration, and uninstalling Rational Robot on a remote computer.

Prerequisites

Importing Rational Build Forge samples

The BuildForgeScripts project is available at Robot installation directory\Rational Test\RTLM_BuildForge\Project.

The Rational Build Forge scripts location contains these projects:
  • configureadapter.xml
  • InstallRobot.xml
  • startadapter.xml
  • UninstallRobot.xml

Perform the following steps to import the Rational Robot samples 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 and import.bat files into the same directory as bfimport.exe.
  3. Run import.bat.
  4. Delete the XML and import.bat files.

    The samples are displayed in your management console.

    The import.bat file has these commands.
    Table 1. Batch file commands
    Command Action
    bfimport.exe -p -S -e -r configureadapter.xml Configure the Rational Robot adapter
    bfimport.exe -p -S -e -r InstallRobot.xml Install Rational Robot on a remote computer
    bfimport.exe -p -S -e -r StartAdapter.xml Start the Rational Robot adapter on a remote computer
    bfimport.exe -p -S -e -r UninstallRobot.xml Uninstall Rational Robot from a remote computer

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

To install Rational Robot on a remote computer, 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:
    • robot-install-response: The name of the response file that is created for installing Rational Robot.
    • source-server: The name of the server that contains the response file and the IBM Installation Manager installer .zip file.
    • source-server-path: The location of the folder that contains the response file and the Installation Manager installer .zip file.
    • destination-path: The path of the destination computer to which to copy the response file and the Installation Manager installer .zip file.
    • agent-installer: The Installation Manager installer file name.
    • agent-directory: The folder name on the destination computer into which the Installation Manager installer .zip file is extracted.
    • robot-uninstall-response: The name of the response file that is created for uninstalling Rational Robot.
    • config-file: The configuration file that contains information on connecting to the Rational Quality Manager server.

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