Skip to main content

Download and extract the StorageGRID installation files

Contributors netapp-lhalbert

You must download the StorageGRID installation archives and extract the files. Optionally, you can manually verify the files in the installation package.

Steps
  1. Go to the NetApp Downloads page for StorageGRID.

  2. Select the button for downloading the latest release, or select another version from the drop-down menu and select Go.

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

  4. If a Caution/MustRead statement appears, read it and select the checkbox.

    Caution You must apply any required hotfixes after you install the StorageGRID release. For more information, see the hotfix procedure in the recovery and maintenance instructions
  5. Read the End User License Agreement, select the checkbox, and then select Accept & Continue.

  6. In the Install StorageGRID column, select the .tgz or .zip installation archive for VMware.

    Note Use the .zip file if you are running Windows on the service laptop.
  7. Save the installation archive.

  8. If you need to verify the installation archive:

    1. Download the StorageGRID code signature verification package. The file name for this package uses the format StorageGRID_<version-number>_Code_Signature_Verification_Package.tar.gz, where <version-number> is the StorageGRID software version.

    2. Follow the steps to manually verify the installation files.

  9. Extract the files from the installation archive.

  10. Choose the files you need.

    The files you need depend on your planned grid topology and how you will deploy your StorageGRID system.

Note The paths listed in the table are relative to the top-level directory installed by the extracted installation archive.
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.