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.
Note
MetalK8s supports downgrade of at most one major version at a time. For example:
- from 124.2.0 to 123.1.2,
- from 124.0.0 to 123.0.1.
Refer to the release notes for more information.
downgrade_not_supported
Warning
Version only supports downgrade of minor and patch version.
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>
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.
- Run the utility script shipped with the current installation providing it with the destination version.
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.