Performing the expansion

When you perform the expansion, the new grid nodes are added to your existing StorageGRID deployment.

Before you begin

About this task

Performing the expansion includes these phases:
  1. You configure the expansion by specifying whether you are adding new grid nodes or a new site and approving the grid nodes you want to add.
  2. You start the expansion.
  3. While the expansion process is running, you download a new Recovery Package file.
  4. You monitor the status of the grid configuration tasks, which run automatically. The set of tasks depends on what types of grid nodes are being added and on whether a new site is being added.
    Attention: Some tasks might take a significant amount of time to run on a large grid. For example, streaming Cassandra to a new Storage Node might take only a few minutes if the Cassandra database is relatively empty. However, if the Cassandra database includes a large amount of object metadata, this stage might take several hours or longer. You can look at the "streamed" percentage shown during the "Starting Cassandra and streaming data" stage to determine how complete the Cassandra streaming operation is.


  1. Select Maintenance > Expansion.
    The Grid Expansion page appears. The Pending Nodes section lists all nodes that are ready to be added.

    screenshot showing Grid Expansion page

  2. Click Configure Expansion.
    The Site Selection dialog box appears.

    Site Selection Dialog

  3. Select the type of expansion you are starting:
    • If you are adding a new site, select New, and enter the name of the new site.
    • If you are adding grid nodes to an existing site, select Existing.
  4. Click Save.
  5. Review the Pending Nodes list, and confirm that it shows all of the grid nodes you deployed.
    As required, you can hover your cursor over a node's Grid Network MAC Address to see details about that node.

    screenshot of Grid Node details

    Note: If a grid node is missing, confirm that it was deployed successfully.
  6. From the list of pending nodes, approve the grid nodes for this expansion.
    1. Select the radio button next to the first pending grid node you want to approve.
    2. Click Approve.

      The grid node configuration form appears.

      Grid Node Configuration form

    3. As required, modify the general settings:
      • Site: The name of the site the grid node will be associated with. If you are adding a new site, all nodes are added to the new site.
      • Name: The host name that will be assigned to the node, and the name that will be displayed in the Grid Manager.
      • NTP Role: The Network Time Protocol (NTP) role of the grid node. The options are Automatic, Primary, and Client. Selecting Automatic assigns the Primary role to Admin Nodes, Storage Nodes with ADC services, Gateway Nodes, and any grid nodes that have non-static IP addresses. All other grid nodes are assigned the Client role.
        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 (Storage Nodes only): Whether this Storage Node will run the Administrative Domain Controller (ADC) service. The ADC service keeps track of the location and availability of grid services. At least three Storage Nodes at each site must include the ADC service. You cannot add the ADC service to a node after it is deployed.
        • If you are adding this node to replace a Storage Node, select Yes if the node you are replacing includes the ADC service. Because you cannot decommission a Storage Node if too few ADC services would remain, this ensures that a new ADC service is available before the old service is removed.
        • Otherwise, select Automatic to let the system determine whether this node requires the ADC service.

        Learn about the ADC quorum in the recovery and maintenance instructions.

    4. As required, modify the settings for the Grid Network, Admin Network, and Client Network.
      • IPv4 Address (CIDR): The CIDR network address for the network interface. For example:
      • Gateway: The default gateway of the grid node. For example:
      • Subnets (CIDR): One or more subnetworks for the Admin Network.
    5. Click Save.
      The approved grid node moves to the Approved Nodes list.

      screenshot showing Approved Nodes

      • To modify the properties of an approved grid node, select its radio button, and click Edit.
      • To move an approved grid node back to the Pending Nodes list, select its radio button, and click Reset.
      • To permanently remove an approved grid node, power the node off. Then, select its radio button, and click Remove.
    6. Repeat these steps for each pending grid node you want to approve.
      Note: If possible, you should approve all pending grid notes and perform a single expansion. More time will be required if you perform multiple small expansions.
  7. When you have approved all grid nodes, enter the Provisioning Passphrase, and click Expand.
    After a few minutes, this page updates to display the status of the expansion procedure. When tasks that affect individual grid node are in progress, the Grid Node Status section lists the current status for each grid node.
    Note: During this process, for appliances the StorageGRID Appliance Installer shows installation moving from Stage 3 to Stage 4, Finalize Installation. When Stage 4 completes, the controller is rebooted.

    This image is explained by the surrounding text.

    Note: A site expansion includes an additional task to configure Cassandra for the new site.
  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 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.
    3. When the download completes, open the .zip file and confirm it includes a gpt-backup directory and a * file. Then, extract the * file, go to the /GID*_REV* directory, and confirm you can open the passwords.txt file.
    4. Copy the downloaded Recovery Package file (.zip) to two safe, secure, and separate locations.
      Attention: The Recovery Package file must be secured because it contains encryption keys and passwords that can be used to obtain data from the StorageGRID system.
  9. If you are adding one or more Storage Nodes, monitor the progress of the "Starting Cassandra and streaming data" stage by reviewing the percentage shown in the status message.

    Grid Expansion > Starting Cassandra and streaming data
    This percentage estimates how complete the Cassandra streaming operation is, based on the total amount of Cassandra data available and the amount that has already been written to the new node.
    Attention: Do not reboot any Storage Nodes during Step 4 (Starting services on the new grid nodes). The "Starting Cassandra and streaming data" stage might take hours to complete for each new Storage Node, especially if existing Storage Nodes contain a large amount of object metadata.
  10. Continue monitoring the expansion until all tasks are complete and the Configure Expansion button reappears.

After you finish

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