Performing the expansion

When you perform the expansion, the new grid nodes or the new site is added to your existing StorageGRID Webscale deployment. You must download an updated copy of the Recovery Package file while the expansion process is completing.

Before you begin

About this task

Performing the expansion includes three phases:
  1. To start the expansion, you specify whether you are adding new grid nodes or a new site, approve the grid nodes you want to add, enter the provisioning passphrase, and click Expand.
  2. While the expansion process is running, you download a new Recovery Package file and monitor the expansion steps on each grid node.
  3. When the expansion is complete, you verify that all new grid nodes have the correct version of StorageGRID Webscale.

During the expansion, you can look at the Expansion Progress section to see the grid configuration tasks required to change the grid topology, along with the status of each task. The set of grid configuration tasks depends on the grid nodes being added, and whether a new site is being added. Some grid configuration tasks might take a significant amount of time to run on a large grid. These grid configuration tasks are run automatically in the background.

This image is explained by the surrounding text.
The screen shot shows an example expansion that includes adding a new site. When each task for the expansion is in progress, the Grid Node Status section lists the current status for each grid node.
Note: Configuring Cassandra for a new site might take only a few minutes if the Cassandra database is relatively empty. However, if the Cassandra database has a large quantity of object metadata, this step might take several hours or longer.


  1. Select Maintenance > Expansion.
  2. Click Configure Expansion.
  3. Select the type of expansion you are starting:
    • If you are adding grid nodes to an existing site, select the existing site to add the grid nodes to from the Site drop-down list.
    • If you are adding a new site, select --New Site-- from the Site drop-down list, and enter the name of the new site.
  4. Click Save.
  5. Approve the pending grid nodes:
    1. Review the Pending Nodes list, and confirm that it shows all of the grid nodes you deployed.
      Note: If a grid node is missing, confirm that it was deployed successfully.
    2. Select the radio button next to the pending grid node you want to approve.
    3. Click Approve.
      The Grid Node Configuration page appears, with the appropriate node name in the title.
    4. In General Settings, modify settings for the following properties, as necessary:
      • Site: The name of the site the grid node will be associated with.
      • Name: The host name that will be assigned to the node, and the name that will be displayed in the Grid Management Interface.
      • NTP Role: The grid node's Network Time Protocol (NTP) role. The options are Automatic, Primary, and Client. Selecting Automatic assigns the Primary option to Admin Nodes, API Gateway Nodes, and Storage Nodes that have an ADC service and assigns the Client option to all other grid node types.
        Note: Assign the Primary NTP role to at least two nodes at each site. This provides redundant system access to external timing sources.
      • ADC Service: This field is only available if the Node Configuration dialog box was opened for Storage Nodes. For Storage Nodes, this option determines whether the selected node will run the Administrative Domain Controller service. Select Automatic to have this option applied automatically by the system as required, or select Yes or No to explicitly set this option for the grid node. For example, because you cannot add an ADC service to a node after it has been deployed, you might need to select Yes if this expansion will be followed by a decommissioning of Storage Nodes containing the ADC service at this site.
    5. In Grid Network, modify settings for the following properties, as necessary:
      • IPv4 Address (CIDR): The CIDR network address for the eth0 Grid Network interface. For example:
      • Gateway: The default gateway of the grid node. For example:
    6. If you want to configure the Admin Network for the grid node, add or update settings in the Admin Network section, as necessary.
      Enter the destination subnetworks of the routes out of this interface in the Subnets (CIDR) text box.
    7. If you want to configure the Client Network for the grid node, add or update settings in the Client Network section, as necessary.
    8. Click Save.
      The approved grid node entry moves to the Approved Nodes list.
      Note: If you need to modify the properties of an approved grid node, select its radio button and click Edit.
    9. Repeat these steps for each pending grid node you want to approve.
  6. When you have approved the new grid nodes, enter the Provisioning Passphrase.
  7. Click Expand.
    The page updates to display the status of the expansion procedure.
  8. As soon as the Download Recovery Package link appears, download the Recovery Package file.
    You must download an updated copy of the Recovery Package file as soon as possible after making grid topology changes to the StorageGRID Webscale system. The Recovery Package file allows you to restore the system if a failure occurs.
    1. Click the download link.
    2. Enter the provisioning passphrase, and click Start Download.
      The download starts immediately.
    3. When the download completes, open the .zip file and confirm it includes a gpt-backup directory and a second .zip file. Then, extract this inner .zip file and confirm you can open the passwords.txt file.
    4. Copy the downloaded Recovery Package file (.zip) to two safe, secure, and separate locations.
      Important: The Recovery Package file must be secured because it contains encryption keys and passwords that can be used to obtain data from the StorageGRID Webscale system.

After you finish

Depending on which types of grid nodes you added, you must perform additional integration and configuration steps.