Rollback Guide: From SMCP 5.12 to SMCP 5.11

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:

None

wget https://raw.githubusercontent.com/platform9/support-locker/master/edge-stack/download.sh 
#Download script

chmod u+x download.sh 
# change permission

./download.sh <PF9-SHARED-SECRET> v-5.11.1-3501826
# Download artifacts 

bash install.sh v-5.11.1-3501826
# Install artifacts

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:

None

isAirgapped: true
systemImages:
- /opt/pf9/airctl/imgs/kubedu-imgs-v-5.11.1-3501826.tar.gz
- /opt/pf9/airctl/imgs/nodelet-imgs-v-5.11.1-3501826.tar.gz
userImages:
- /opt/pf9/airctl/imgs/kubedu-imgs-v-5.12.1-3802903.tar.gz

4. Use upgrade-mgmt to SMCP 5.11 Management Cluster

None

airctl advanced-ddu upgrade-mgmt

5. Verify DU Status

Check that the DU is in a ready state:

None

airctl status

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):

None

sudo airctl advanced-du push-images --img-tar [tar file name]

To push all new images at once:

None

ls -1 /opt/pf9/airctl/imgs/k8s* | xargs -I{} sh -c "sudo /opt/pf9/airctl/airctl --config /opt/pf9/airctl/conf/airctl-config.yaml advanced-du push-images --img-tar {}"

9. Upgrade Host Components

Upgrade the host-side components to SMCP 5.11:

None

airctl configure-hosts --reset-pf9-managed-docker-conf --skip-docker-install --skip-docker-img-import --verbose airctl hosts-status airctl upgrade-hosts --verbose

10. Verify Status and Version

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

None

airctl status
# Check the status of management plane

airctl version
# The output should be: v-5.11.1-3501826

kubectl get nodes -o wide
# Ensure all the nodes are in Ready state