Setting up the integration with Jenkins

You can set up the integration with Jenkins by deploying the Integration Tester plug-ins for Jenkins into the Jenkins environment.

Note: The test results viewer plug-in HPI file may have a different name depending on the version of Rational® Test Control Panel that is in use:

In all the versions older than 9.1.1: RITPluginForJenkins-1.4.hpi.
In version 9.1.1: IntegrationTesterPluginForJenkins-1.4.hpi.
Starting in version 9.1.1.1: IntegrationTesterResultsPlugin-version.hpi, where version is the plug-in version number. For example, 1.5.

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

Before you begin

Rational Integration Tester or Rational Integration Tester Agent must be installed on the same computer as Jenkins (master or slave). If you are using Apache Ant to run your tests, you must install it on the same machine as well. It is not necessary to install Rational Test Control Panel on the same computer as the other software. See also, Notes.

About this task

You can deploy the Integration Tester plug-ins for Jenkins to run tests and integrate viewing of test results from Rational Integration Tester in the Jenkins Job view.

Procedure

Download and extract the Integration Tester plug-ins for Jenkins package (CIJenkins.zip) that is provided with Rational Test Control Panel. For more information, 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 Notes at the beginning of this topic.
Using a web browser, open the Jenkins dashboard and click Manage Jenkins.
The Manage Jenkins page is displayed.
Click Manage Plugins.
Click the Advanced tab.
Under Upload Plugin, click Choose File, navigate to the hpi file, and click Open.
Click Upload.
The plug-in 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, you can verify that the plug-in 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 Enabled, a check box next to the name is selected.
Repeat from Step 2 to Step 9 for the IntegrationTesterTestExecution-version.hpi file, as applicable. See Notes at the beginning of this topic for details. When you repeat Step 9, the name of the plug-in to look for is Integration Tester Test Execution Plugin.

Results

You can now use Jenkins to run Integration Tester tests and view the results.

Feedback