When you perform an automated upgrade, ONTAP automatically installs the target ONTAP image on each node, validates that the cluster can be upgraded successfully, and then executes either a batch or rolling upgrade in the background based on the number of nodes in the cluster.

If it is supported by your configuration, you should use ONTAP System Manager to perform an automated upgrade. If your configuration does not support automated upgrade using ONTAP System Manager, you can use the ONTAP command line interface (CLI) to perform an automated upgrade.

Modifying the setting of the storage failover modify-auto-giveback command option before the start of an automatic nondisruptive upgrade (ANDU) has no impact on the upgrade process. The ANDU process ignores any preset value to this option during the takeover/giveback required for the update. For example, setting -autogiveback to false prior to beginning ANDU does not interrupt the automatic upgrade before giveback.

Before you begin

You should prepare for your upgrade.
You should download the ONTAP software image for your target ONTAP release.

If you are performing a direct multi-hop upgrade, you need to download both of the ONTAP images required for your specific upgrade path.

For each HA pair, each node should have one or more ports on the same broadcast domain.

If your ONTAP cluster has 8 or more nodes, the batch upgrade method is used in the automatic nondisruptive upgrade to preemptively force data LIF migration prior to SFO takeover. How LIFs are migrated during a batch upgrade varies based on your version of ONTAP.

If you are running ONTAP…	LIFs are migrated…
9.15.1 or later 9.14.1P5 9.13.1P10 9.12.1P13 9.11.1P16, P17 9.10.1P19	To a node in the other batch group. If the migration to the other batch group fails, the LIFs are migrated to the node’s HA partner in the same batch group.
9.8 through 9.14.1	To a node in the other batch group. If the network broadcast domain doesn’t allow LIF migration to the other batch group, the LIF migration fails and ANDU pauses.
9.7	To the HA partner of the node being upgraded. If the partner doesn’t have any ports in the same broadcast domain, then LIF migration fails and ANDU pauses.

If you are running ONTAP…

LIFs are migrated…

9.15.1 or later
9.14.1P5
9.13.1P10
9.12.1P13
9.11.1P16, P17
9.10.1P19

To a node in the other batch group.

If the migration to the other batch group fails, the LIFs are migrated to the node’s HA partner in the same batch group.

9.8 through 9.14.1

To a node in the other batch group.

If the network broadcast domain doesn’t allow LIF migration to the other batch group, the LIF migration fails and ANDU pauses.

9.7

To the HA partner of the node being upgraded.

If the partner doesn’t have any ports in the same broadcast domain, then LIF migration fails and ANDU pauses.

If you don’t plan to monitor the progress of the upgrade process, you should request EMS notifications of errors that might require manual intervention.

Example 1. Steps

ONTAP System Manager

Validate the ONTAP target image:

If you are upgrading a MetroCluster configuration, you should validate Cluster A and then repeat the validation process on Cluster B.

Depending on the ONTAP version that you are running, perform one of the following steps:

If you are running…

Do this…

ONTAP 9.8 or later

Click Cluster > Overview.

ONTAP 9.7

Click Configuration > Cluster > Update.
In the right corner of the Overview pane, click .
Click ONTAP Update.

If you are running…	Do this…
ONTAP 9.8 or later	Click Cluster > Overview.
ONTAP 9.7	Click Configuration > Cluster > Update.

In the Cluster Update tab, add a new image or select an available image.

If you want to…	Then…
Add a new software image from a local folder You should have already downloaded the image to the local client.	Under Available Software Images, click Add from Local. Browse to the location you saved the software image, select the image, and then click Open.
Add a new software image from an HTTP or FTP server	Click Add from Server. In the Add a New Software Image dialog box, enter the URL of the HTTP or FTP server to which you downloaded the ONTAP software image from the Technical Support Site. For anonymous FTP, you must specify the URL in the ftp://anonymous@ftpserver format. Click Add.
Select an available image	Choose one of the listed images.

If you want to…

Then…

Add a new software image from a local folder

You should have already downloaded the image to the local client.

Under Available Software Images, click Add from Local.
Browse to the location you saved the software image, select the image, and then click Open.

Add a new software image from an HTTP or FTP server

Click Add from Server.
In the Add a New Software Image dialog box, enter the URL of the HTTP or FTP server to which you downloaded the ONTAP software image from the Technical Support Site.

For anonymous FTP, you must specify the URL in the ftp://anonymous@ftpserver format.
Click Add.

Select an available image

Choose one of the listed images.

Click Validate to run the pre-upgrade validation checks.

If any errors or warnings are found during validation, they are displayed along with a list of corrective actions. You must resolve all errors before proceeding with the upgrade. It is best practice to also resolve warnings.

Click Next.

Click Update.

Validation is performed again. Any remaining errors or warnings are displayed along with a list of corrective actions. Errors must be corrected before you can proceed with the upgrade. If the validation is completed with warnings, you correct the warnings or choose Update with warnings.

By default, ONTAP uses the batch upgrade process to upgrade clusters with eight or more nodes. Beginning in ONTAP 9.10.1, if preferred, you can select Update one HA pair at a time to override the default and have your cluster upgrade one HA pair at a time using the rolling upgrade process.

For MetroCluster configurations with more than 2 nodes, the ONTAP upgrade process starts simultaneously on the HA pairs at both sites. For a 2-node MetroCluster configuration, the upgrade is started first on the site where the upgrade is not initiated. The upgrade on the remaining site begins after the first upgrade is fully completed.

After you finish

After the upgrade is completed successfully, the node reboots, and you are redirected to the ONTAP System Manager login page. If the node takes a long time to reboot, you should refresh your browser.

CLI

Validate the ONTAP target software image

If you are upgrading a MetroCluster configuration you should first execute the following steps on cluster A, then execute the same steps on cluster B.
1. Delete the previous ONTAP software package:
  cluster image package delete -version previous_ONTAP_Version
2. Load the target ONTAP software image into the cluster package repository:
  cluster image package get -url location
  cluster1::> cluster image package get -url http://www.example.com/software/9.13.1/image.tgz Package download completed. Package processing completed.
  If you are performing a direct multi-hop upgrade, you also need to load the software package for the intermediate version of ONTAP required for your upgrade. For example, if you are upgrading from 9.8 to 9.13.1, you need to load the software package for ONTAP 9.12.1, and then use the same command to load the software package for 9.13.1.
3. Verify that the software package is available in the cluster package repository:
  cluster image package show-repository
  cluster1::> cluster image package show-repository Package Version Package Build Time ---------------- ------------------ 9.13.1 MM/DD/YYYY 10:32:15
4. Execute the automated pre-upgrade checks:
  cluster image validate -version package_version_number
  If you are performing a direct multi-hop upgrade,you only need to use the target ONTAP package for verification. You don’t need to validate the intermediate upgrade image separately. For example, if you are upgrading from 9.8 to 9.13.1, use the 9.13.1 package for verification. You don’t need to validate the 9.12.1 package separately.
  cluster1::> cluster image validate -version 9.13.1 WARNING: There are additional manual upgrade validation checks that must be performed after these automated validation checks have completed...
5. Monitor the progress of the validation:
  cluster image show-update-progress
6. Complete all required actions identified by the validation.
7. If you are upgrading a MetroCluster configuration, repeat the above steps on cluster B.
Generate a software upgrade estimate:
```
cluster image update -version package_version_number -estimate-only
```
If you are upgrading a MetroCluster configuration, you can run this command on either Cluster A or Cluster B. You don’t need to run it on both clusters.

The software upgrade estimate displays details about each component to be updated, as well as the estimated duration of the upgrade.
Perform the software upgrade:
```
cluster image update -version package_version_number
```
- If you are performing a direct multi-hop upgrade, use the target ONTAP version for the package_version_number. For example, if you are upgrading from ONTAP 9.8 to 9.13.1, use 9.13.1 as the package_version_number.
- By default, ONTAP uses the batch upgrade process to upgrade clusters with eight or more nodes. If preferred, you can use the -force-rolling parameter to override the default process and have your cluster upgraded one node at a time using the rolling upgrade process.
- After completing each takeover and giveback, the upgrade waits for 8 minutes to enable client applications to recover from the pause in I/O that occurs during the takeover and giveback. If your environment requires more or less time for client stabilization, you can use the -stabilize-minutes parameter to specify a different amount of stabilization time.
- For MetroCluster configurations with 4 nodes more, the automated upgrade starts simultaneously on the HA pairs at both sites. For a 2-node MetroCluster configuration, the upgrade starts on the site where the upgrade is not initiated. The upgrade on the remaining site begins after the first upgrade is fully completed.
```
cluster1::> cluster image update -version 9.13.1

Starting validation for this update. Please wait..

It can take several minutes to complete validation...

WARNING: There are additional manual upgrade validation checks...

Pre-update Check      Status     Error-Action
--------------------- ---------- --------------------------------------------
...
20 entries were displayed

Would you like to proceed with update ? {y|n}: y
Starting update...

cluster-1::>
```
Display the cluster update progress:
```
cluster image show-update-progress
```
If you are upgrading a 4-node or 8-node MetroCluster configuration, the cluster image show-update-progress command only displays the progress for the node on which you run the command. You must run the command on each node to see individual node progress.

Verify that the upgrade was completed successfully on each node.

cluster image show-update-progress

cluster1::> cluster image show-update-progress

                                             Estimated         Elapsed
Update Phase         Status                   Duration        Duration
-------------------- ----------------- --------------- ---------------
Pre-update checks    completed                00:10:00        00:02:07
Data ONTAP updates   completed                01:31:00        01:39:00
Post-update checks   completed                00:10:00        00:02:00
3 entries were displayed.

Updated nodes: node0, node1.

Trigger an AutoSupport notification:
```
autosupport invoke -node * -type all -message "Finishing_NDU"
```
If your cluster is not configured to send AutoSupport messages, a copy of the notification is saved locally.

If you are upgrading a standard configuration, or a MetroCluster IP configuration greater than 2 nodes, you don’t need to perform this step.

Check whether automatic unplanned switchover is enabled:
```
metrocluster show
```
If automatic unplanned switchover is enabled, the following statement appears in the command output:
```
AUSO Failure Domain    auso-on-cluster-disaster
```
If the statement does not appear in the output, enable automatic unplanned switchover:
```
metrocluster modify -auto-switchover-failure-domain auso-on-cluster-disaster
```
Verify that automatic unplanned switchover has been enabled:
```
metrocluster show
```

Resume ONTAP software upgrade after an error in the automated upgrade process

If an automated ONTAP software upgrade pauses because of an error, you should resolve the error and then continue the upgrade. After the error is resolved, you can choose to continue the automated upgrade process or complete the upgrade process manually. If you choose to continue the automated upgrade, don’t perform any of the upgrade steps manually.

Example 2. Steps

ONTAP System Manager

Depending on the ONTAP version that you are running, perform one of the following steps:

If you are running…

Then…

ONTAP 9.8 or later

Click Cluster > Overview

ONTAP 9.7

Click Configuration > Cluster > Update.
Continue the automated upgrade or cancel it and continue manually.

If you want to…

Then…

Resume the automated upgrade

Click Resume.

Cancel the automated upgrade and continue manually

Click Cancel.

If you are running…	Then…
ONTAP 9.8 or later	Click Cluster > Overview
ONTAP 9.7	Click Configuration > Cluster > Update.

If you want to…	Then…
Resume the automated upgrade	Click Resume.
Cancel the automated upgrade and continue manually	Click Cancel.

CLI

View the upgrade error:
```
cluster image show-update-progress
```
Resolve the error.

Resume the upgrade:

If you want to…	Enter the following command…
Resume the automated upgrade	`cluster image resume-update`
Cancel the automated upgrade and continue manually	`cluster image cancel-update`

If you want to…

Enter the following command…

Resume the automated upgrade

cluster image resume-update

Cancel the automated upgrade and continue manually

cluster image cancel-update

After you finish

Perform post-upgrade checks.

ONTAP 9 Manuals ( CA08871-402 )

Automated nondisruptive ONTAP upgrade

Resume ONTAP software upgrade after an error in the automated upgrade process

On this page