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.

  1. Use the show clustercommand to ensure that all the cluster members are up and in a consistent state.

  2. Wait till the cluster is ready to attempt the upgrade operation.

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.

  1. Use the from imageproperties to determine if the existing free-disk size meets the requirements of the new image.

  2. The from-image properties can be retrieved by show image <from-image> command

  1. This requires the user to actively intervene and initiate cleanup.

  2. Check for cores and initiate a cleanup.

  3. Check for tech-support tarballs and initiate a cleanup.

  4. Check for unused-images through show image and initiate a cleanup.

  5. Check if images are present in non-standard directories (/home/admin, etc.) and clean up.

  6. Check for /tmp/ and initiate a cleanup.

  7. Perform a du -sh from the root and cleanup the outliers.

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. Use thefrom imageproperties to determine the if the existing free-disk size meets the requirements of the new image.

  2. The from-image properties can be retrieved by the show image <from-image> command.

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