Upgrade

This document describes steps to upgrade your self-hosted Private Cloud Director deployment.

To upgrade all regions of your Private Cloud Director setup, run the following command:

Bash

airctl upgrade --config /opt/pf9/airctl/conf/airctl-config.yaml

To upgrade a specific region, run the following command, replacing with the name of the region you'd like to upgrade:

Bash

airctl upgrade --region <region-name> --config /opt/pf9/airctl/conf/airctl-config.yaml

Sample output of the upgrade command for a specific region:

Bash

# airctl upgrade --region Region1 --config /opt/pf9/airctl/conf/airctl-config.yaml
 INFO  rollback state directory /tmp/airctl_ddu_backup_Region1_240020739                           
 INFO  Saving the helm revisions to the state file                                        
 INFO  --- backing up region--- Region1                                                             
 INFO  Archive created successfully for Region1. Backup backup.tar.gz saved to /tmp/airctl_ddu_backup_Region1_240020739                                                        
 INFO  --- moving old state file to /tmp/airctl_ddu_backup_Region1_240020739/state.yaml ---        
 INFO  --- moving old kplane_values.yaml file to /tmp/airctl_ddu_backup_Region1_240020739/kplane_values.yaml ---                                     
 SUCCESS  Upgrading region Region1                                                      
upgrade done

Update PXC objects:

Warning

Running airctl upgrade from previous version (December release) to current version will not update the memory requests and limits for percona pxc-db statefulsets.

Bash

kubectl patch pxc percona-db-pxc-db -n <namespace> --type='merge' -p '{"spec":{"pxc":{"resources":{"requests":{"memory":"3Gi"},"limits":{"memory":"6Gi"}}}}}'

Once this command is run, statefulset percona-db-pxc-db-pxc for the respective namespace will get updated and new replicas will get created with updated memory requests and limits.