Starting the upgrade

When you are ready to perform the upgrade, you disable email notifications, select the downloaded file, and enter the provisioning passphrase. As an option, you can run the upgrade prechecks before performing the actual upgrade.

Before you begin

You have reviewed all of the considerations and completed all of the steps in "Upgrade planning and preparation."


  1. Sign in to the Grid Manager using a supported browser.
  2. Optionally, disable email notifications for alarms.
    You can disable email notifications for alarms during the upgrade to avoid receiving excessive email notifications about node outages and upgrade processes.
    1. Select Configuration > Display Options.
    2. Select the Notification Suppress All check box.

      All email notifications are suppressed when this check box is selected, including those unrelated to the upgrade, such as event-triggered AutoSupport email notifications.

      screenshot of Configuration > Display Options page
    3. Click Apply Changes.
  3. Select Maintenance > Software Upgrade.

    The Software Upgrade page appears. The date and time that the most recent upgrade completed are displayed, unless the primary Admin Node has been rebooted or the management API restarted since that upgrade was performed.

    screenshot showing software upgrade page

  4. Select the .upgrade file you downloaded.
    1. Click Browse.
    2. Locate and select the file: NetApp_StorageGRID_version_Software_uniqueID.upgrade
    3. Click Open.

      The file is uploaded and validated. When the validation process is done, a green checkmark appears next to the upgrade file name.

      screenshot showing the upgrade file has been uploaded and validated

  5. Enter the provisioning passphrase in the text box.

    The Run Prechecks and Start Upgrade buttons become enabled.

    screenshot showing buttons enabled after entering provisioning passphrase

  6. If you want to validate the condition of your system before you start the actual upgrade, click Run Prechecks. Then, resolve any precheck errors that are reported.
    Note: The same prechecks are performed when you click Start Upgrade. Clicking Run Prechecks allows you to detect and resolve issues before starting the upgrade.
    Attention: If you have opened any custom firewall ports, you are notified during the precheck validation. You must contact technical support before proceeding with the upgrade.
  7. When you are ready to perform the upgrade, click Start Upgrade.
    A warning box appears to remind you that your browser's connection will be lost when the primary Admin Node is rebooted. When the primary Admin Node is available again, you will need to clear your web browser's cache and reload the Software Upgrade page.

    screenshot showing Connect will be temporarily lost dialog box

  8. Click OK to acknowledge the warning and start the upgrade process.
    When the upgrade starts:
    1. The upgrade prechecks are run.
      Note: If any precheck errors are reported, resolve them and click Start Upgrade again.
    2. The primary Admin Node is upgraded, which includes stopping services, upgrading the software, and restarting services. You will not be able to access the Grid Manager while the primary Admin Node is being upgraded. Audit logs will also be unavailable. This upgrade can take up to 30 minutes.
      Note: While the primary Admin Node is being upgraded, multiple copies of the following error messages appear:

      Software Upgrade Problem Connecting Error

      Software Upgrade 503 Error

      Software Upgrade 400 Error

  9. After the primary Admin Node has been upgraded, clear your web browser's cache, sign back in, and reload the Software Upgrade page.
    For instructions, see the documentation for your web browser.
    Attention: You must clear the web browser's cache to remove outdated resources used by the previous version of the software.