Skip to content

After migration of Rancher between different Kubernetes distriubtions, via the rancher-backup operator, the local cluster distribution within Rancher is not updated

Article Number: 000021577

Environment

Rancher 2.5+

Situation

Migration of Rancher from one Kubernetes distribution to another, e.g. from K3s to RKE2, using the Rancher Backup Operator.

Cause

The rancher-backup operator performs a restore of Rancher configuration resources, without manipulating any of these in the process. As a result, when migrating Rancher between different cluster types, values within the local cluster.management.cattle.io resource need to be manually updated to to reflect the change in distribution. Further details can be found in the GitHub issue at https://github.com/rancher/rancher/issues/42158

Resolution

Follow the documented steps at the end of point 2. Restore from backup using a Restore custom resource in the Rancher migration documentation, to update the distribution version of the Rancher local cluster within the Rancher state.