Skip to main content
ONTAP 9.16.1 commands

cluster image validate

Contributors
Suggest changes
PDFs

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.

Note 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. Refer to the Upgrade Advisor Plan or the "What should I
verify before I upgrade with or without Upgrade Advisor" section in the
"Upgrade ONTAP" documentation for the remaining manual validation checks
that need to be performed before update.
Upgrade ONTAP documentation available at: https://docs.netapp.com/us-en/ontap/upgrade/index.html
The list of checks are available at: https://docs.netapp.com/us-en/ontap/upgrade/task_what_to_check_before_upgrade.html
Failing to do so can result in an update failure or an I/O disruption.
Please use Interoperability Matrix Tool
(IMT  http://mysupport.netapp.com/matrix) 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.
Refer to the Upgrade Advisor Plan or the "What should I verify before
I upgrade with or without Upgrade Advisor" section in the
"Upgrade ONTAP" documentation for the remaining manual validation
checks that need to be performed before update.
Upgrade ONTAP documentation available at: https://docs.netapp.com/us-en/ontap/upgrade/index.html
The list of checks are available at: https://docs.netapp.com/us-en/ontap/upgrade/task_what_to_check_before_upgrade.html
Failing to do so can result in an update failure or an I/O disruption.
Please use Interoperability Matrix Tool
(IMT  http://mysupport.netapp.com/matrix) to verify host system
supportability configuration information.

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