cluster run-upgrade-validations

  • Updated on Jan 31, 2026
  • Published on Jan 28, 2026
  • 1 minute(s) read
Prev Next

This command performs pre-upgrade validations without performing an upgrade on the VAST Cluster core platform and VMS software. The upgrade validations performed with this command are also performed as part of the upgrade process. Running them alone before initiating the upgrade can help you identify an issue that may require fixing so that the upgrade will be successful or to decide to skip hardware validations when actually upgrading.

Usage
 cluster run-upgrade-validations [--skip-os-upgrade-validations]
                                 [--skip-hardware-validations]
                                 [--force]
Options

--skip-os-upgrade-validations

Skips validations that are needed for OS upgrades, including:

  • Unmounting certain mountpoints on the hosts if they are found.  

  • Validating free space

  • Validating the presence and correct configuration of pre-requisite files on the hosts.

  • Verifying supported ssd models in DBoxes.

  • Verifying host-to-switch connectivity.

  • Checking every DBox FPGA is responsive.

--skip-hardware-validations

Skips validation of hardware component health. Use with caution since component redundancy is important in NDU. The following validations are skipped with this option selected:

  • Verification that the MTU of each NIC is correctly configured.

  • Verifying that all DNodes are active.

  • Verifying SSH connectivity to all hosts.

--force

Skips validation of the NVRAM RAID state, which should not be disabled for upgrade.

Related articles