Starting the upgrade

When you are ready to perform the upgrade, you disable email notifications for alarms, select the downloaded file, and enter the provisioning passphrase. As an option, you can run the upgrade prechecks before performing the actual upgrade.

Before you begin

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

Procedure

  1. Sign in to the Grid Manager using a supported browser.
  2. Optionally, disable email notifications for alarms.
    You can disable email notifications for alarms during the upgrade to avoid receiving excessive email notifications about node outages and upgrade processes.
    1. Select Configuration > Display Options.
    2. Select the Notification Suppress All check box.

      screenshot of Configuration > Display Options page
    3. Click Apply Changes.
      All alarm email notifications and event-triggered AutoSupport emails are now suppressed. Alert email notifications are not suppressed. Because the alert system is designed to be quieter than the alarm system, you should not receive many alert email notifications during an upgrade.
  3. Select Maintenance. Then in the System section of the menu, select StorageGRID Upgrade.

    The Software Upgrade page appears. The date and time that the most recently completed upgrade are displayed, unless the primary Admin Node has been rebooted or the management API restarted since that upgrade was performed.


    screenshot showing software upgrade page
  4. Select the .upgrade file you downloaded.
    1. Click Browse.
    2. Locate and select the file: NetApp_StorageGRID_version_Software_uniqueID.upgrade
    3. Click Open.

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


      screenshot showing the upgrade file has been uploaded and validated
  5. Enter the provisioning passphrase in the text box.

    The Run Prechecks and Start Upgrade buttons become enabled.

    screenshot showing buttons enabled after entering provisioning passphrase

  6. If you want to validate the condition of your system before you start the actual upgrade, click Run Prechecks. Then, resolve any precheck errors that are reported.
    Attention: 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.
    Note: The same prechecks are performed when you click Start Upgrade. Clicking Run Prechecks allows you to detect and resolve issues before starting the upgrade.
  7. When you are ready to perform the upgrade, click Start Upgrade.
    A warning appears to remind you that your browser's connection will be lost when the primary Admin Node is rebooted. When the primary Admin Node is available again, you need to clear your web browser's cache and reload the Software Upgrade page.

    screenshot showing Connect will be temporarily lost dialog box
  8. Click OK to acknowledge the warning and start the upgrade process.
    When the upgrade starts:
    1. The upgrade prechecks are run.
      Note: If any precheck errors are reported, resolve them and click Start Upgrade again.
    2. The primary Admin Node is upgraded, which includes stopping services, upgrading the software, and restarting services. You will not be able to 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.
      Note: While the primary Admin Node is being upgraded, multiple copies of the following error messages appear:

      Software Upgrade Problem Connecting Error

      Software Upgrade 503 Error

      Software Upgrade 400 Error
  9. After the primary Admin Node has been upgraded, 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.