Upgrade workflow

Contributors netapp-madkat

Before starting the upgrade, review the general workflow. The StorageGRID Upgrade page guides you through each upgrade step.

Flowchart of the software upgrade steps
  1. If any StorageGRID nodes are deployed on Linux hosts, install the RPM or DEB package on each host before you start the upgrade.

  2. From the primary Admin Node, access the StorageGRID Upgrade page and upload the upgrade file.

  3. Optionally run upgrade prechecks to detect and resolve any issues before you start the actual upgrade.

  4. Start the upgrade, which runs prechecks and upgrades the primary Admin Node automatically. You cannot 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.

  5. After the primary Admin Node has been upgraded, clear your web browser’s cache, sign back in, and return to the StorageGRID Upgrade page.

  6. Download a new Recovery Package.

  7. Approve the grid nodes. You can approve individual grid nodes, groups of grid nodes, or all grid nodes.

    Important Do not approve the upgrade for a grid node unless you are sure that node is ready to be stopped and rebooted.
  8. Resume operations. When all grid nodes have been upgraded, new features are enabled and you can resume operations. You must wait to perform a decommission or expansion procedure until the background Upgrade Database task and the Final Upgrade Steps task have completed.

  9. When the upgrade is complete, confirm the software version and apply any hotfixes.