Gather required materials
Before performing an expansion operation, gather the materials and install and configure any new hardware and networks.
Item | Notes |
---|---|
StorageGRID installation archive |
If you are adding new grid nodes or a new site, you must download and extract the StorageGRID installation archive. You must use the same version that is currently running on the grid. For details, see the instructions for downloading and extracting the StorageGRID installation files. Note: You don't need to download files if you are adding new storage volumes to existing Storage Nodes or installing a new StorageGRID appliance. |
Service laptop |
The service laptop has the following:
|
|
Contains the passwords required to access grid nodes on the command line. Included in the Recovery Package. |
Provisioning passphrase |
The passphrase is created and documented when the StorageGRID system is first installed. The provisioning passphrase is not in the |
StorageGRID documentation |
|
Current documentation for your platform |
For supported versions, see the Interoperability Matrix Tool (IMT). |
Download and extract the StorageGRID installation files
Before you can add new grid nodes or a new site, you must download the appropriate StorageGRID installation archive and extract the files.
You must perform expansion operations using the version of StorageGRID that is currently running on the grid.
-
Select the version of StorageGRID that is currently running on the grid.
-
Sign in with the username and password for your NetApp account.
-
Read the End User License Agreement, select the checkbox, and then select Accept & Continue.
-
In the Install StorageGRID column of the download page, 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 Red Hat Enterprise Linux
StorageGRID-Webscale-version-RPM-uniqueID.zip
StorageGRID-Webscale-version-RPM-uniqueID.tgz
Ubuntu or Debian or Appliances
StorageGRID-Webscale-version-DEB-uniqueID.zip
StorageGRID-Webscale-version-DEB-uniqueID.tgz
VMware
StorageGRID-Webscale-version-VMware-uniqueID.zip
StorageGRID-Webscale-version-VMware-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.
-
Download and extract the archive file.
-
Follow the appropriate step for your platform to 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 step for each platform are relative to the top-level directory installed by the archive file.
-
If you are expanding a Red Hat Enterprise Linux system, select the appropriate files.
Path and file name | Description |
---|---|
|
A text file that describes all of the files contained in the StorageGRID download file. |
|
A free license that does not provide any support entitlement for the product. |
|
RPM package for installing the StorageGRID node images on your RHEL hosts. |
|
RPM package for installing the StorageGRID host service on your RHEL hosts. |
Deployment scripting tool |
Description |
|
A Python script used to automate the configuration of a StorageGRID system. |
|
A Python script used to automate the configuration of StorageGRID appliances. |
|
An example configuration file for use with the |
|
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. |
|
A blank configuration file for use with the |
|
Example Ansible role and playbook for configuring RHEL hosts for StorageGRID container deployment. You can customize the role or playbook as necessary. |
|
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. |
|
A helper script called by the companion |
|
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. |
-
If you are expanding an Ubuntu or Debian system, select the appropriate files.
Path and file name | Description |
---|---|
|
A text file that describes all of the files contained in the StorageGRID download file. |
|
A non-production NetApp License File that you can use for testing and proof of concept deployments. |
|
DEB package for installing the StorageGRID node images on Ubuntu or Debian hosts. |
|
MD5 checksum for the file |
|
DEB package for installing the StorageGRID host service on Ubuntu or Debian hosts. |
Deployment scripting tool |
Description |
|
A Python script used to automate the configuration of a StorageGRID system. |
|
A Python script used to automate the configuration of StorageGRID appliances. |
|
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. |
|
An example configuration file for use with the |
|
A blank configuration file for use with the |
|
Example Ansible role and playbook for configuring Ubuntu or Debian hosts for StorageGRID container deployment. You can customize the role or playbook as necessary. |
|
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. |
|
A helper script called by the companion |
|
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. |
-
If you are expanding a VMware system, select the appropriate files.
Path and file name | Description |
---|---|
|
A text file that describes all of the files contained in the StorageGRID download file. |
|
A free license that does not provide any support entitlement for the product. |
|
The virtual machine disk file that is used as a template for creating grid node virtual machines. |
|
The Open Virtualization Format template file ( |
|
The template file ( |
|
The template file ( |
|
The template file ( |
Deployment scripting tool |
Description |
|
A Bash shell script used to automate the deployment of virtual grid nodes. |
|
An example configuration file for use with the |
|
A Python script used to automate the configuration of a StorageGRID system. |
|
A Python script used to automate the configuration of StorageGRID appliances. |
|
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. |
|
An example configuration file for use with the |
|
A blank configuration file for use with the |
|
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. |
|
A helper script called by the companion |
|
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. |
-
If you are expanding a StorageGRID appliance-based system, select the appropriate files.
Path and file name | Description |
---|---|
|
DEB package for installing the StorageGRID node images on your appliances. |
|
MD5 checksum for the file |
For appliance installation, these files are only required if you need to avoid network traffic. The appliance can download the required files from the primary Admin Node. |
Verify hardware and networking
Before beginning the expansion of your StorageGRID system, ensure the following:
-
The hardware needed to support the new grid nodes or new site has been installed and configured.
-
All new nodes have bidirectional communication paths to all existing and new nodes (a requirement for the Grid Network). In particular, confirm that the following TCP ports are open between the new nodes you are adding in the expansion and the primary Admin Node:
-
1055
-
7443
-
8011
-
10342
-
-
The primary Admin Node can communicate with all expansion servers that are intended to host the StorageGRID system.
-
If any of the new nodes has a Grid Network IP address on a subnet not previously used, you have already added the new subnet to the Grid Network subnet list. Otherwise, you will have to cancel the expansion, add the new subnet, and start the procedure again.
-
You aren't using network address translation (NAT) on the Grid Network between grid nodes or between StorageGRID sites. When you use private IPv4 addresses for the Grid Network, those addresses must be directly routable from every grid node at every site. Using NAT to bridge the Grid Network across a public network segment is supported only if you use a tunneling application that is transparent to all nodes in the grid, meaning the grid nodes require no knowledge of public IP addresses.
This NAT restriction is specific to grid nodes and the Grid Network. As required, you can use NAT between external clients and grid nodes, such as to provide a public IP address for a Gateway Node.