Starting the upgrade

When you are ready to perform the upgrade, you 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. Select Maintenance > System > Software Update.
    The Software Update page appears.
  3. Select StorageGRID Upgrade.

    The StorageGRID Upgrade page appears and shows the date and time of the most recently completed upgrade, unless the primary Admin Node has been rebooted or the management API restarted since that upgrade was performed.

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

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

  5. Enter the provisioning passphrase in the text box.

    The Run Prechecks and Start Upgrade buttons become enabled.

    StorageGRID Upgrade Buttons Enabled

  6. If you want to validate the condition of your system before you start the actual upgrade, select Run Prechecks. Then, resolve any precheck errors that are reported.
    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.
    Note: The same prechecks are performed when you select Start Upgrade. Selecting Run Prechecks allows you to detect and resolve issues before starting the upgrade.
  7. When you are ready to perform the upgrade, select Start Upgrade.
    A warning 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 need to clear your web browser's cache and reload the Software Upgrade page.

    Software Upgrade Connection Will Be Lost
  8. Select 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 select 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, which you can ignore.

      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.