Skip to main content

Download and extract StorageGRID installation files

Contributors netapp-perveilerk
PDFs

Before you can recover StorageGRID nodes, you must download the software and extract the files.

You must use the version of StorageGRID that is currently running on the grid.

Steps

  1. Determine which version of the software is currently installed. From the top of the Grid Manager, select the help icon and select About.

  2. Go to the NetApp Downloads page for StorageGRID.

    NetApp Downloads: StorageGRID

  3. Select the version of StorageGRID that is currently running on the grid.

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

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

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

  6. In the Install StorageGRID column of the download page, select the .tgz or .zip file for your platform.

    The version shown in the installation archive file must match the version of the software that is currently installed.

    Use the .zip file if you are running Windows.

    Platform Installation archive

    RHEL

    StorageGRID-Webscale-version-RPM-uniqueID.zip

    StorageGRID-Webscale-version-RPM-uniqueID.tgz

    Ubuntu or Debian or Appliances

    StorageGRID-Webscale-version-DEB-uniqueID.zip

    StorageGRID-Webscale-version-DEB-uniqueID.tgz

    VMware

    StorageGRID-Webscale-version-VMware-uniqueID.zip

    StorageGRID-Webscale-version-VMware-uniqueID.tgz

  7. Download and extract the archive file.

  8. Follow the appropriate step for your platform to choose the files you need, based on your platform and which grid nodes you need to recover.

    The paths listed in the step for each platform are relative to the top-level directory installed by the archive file.

  9. If you are recovering a software-based node, select the appropriate files:

    RHEL
    Path and file name Description

    ./rpms/README

    A text file that describes all of the files contained in the StorageGRID download file.

    ./rpms/NLF000000.txt

    A free license that does not provide any support entitlement for the product.

    ./rpms/StorageGRID-Webscale-Images-version-SHA.rpm

    RPM package for installing the StorageGRID node images on your RHEL hosts.

    ./rpms/StorageGRID-Webscale-Service-version-SHA.rpm

    RPM package for installing the StorageGRID host service on your RHEL hosts.

    Deployment scripting tool

    Description

    ./rpms/configure-storagegrid.py

    A Python script used to automate the configuration of a StorageGRID system.

    ./rpms/configure-sga.py

    A Python script used to automate the configuration of StorageGRID appliances.

    ./rpms/configure-storagegrid.sample.json

    An example configuration file for use with the configure-storagegrid.py script.

    ./rpms/storagegrid-ssoauth.py

    An example Python script that you can use to sign in to the Grid Management API when single sign-on is enabled. You can also use this script for Ping Federate integration.

    ./rpms/configure-storagegrid.blank.json

    A blank configuration file for use with the configure-storagegrid.py script.

    ./rpms/extras/ansible

    Example Ansible role and playbook for configuring RHEL hosts for StorageGRID container deployment. You can customize the role or playbook as necessary.

    ./rpms/storagegrid-ssoauth-azure.py

    An example Python script that you can use to sign in to the Grid Management API when single sign-on (SSO) is enabled using Active Directory or Ping Federate.

    ./rpms/storagegrid-ssoauth-azure.js

    A helper script called by the companion storagegrid-ssoauth-azure.py Python script to perform SSO interactions with Azure.

    ./rpms/extras/api-schemas

    API schemas for StorageGRID.

    Note: Before you perform an upgrade, you can use these schemas to confirm that any code you have written to use StorageGRID management APIs will be compatible with the new StorageGRID release if you don't have a non-production StorageGRID environment for upgrade compatibility testing.
    Ubuntu or Debian
    Path and file name Description

    ./debs/README

    A text file that describes all of the files contained in the StorageGRID download file.

    ./debs/NLF000000.txt

    A non-production NetApp License File that you can use for testing and proof of concept deployments.

    ./debs/storagegrid-webscale-images-version-SHA.deb

    DEB package for installing the StorageGRID node images on Ubuntu or Debian hosts.

    ./debs/storagegrid-webscale-images-version-SHA.deb.md5

    MD5 checksum for the file /debs/storagegrid-webscale-images-version-SHA.deb.

    ./debs/storagegrid-webscale-service-version-SHA.deb

    DEB package for installing the StorageGRID host service on Ubuntu or Debian hosts.

    Deployment scripting tool

    Description

    ./debs/configure-storagegrid.py

    A Python script used to automate the configuration of a StorageGRID system.

    ./debs/configure-sga.py

    A Python script used to automate the configuration of StorageGRID appliances.

    ./debs/storagegrid-ssoauth.py

    An example Python script that you can use to sign in to the Grid Management API when single sign-on is enabled. You can also use this script for Ping Federate integration.

    ./debs/configure-storagegrid.sample.json

    An example configuration file for use with the configure-storagegrid.py script.

    ./debs/configure-storagegrid.blank.json

    A blank configuration file for use with the configure-storagegrid.py script.

    ./debs/extras/ansible

    Example Ansible role and playbook for configuring Ubuntu or Debian hosts for StorageGRID container deployment. You can customize the role or playbook as necessary.

    ./debs/storagegrid-ssoauth-azure.py

    An example Python script that you can use to sign in to the Grid Management API when single sign-on (SSO) is enabled using Active Directory or Ping Federate.

    ./debs/storagegrid-ssoauth-azure.js

    A helper script called by the companion storagegrid-ssoauth-azure.py Python script to perform SSO interactions with Azure.

    ./debs/extras/api-schemas

    API schemas for StorageGRID.

    Note: Before you perform an upgrade, you can use these schemas to confirm that any code you have written to use StorageGRID management APIs will be compatible with the new StorageGRID release if you don't have a non-production StorageGRID environment for upgrade compatibility testing.
    VMware
    Path and file name Description

    ./vsphere/README

    A text file that describes all of the files contained in the StorageGRID download file.

    ./vsphere/NLF000000.txt

    A free license that does not provide any support entitlement for the product.

    ./vsphere/NetApp-SG-version-SHA.vmdk

    The virtual machine disk file that is used as a template for creating grid node virtual machines.

    ./vsphere/vsphere-primary-admin.ovf

    ./vsphere/vsphere-primary-admin.mf

    The Open Virtualization Format template file (.ovf) and manifest file (.mf) for deploying the primary Admin Node.

    ./vsphere/vsphere-non-primary-admin.ovf

    ./vsphere/vsphere-non-primary-admin.mf

    The template file (.ovf) and manifest file (.mf) for deploying non-primary Admin Nodes.

    ./vsphere/vsphere-gateway.ovf

    ./vsphere/vsphere-gateway.mf

    The template file (.ovf) and manifest file (.mf) for deploying Gateway Nodes.

    ./vsphere/vsphere-storage.ovf

    ./vsphere/vsphere-storage.mf

    The template file (.ovf) and manifest file (.mf) for deploying virtual machine-based Storage Nodes.

    Deployment scripting tool

    Description

    ./vsphere/deploy-vsphere-ovftool.sh

    A Bash shell script used to automate the deployment of virtual grid nodes.

    ./vsphere/deploy-vsphere-ovftool-sample.ini

    An example configuration file for use with the deploy-vsphere-ovftool.sh script.

    ./vsphere/configure-storagegrid.py

    A Python script used to automate the configuration of a StorageGRID system.

    ./vsphere/configure-sga.py

    A Python script used to automate the configuration of StorageGRID appliances.

    ./vsphere/storagegrid-ssoauth.py

    An example Python script that you can use to sign in to the Grid Management API when single sign-on (SSO) is enabled. You can also use this script for Ping Federate integration.

    ./vsphere/configure-storagegrid.sample.json

    An example configuration file for use with the configure-storagegrid.py script.

    ./vsphere/configure-storagegrid.blank.json

    A blank configuration file for use with the configure-storagegrid.py script.

    ./vsphere/storagegrid-ssoauth-azure.py

    An example Python script that you can use to sign in to the Grid Management API when single sign-on (SSO) is enabled using Active Directory or Ping Federate.

    ./vsphere/storagegrid-ssoauth-azure.js

    A helper script called by the companion storagegrid-ssoauth-azure.py Python script to perform SSO interactions with Azure.

    ./vsphere/extras/api-schemas

    API schemas for StorageGRID.

    Note: Before you perform an upgrade, you can use these schemas to confirm that any code you have written to use StorageGRID management APIs will be compatible with the new StorageGRID release if you don't have a non-production StorageGRID environment for upgrade compatibility testing.

  1. If you are recovering a StorageGRID appliance-based system, select the appropriate files.

Note For appliance installation, these files are required only if you need to avoid network traffic. The appliance can download the required files from the Admin Node where you perform the recovery procedure.
Path and file name Description

./debs/storagegrid-webscale-images-version-SHA.deb

DEB package for installing the StorageGRID node images on your appliances.

./debs/storagegrid-webscale-images-version-SHA.deb.md5

MD5 checksum for the file /debs/storagegridwebscale- images-version-SHA.deb.