Downloading and extracting the StorageGRID installation files

Before you can add new grid nodes or a new data center site, you must download the appropriate StorageGRID installation archive and extract the files to the service laptop.

1. Go to the Software Download page on the NetApp Support Site.

   NetApp Downloads: Software

2. Sign in using the username and password for your NetApp account.
3. Scroll to StorageGRID (formerly StorageGRID Webscale), select All Platforms, and click Go.
4. Select the StorageGRID release, and click View & Download.
5. From the Software Download section of the page, click CONTINUE, and accept the End User License Agreement.
6. 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.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/other Hypervisor	To expand an existing deployment on OpenStack, you must deploy a virtual machine running one of the supported Linux distributions listed above and follow the appropriate instructions for Linux.

7. Download the archive file.
8. Extract the archive file.
9. Choose the files you need, based on your platform, planned grid topology, and how you will expand your StorageGRID grid.

   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 nodes.
   /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 Storage Nodes.
   Deployment scripting tools
   /vsphere/deploy-vsphere-ovftool.sh	A Bash shell script used to automate the deployment of 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 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 playbook for configuring the hosts for StorageGRID container deployment. You can customize the playbook or role as necessary.