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. The Grid Node Status table appears when Upgrade Grid Nodes is in progress, and it lists the upgrade stage for all grid nodes in your system.
  2. After the grid nodes appear in the Grid Node Status section and 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. 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.1.x to 11.2 (or from 11.2.x to 11.2.y) does not require a Cassandra upgrade, so this verification check should only take a few minutes for the entire grid. For otherStorageGRID 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.
  9. Verify that grid operations have returned to normal:
    1. Check that the services are operating normally and that there are no new alarms.
    2. Review all custom alarms to verify that they are still required and usable.
    3. Confirm that client connections to the StorageGRID system are operating as expected.
  10. Re-enable email notifications if you suppressed them for the upgrade.
    1. Select Configuration > Display Options.
    2. Unselect the Notification Suppress All check box.
    3. Click Apply Changes.