Downloading and extracting the StorageGRID Webscale installation files

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

About this task

Attention: You must use the version of StorageGRID Webscale that is currently running on the grid. Make sure the version shown in the installation archive file matches the version of StorageGRID Webscale that is currently installed. To determine the installed version, sign in to the Grid Management Interface, and click Help > About.

Steps

  1. Download the .tgz or .zip file for your platform.
    Use the .zip file if you are running Windows on the service laptop.
    Platform Installation archive
    VMware
    • StorageGRID-Webscale-version-VMware-uniqueID.tgz
    • StorageGRID-Webscale-version-VMware-uniqueID.zip
    Red Hat Enterprise Linux or CentOS
    • StorageGRID-Webscale-version-RPM-uniqueID.tgz
    • StorageGRID-Webscale-version-RPM-uniqueID.zip
    Ubuntu or Debian
    • StorageGRID-Webscale-version-DEB-uniqueID.tgz
    • StorageGRID-Webscale-version-DEB-uniqueID.zip
    OpenStack
    • StorageGRID-Webscale-version-OpenStack-uniqueID.tgz
    • StorageGRID-Webscale-version-OpenStack-uniqueID.zip
    Note: NetApp-provided virtual machine disk files and scripts for OpenStack have been deprecated for new installations or expansions of StorageGRID Webscale, but are available for recovery. Download the appropriate files and follow the OpenStack-specific recovery procedures in this guide.
  2. Extract the archive file.
  3. Choose the files you need, based on your platform, planned grid topology, 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 Webscale 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 API 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 Webscale appliances.
    /vsphere/configure-storagegrid.py A Python script used to automate the configuration of a StorageGRID Webscale 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 files
    Path and file name Description
    /rpms/README A text file that describes all of the files contained in the StorageGRID Webscale 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 Webscale node images on your RHEL hosts.
    /rpms/StorageGRID-Webscale-Service-version-SHA.rpm RPM package for installing the StorageGRID Webscale host service on your RHEL hosts.
    Deployment scripting tools
    /rpms/configure-storagegrid.py A Python script used to automate the configuration of a StorageGRID Webscale 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 Webscale appliances.
    /rpms/extras/ansible An Ansible role and example Ansible playbook for configuring RHEL hosts for StorageGRID Webscale container deployment. You can customize the playbook or role as necessary.
    Table 3. Ubuntu files
    Path and file name Description
    /debs/README A text file that describes all of the files contained in the StorageGRID Webscale 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 Webscale node images on Ubuntu hosts.
    /debs/storagegrid-webscale-service-version-SHA.deb DEB package for installing the StorageGRID Webscale host service on Ubuntu hosts.
    Deployment scripting tools
    /debs/configure-storagegrid.py A Python script used to automate the configuration of a StorageGRID Webscale 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 Webscale appliances.
    /debs/extras/ansible An Ansible role and example Ansible playbook for configuring Ubuntu hosts for StorageGRID Webscale container deployment. You can customize the playbook or role as necessary.
    Table 4. OpenStack files
    File Description
    /openstack/README A text file that describes all of the files contained in the StorageGRID Webscale download file.
    /openstack/NLF000000.txt A free license that does not provide any support entitlement for the product.
    /openstack/NetApp-SG-version-SHA.vmdk The virtual machine disk file that is used to create all grid node types from an OpenStack image.
    /openstack/deploy_sgws_openstack-version-py2-none-any.whl The installation package (.whl file) used by the Python pip installation tool to install the OpenStack deployment utility:

    deploy-sgws-openstack

    /openstack/deploy-sgws-openstack.sample.ini A sample configuration file for use with the deploy-sgws-openstack deployment utility.
    Deployment scripting tools
    /openstack/configure-sga.py A Python script used to automate the configuration of StorageGRID Webscale appliances.
    /openstack/configure-storagegrid.py A Python script used to automate the configuration of a StorageGRID Webscale system.
    /openstack/configure-storagegrid.sample.json A sample configuration file for use with the configure-storagegrid.py script.
    /openstack/configure-storagegrid.blank.json A blank configuration file for use with the configure-storagegrid.py script.
    /openstack/extras A folder containing additional deployment helpers, which are provided as is. The files in this folder might be useful in specific environments but are not supported.