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.
- 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 put the location of the Apache Ant script that was generated by Rational Integration Tester.
- Under Post-build Actions, click Add
post-build action.
- Click GH Tester Results View.
- Click Save.