Jenkins : Config Rotator Plugin

Plugin Information

View Config Rotator on the plugin site for more information.

Developed by

Sponsored by

Config Rotator, now with Git support


In ClearCase UCM a composite baseline describes dependencies between different baselines of components in a parent/child relation.

This 'dependency graph' in a composite baseline describes a configuration, where one specific baselines defines a relation to other specific baselines – potentially nested in several layers.

But it can also be regarded as a more generic structure that simply describes a hierarchy of components.

When viewed as a hierarchy it's interesting to know, if another (newer) component in the structure would still be compliant with the configuration as a whole. Somebody ought to test
that each time a new baseline of a component in the hierarchy is released.

The Config Rotator monitors the SCM for newer versions of components in the structure, and executes this test when necessary. The configuration is only created temporary and only the
result of the try-out is stored. The actual tested configuration is not persisted. Component developers can subscribe to test results involving their components through ATOM feeds on the Jenkins job running the Config Rotator.

Supported SCMs

  • ClearCase UCM
  • Git, from version 1.1.0

Feature highlights

  • Try-out new configuration of components, including reset to old configuration to try again
  • Be able to subscribe to Atom feeds, by component, with information about new compatible or incompatible configuration with the component

Requirements and recommended setup

ClearCase UCM

  1. You need a working ClearCase environment for the user running the Jenkins build on the host (Jenkins master or slave) where the build is executed
  2. Plugin is in current version only tested on Windows
  3. Freestyle builds must be used
  4. Jenkins slaves are tested running as a service, or Java Webstart (it's important user running service or Java has a working ClearCase environment)

Future plans might be Linux support or other ways to setup job and master/slave. If you are using the plugin in other setups than the above, kindly let us know if it works or not.


Git requires no special setup.

Getting Started Guide

In the Source Code Management section select the Config rotator option

ClearCase UCM Configuration

The Context Project VOB is where the UCM project of the temporary stream is located. In this Project VOB a special UCM Project must be created and named jenkins
Contribute data globally will write the resulting action of a config rotator build to a database specified in global configuration under the global configuration page:

The UCM configuration is a series of baselines describing the configurations.

  • Baseline A baseline describing a component of the configuration
  • Promotion level The required promotion level for the baseline
  • Fixed Fixation of configuration component. Can this component be rotated or not.
  • Name Source location of the workspace. If empty, the name of the repository is used.
  • Repository The URL of the Git repository.
  • Branch The branch to rotate. Master is used if empty.
  • Commit Offset commit to rotate from, either a SHA1 or tag.
  • Fixed Fixation of configuration component. Can this component be rotated or not.

Feature description

Trying a series of configurations

  • Set Your job up to poll the SCM
  • When Config Rotator finds new baselines, it starts building

Picture show a series of successfull build. The project/job page will show latest result for the configuration. If You click on the a build the tested configuration from the build is shown.

Click the Config Rotator link in the left menu on the project/job to view all tried configurations

Using feeds

  • Main page of Jenkins shows a link to the Config Rotator feed page
  • For every component in a build earlier executed, a feed for the component contains information about the outcome of the test showing compatible or incompatible. |
  • Use your favorite RSS/Atom feed reader and subscribe the links.

Reset to old configuration

If You wan't to try a configuration once more, and continue from that time on, go to the job, click a build and on the build page click Reset to this configuration

  • Note that resetting to a configuration applies only on the next build, thus the project/job page is first updated after next build.

Changes link working on component baselines

We have implement the Changes feature to show changes between the baselines of the changes component in the configuration.

Known Issues (current version)

If it's broken ...We Can Fix It!

  • We've had people reporting issues when trying to copy existing jobs using the config rotator SCM component, where the copied data is different from the target job. 
  • There are issues with changesets prior to 1.0.1. The changeset would not properly recognize the user of the change. This should is fixed in the most recent version. We've had to change the format of the changes.xml files created by the job, so only changesets generated with 1.0.2 will work as designed, and 1.0.1 changeset will still show the user as 'unknown'.
  • "Build has failed" mails are sent even though the build is marked as "nothing to do". Make sure the email plugin is run after the config rotator post build step. Yes, there is such a thing. Normally it is added automatically, inserted at random. It is required and cannot be disabled.
type key summary

Can't show details. Ask your admin to whitelist this Jira URL.

View these issues in Jira


Version 2.0.0(August 25, 2016)

  • Fixed an issue with the Git implementation not releasing file handles on windows (#10)
  • Fixed an issue that prevented job being saved on Jenkins 2.13+ (#9)

Version 1.3.1(October 12, 2015)

Version 1.3.0(August 28, 2015)

  • Add 'Use newest' option for Config Rotator when using ClearCase as SCM (JENKINS-28983)

Version 1.2.1(August 18, 2015)

  • Fixed an issue with Filters not working properly in ClearCase (JENKINS-29975)

Version 1.2.0(July 6, 2015)

  • Introduced the ability to add data for subscription (JENKINS-27215)
  • Added the ability to turn this feature on/off (JENKINS-28065)

Version 1.1.8(Januar 29, 2015)

Version 1.1.8(November 17, 2014)

  • Properly trigger reset, when job altered and saved (JENKINS-24822)

Version 1.1.7(August 16, 2014)

Version 1.1.6(June 23, 2014)

  • Fixed an issue with clearcase, unable to create workspace when view is deleted (JENKINS-22832)

Version 1.1.5(May 2, 2014)

Version 1.1.4(March  11, 2014)

  • Improved the layout in IE9. The layout is now longer garbled when usiing IE9. (JENKINS-20981)
  • Fixed an issue with rebasing, the plugin will now attempt to cancel a rebase if it underway (JENKINS-22058)

Version 1.1.3(December 20, 2013)

  • ClearCase UCM: Clarified error message (JENKINS-21068)
  • ClearCase UCM: Improved checkout performance (JENKINS-21069)
  • Fixed an issue where polling could result in 'Nothing to do' grey builds (JENKINS-21066)
  • ClearCase UCM: Handling hijacked files (JENKINS-21065)

Version 1.1.2(August 26, 2013)

Version 1.1.1(June 4, 2013)

  • Config Rotator triggers, but nothing new is found (JENKINS-18194)
  • Config spec for ClearCase UCM is not created correctly (JENKINS-17803)

Version 1.1.0(April 14, 2013)

Version 1.0.4(April 3, 2013)

  • Config Rotator does not trig on new baseline (JENKINS-17229)
  • Use nothing to build (grey builds) if there is no new baselines (JENKINS-14746)

Version 1.0.3(April 2, 2013), faulty release

Version 1.0.2

  • Changesets are now visualized like they are in the ClearCase UCM Plugin
  • Fixed user identity in changeset - JENKINS-15481

Version 1.0.1

Release note

We have implemented two levels of check of configuration. The first check is if configuration is loadable in ClearCase. The second level of check is if the configuration added make sense in a context of configuration rotation. Eg. config-rotator does not allow the same component more the once.

Polling check the first level, and abort polling if check is not passed.
Builds do both checks and fail if not passed.

Version 1.0.0, initial version


Screen Shot 2012-04-20 at 4.02.35 PM.png (image/png)
Screen Shot 2012-04-20 at 4.29.53 PM.png (image/png)
Screen Shot 2012-04-20 at 4.35.23 PM.png (image/png)
onlyOneComponentError.png (image/png)
cc_ucmconfig.png (image/png)
cc_ucmconfig.png (image/png)
cc_ucmconfig.png (image/png)
praqma_logo.png (image/png)
grundfos_logo.jpg (image/jpeg)
dump2.png (image/png)
cc_ucmconfig2.png (image/png)
configrotatormainmenulink.png (image/png)
configrotatorfeedpage.png (image/png)
changes.png (image/png)
changes2.png (image/png)
reset2conf.png (image/png)
projectpage.png (image/png)
reset2conf.png (image/png)
changes2.png (image/png)
projectpage.png (image/png)
overviewofconfiguration.png (image/png)
praqma_logo_70x70.jpg (image/jpeg)
url-1.jpeg (image/jpeg)
ccucmconfigure.png (image/png)
configure1.png (image/png)
gitconfigure.png (image/png)
Contribute.png (image/png)
ccucm_config.png (image/png)
CR_Contribute.png (image/png)