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 Completed, 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 all grid nodes 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 by type.

    screenshot of Upgrade Grid Nodes after Admin Node done
    A grid node can have 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.
    Note: 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(s).
    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.
    • Click one or more Approve buttons to add one or more individual nodes to the upgrade queue.
    • Click the Approve All button within each section to add all nodes of the same type to the upgrade queue.
    • Click 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, click 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 applying the upgrade, stopping services, upgrading the base operating system, rebooting, and starting services.
    When all grid nodes have been upgraded, the Upgrade Grid Nodes task is shown as Completed, and the Upgrade Cassandra task starts. During this stage, the upgrade process checks each node to verify that the Cassandra database does not need to be updated.
    Note: The upgrade from StorageGRID 11.3 to 11.4 does not require a Cassandra database upgrade; however, the Cassandra service will be stopped and restarted on each Storage Node. For future StorageGRID feature releases, the Cassandra database update step might take several days or weeks, based on the amount of metadata in your system.
  7. When the Upgrade Cassandra upgrade task has completed, wait a few minutes for the Final Upgrade Steps task to complete.

    screenshot of Final Upgrade Steps in progress
    When the Final Upgrade Steps task has completed, the upgrade is done.
  8. 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. Then, in the System section of the menu, select Software Update, and then click 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
  9. Verify that grid operations have returned to normal:
    1. Check that the services are operating normally and that there are no unexpected alerts or alarms.
    2. Confirm that client connections to the StorageGRID system are operating as expected.