Download and install the ONTAP software image

Contributors

You must first download the ONTAP software from the NetApp Support site; then you can install it using the automatic nondisruptive upgrade (ANDU) or manual upgrade process.

Download the software image

Depending on your ONTAP release, you can copy the ONTAP software image from the NetApp Support Site to one of the following locations: an HTTP, HTTPS or FTP server on your network, or a local folder.

You should note the following important information:

  • Software images are specific to platform models.

    You must obtain the correct image for your cluster. Software images, firmware version information, and the latest firmware for your platform model are available on the NetApp Support Site.

  • Software images include the latest version of system firmware that was available when a given version of ONTAP was released.

  • If you are upgrading a system with NetApp Volume Encryption to ONTAP 9.5 or later, you must download the ONTAP software image for non-restricted countries, which includes NetApp Volume Encryption.

    If you use the ONTAP software image for restricted countries to upgrade a system with NetApp Volume Encryption, the system panics and you lose access to your volumes.

  • If you are upgrading from ONTAP 9.5 to 9.9.1, you must copy the software image for ONTAP 9.7 and 9.9.1.

  • If you are upgrading from ONTAP 9.3 to 9.7, you must copy the software image for ONTAP 9.5 and 9.7.

Steps
  1. Locate the target ONTAP software in the Software Downloads area of the NetApp Support Site.

  2. Copy the software image (for example, 97_q_image.tgz) to the appropriate location.

    Depending on your ONTAP release, the location will be a directory an HTTP, HTTPS or FTP server from which the image will be served to the local system, or to a local folder on the storage system.

    You can copy the image to this location…​ If you are running these ONTAP releases…​

    An HTTP or FTP server

    ONTAP 9.0 and later

    A local folder

    ONTAP 9.4 and later

    An HTTPS server
    The server’s CA certificate must be installed on the local system.

    ONTAP 9.6 and later

Install the software image

You must install the target software image on the cluster’s nodes.

  • If you are upgrading a system with NetApp Volume Encryption to ONTAP 9.5 or later, you must have downloaded the ONTAP software image for non-restricted countries, which includes NetApp Volume Encryption.

    If you use the ONTAP software image for restricted countries to upgrade a system with NetApp Volume Encryption, the system panics and you lose access to your volumes.

  • If you are upgrading from ONTAP 9.5 directly to 9.9.1, you must download the software image for ONTAP 9.7 and 9.9.1. If you are upgrading from ONTAP 9.3 directly to 9.7, you must download the software image for ONTAP 9.5 and 9.7.

    The automated upgrade process uses both images in the background to complete the upgrade.

For automatic nondisruptive upgrade (ANDU)

  1. Check the image repository and delete any previous images.

    cluster image package show-repository

    cluster image package show-repository\
    <<name_of_vsim|There are no packages in the repository.\r\n
  2. Download the image.

    cluster image package get -url url_to_image_on_nss

  3. Verify the package is downloaded.

    cluster image package show-repository

    Example
    cluster image package show-repository -fields download-ver\
    <<name_of_vsim| download-verX;X\r\n
    <<name_of_vsim| Downloaded VersionX;X\r\n
    <<name_of_vsim| ONTAP 9.10.1.X;X\r\n

For manual upgrades

  1. Set the privilege level to advanced, entering y when prompted to continue: set -privilege advanced

    The advanced prompt (*>) appears.

  2. Download the image.

    1. If you are upgrading a cluster without a MetroCluster configuration or a two-node MetroCluster configuration, use the following command to download the image:

      system node image update -node * -package location -replace-package true -setdefault true -background true

      location can be a web server or a local folder, depending on the ONTAP version. See the system node image update man page for details.

      This command downloads and installs the software image on all of the nodes simultaneously. To download and install the image on each node one at a time, do not specify the -background parameter.

    2. If you are upgrading a four or eight-node MetroCluster configuration, you must issue the following command on both clusters:

      system node image update -node * -package location -replace-package true -background true -setdefault false

      This command uses an extended query to change the target software image, which is installed as the alternate image on each node.

  3. Enter y to continue when prompted.

  4. Verify that the software image is downloaded and installed on each node.

    system node image show-update-progress -node *

    This command displays the current status of the software image download and installation. You should continue to run this command until all nodes report a Run Status of Exited, and an Exit Status of Success.

    The system node image update command can fail and display error or warning messages. After resolving any errors or warnings, you can run the command again.

    This example shows a two-node cluster in which the software image is downloaded and installed successfully on both nodes:

    cluster1::*> system node image show-update-progress -node *
    There is no update/install in progress
    Status of most recent operation:
            Run Status:     Exited
            Exit Status:    Success
            Phase:          Run Script
            Exit Message:   After a clean shutdown, image2 will be set as the default boot image on node0.
    There is no update/install in progress
    Status of most recent operation:
            Run Status:     Exited
            Exit Status:    Success
            Phase:          Run Script
            Exit Message:   After a clean shutdown, image2 will be set as the default boot image on node1.
    2 entries were acted on.