OS Migration for SMCP 5.12

Prerequisites

• Backup of the SMCP 5.12 management plane

• Access to SMCP 5.11 artifacts

Rollback Procedure

1. Backup SMCP 5.12 Management Plane(Optional)

Follow the Backup Guide to create a backup of the current SMCP 5.12 management plane.

2. Download and Install SMCP 5.11 Artifacts

Download the SMCP 5.11 artifacts and install them:

3. Configure SMCP 5.11 Management Cluster

Update configuration files before deployment:

1. Edit airctl-config.yaml:

   • Update airctlBuildNumber to match the SMCP 5.9 version

2. Edit nodelet-bootstrap.yaml:

   • Update systemImages to use SMCP 5.11 image files

   • Set userImages to point to SMCP 5.12 image files

   • Add isAirgapped: true for offline installations

Example nodelet-bootstrap.yaml snippet:

4. Use upgrade-mgmt to SMCP 5.11 Management Cluster

5. Verify DU Status

Check that the DU is in a ready state:

Wait until all components show as ready before proceeding.

6. Upgrade DU Components (Optional)

If needed, follow the SMCP 5.11 upgrade guide to update the DU components.

7. Verify Rollback in GUI

Log in to the management UI and confirm the version is displayed as 5.11.

8. Push Required Kubernetes Images

Push images for the supported Kubernetes versions (1.28, 1.29, 1.30) to your private registry (if applicable):

To push all new images at once:

9. Upgrade Host Components

Upgrade the host-side components to SMCP 5.11:

10. Verify Status and Version

After the rollback, confirm the management plane is in a ready state: