ONTAP 9.14

to Japanese version

Automated nondisruptive ONTAP upgrade

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
Example 1. Steps
ONTAP System Manager
  1. 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.
    1. 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.

    2. In the right corner of the Overview pane, click menu icon.

    3. Click ONTAP Update.

    4. 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.

      1. Under Available Software Images, click Add from Local.

      2. 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

      1. Click Add from Server.

      2. 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 Fujitsu Support Site.

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

      3. Click Add.

      Select an available image

      Choose one of the listed images.

    5. 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.

  2. Click Next.

  3. 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
  1. 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.

  2. 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.

  3. 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::>
  4. 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.

  5. 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.
  6. 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.
    1. 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
    2. If the statement does not appear in the output, enable automatic unplanned switchover:

      metrocluster modify -auto-switchover-failure-domain auso-on-cluster-disaster
    3. Verify that automatic unplanned switchover has been enabled:

      metrocluster show
Top of Page