Upgrading grid nodes and completing the upgrade

After the primary Admin Node has been upgraded, you must upgrade all other grid nodes in your StorageGRID system. You can customize the upgrade sequence by selecting to upgrade individual grid nodes, groups of grid nodes, or all grid nodes.


  1. Review the Upgrade Progress section on the Software Upgrade page, which provides information about each major upgrade task.
    1. Start Upgrade Service is the first upgrade task. During this task, the software file is distributed to the grid nodes, and the upgrade service is started.
    2. When the Start Upgrade Service task is complete, the Upgrade Grid Nodes task starts.
    3. While the Upgrade Grid Nodes task is in progress, the Grid Node Status table appears and shows the upgrade stage for each grid node in your system.
  2. After the grid nodes appear in the Grid Node Status table, but before approving any grid nodes, download a new copy of the Recovery Package.
    Attention: You must download a new copy of the Recovery Package file after you upgrade the software version on the primary Admin Node. The Recovery Package file allows you to restore the system if a failure occurs.
  3. Review the information in the Grid Node Status table. Grid nodes are arranged in sections by type: Admin Nodes, API Gateway Nodes, Storage Nodes, and Archive Nodes.

    screenshot of Upgrade Grid Nodes after Admin Node done
    A grid node can be in one of these stages when this page first appears:
    • Done (primary Admin Node only)
    • Preparing upgrade
    • Software download queued
    • Downloading
    • Waiting for you to approve
  4. Approve the grid nodes you are ready to add to the upgrade queue. Approved nodes of the same type are upgraded one at a time.

    If the order in which nodes are upgraded is important, approve nodes or groups of nodes one at a time and wait until the upgrade is complete on each node before approving the next node or group of nodes.

    Attention: When the upgrade starts on a grid node, the services on that node are stopped. Later, the grid node is rebooted. These operations might cause service interruptions for clients that are communicating with the node. Do not approve the upgrade for a node unless you are sure that node is ready to be stopped and rebooted.
    • Select one or more Approve buttons to add one or more individual nodes to the upgrade queue.
    • Select the Approve All button within each section to add all nodes of the same type to the upgrade queue.
    • Select the top-level Approve All button to add all nodes in the grid to the upgrade queue.
  5. If you need to remove a node or all nodes from the upgrade queue, select Remove or Remove All.

    As shown in the example, when the Stage reaches Stopping services, the Remove button is hidden and you can no longer remove the node.

    screeen shot showing Stage is Stopping services
  6. Wait for each node to proceed through the upgrade stages, which include Queued, Stopping services, Stopping container, Cleaning up Docker images, Upgrading base OS packages, Rebooting, and Starting services.
    Note: When an appliance node reaches the Upgrading base OS packages stage, the StorageGRID Appliance Installer software on the appliance is updated. This automated process ensures that the StorageGRID Appliance Installer version remains in sync with the StorageGRID software version.
    When all grid nodes have been upgraded, the Upgrade Grid Nodes task is shown as Completed. The remaining upgrade tasks are performed automatically and in the background.
  7. As soon as the Enable Features task is complete (which occurs quickly), you can start using the new features in the upgraded StorageGRID version.
    For example, if you are upgrading to StorageGRID 11.5, you can now enable S3 Object Lock, configure a key management server, or increase the Metadata Reserved Space setting.

    Increasing the Metadata Reserved Space setting

  8. Periodically monitor the progress of the Upgrade Database task.
    During this task, the Cassandra database is upgraded on each Storage Node.
    Note: The Upgrade Database task might take days to complete. As this background task runs, you can apply hotfixes or recover nodes. However, you must wait for the Final Upgrade Steps task to complete before performing an expansion or decommission procedure.
    You can review the graph to monitor the progress for each Storage Node.
    Software Upgrade Upgrade Database
  9. When the Upgrade Database task has completed, wait a few minutes for the Final Upgrade Steps task to complete.

    Final Upgrade Steps
    When the Final Upgrade Steps task has completed, the upgrade is done.
  10. Confirm that the upgrade completed successfully.
    1. Sign in to the Grid Manager using a supported browser.
    2. Select Help > About.
    3. Confirm that the displayed version is what you would expect.
    4. Select Maintenance > System > Software Update. Then, select StorageGRID Upgrade.
    5. Confirm that the green banner shows that the software upgrade was completed on the date and time you expected.

      Software Upgrade Done
  11. Verify that grid operations have returned to normal:
    1. Check that the services are operating normally and that there are no unexpected alerts.
    2. Confirm that client connections to the StorageGRID system are operating as expected.
  12. Check the NetApp Downloads page for StorageGRID to see if any hotfixes are available for the StorageGRID version that you just installed.

    NetApp Downloads: StorageGRID

    In the StorageGRID 11.5.x.y version number:
    • The major release has an x value of 0 (11.5.0).
    • A minor release, if available, has an x value other than 0 (for example, 11.5.1).
    • A hotfix, if available, has a y value (for example,
  13. If available, download and apply the latest hotfix for your StorageGRID version.

    See the recovery and maintenance instructions for information about applying hotfixes.