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:

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:

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

airctl advanced-ddu upgrade-mgmt

###

5. Verify DU Status

Check that the DU is in a ready state:

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

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

To push all new images at once:

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:

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:

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