Obtain the required materials for a software upgrade

Contributors netapp-madkat netapp-perveilerk

Before you begin the software upgrade, you must obtain all required materials so you can complete the upgrade successfully.

Item Notes

StorageGRID upgrade files

Download the StorageGRID upgrade files to your service laptop.

Service laptop

The service laptop must have:

  • Network port

  • SSH client (for example, PuTTY)

Browser support typically changes for each StorageGRID release. Make sure your browser is compatible with the new StorageGRID version.

Recovery Package (.zip) file

Download the Recovery Package before upgrading, and save the file in a safe location. The Recovery Package file allows you to restore the system if a failure occurs.

Passwords.txt file

This file is included in the SAID package, which is part of the Recovery Package .zip file. You must obtain the latest version of the Recovery Package.

Provisioning passphrase

The passphrase is created and documented when the StorageGRID system is first installed. The provisioning passphrase is not listed in the Passwords.txt file.

Related documentation

Download the StorageGRID upgrade files

You must download one or more files, depending on where your nodes are installed.

  • All platforms: .upgrade file

If any nodes are deployed on Linux hosts, you must also download an RPM or DEB archive, which you will install before you start the upgrade:

  • Red Hat Enterprise Linux or CentOS: An additional RPM file (.zip or .tgz)

  • Ubuntu or Debian: An additional DEB file (.zip or .tgz)

Steps
  1. Go to NetApp Downloads: StorageGRID.

  2. Select the button for downloading the latest release, or select another version from the drop-down menu and select Go.

    StorageGRID software versions have this format: 11.x.y. StorageGRID hotfixes have this format: 11.x.y.z.

  3. Sign in with the username and password for your NetApp account.

  4. If a Caution/MustRead statement appears, read it and select the check box.

    This statement appears if there is a required hotfix for the release.

  5. Read the End User License Agreement, select the check box, and then select Accept & Continue.

    The downloads page for the version you selected appears. The page contains three columns:

    • Install StorageGRID

    • Upgrade StorageGRID

    • Support files for StorageGRID Appliances

  6. In the Upgrade StorageGRID column, select and download the .upgrade archive.

    Every platform requires the .upgrade archive.

  7. If any nodes are deployed on Linux hosts, also download the RPM or DEB archive in either .tgz or .zip format. Select the .zip file if you are running Windows on the service laptop.

    • Red Hat Enterprise Linux or CentOS
      StorageGRID-Webscale-version-RPM-uniqueID.zip
      StorageGRID-Webscale-version-RPM-uniqueID.tgz

    • Ubuntu or Debian
      StorageGRID-Webscale-version-DEB-uniqueID.zip
      StorageGRID-Webscale-version-DEB-uniqueID.tgz

      Note No additional files are required for the SG100 or SG1000.

Download the Recovery Package

The Recovery Package file allows you to restore the StorageGRID system if a failure occurs. Download the current Recovery Package file before making grid topology changes to the StorageGRID system or before upgrading software. Then, download a new copy of the Recovery Package after making grid topology changes or after upgrading software.

What you’ll need
  • You must be signed in to the Grid Manager using a supported web browser.

  • You must have the provisioning passphrase.

  • You must have specific access permissions.

Steps
  1. Select Maintenance > System > Recovery Package.

  2. Enter the provisioning passphrase, and select Start Download.

    The download starts immediately.

  3. When the download completes:

    1. Open the .zip file.

    2. Confirm it includes a gpt-backup directory and an inner .zip file.

    3. Extract the inner .zip file.

    4. Confirm you can open the Passwords.txt file.

  4. Copy the downloaded Recovery Package file (.zip) to two safe, secure, and separate locations.

    Important The Recovery Package file must be secured because it contains encryption keys and passwords that can be used to obtain data from the StorageGRID system.