Why does Beekeeper not offer simplified upgrades ?

Article ID:360024965712
2 minute readKnowledge base

Issue

  • I received a security warning that mentions that I need to do an incremental upgrade but the Upgrades section of Beekeeper shows "No upgrades are available."

  • Once a new full version is available, I cannot see incremental upgrades in the Beekeeper Upgrade Assistant. I only see the new full upgrade.

Environment

Explanation

Beekeeper detects new upgrades from update sites (update centers) similar to how it detects new versions of plugins.

The default behavior of Beekeeper is to offer the latest upgrade available. That includes simplified upgrades (also known as revision or incremental upgrades) or full upgrades.

However, only one upgrade is advertised, and the full upgrade takes precedence over simplified upgrades. If a new full upgrade is available, simplified upgrades are not offered anymore by Beekeeper.

Resolution

Running the latest CloudBees CI full version

In that case, simplified upgrade should be visible. Refresh the update center metadata:

  • Navigate to Manage Jenkins  Manage Plugins

  • Click Check Now

Allow few seconds for Jenkins to refresh the metadata. Then navigate to Manage Jenkins  Beekeeper Upgrade Assistant  Upgrades

Not running the latest CloudBees CI full version

In that case, this is expected. System properties can be used to control that behavior.

Property Description

cb.BeekeeperProp.noFullUpgrade

Default to false. Do not check for full upgrades.

cb.BeekeeperProp.autoInstallIncremental

Default to false. Install incremental upgrades automatically at startup.

In order to see the offered simplified upgrade:

Then navigate to Manage Jenkins  Beekeeper Upgrade Assistant  Upgrades where you should see the upgrade.

In that scenario, it would take to restart to complete the simplified upgrade. One restart to be able to see it. Then another restart to apply it. To minimize the number of restart, the property -Dcb.BeekeeperProp.autoInstallIncremental can be added to automatically carry out the simplified upgrade on startup when it is available.

Not running the latest CloudBees CI full version and temporarily enable the revision update

  1. Navigate to Manage Jenkins  Script Console

  2. Copy and paste the following lines into the text box provided:

     com.cloudbees.jenkins.plugins.assurance.props.BeekeeperProp.get().NO_FULL_UPGRADES.set()
 com.cloudbees.jenkins.plugins.assurance.CloudBeesAssurance.get().refreshStateSync()
 println "Success"

  3. Click Run. You should see the word Success printed.

  4. Navigate to Manage Jenkins  Manage Plugins

  5. Click Check Now

Then navigate to Manage Jenkins  Beekeeper Upgrade Assistant  Upgrades where you should see the upgrade.

References