Downloading and extracting the StorageGRID installation files

Before you can recover StorageGRID grid nodes, you must download the software and extract the files to your service laptop.

About this task

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 Grid Manager, go to Help > About.
  2. Go to the NetApp Downloads page for StorageGRID.
  3. Select the version of StorageGRID that is currently running on the grid.
  4. Sign in using the username and password for your NetApp account.
  5. Read and accept the End User License Agreement.
    The downloads page for the version you selected appears. The page contains columns for new installation files, upgrade files, and NAS Bridge.
  6. In the New install files column, 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 on the service laptop.
    Platform Installation archive
    VMware
    • StorageGRID-Webscale-version-VMware-uniqueID.zip
    • StorageGRID-Webscale-version-VMware-uniqueID.tgz
    Red Hat Enterprise Linux or CentOS
    • 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
    OpenStack or other hypervisor

    NetApp-provided virtual machine disk files and scripts for OpenStack are no longer supported for recovery operations. If you need to recover a node running in an OpenStack deployment, download the files for your Linux operating system. Then, follow the procedure for replacing a Linux node.

  7. Download and extract the archive file.
  8. Choose the files you need, based on your platform and which grid nodes you need to recover.

    The paths listed in the tables are relative to the top-level directory installed by the archive file.

    Table 1. VMware files
    Filename 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-archive.ovf

    /vsphere/vsphere-archive.mf

    The template file (.ovf) and manifest file (.mf) for deploying Archive 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 non-appliance Storage Nodes.
    Deployment scripting tools
    /vsphere/deploy-vsphere-ovftool.sh A Bash shell script used to automate the deployment of virtual grid nodes.
    /vsphere/deploy-vsphere-ovftool-sample.ini A sample configuration file for use with the deploy-vsphere-ovftool.sh script.
    /vsphere/configure-sga.py A Python script used to automate the configuration of StorageGRID appliances.
    /vsphere/configure-storagegrid.py A Python script used to automate the configuration of a StorageGRID system.
    /vsphere/configure-storagegrid.sample.json A sample 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.
    Table 2. Red Hat Enterprise Linux or CentOS files
    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 hosts.
    /rpms/StorageGRID-Webscale-Service-version-SHA.rpm RPM package for installing the StorageGRID host service on your hosts.
    Deployment scripting tools
    /rpms/configure-storagegrid.py A Python script used to automate the configuration of a StorageGRID system.
    /rpms/configure-storagegrid.sample.json A sample configuration file for use with the configure-storagegrid.py script.
    /rpms/configure-storagegrid.blank.json A blank configuration file for use with the configure-storagegrid.py script.
    /rpms/configure-sga.py A Python script used to automate the configuration of StorageGRID appliances.
    /rpms/extras/ansible An Ansible role and example Ansible playbook for configuring the hosts for StorageGRID container deployment. You can customize the playbook or role as necessary.
    Table 3. Ubuntu or Debian files
    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 free license that does not provide any support entitlement for the product..

    /debs/storagegrid-webscale-images-version-SHA.deb DEB package for installing the StorageGRID node images on your hosts.
    /debs/storagegrid-webscale-service-version-SHA.deb DEB package for installing the StorageGRID host service on your hosts.
    Deployment scripting tools
    /debs/configure-storagegrid.py A Python script used to automate the configuration of a StorageGRID system.
    /debs/configure-storagegrid.sample.json A sample 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/configure-sga.py A Python script used to automate the configuration of StorageGRID appliances.
    /debs/extras/ansible An Ansible role and example Ansible playbook for configuring the hosts for StorageGRID container deployment. You can customize the playbook or role as necessary.
    Table 4. Appliance files
    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 Checksum of the DEB installation package used by the StorageGRID Appliance Installer to validate that the package is intact after upload.