Updating an ONTAP cluster disruptively

If you can take your cluster offline to upgrade or downgrade to a new ONTAP release, then you can use the disruptive upgrade method. This method has several steps: disabling storage failover for each HA pair, rebooting each node in the cluster, and then reenabling storage failover.

Before you begin

You must have satisfied preparation requirements.
If you are operating in a SAN environment, all SAN clients must be shut down or suspended until the upgrade or downgrade is complete.
If SAN clients are not shut down or suspended prior to a disruptive upgrade or downgrade, then the client file systems and applications suffer errors that might require manual recovery after the upgrade or downgrade is completed.

About this task

In a disruptive upgrade or downgrade, downtime is required because storage failover is disabled for each HA pair, and each node is updated. When storage failover is disabled, each node behaves as a cluster; that is, system services associated with the node are interrupted for as long as it takes the system to reboot.

Set the privilege level from admin to advanced, entering y when prompted to continue: set -privilege advanced
The advanced prompt (*>) appears.
Set the new ONTAP software image to be the default image: system image modify {-node * -iscurrent false} -isdefault true
This command uses an extended query to change the target ONTAP software image (which is installed as the alternate image) to be the default image for each node.

Verify that the new ONTAP software image is set as the default image: system image show

Example

In the following example, image 2 is the new ONTAP version and is set as the default image on both nodes:

TDC-DM7K::*> system image show
                 Is      Is                Install
Node     Image   Default Current Version    Date
-------- ------- ------- ------- --------- -------------------
TDC-7K-03
         image1  false   true    X.X.X     MM/DD/YYYY TIME
         image2  true    false   Y.Y.Y     MM/DD/YYYY TIME
TDC-7K-01
         image1  false   true    X.X.X     MM/DD/YYYY TIME
         image2  true    false   Y.Y.Y     MM/DD/YYYY TIME
4 entries were displayed.

Perform either one of the following steps:

If the cluster consists of...	Do this...
One node	Continue to the next step.
Two nodes	Disable cluster high availability: `cluster ha modify -configured false` Enter `y` to continue when prompted. Disable storage failover for the HA pair:`storage failover modify -node * -enabled false`
More than two nodes	Disable storage failover for each HA pair in the cluster: `storage failover modify -node * -enabled false`

Reboot a node in the cluster: system node reboot -node nodename -ignore-quorum-warnings
Attention
Do not reboot more than one node at a time.
The node boots the new ONTAP image. The ONTAP login prompt appears, indicating that the reboot process is complete.

After the node or set of nodes has rebooted with the new ONTAP image, confirm that the new software is running: system node image show

Example

In the following example, image1 is the new ONTAP version and is set as the current version on TDC-7K-03:

TDC-DM7K::*> system node image show 
                 Is      Is                 Install
Node     Image   Default Current Version    Date
-------- ------- ------- ------- --------   -------------------
TDC-7K-03
         image1  true    true    X.X.X       MM/DD/YYYY TIME
         image2  false   false   Y.Y.Y      MM/DD/YYYY TIME
TDC-7K-01
         image1  true    false   X.X.X      MM/DD/YYYY TIME
         image2  false   true    Y.Y.Y      MM/DD/YYYY TIME
4 entries were displayed.

Verify that the upgrade or downgrade is completed successfully:
1. Set the privilege level to advanced: set -privilege advanced
2. Verify that the upgrade or downgrade status is complete for each node: system node upgrade-revert show -node nodename
  The status should be listed as complete.
  If the upgrade or downgrade is not successful, from the node, run the system node upgrade-revert upgrade command. If this command does not complete the node's upgrade or downgrade, contact technical support immediately.
3. Return to the admin privilege level: set -privilege admin
Repeat Steps 5 through 7 for each additional node.
If the cluster consists of two or more nodes, enable storage failover for each HA pair in the cluster: storage failover modify -node * -enabled true
If the cluster consists of only two nodes, enable cluster high availability: cluster ha modify -configured true

Give documentation feedback