Cluster Downgrade

MetalK8s clusters are downgraded using the utility scripts that are packaged with your current installation. This topic describes downgrading MetalK8s and all components included in the stack.

Supported Versions

Note

MetalK8s supports downgrade of at most one minor version at a time. For example:

  • from 2.4.4 to 2.4.1,

  • from 2.5.1 to 2.4.0.

Refer to the release notes for more information.

Warning

Version 2.11.0-alpha1-52-gaf16ae393-dirty only supports downgrade of patch version.

Prerequisites

ISO Preparation

Provision a new MetalK8s ISO by running the utility script shipped with the current installation.

/srv/scality/metalk8s-X.X.X/iso-manager.sh -a <path_to_iso>

Pre-Checks

You can test if your environment will successfully downgrade with the following command.

/srv/scality/metalk8s-X.Y.Z/downgrade.sh --destination-version \
  <destination_version> --dry-run --verbose

This will simulate the downgrade pre-checks and provide an overview of the changes to be carried out in your MetalK8s cluster.

Important

The version prefix metalk8s-X.Y.Z must be the current installed MetalK8s version.

Downgrade

  1. Run the utility script shipped with the current installation providing it with the destination version.

  2. From the Bootstrap node, launch the downgrade.

    /srv/scality/metalk8s-X.Y.Z/downgrade.sh --destination-version <version>
    

Important

The version prefix metalk8s-X.Y.Z must be the current installed MetalK8s version.