This plugin allows Jenkins to invoke IBM Rational Application Developer as a build step.
Tutorial regarding the use of this plugin
For a complete tutorial describing how to use this plugin, refer to the Enhance continuous integration using Rational Application Developer and the Hudson build server article on developerWorks.
Introduction to Rational build utility
This plugin is aimed at using the headless capabilities of IBM Rational Application Developer (RAD) 7.0/7.5, which is Ant-based, to build J2EE applications designed with RAD.
This plugin currently supports:
- RAD 7.0 (version 1.x successfully tested with RAD 18.104.22.168 and RAD 22.214.171.124 – should work with other 7.0.0.x versions)
- RAD 7.5 (version 1.x successfully tested with RAD 7.5.3, 7.5.4, 7.5.5, 126.96.36.199, 188.8.131.52 and 184.108.40.206 – should work with other 7.5.x versions)
- RAD build utility (BU) 7.5 (version 1.x successfully tested with BU 7.5.3, 7.5.4, 7.5.5, 220.127.116.11, 18.104.22.168 and 22.214.171.124 – should work with other 7.5.x versions)
- RAD build utility (BU) 8.0 (version 1.1.4 successfully tested with BU 8.0.2 – should work with other 8.0.x version)
BU is the fully headless version of RAD.
This plugin works as the built-in Ant builder:
- The first thing to do is to define RAD/BU installations in Hudson's
- Once done, corresponding build steps can be added to the project:
About the WORKSPACE environment variable
RAD uses an environment variable called
workspace to define the RAD
workspace to use. It means that there's a "competition" (no matter the
case) between this variable and the one defined by Hudson (which refers
to the project's workspace). As a consequence, don't use the
variable within this build step as it doesn't refer to what's expected.
- To get more information on the headless capabilities of RAD 7.0, please refer to the RAD 7.0 Infocenter
- To get more information on the headless capabilities of RAD 7.5, please refer to the RAD 7.5 Infocenter
- To get more information on BU 7.5, please refer to the RAD 7.5 Infocenter.
- To get more information on BU 8.0, please refer to the RAD 8.0 Infocenter too.
- Support of WebSphere Message Broker Toolkit
- Fixed a bug which was preventing to display RAD installations actually used by build steps (the first item in the installations list was always selected)
- Implemented JENKINS-8652: Build logs are now annotated so that the logs for Ant targets can be accessed faster
- Fixed JENKINS-8545: RAD Builder refused to work if the RAD installation path on a slave node was different than the path on the master node
- Improved handling of the
workspaceenvironment variable: Now, the plugin sets RAD's workspace using
workspace(lower case letters) whether it is running on Windows or Linux
- Bug fix: The "Create PROJECT_WORKSPACE variable" option now works fine (previously, this new variable was created at the end of the build step rather than at the beginning)
- The "Delete RAD workspace" option is now checked by default
- Bug fix for the
WORKSPACEenvironment variable on Windows: RAD/BU expects it to be an absolute path, not a relative one
- Experimental (not yet tested): New "Create PROJECT_WORKSPACE
variable" option to provide a replacement for the
- Bug fix for the
workspaceenvironment variable on Linux
- Switch to the right
groupId(org.jvnet.hudson.plugins rather than hudson.plugins)
If you use version a RAD or a BU installation on Linux, you need to
eclipse/bin/runAnt.sh to change
workspace environment variable to
WORSKPACE. Otherwise, RAD/BU
may fail complaining that no valid workspace has been found (depending
on the permissions of the user used to run RAD/BU). This has been fixed
- Initial release