Cluster update requirements

There are release and configuration requirements that your cluster should meet before you perform an update. Additionally, there are mixed version requirements that you should be aware of while you are performing the update.

Release requirements

The version of ONTAP that you can upgrade or downgrade to varies based on the version of ONTAP currently running on your nodes. You can determine the current version of ONTAP running on each node by using the system image show command.

You can upgrade from... To...
ONTAP 9.5 ONTAP 9.6
ONTAP 9.4 ONTAP 9.5
ONTAP 9.3 ONTAP 9.4 or ONTAP 9.5
ONTAP 9.2 ONTAP 9.3
ONTAP 9.1 ONTAP 9.2 or 9.3
Note: If you are running a release earlier than ONTAP 9.1, you cannot upgrade directly to ONTAP 9.2 or ONTAP 9.3. You must upgrade to ONTAP 9.1 first, then upgrade to ONTAP 9.2 or ONTAP 9.3.
ONTAP 9 ONTAP 9.1
Data ONTAP 8.3.x ONTAP 9 or 9.1
Note: If you are running a release earlier than Data ONTAP 8.3.x, you cannot upgrade directly to ONTAP 9 or 9.1. You must upgrade to Data ONTAP 8.3.x first, then upgrade to ONTAP 9 or 9.1.
Data ONTAP 8.2.x Data ONTAP 8.3.x
You can downgrade from... To...
ONTAP 9.1 ONTAP 9
Note: Downgrade of a two-node MetroCluster configuration from ONTAP 9.1 to 9 is disruptive.
You must perform a revert from... To...
ONTAP 9.6 ONTAP 9.5
ONTAP 9.5 ONTAP 9.4
ONTAP 9.4 ONTAP 9.3
ONTAP 9.3 ONTAP 9.2
ONTAP 9.2 ONTAP 9.1
ONTAP 9.1 or ONTAP 9 Data ONTAP 8.3.x

Mixed version requirements

Beginning with ONTAP 9.3, by default, you cannot join new nodes to the cluster that are running a version of ONTAP that is different from the version running on the existing nodes. If you plan to add new nodes to your cluster that are running a version of ONTAP that is later than the nodes in your existing cluster, you should upgrade the nodes in your cluster to the later version first, then add the new nodes.

Mixed version clusters are not recommended, but in certain cases you might need to temporarily enter a mixed version state. For example, you need to enter a mixed version state if you are upgrading to a later version of ONTAP that is not supported on certain nodes in your existing cluster. In this case, you should upgrade the nodes that do support the later version of ONTAP, then unjoin the nodes that do not support the version of ONTAP you are upgrading to using the advance privilege cluster unjoin -skip-lastlow-version-node check command.

You might also need to enter a mixed version state for a technical refresh or an interrupted upgrade. In such cases you can override the ONTAP 9.3 default behavior and join nodes of a different version using the following advance privilege commands:
  • cluster join -allow-mixed-version-join
  • cluster add-node -allow-mixed-version-join

When you have to enter a mixed version state, you should complete the upgrade as quickly as possible. An HA pair must not run an ONTAP version from a release that is different from other HA pairs in the cluster for more than seven days. For correct cluster operation, the period the cluster is in a mixed version state should be as short as possible.

When the cluster is in a mixed version state, you should not enter any commands that alter the cluster operation or configuration except as necessary to satisfy the upgrade requirements.