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 NetApp Downloads page for StorageGRID.

   NetApp Downloads: StorageGRID

2. Select the version of StorageGRID that is currently running on the grid.
3. Sign in using the username and password for your NetApp account.
4. 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 and upgrade files.
5. 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 and Appliance	StorageGRID-Webscale-version-DEB-uniqueID.zip StorageGRID-Webscale-version-DEB-uniqueID.tgz
   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.

6. Download and extract the archive file.
7. Choose the files you need, based on your platform, planned grid topology, and how you will expand your StorageGRID system.

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

   Table 1. Files for 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-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 virtual machine-based 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-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 is enabled.
   ./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. Files for Red Hat Enterprise Linux or CentOS Linux

   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 or CentOS hosts.
   ./rpms/StorageGRID-Webscale-Service-version-SHA.rpm	RPM package for installing the StorageGRID host service on your RHEL or CentOS hosts.
   Deployment scripting tools
   ./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	A sample 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.
   ./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 or CentOS hosts for StorageGRID container deployment. You can customize the role or playbook as necessary.

   Table 3. Files for 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 tools
   ./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.
   ./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/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.

   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.

   Note: For appliance installation, these files are usually not required. The appliance can download the required files from the primary Admin Node.