This section explains the must-checks that are executed prior to the upgrade operations. Must-checks are specific to upgrade operations. It returns the messages as warnings or errors. Warnings can be skipped while errors cannot be overridden. NSX Advanced Load Balancer REST API/NSX Advanced Load Balancer CLI presents the skip_warnings option to control the above behavior.
For REST API: add /preview/ at the end of APIs described in V2 APIs to get previews for that particular flow
For NSX Advanced Load Balancer CLI: This is directly integrated into the normal work-flow and there is no separate command.
Must-Checks
This section describes various must-checks. The following table describes the detailed information on various error and warning messages. Use the steps mentioned in the recovery steps to proceed further with upgrade process.
Must-Check Name and Type |
Must-Check Message |
Description |
Recovery Steps |
Operation |
---|---|---|---|---|
CheckLicense(Error) |
License <name> is either expired or will expire within <num_days> days |
This check ensures that there is a minimum of 7 days of license validity |
Please reach out the customer success team to extend the license duration |
All upgrade operations |
CheckClusterState(Error) |
Controller cluster is not ready. All the cluster nodes should be ACTIVE before initiating the process. |
The cluster should be ready prior to initiate any upgrade operations. |
|
All upgrade operations |
ControllerUpgradeDiskSpace(Error) |
Node <node> does not have enough disk space for upgrade operations, The available space is <avail_space>, Required space is <req_space>. |
There is insufficient disk space on one or more of the cluster members.
|
|
All upgrade operations |
CheckControllerDiskSpace(Erorr) |
Node <node name> does not have enough disk space for upgrade operations, The available space is <avail_space>, Required space is <req_space> |
There is insufficient disk space on one or more of the cluster members. |
Please refer to the recovery steps mentioned for the ControllerUpgradeDiskSpace error. |
Upgrade, patch upgrade, SE group, and SE group resume |
CheckControllerRollbackDiskSpace |
Node <node name> does not have enough disk space for upgrade operations, The available space is <avail_space>, Required space is <req_space> |
There is insufficient disk space on one or more of the cluster members during rollback operations. The free-disk threshold for rollback operations is generally less than the free-disk threshold for upgrade operations. |
Please refer to the recovery steps mentioned for the ControllerUpgradeDiskSpace error. |
Rollback and rollback patch |
SeGroupUpgradeDiskSpace(Error) |
Node <node name> does not have enough disk space for upgrade operations, The available space is <avail_space>, Required space is <req_space> |
There is insufficient disk space on one or more ServiceEngines.
|
1. Check for cores and initiate a cleanup. 2. Check for /tmp and initiate a cleanup. 3. Use the du -sh command from the root directory and clean up the outliers. |
(Upgrade, patch) se group and (upgrade, patch) system |