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. Optionally, sort the lists of nodes in ascending or descending order by Site, Name, Progress, Stage, or Error. Or, enter a term in the Search box to search for specific nodes.
  5. Approve the grid nodes you are ready to add to the upgrade queue.
    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.
      Note: Nodes of the same type are upgraded one at a time.
    • Click the top-level Approve All button to add all nodes in the grid to the upgrade queue.
  6. 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

  7. 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.2 to 11.3 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.
  8. 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.