Configuring the Jenkins environment for running tests

If your Jenkins environment has the Rational Integration Tester Test Execution plug-in installed, you can use it to run tests without the need for Apache Ant. Use of the plug-in can provide improved test execution shutdown if a job is aborted. Alternatively, you can use the Ant plug-in to run an Ant script that will in turn run the tests.

Before you begin

If you use Rational Integration Tester Test Execution plug-in to run tests, ensure that you install it by following the procedure described in Setting up the integration with Jenkins.
If you use Apache Ant to run tests, generate an Ant script by using Rational® Integration Tester. For more information, see Generating Ant scripts to run tests.

Running tests by using the Rational Integration Tester Test Execution plug-in

Procedure

On the Jenkins dashboard, create a new project or modify an existing project.
On the Project page, click Configure.
Under Build, click Add build step.
Select Run Rational Integration Tester Tests. The following dialog is displayed:
Fill in values for the task as required: Enter values for the following: Installation directory, Project, Environment, and Tests. If you leave the Installation directory blank, the following environment variables will be queried at runtime to find the directory: INTEGRATION_TESTER_AGENT_HOME and INTEGRATION_TESTER_HOME. If no value is found, the job will fail. These variables must be visible to the user or the service account that is running the Jenkins master or slave. If you update either of the environment variables, you must restart the Jenkins master or slave for the values to take effect.
Optionally, click Advanced to view and update the other fields as needed. For a detailed description of any field, click the question mark icon that is next to it. Also see Run tests by using an Ant task.
Click Save.

Running tests by using the Ant plug-in

Procedure

On the Jenkins dashboard, create a new project or modify an existing project.
On the Project page, click Configure.
Under Build, click Add build step.
Select Invoke Ant.
Click Advanced.
In the Build File field, enter the location of the Apache Ant script that was generated by Rational Integration Tester.
Click Save.

Feedback