How to upgrade CJE?

Issue

  • Jenkins notifies that a new version is available but how can I upgrade my cluster
  • How to upgrade CJE Operations Center
  • How to upgrade CJE Managed Master(s)

Environment

  • CloudBees Jenkins Enterprise (CJE)

Resolution

The proper way to upgrade CJE if to upgrade the CJE CLI. This will automatically upgrade the components of your cluster.

Upgrade Warnings

The upgrade notification in Jenkins is shown in the UI via an administrative monitor:

It can also be seen under Manage Jenkins. At the time of the article (CJE 1.6.3), this message guides the users to a broken link and should be ignored. The upgrade path for CJE is via the CJE CLI.

Upgrade CJE

Upgrading CloudBees Jenkins Enterprise consists of the following steps:

1) Download a new CloudBees Jenkins Enterprise release

2) Install the new release locally (extract the downloaded archive and the bin directory to the $PATH):

$ cd ~
$ tar zxvf pse_1.6.1_linux_amd64.tar.gz
$ export PATH=~/pse_1.6.1/bin:$PATH

3) Upgrade the CloudBees Jenkins Enterprise project by running the following under the CloudBees Jenkins Enterprise project:

$ cje upgrade-project

Note: In most cases this command will be a no-op.

4) Upgrade CloudBees Jenkins Enterprise components:

$ cje upgrade

Cluster components will be temporarily unavailable during the procedure.

Note: The steps to upgrade CJE are described in the CLI reference

Upgrade Managed Masters

Once Cloudbees Jenkins Enterprise has been upgraded, you should see that a new version of the docker image is available for your Managed Master(s):

Per-Master Upgrade

To upgrade your Managed Master:

1) Stop the Managed Master:

You will have the option to Wait for jobs completion or Force the shutdown:

2) Change the docker image in the Managed Master configuration and save:

3) Start the Managed Master:

Note: The steps to upgrade a Managed Master are described in Operating CloudBees Jenkins Enterprise - Upgrading Managed Masters

Bulk Upgrade

To upgrade multiple Managed Masters:

1) Create a Cluster operation

2) Choose which masters to target. Use the filter Uses Docker Image and pick the current version:

3) Add a Update Docker Image step with the new version and a Reprovision step:

4) Launch the cluster operation to start the upgrade

Note: The steps to bulk upgrade Managed Masters are described in Operating CloudBees Jenkins Enterprise - Bulk-upgrading Managed Masters

Related Articles

Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.