Skip to main content

Download and extract the StorageGRID installation files

Contributors netapp-lhalbert
PDFs

You must download the StorageGRID installation archive and extract the required 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 Ubuntu or Debian.

    Note Select 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 depends 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

./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 tool

Description

./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. You can also use this script for Ping Federate integration.

./debs/configure-storagegrid.sample.json

An example 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.

./debs/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.

./debs/storagegrid-ssoauth-azure.js

A helper script called by the companion storagegrid-ssoauth-azure.py Python script to perform SSO interactions with Azure.

./debs/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.