Skip to main content

Download and extract the StorageGRID installation files

Contributors netapp-perveilerk ssantho3 netapp-lhalbert

You must download the StorageGRID installation archive and extract the required files.

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.

    Important 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.

    The downloads page for the version you selected appears. The page contains three columns:

  6. In the Install StorageGRID column, select the .tgz or .zip file for Ubuntu or Debian.

    Note Select the .zip file if you are running Windows on the service laptop.
  7. Save and extract the archive file.

  8. Choose the files you need from the following list.

    The set of files you need depends on your planned grid topology and how you will deploy your StorageGRID grid.

    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.

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