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:
- Click Manage Jenkins on the Jenkins dashboard.
- Click Manage Plugins on the Manage Jenkins
page.
- 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.