Upgrading NSX Advanced Load Balancer Controller

This section explains about upgrading NSX Advanced Load Balancer Controller.

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

Enabling the prechecks_only flag enables upgrade APIs to perform upgrade checks prior to an upgrade maintenance window. When this flag is enabled, only the list of pre-check actions is performed on NSX Advanced Load Balancer Controller Controller. Executing the prechecks_only flag does not trigger any upgrade operation. Please note it is safe to perform upgrade operation with 'prechecks_only' flag outside of maintenance window.

Use the upgrade controller image_ref <image_name> prechecks_only command to inititate the prechecks_only flag.

[admin:10-x-x-1]: > 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.'                               |
+-------------+-----------------------------------------------------------------------------------------+

Note:

Presently, the prechecks_only flag is not available through NSX Advanced Load Balancer Controller UI.