You can set up the integration with Jenkins by deploying the Rational Integration Tester plug-ins
for Jenkins into the Jenkins environment.
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,
Note.
About this task
You can deploy the Rational Integration Tester plug-ins for Jenkins to run tests and integrate
viewing of test results from
Rational
Integration Tester in the
Jenkins Job view.
Note: The test results viewer plug-in the HPI file can 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.
Procedure
- Download and extract the Rational 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 Note 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:
- Click Manage Jenkins on the Jenkins dashboard.
- Click Manage Plugins on the Manage Jenkins
page.
- Click the Installed tab.
Under Name, an Rational 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 Note at the
beginning of this topic for details. When you repeat Step
9, the name of the plug-in to look for is Rational Integration Tester Test Execution
Plugin.
Results
You can now use Jenkins to run Rational Integration Tester tests and view the results.