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 pre-upgrade validations 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."

Steps

  1. Sign in to the Grid Manager using a supported browser.
  2. Optionally, disable email notifications.
    You can disable email notifications 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 perform the pre-upgrade validations before you start the actual upgrade, click Run Prechecks. Then, resolve any errors are reported.
    Note: The same prechecks will be performed when you click Start Upgrade. Clicking Run Prechecks allows you to detect and resolve issues before starting 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 pre-upgrade validations are run.
      Note: If any 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:
      Problem connecting to the server
      Unable to communicate with the server. Please reload the page and try again.
      503 Service Unavailable
      The StorageGRID API Service is not responding. Please try again later.
      400 Bad Request
      Clear your web browser's cache and reload the page to continue the upgrade.
  9. When 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.