This section explains the steps to upgrade NSX Advanced Load Balancer System (NSX Advanced Load Balancer Controller and SE Groups)
Prechecks_only Flag
Starting with NSX Advanced 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 NSX Advanced 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 | +--------------------+------------------------------------------------------------------------------------------------+