If your Jenkins environment has the IBM® Rational® Integration Tester plug-in
for Jenkins installed, the results of the Jenkin job can be viewed
on an IBM Rational Test Control Panel Results
page.
Before you begin
- Rational Integration Tester,
Apache Ant, and Jenkins must be installed on the same computer. It
is not necessary to install Rational Test Control Panel on
the same computer as the other software.
- Ensure that the Rational Integration Tester project
that you are using has a valid Rational Integration Tester project
results database configuration.
- Verify that the connection to Rational Integration Tester project
results database is working correctly. Click Project >
Project Settings on the menu bar of Rational Integration Tester,
click the Server Settings tab on the Project
Settings window, and then click Test Connection.
- Ensure that your Rational Integration Tester project
is connected to a valid instance of Rational Test Control Panel.
Details about the Rational Test Control Panel instance
are used by Apache Ant when it is generating console output that is
used by Jenkins to display test results.
- Verify that the connection is working correctly. Click Project
> Project Settings on the menu bar, click the Server
Settings tab on the Project Settings window,
and verify that a green check mark icon is displayed next to the URL field
on the Rational Test Control Panel area
of the tab. If no URL is displayed or if there is a red X icon next
to the URL field, contact your Rational Integration Tester project
administrator.
- Ensure that the Rational Test Control Panel
instance that you are using has the same Rational Integration Tester
project results database configuration as the Rational Integration Tester
project; to do so, click Project > Project Settings on the menu
bar, click the Server Settings tab on the Project
Settings window, and then in the Rational Test Control
Panel section, click Publish results database
connection.
- Generate an Ant script by using Rational Integration Tester.
For more information, see Generating Ant scripts to run tests.
Note: If Rational Integration Tester and
Apache Ant are installed on different operating systems, such as Microsoft Windows and UNIX,
edit path names in the build script so that the operating system of
the computer where Apache Ant and Jenkins are installed can interpret
the script correctly.
Procedure
- On the Jenkins dashboard, click the relevant project.
- On the Project page, click Configure.
- Under Build, click Add
build step.
- Click Invoke Ant
- Click Advanced
- In the Build File field, enter the location of the Apache Ant
script that was generated by Rational Integration Tester.
This location is relative to the base of the project workspace used by Jenkins.
- Under Post-build Actions, click Add
post-build action.
- Click GH Tester Results View.
- Click Save.