This is a draft document that was built and uploaded automatically. It may document beta software and be incomplete or even incorrect. Use this document at your own risk.

Jump to contentJump to page navigation: previous page [access key p]/next page [access key n]
SUSE Telco Cloud Documentation|Day 2 Operations|Edge 3.7 migration
Applies to SUSE Telco Cloud 3.7

59 Edge 3.7 migration

 

This section explains how to migrate your management and downstream clusters from SUSE Telco Cloud 3.6 to SUSE Telco Cloud 3.7.0.

Important
Important

Always perform cluster migrations from the latest Z-stream release of SUSE Telco Cloud 3.6.

Always migrate to the SUSE Telco Cloud 3.7.0 release. For subsequent post-migration upgrades, refer to the management (Chapter 60, Management Cluster) sections.

The following table lists the different types of clusters and the methods to upgrade clusters:

Table 59.1: Clusters and methods to upgrade downstream clusters
 
Cluster typeMethod

EIB provisioned clusters

See Section 59.1.3, “Fleet” for details.

Metal3 provisioned clusters

See Downstream cluster upgrades (Section 61.3, “Downstream cluster upgrades”) for details.

59.1 Management Cluster

 

This section covers the following topics:

Section 59.1.1, “Prerequisites” - prerequisite steps to complete before starting the migration.

Section 59.1.2, “Upgrade Controller” - how to do a management cluster migration using the Chapter 22, Upgrade Controller.

Section 59.1.3, “Fleet” - how to do a management cluster migration using Chapter 9, Fleet.

59.1.1 Prerequisites

 

59.1.1.1 Upgrade the Bare Metal Operator CRDs

 
Note
Note

Applies only to CAPI/Metal3 management clusters that require a Chapter 12, Metal3 chart upgrade.

The Metal3 Helm chart includes the Bare Metal Operator (BMO) CRDs by leveraging Helm’s CRD directory.

However, this approach has certain limitations, particularly the inability to upgrade CRDs in this directory using Helm. For more information, refer to the Helm documentation.

As a result, before upgrading Metal3 to an SUSE Telco Cloud 3.7.0 compatible version, users must manually upgrade the underlying BMO CRDs.

On a machine with Helm installed and kubectl configured to point to your management cluster:

  1. Manually apply the BMO CRDs:

    helm show crds oci://registry.suse.com/edge/charts/metal3 --version 307.0.31+up0.16.0 | kubectl apply -f -

59.1.2 Upgrade Controller

 
Important
Important

The Upgrade Controller currently supports SUSE Telco Cloud release migrations only for non air-gapped management clusters.

The following topics are covered as part of this section:

Section 59.1.2.1, “Prerequisites” - prerequisites specific to the Upgrade Controller.

Section 59.1.2.2, “Migration steps” - steps for migrating a management cluster to a new SUSE Telco Cloud version using the Upgrade Controller.

59.1.2.1 Prerequisites

 
59.1.2.1.1 SUSE Telco Cloud 3.7 Upgrade Controller
 

Before using the Upgrade Controller, you must first ensure that it is running a version that is capable of migrating to the desired SUSE Telco Cloud release.

To do this:

  1. If you already have Upgrade Controller deployed from a previous SUSE Telco Cloud release, upgrade its chart:

    helm upgrade upgrade-controller -n upgrade-controller-system oci://registry.suse.com/edge/charts/upgrade-controller --version 307.0.4+up0.1.3

  2. If you do not have Upgrade Controller deployed, follow Section 22.3, “Installing the Upgrade Controller”.

59.1.2.2 Migration steps

 

Performing a management cluster migration with the Upgrade Controller is fundamentally similar to executing an upgrade.

The only difference is that your UpgradePlan must specify the 3.7.0 release version:

apiVersion: lifecycle.suse.com/v1alpha1
kind: UpgradePlan
metadata:
  name: upgrade-plan-mgmt
  # Change to the namespace of your Upgrade Controller
  namespace: CHANGE_ME
spec:
  releaseVersion: 3.7.0

For information on how to use the above UpgradePlan to do a migration, refer to Upgrade Controller upgrade process (Section 60.1, “Upgrade Controller”).

59.1.3 Fleet

 
Note
Note

Whenever possible, use the Section 59.1.2, “Upgrade Controller” for migration.

Refer to this section only for use cases not covered by the Upgrade Controller.

Performing a management cluster migration with Fleet is fundamentally similar to executing an upgrade.

The key differences being that:

  1. The fleets must be used from the release-3.7.0 release of the suse-edge/fleet-examples repository.

  2. Charts scheduled for an upgrade must be upgraded to versions compatible with the SUSE Telco Cloud 3.7.0 release. For a list of the SUSE Telco Cloud 3.7.0 components, refer to Section 79.3, “Release 3.7.0”.

Important
Important

To ensure a successful SUSE Telco Cloud 3.7.0 migration, it is important that users comply with the points outlined above.

59.2 Downstream Clusters

 

Section 59.2.1, “Fleet” - how to do a downstream cluster migration using Chapter 9, Fleet.

59.2.1 Fleet

 

Performing a downstream cluster migration with Fleet is fundamentally similar to executing an upgrade.

The key differences being that:

  1. The fleets must be used from the release-3.7.0 release of the suse-edge/fleet-examples repository.

  2. Charts scheduled for an upgrade must be upgraded to versions compatible with the SUSE Telco Cloud 3.7.0 release. For a list of the SUSE Telco Cloud 3.7.0 components, refer to Section 79.3, “Release 3.7.0”.

Important
Important

To ensure a successful SUSE Telco Cloud 3.7.0 migration, it is important that users comply with the points outlined above.