ONTAP 9.16.1 commands ( CA08871-226en )

cluster image validate

Validates the cluster’s update eligibility

Availability: This command is available to cluster administrators at the admin privilege level.

Description

The cluster image validate command checks for issues within the cluster that might lead to problems during the update.

Parameters

[-fields <fieldname>,…​]

If you specify the -fields <fieldname>, …​ parameter, the command output also includes the specified field or fields. You can use '-fields ?' to display the fields to specify.

[-version <text>] - Update Version

Specifies the ONTAP version to use to validate the cluster.

[-rolling <true>] - Rolling Update

Specify this optional parameter on a cluster with eight or more nodes to perform a rolling-update check. The default is to perform a batch-update check.

This parameter is only supported on a cluster with eight or more nodes, and is not supported for two-node MetroCluster.
[-nodes {<nodename>|local}] - Nodes

Specifies the nodes that are to be validated. This parameter is not supported for MetroCluster configurations and for two-stage upgrades.

[-show-validation-details <true>] - Shows All Validation Details

Specify to display all validation details. Default: do not display all details.

[-skip-nodes-at-target-version <true>] - Skip Nodes at Target Version (privilege: advanced)

Specifies that the validation will skip the nodes which are already running target version. Default: true.

Examples

The following example shows the validate operation:

cluster1::> cluster image validate -version 9.16.1

It can take several minutes to complete validation...

WARNING: There are additional manual upgrade validation checks that must be performed after these automated validation checks have completed successfully.
Upgrade ONTAP documentation available at: link:../axhx/upgrade/index.html
The list of checks are available at: link:../axhx/upgrade/task_what_to_check_before_upgrade.html
Failing to do so can result in an update failure or an I/O disruption.
Please contact our support personnel to verify host system supportability configuration information.

Validation checks started. Run the "cluster image show-update-progress" command to check validation status.

The following example shows the validate operation with validation details:

cluster1::> cluster image validate -version 9.16.1 -show-validation-details

It can take several minutes to complete validation...

WARNING: There are additional manual upgrade validation checks that must be performed after these automated validation checks have completed successfully.
Upgrade ONTAP documentation available at: link:../axhx/upgrade/index.html
The list of checks are available at: link:../axhx/upgrade/task_what_to_check_before_upgrade.html
Failing to do so can result in an update failure or an I/O disruption.
Please contact our support personnel to verify host system supportability configuration information.

Validation checks started.  Run the "cluster image show-update-progress" command to check validation status.
Top of Page