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 Webscale system. You can customize the upgrade sequence by selecting to upgrade individual grid nodes, groups of grid nodes, or all grid nodes.


  1. When the primary Admin Node has been upgraded and the Grid Manager is available again, clear your web browser's cache, sign back in, and reload the Software Upgrade page.
    For instructions, see the documentation for your web browser.
    Attention: You must clear the web browser's cache to remove outdated resources used by the previous version of the software.
  2. 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.
  3. 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.
  4. 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
  5. 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.
  6. 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.
  7. 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

  8. 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 tasks starts.
  9. Periodically monitor the progress of the Upgrade Cassandra task.

    image of Upgrade Cassandra section of Upgrade Status page

  10. While waiting for the database upgrade to complete, 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 Webscale system are operating as expected.
  11. While waiting for the database upgrade to complete, re-enable email notifications if you suppressed them for the upgrade.
    The upgrade processes that would have triggered excessive alarms have now completed.
    1. Select Configuration > Display Options.
    2. Unselect the Notification Suppress All check box.
    3. Click Apply Changes.
  12. 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.