# Deploying Rational Functional Tester using Rational Build Forge script samples

You can install IBM® Rational® Functional Tester on a remote computer using IBM Rational Quality Manager. Use the Build Forge sample projects that are provided with Rational Functional Tester to install Rational Functional Tester on a remote computer and configure the Rational Functional Tester 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 Functional Tester, configuring the adapter for Rational Quality Manager integration, and uninstalling Rational Functional Tester on a remote computer.

Prerequisites

- Configure IBM Rational Build Forge to connect with Rational Quality Manager.
- Configure Rational Quality Manager to receive lab resource data from Rational Build Forge.
- Install the Rational Build Forge agent in the test machines on which Rational Functional Tester has to be deployed and the machine on which the response files are located.

# Importing Rational Build Forge samples

The Build Forge sample projects are available on Windows at functional tester installation directory\FunctionalTester\RQMAdapter\RTLM_BuildForgeScripts and on Linux at functional tester installation directory/FunctionalTester/RQMAdapter/RTLM_BuildForgeScripts.

The Rational Build Forge scripts location contains these projects on Windows:

- Install_RFT.xml
- Uninstall_RFT.xml
- Configure_RFT_Adapter.xml
- Start_RFT_Adapter.xml

The Rational Build Forge scripts location contains these projects on Linux:

- Install_RFT_Linux.xml
- Uninstall_RFT_Linux.xml
- Configure_RFT_Adapter_Linux.xml
- Start_RFT_Adapter_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 and import.bat files into the same directory as bfimport.exe.
3. Run the import.bat file.
4. Delete the XML and import.bat files.
   The import.bat file has these commands. Use these commands to import the Build Forge projects to the Management Console.

   Table 1. Batch file commands
   Command | Action
   --- | ---
   bfimport.exe -p -S -e -r Configure_RFT_Adapter.xml | Configure the Rational Functional Tester adapter
   bfimport.exe -p -S -e -r Install_RFT.xml | Install Rational Functional Tester on a remote computer
   bfimport.exe -p -S -e -r Uninstall_RFT.xml | Uninstall Rational Functional Tester from a remote computer
   bfimport.exe -p -S -e -r Start_RFT_Adapter.xml | Start the Rational Functional Tester adapter on 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 Functional Tester 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:
   - rft-install-response: The name of the response file that is created for installing Rational Functional Tester.
   - 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.
   - rft-uninstall-response: The name of the response file that is created for uninstalling Rational Functional Tester.
   - 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 Functional Tester.