Home
Administrator Guide
This guide describes how to install IBM® Rational® Functional Tester software. After you install the software, you can perform administration tasks such as license configuration and integration with other products. This guide is intended for administrators.
Integrations in Functional Test perspective
In this section, you will learn about the supported integrations for the Functional Test perspective.
Integration with Jenkins
You can use the HCL OneTest™ UI Jenkins plugin to run tests on a Jenkins server.

Administrator Guide
This guide describes how to install IBM® Rational® Functional Tester software. After you install the software, you can perform administration tasks such as license configuration and integration with other products. This guide is intended for administrators.
- Installing
  In this section, you will learn about two ways to install the product. In the first approach, you use an executable file to directly install the product in an easy manner. In the second approach, you download and install IBM® Installation Manager and then use that tool to install the product.
- Starting Rational® Functional Tester from the command line
  You can start Rational® Functional Tester from the desktop environment or a command-line interface.
- Integrations in UI Test perspective
  In this section, you will learn about the supported integrations for the Web UI Test perspective.
- Integrations in Functional Test perspective
  In this section, you will learn about the supported integrations for the Functional Test perspective.
  - Integration plugin compatibility matrix
    You can find information about the versions of the integration plugin that are compatible with HCL OneTest™ UI.
  - Testing with Ant
    You can use ant to run functional tests from the command line. Starting with version 2.0 of the ant plugin, you can run multiple tests simultaneously. Version 2.0 of the ant plugin is supported in HCL OneTest™ UI 9.2 and newer.
  - Integration with Azure DevOps for Functional tests
    When you use Azure DevOps for continuous integration and continuous deployment of your application, you can create tests for your application in HCL OneTest™ UI and run those tests in Azure DevOps pipelines. You can integrate Azure DevOps with HCL OneTest UI by using the HCL OneTest Studio extension that is available in the Visual Studio Marketplace portal.
  - Testing with Cucumber
    Starting with Rational® Functional Tester 9.2, you can take advantage of Cucumber integration to create, annotate, and run functional test scripts that can be easily understood by all members of the team.
  - Integrating and running Functional Test scripts in Micro Focus Application Life Cycle Management
    To obtain test result details, you can integrate and run Functional Test scripts in Micro Focus Application Lifecycle Management by using a ready-made template available in the HCL OneTest™ UI installation directory.
  - Testing with IBM® Engineering Test Management
    Rational® Functional Tester can be integrated with IBM® Engineering Test Management. You can execute the functional test scripts from Rational Functional Tester.
  - Integration with Jenkins
    You can use the HCL OneTest™ UI Jenkins plugin to run tests on a Jenkins server.
    - Environment variables
      You can add environment variables on the Jenkins server to run the Jenkins build by referring to environment variables.
    - Task flows for running test assets from Jenkins
      You can perform certain tasks to run test assets from the Jenkins Freestyle project.
    - Installing the plugin on the Jenkins primary server
      You must install the HCL OneTest™ UI Jenkins plugin to run test assets from the Jenkins server.
    - Configuring the Freestyle project
      You must configure a Freestyle project to add a build step, and then run test assets from Jenkins.
    - Running tests from Jenkins
      You can run test assets either from the Jenkins Freestyle or the Pipeline project on the Jenkins server to test an application under test.
  - Testing with Maven
    Starting with v9.2, you can use the Maven plug-in to run Functional Test scripts. Apache Maven is a software build tool based on the concept of a project object model (POM). You can use the Maven plug-in that is provided to run tests as part of your Maven build.
  - Testing with Rational® ClearCase®
    As you develop your Rational® Functional Tester test scripts and the supporting files that accompany those scripts, you can use Rational ClearCase® as your software configuration management system to maintain an auditable and repeatable history of your organization's test assets.
  - Testing with Rational® Team Concert™
    IBM® Rational® Functional Tester can be integrated with IBM Rational Team Concert™ (formerly known as Rational Team Concert). You can manage functional test assets by using the Jazz™ source control management that the Jazz Eclipse Client provides. You must have a compatible version of Rational Team Concert server set up to use the Jazz source control management.
  - Testing with Tivoli Composite Application Manager
    Rational® Functional Tester can be integrated with IBM Tivoli® Composite Application Manager. You can schedule the interval at which the application manager agent runs to track the response time and generate logs using Rational Functional Tester scripts.
  - Testing with UrbanCode™ Deploy
    You can run functional test scripts remotely with the IBM® Rational® Functional Tester plug-in for UrbanCode™ Deploy.

Integration with Jenkins

You can use the HCL OneTest™ UI Jenkins plugin to run tests on a Jenkins server.

To automate testing with Jenkins, you must configure Jenkins primary server and Jenkins secondary server. This configuration provides a single Jenkins installation on the Jenkins primary server to host multiple Jenkins secondary server for building and running tests. For more information about the Jenkins primary and secondary server relationship, refer to the Jenkins documentation.

You must install the required version of the HCL OneTest™ UI Jenkins plugin on the Jenkins primary server, and install HCL OneTest™ UI on the Jenkins secondary server, where you create tests.

You can use the Jenkins Freestyle project to run test assets from Jenkins. With Freestyle project, you can create a build step from the Jenkins UI to run the test assets.

Refer to the following topics to learn more about integrating Jenkins with HCL OneTest™ UI in the Functional Test perspective: