Skip to main content

Revert an ONTAP cluster

Contributors netapp-aherbin netapp-aaron-holt netapp-barbe netapp-forry
PDFs

Reverting an ONTAP cluster is disruptive. You must take the cluster offline for the duration of the reversion. You should not revert a production cluster without assistance from technical support.

To revert a new or test cluster, you must disable storage failover and data LIFs and address reversion preconditions; then you must revert the cluster and file system configuration on each node in the cluster.

Before you begin.

Step 1: Prepare the cluster for reversion

Before you revert any of your cluster nodes, you should verify that your target ONTAP image is installed and you should disable all the data LIFs in the cluster.

Steps

  1. Set the privilege level to advanced:

    set -privilege advanced
    Cli
    Copy

    Enter y when prompted to continue.

  2. Verify that the target ONTAP software is installed:

    system image show
    Cli
    Copy

    The following example shows that version 9.13.1 is installed as the alternate image on both nodes:

    cluster1::*> system image show
                 Is      Is                 Install
Node     Image   Default Current Version    Date
-------- ------- ------- ------- --------   -------------------
node0
         image1  true    true    9.14.1      MM/DD/YYYY TIME
         image2  false   false   9.13.1      MM/DD/YYYY TIME
node1
         image1  true    true    9.14.1      MM/DD/YYYY TIME
         image2  false   false   9.13.1      MM/DD/YYYY TIME
4 entries were displayed.

  3. Disable all of the data LIFs in the cluster:

    network interface modify {-role data} -status-admin down
    Cli
    Copy

  4. Determine if you have inter-cluster flexcache relationships:

    flexcache origin show-caches -relationship-type inter-cluster
    Cli
    Copy

  5. If inter-cluster flexcaches are present, disable the data lifs on the cache cluster:

    network interface modify -vserver <vserver_name> -lif <lif_name> -status-admin down
    Cli
    Copy

Step 2: Revert cluster nodes

To revert your cluster, you need to revert the first node in an HA pair, then revert the partner node. You then repeat this process for each HA pair in your cluster until all nodes are reverted. If you have a MetroCluster configuration, you need to repeat these steps for both the clusters in the configuration.

4 or more nodes
Steps

  1. Log in to the node that you want to revert.

    To revert a node, you must be logged in to the cluster through the node's node management LIF.

  2. Disable storage failover for the nodes in the HA pair:

    storage failover modify -node <nodename> -enabled false
    Cli
    Copy

    You only need to disable storage failover once for the HA pair. When you disable storage failover for a node, storage failover is also disabled on the node's partner.

  3. Set the node's target ONTAP software image to be the default image:

    system image modify -node <nodename> -image <target_image> -isdefault true
    Cli
    Copy

  4. Verify that the target ONTAP software image is set as the default image for the node that you are reverting:

    system image show
    Cli
    Copy

    The following example shows that version 9.13.1 is set as the default image on node0:

    cluster1::*> system image show
                 Is      Is                 Install
Node     Image   Default Current Version    Date
-------- ------- ------- ------- --------   -------------------
node0
         image1  false   true    9.14.1      MM/DD/YYYY TIME
         image2  true    false   9.13.1      MM/DD/YYYY TIME
node1
         image1  true    true    9.14.1      MM/DD/YYYY TIME
         image2  false   false   9.13.1      MM/DD/YYYY TIME
4 entries were displayed.

  5. Verify that the node is ready for reversion:

    system node revert-to -node <nodename> -check-only true -version 9.x
    Cli
    Copy

    The check-only parameter identifies any preconditions that must be addressed before reverting, such as disabling the snapshot policy or deleting snapshots that were created after upgrading to the later version of ONTAP.

    The -version option refers to the ONTAP release to which you are reverting. For example, if you are reverting from 9.14.1 to 9.13.1, the correct value of the -version option is 9.13.1.

  6. Revert the cluster configuration of the node:

    system node revert-to -node <nodename> -version 9.x
    Cli
    Copy

    The cluster configuration is reverted, and then you are logged out of the clustershell.

  7. Wait for the login prompt; then enter No when you are asked if you want to login to the systemshell.

    It could take up to 30 minutes or more for the login prompt to appear.

  8. Log in to the clustershell with admin.

  9. Switch to the nodeshell:

    run -node <nodename>
    Cli
    Copy

    After logging on the clustershell again, it might take a few minutes before it is ready to accept the nodeshell command. So, if the command fails, wait a few minutes and try it again.

  10. Revert the file system configuration of the node:

    revert_to 9.x
    Cli
    Copy

    This command verifies that the node's file system configuration is ready to be reverted, and then reverts it. If any preconditions are identified, you must address them and then rerun the revert_to command.

    Note Using a system console to monitor the revert process displays greater details than seen in nodeshell.

    If AUTOBOOT is true, when the command finishes, the node will reboot to ONTAP.

    If AUTOBOOT is false, when the command finishes, the LOADER prompt is displayed. Enter yes to revert; then use boot_ontap to manually reboot the node.

  11. After the node has rebooted, confirm that the new software is running:

    system node image show
    Cli
    Copy

    In the following example, image1 is the new ONTAP version and is set as the current version on node0:

    cluster1::*> system node image show
                 Is      Is                 Install
Node     Image   Default Current Version    Date
-------- ------- ------- ------- --------   -------------------
node0
         image1  true    true    X.X.X       MM/DD/YYYY TIME
         image2  false   false   Y.Y.Y      MM/DD/YYYY TIME
node1
         image1  true    false   X.X.X      MM/DD/YYYY TIME
         image2  false   true    Y.Y.Y      MM/DD/YYYY TIME
4 entries were displayed.

  12. Verify that the revert status for the node is complete:

    system node upgrade-revert show -node <nodename>
    Cli
    Copy

    The status should be listed as "complete", "not needed", or "there are no table entries returned."

  13. Repeat these steps on the other node in the HA pair; then repeat these steps for each additional HA pair.

    If you have a MetroCluster Configuration, you need to repeat these steps on both clusters in the configuration

  14. After all nodes have been reverted, reenable high availability for the cluster:

    cluster ha modify -configured true
    Cli
    Copy