This section explains the steps to upgrade Avi Load Balancer System (Avi Load Balancer Controller and SE Groups)

Prechecks_only Flag

Starting with Avi Load Balancer Controller 22.1.6, a new flag prechecks_only is introduced for all upgrade operations (upgrade, patch upgrade, rollback). The prechecks_only flag enables upgrade APIs to perform upgrade checks prior to an upgrade maintenance window. Executing the prechecks_only flag does not trigger any upgrade operation and it is safe to perform upgrade operations with the prechecks_only flag outside of a maintenance window.

Use the upgrade controller image_ref <image_name> prechecks_only command to inititate the prechecks_only operation for Avi Load Balancer Controller.

[admin:100-65-10-137]: > upgrade controller image_ref 22.1.6-8143-20240115.080016 prechecks_only
Previewing upgrade
+-------------+-----------------------------------------------------------------------------------------+
| Field       | Value                                                                                   |
+-------------+-----------------------------------------------------------------------------------------+
| status_code | SYSERR_UPGRADE_OPS_PREVIEW_RESPONSE                                                     |
| status      | Checks preview for upgrade operations.                                                  |
| checks      |                                                                                         |
|             | 'Checking Controller Cluster readiness for upgrade operations.'                         |
|             | 'Check if upgrade operation is already in progress.'                                    |
|             | 'Checking active versions compatibility for upgrade operations.'                        |
|             | 'Checking if system in Avi-ESSENTIALS/BASIC mode and allows only permitted operations.' |
|             | 'Checking if the cloud api versions are compatible after upgrade.'                      |
|             | 'Checking ServiceEngineGroup has an ongoing upgrade operation.'                         |
|             | 'Checking Controller Cluster disk space for upgrade operations.'                        |
|             | 'Checking image version compatibility for upgrade operations.'                          |
|             | 'Checking idempotent operations for upgrade operations.'                                |
|             | 'Checking Image state across Cluster members for upgrade operations.'                   |
|             | 'Checking the system configuration.'                                                    |
|             | 'Checking config migration.'                                                            |
|             | 'Checking if Gslb Maintenance Mode is enabled prior to upgrade.'                        |
|             | 'Checking if Gslb Feature is enabled and provides feature specific messages.'           |
|             | 'Checking and inform user to take a backup prior to upgrade operations.'                |
|             | 'Checking if Docker version is compatible.'                                             |
|             | 'Checking for the mandatory patch in image bundle.'                                     |
|             | 'Checking if configured IP type is DHCP or STATIC.'                                     |
|             | 'Checking if se linux is enabled on controller nodes.'                                  |
|             | 'Checking total number of alerts for upgrade operations.'                               |
+-------------+-----------------------------------------------------------------------------------------+
Starting upgrade
+--------------------+------------------------------------------------------------------------------------------------+
| Field              | Value                                                                                          |
+--------------------+------------------------------------------------------------------------------------------------+
| status_code        | SYSERR_EVAL_UPGRADE_CONTROLLER_STARTED                                                         |
| status             | 'Pre-checks for Upgrade of Controller started. Use 'show upgrade status' to check the status.' |
| system_report_uuid | systemreport-6f499bff-fcbd-4fca-a43a-483d1764eed5                                              |
+--------------------+------------------------------------------------------------------------------------------------+