Decommissioning connected grid nodes

You can decommission and permanently remove grid nodes that are connected to the grid.

Before you begin

Before decommissioning a connected node, confirm the following:
  • The grid only includes connected grid nodes.
  • The Decommission Possible column for the node or nodes you want to decommission includes a green check mark.
  • All grid nodes have Normal (green) health green checkmark icon. If you see one of these icons in the Health column, you must try to resolve the issue or alarm:
    • yellow square icon (yellow): Notice
    • light orange diamond icon (light orange): Minor
    • dark orange diamond icon (dark orange): Major
    • red x icon (red): Critical
  • If you previously decommissioned a disconnected Storage Node, the data repair jobs have all completed successfully. See the instructions for checking data repair jobs.
Attention: Do not remove a grid node's virtual machine or other resources until instructed to do so in this procedure.


  1. From the Decommission page, select the check box for each grid node you want to decommission.
  2. Enter the provisioning passphrase.
    The Start Decommission button is enabled.
  3. Click Start Decommission.
    A confirmation dialog box appears.
    screenshot of decommission confirmation dialog box
  4. Review the list of selected nodes, and click OK.
    The decommission procedure starts, and the progress is displayed for each node. During the procedure, a new Recovery Package is generated to show the grid configuration change.
    screenshot of node decomissioning in progress
    Note: Do not take a Storage Node offline after the decommission procedure has started. (That is, do not change the setting of Storage State-Desired from LDR > Storage > Configuration.) Changing the state might result in some content not being copied to other locations.
  5. As soon as the new Recovery Package is available, click the link or select Maintenance > Recovery Package to access the Recovery Package page. Then, download the .zip file.
    See "Downloading the Recovery Package" for instructions.
    Note: Download the Recovery Package as soon as possible to ensure you can recover your grid if something goes wrong during the decommission procedure.
  6. Periodically monitor the Decommission page to ensure that all selected nodes are decommissioned successfully.
    Storage Nodes can take days or weeks to decommission. When all tasks are complete, the node selection list is redisplayed with a success message.
    screenshot showing that decommission is complete
  7. Follow the appropriate step for your platform:
    • Linux: Detach the volumes and delete the node configuration files you created during installation.
    • VMware: Use the vCenter "Delete from Disk" option to delete the virtual node.
    • StorageGRID appliance: The appliance node automatically reverts to an undeployed state where you can access the StorageGRID Appliance Installer. You can power off the appliance or add it to another grid.

After you finish

Ensure that the drives of the decommissioned grid node are wiped clean. Use a commercially available data wiping tool or service to permanently and securely remove data from the drives.