Performing the upgrade

You must upgrade all grid nodes in your StorageGRID Webscale system to complete the upgrade, but you can update your grid in stages to control the timing of the upgrade or to ensure the continuous availability of your StorageGRID Webscale system.

Before you begin

To perform this task, you need specific access permissions. For details, see information about controlling system access with administration user accounts and groups.

About this task

You must complete the upgrade of your StorageGRID Webscale system on the primary Admin Node.

The Software Upgrade page guides you through the process of uploading the required files, upgrading all of the grid nodes in your StorageGRID Webscale system (starting with the primary Admin Node), and then upgrading the database.

You can customize the upgrade sequence by selecting groups of grid nodes to upgrade. After the selected group of grid nodes has been upgraded, you can repeat the process of selecting grid nodes to upgrade as many times as necessary, until all grid nodes at all sites are upgraded. After all grid nodes are upgraded, you must upgrade the database to complete the process.

API Gateway Nodes are deselected by default. You must decide when to upgrade API Gateway Nodes based on your grid's configuration. If your StorageGRID Webscale system has multiple API Gateway Nodes, you must sequence the upgrade so that client applications are always directed to an available API Gateway Node. If your StorageGRID Webscale system has only one API Gateway Node, you must plan a downtime for the upgrade because client applications will not be able to access the system while the API Gateway Node is being upgraded.

Attention: If an API Gateway Node is connected to a NAS Bridge instance, you must manually connect the NAS Bridge to an alternate API Gateway Node before you upgrade the primary API Gateway Node. Otherwise, NFS and SMB clients will temporarily lose access to their data. See "Defining the StorageGRID Webscale Gateway Node" in the NAS Bridge Installation and Setup Guide.

Because of ILM policy configuration changes in StorageGRID Webscale, do not update the ILM configuration until you have upgraded all grid nodes. Otherwise, you might experience inconsistent and unexpected ILM behavior.


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

      When this check box is selected, all email notifications are suppressed, included those unrelated to the upgrade.

      screenshot of Configuration > Display Options page
    3. Click Apply Changes.
  3. Select Maintenance > Software Upgrade.
  4. In the Provisioning Passphrase text box, enter your provisioning passphrase, and click Verify.
  5. Select the Upgrade file.
    1. Click Browse to the right of Upgrade file.
    2. Locate and select the StorageGRID Webscale software upgrade file in the File Upload dialog box:NetApp_StorageGRID_version_Software_uniqueID.upgrade
    3. Click Open.
      The selected software upgrade file is uploaded and then validated.

    screenshot showing upload of upgrade file
  6. When the upgrade file has been validated, click Start Upgrade.
    When you start the upgrade, pre-upgrade validations are performed, which might take awhile to complete. If any pre-upgrade validation errors are reported, resolve them and click Start Upgrade again.
  7. If you are not already on the Software Upgrade Status page, select Maintenance > Software Upgrade > Status.
  8. Click Start next to the Load Provisioning Software action.
  9. Click Start next to the Run Grid Task action.
    Note: The Run Grid Task action applies only to major version upgrades, such as from version 10.4 to version 11.0. It does not apply to minor upgrades, such as from version 11.0.x to version 11.0.y.
  10. Click Start next to the Upgrade Primary Admin Node action.
    Users will not be able to access the Grid Management Interface on the primary Admin Node while the primary Admin Node is being upgraded.
  11. Click OK in the confirmation dialog box.
    The Grid Management Interface and audit logs are unavailable for several minutes during the upgrade while the services are stopped and the software is upgraded and restarted.
  12. Periodically, refresh the browser until the Grid Management Interface becomes available.
    You can follow the progress of the upgrade in the virtual machine console.
  13. After the primary Admin Node is upgraded and the Grid Management Interface is available again, clear your web browser's cache and reload the page.
    You must clear the web browser's cache to remove outdated resources used by the previous version of the StorageGRID Webscale system. For instructions, see the documentation for your web browser.
  14. If you are not already on the Software Upgrade Status page, select Maintenance > Software Upgrade > Status.
  15. Select or deselect individual grid nodes or data center sites in the Update Queue section to specify which grid nodes to upgrade.
  16. Scroll to the bottom of the Upgrade Stages section, and click Upgrade.

    As each grid node is upgraded, it goes offline as the services are restarted, and the system status displays an error state.

    The Upgrade Queue section displays the status of the grid nodes being upgraded. The Upgraded Grid Nodes section lists grid nodes when the upgrade on each grid node is complete.
  17. After you have upgraded all grid nodes, return to the Software Upgrade Status page by selecting Maintenance > Software Upgrade > Status.
  18. Scroll to the bottom of the Upgrade Stages section, and click Start to upgrade the database.
    Upgrading the database can take an extended amount of time (from days to weeks). The grid operates normally while the upgrade is in progress.
    You can monitor progress under Database Upgrade in the Upgrade Actions section. The database upgrade is complete when the status is listed as complete on all Storage Nodes.
  19. Because the database upgrade can take a long time to finish, you should verify grid operations before the upgrade completes:
    1. Check that the services are operating normally and that there are no alarms.
    2. Review all custom alarms to verify that they are still required and usable.
    3. Confirm that client connections to the StorageGRID Webscale system are operating as expected.
  20. Reenable email notifications if you suppressed them for the upgrade.
    The upgrade processes that can trigger excessive alarms have now completed.
    1. Select Configuration > Display Options.
    2. Unselect the Notification Suppress All check box.
    3. Click Apply Changes.