Perform the upgrade

Contributors netapp-madkat

When you are ready to perform the upgrade, you select the .upgrade archive and enter the provisioning passphrase. As an option, you can run the upgrade prechecks before performing the actual upgrade.

What you’ll need

You have reviewed all of the considerations and completed all of the planning and preparation steps.

Upload the upgrade file

  1. Sign in to the Grid Manager using a supported web browser.

  2. Select Maintenance > System > Software Update.

    The Software Update page appears.

  3. Select StorageGRID Upgrade.

  4. On the StorageGRID Upgrade page, select the .upgrade archive.

    1. Select Browse.

    2. Locate and select the file: NetApp_StorageGRID_11.6.0_Software_uniqueID.upgrade

    3. Select Open.

      The file is uploaded and validated. When the validation process is done, a green checkmark appears next to the upgrade file name.

  5. Enter the provisioning passphrase in the text box.

    The Run Prechecks and Start Upgrade buttons become enabled.

    StorageGRID Upgrade Buttons Enabled

Run prechecks

Optionally, you can validate the condition of your system before you start the actual upgrade. Selecting Run Prechecks allows you to detect and resolve issues before starting the upgrade. The same prechecks are performed when you start the upgrade. Precheck failures will stop the upgrade process and some might require technical support involvement to resolve.

  1. Select Run Prechecks.

  2. Wait for the prechecks to complete.

  3. Follow the instructions to resolve any precheck errors that are reported.

    Important If you have opened any custom firewall ports, you are notified during the precheck validation. You must contact technical support before proceeding with the upgrade.

Start upgrade and update primary Admin Node

When the upgrade starts, upgrade prechecks are performed, and the primary Admin Node is upgraded, which includes stopping services, upgrading the software, and restarting services. You cannot access the Grid Manager while the primary Admin Node is being upgraded. Audit logs will also be unavailable. This upgrade can take up to 30 minutes.

  1. When you are ready to perform the upgrade, select Start Upgrade.

    A warning appears to remind you that your browser’s connection will be lost when the primary Admin Node is rebooted.

    Software Upgrade Connection Will Be Lost
  2. Select OK to acknowledge the warning and start the upgrade process.

  3. Wait for the upgrade prechecks to be performed and for the primary Admin Node to be upgraded.

    Note If any precheck errors are reported, resolve them and select Start Upgrade again.

    While the primary Admin Node is being upgraded, multiple 503: Service Unavailable and Problem connecting to the server messages appear, which you can ignore.

    Software Upgrade 503 Error
    Software Upgrade Problem Connecting Error
  4. When you see the 400: Bad Request message, go to the next step. The Admin Node upgrade is complete.

    Software Upgrade 400 Error

Clear browser cache and sign back in

  1. After the primary Admin Node has been upgraded, clear your web browser’s cache and sign back in.

    For instructions, see the documentation for your web browser.

    Important You must clear the web browser’s cache to remove outdated resources used by the previous version of the software.

    The redesigned Grid Manager interface appears, which indicates that the primary Admin Node has been upgraded.

    Grid Manager dashboard
  2. From the sidebar, select MAINTENANCE to open the Maintenance menu.

  3. In the System section, select Software update.

  4. In the StorageGRID Upgrade section, select Upgrade.

  5. Review the Upgrade Progress section on the StorageGRID 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.

Download Recovery Package and upgrade all grid nodes

  1. 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.

    Important 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.
  2. 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

  3. Approve the grid nodes you are ready to add to the upgrade queue.

    Important When the upgrade starts on a grid node, the services on that node are stopped. Later, the grid node is rebooted. To avoid service interruptions for client applications 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. As required, schedule a maintenance window or notify customers.

    You must upgrade all grid nodes in your StorageGRID system, but you can customize the upgrade sequence. You can approve individual grid nodes, groups of grid nodes, or all grid nodes.

    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.

    • Select one or more Approve buttons to add one or more individual nodes to the upgrade queue. If you approve more than one node of the same type, the nodes will be upgraded one at a time.

    • 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.

    • Select Remove or Remove All to remove a node or all nodes from the upgrade queue. You cannot remove a node when its Stage reaches Stopping services. The Remove button is hidden.

      screen shot showing Stage is Stopping services
  4. 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, Performing steps after reboot, Starting services, and Done.

    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.

Complete upgrade

When all grid nodes have completed the upgrade stages, the Upgrade Grid Nodes task is shown as Completed. The remaining upgrade tasks are performed automatically and in the background.

  1. As soon as the Enable Features task is complete (which occurs quickly), optionally start using the new features in the upgraded StorageGRID version.

  2. During the Upgrade Database task, the upgrade process checks each node to verify that the Cassandra database does not need to be updated.

    Note The upgrade from StorageGRID 11.5 to 11.6 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 to complete.
  3. When the Upgrade Database task has completed, wait a few minutes for the Final Upgrade Steps task to complete.

    When the Final Upgrade Steps task has completed, the upgrade is done.

Confirm upgrade

  1. Confirm that the upgrade completed successfully.

    1. From the top of the Grid Manager, select the help icon and select About.

    2. Confirm that the displayed version is what you would expect.

    3. Select MAINTENANCE > System > Software update.

    4. In the StorageGRID upgrade section, select Upgrade.

    5. Confirm that the green banner shows that the software upgrade was completed on the date and time you expect.

      Software Upgrade Done
  2. From the StorageGRID Upgrade page, determine if any hotfixes are available for the current StorageGRID version.

    Note If no Update Path is shown, your browser might not be able to reach the NetApp Support Site. Or, the Check for software updates check box on the AutoSupport page (SUPPORT > Tools > AutoSupport) might be disabled.
  3. If a hotfix is available, download the file. Then, use the StorageGRID hotfix procedure to apply the hotfix.

  4. 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.