Setting up the integration with Jenkins

You can run Rational® Integration Tester tests and view the results. You must set up the integration with Jenkins by deploying the Integration Tester Jenkins Plugin on the Jenkins primary server.

Before you begin

Rational® Integration Tester or Rational® Integration Tester Agent must be installed on the computer where you installed the Jenkins secondary server.
If you are using Apache Ant to run your tests, you must have installed it on the same computer. It is not necessary to install Rational® Test Control Panel on the same computer as the other software.

About this task

You can deploy the Integration Tester Jenkins Plugin to run the tests and integrate viewing of test results from Rational® Integration Tester in the Jenkins Job view.

Note: The test results viewer plugin in the HPI file can get a different name depending on the version of Rational® Test Control Panel that is in use:

In 9.1.1 or earlier: RITPluginForJenkins-1.4.hpi.
In 9.1.1: IntegrationTesterPluginForJenkins-1.4.hpi.
9.1.1.1 or later: IntegrationTesterResultsPlugin-version.hpi, where version is the plugin version number. For example, 1.5.

The test execution plugin IntegrationTesterTestExecution-version.hpi is available in Rational® Test Control Panel 9.1.1.1 or later only. It requires Rational® Integration Tester or Rational® Integration Tester Agent 9.1.1.1 or later.

Procedure

Download and extract the Integration Tester plugins for Jenkins package (CIJenkins.zip) that is provided with Rational® Test Control Panel. For more information on the tool package list, see Rational Integration Tester tool packages.
Copy the IntegrationTesterResultsPlugin-version.hpi file from the downloaded package to a temporary location on the computer where Jenkins is installed.

For the exact file name, check Note.
Open the Jenkins dashboard using a web browser and click Manage Jenkins.

The Manage Jenkins page is displayed.
Click Manage Plugins.
Click the Advanced tab.
Click the Choose File option under the Upload Plugin, navigate to the hpi file, and click Open.
Click Upload.
The plugin is installed.
Select the Restart Jenkins when installation is complete and no jobs are running check box.

Alternatively, restart Jenkins manually.
Optional: After Jenkins restarts, verify that the plugin is installed by completing the following tasks:
1. Click Manage Jenkins on the Jenkins dashboard.
2. Click Manage Plugins on the Manage Jenkins page.
3. Click the Installed tab.
  
  Under Name, an Integration Tester Results Plugin entry is displayed and under the Enabled option, a check box next to the name is selected.
Repeat from Step 2 to Step 9 for the IntegrationTesterTestExecution-version.hpi file.

Note: When you repeat Step 9, the name of the plugin to look for is Integration Tester Test Execution Plugin.

Results

You installed the Integration Tester Jenkins Plugin on the Jenkins server.

What to do next

You can perform any of the following actions:

Configure the Freestyle project to add a build step. See Configuring the Freestyle project by using the Integration Tester Jenkins Plugin or Configuring the Freestyle project by using the Ant script.