Skip to main content

Starting the upgrade

Contributors netapp-lhalbert

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.

What you'll need

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

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

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

    Important You must clear the web browser's cache to remove outdated resources used by the previous version of the software.
Related information

Upgrade planning and preparation