Step 2: Review the site

From Step 2 (Review) of the Decommission Site page, you can review the storage usage for each Storage Node at the site. Then, you must update ILM rules that refer to the site in an Erasure Coding profile or a storage pool.

About this task

You are prevented from starting the site decommission procedure in these cases:
  • A storage pool that refers to the site is used in any ILM rule in the active ILM policy or in a proposed ILM policy.
  • An Erasure Coding profile that refers to the site is used in any ILM rule.
    Note: During the site decommission procedure, StorageGRID deactivates and removes any Erasure Coding profiles that reference the decommissioned site. Because StorageGRID cannot deactivate an Erasure Coding profile if it is referred to by an ILM rule, you must remove all affected Erasure Coding profiles from all ILM rules before you can start this procedure.

If either of these conditions exist, you must update ILM rule and policy settings as described in the following steps.

Procedure

  1. In the Nodes section of the Decommission Site page, review the value for each Storage Node in the Used Storage Capacity column.
    The Used Storage Capacity is an estimate of how much storage has been used for object copies, erasure-coded fragments, and object metadata on each node. Because the nodes are offline, Used Storage Capacity shows the last known value for each node. Use the sum of these values to estimate how much of your system's data storage will become inaccessible when you decommission this site.
    Note: If your ILM policy was designed to protect against the loss of a single site, copies of your object data should still exist on the remaining sites.

    Decommission Site Page Step 2 Nodes
  2. In the ILM rules section of the page, determine whether any ILM rules refer to this site in an Erasure Coding profile or a storage pool.
    • If only the stock Make 2 Copies rule is listed, you can start the decommission. Go to Step 3: Perform the decommission.
      Note: You can decommission a site even if the stock Make 2 Copies rule is used in the active ILM policy or a proposed ILM policy. When StorageGRID removes a site, it automatically updates the default All Storage Nodes storage pool, which is used in the Make 2 Copies rule.
    • If Uses EC Profile is selected for a rule, that rule refers to the site in an Erasure Coding profile. Go to step 3.
    • If Uses EC Profile is not selected for a rule, that rule refers to the site in a storage pool. Go to step 4.

    Decommission Site Page Step 2 ILM
    In the example, the Raleigh site is referred to by three ILM rules:
    • The 3 site EC rule refers to the site in an Erasure Coding profile. This ILM rule is used in the active ILM policy.
    • The 2 copies at Raleigh and Sunnyvale rule refers to the site in a storage pool. This ILM rule is used in the active ILM policy.
    • The stock Make 2 Copies rule refers to the site in the default All Storage Nodes storage pool. This ILM rule is used in the active ILM policy.
  3. If one or more ILM rules refer to the site in an Erasure Coding profile, follow these steps for each affected rule:
    Note: For details, see information about ILM rules and ILM policies in the instructions for administering StorageGRID.
    Where has the profile been used? Additional steps to perform before decommissioning the site
    In an ILM rule that is not in the active or a proposed ILM policy
    1. Click the rule name to determine the name of the Erasure Coding profile.
    2. Edit or delete the ILM rule. If you edit the rule, remove all placements that use the Erasure Coding profile.
    3. Return to Step 2 of the Decommission Site page to ensure that no checkmarks appear in the Uses EC Profile column.
    In an ILM rule that is currently in the active ILM policy
    1. Click the rule name to determine the name of the Erasure Coding profile.
    2. Clone the active policy.
    3. Remove the ILM rule that uses the Erasure Coding profile.
    4. Add one or more new ILM rules to ensure objects are protected across the remaining sites.
    5. Save, simulate, and activate the new policy.
    6. Edit or delete the rule you removed from the policy. If you edit the rule, remove all placements that use the Erasure Coding profile.
    7. Return to Step 2 of the Decommission Site page to ensure that no checkmarks appear in the Uses EC Profile column.
    In an ILM rule that is currently in a proposed ILM policy
    1. Click the rule name to determine the name of the Erasure Coding profile.
    2. Edit the proposed policy.
    3. Remove the ILM rule that uses the Erasure Coding profile.
    4. Add one or more new ILM rules to ensure all objects are protected across the remaining sites.
    5. Save the proposed policy.
    6. Edit or delete the rule you removed from the policy. If you edit the rule, remove all placements that use the Erasure Coding profile.
    7. Return to Step 2 of the Decommission Site page to ensure that no checkmarks appear in the Uses EC Profile column.
  4. If one or more ILM rules refer to this site in a storage pool (Uses EC Profile is not selected), follow these steps for each affected rule:
    Attention: You can perform a site decommission if a storage pool that refers to the site exists in an unused ILM rule. However, to avoid adding the rule to a future ILM policy, you should edit or delete the rule to remove all placements that refer to the site.
    Note: For details, see information about ILM rules and ILM policies in the instructions for administering StorageGRID.
    Where has the storage pool been used? Additional steps to perform before decommissioning the site
    In an ILM rule that is not in the active or a proposed ILM policy
    1. Click the rule name to determine the name of the storage pool.
    2. (Optional, but recommended): Edit or delete the ILM rule. If you edit the rule, remove all placements that use the storage pool.
    3. Return to Step 2 of the Decommission Site page to ensure that the rule no longer appears.
    In an ILM rule that is currently in the active ILM policy
    1. Click the rule name to determine the name of the storage pool.
    2. Clone the active policy.
    3. Remove the ILM rule that uses the storage pool.
    4. Add one or more new ILM rules to ensure objects are protected across the remaining sites.
    5. Save, simulate, and activate the new policy.
    6. (Optional, but recommended): Edit or delete the rule you removed from the policy. If you edit the rule, remove all placements that use the storage pool.
    7. Return to Step 2 of the Decommission Site page to ensure that the rule no longer appears.
    In an ILM rule that is currently in a proposed ILM policy
    1. Click the rule name to determine the name of the storage pool.
    2. Edit the proposed policy.
    3. Remove the ILM rule that uses the storage pool.
    4. Add one or more new ILM rules to ensure all objects are protected across the remaining sites.
    5. Save the proposed policy.
    6. (Optional, but recommended): Edit or delete the rule you removed from the policy. If you edit the rule, remove all placements that use the storage pool.
    7. Return to Step 2 of the Decommission Site page to ensure that the rule no longer appears.
  5. Review the ILM rules table and confirm the following:
    • No ILM rules refer to the site in an Erasure Coding profile.
    • No rules that refer to the site in a storage pool are used in the active ILM policy or a proposed ILM policy.
      Note: You can decommission a site even if the stock Make 2 Copies rule is used in the active ILM policy or a proposed ILM policy.
    • The Provisioning Passphrase field is now enabled.

    Decommission Site Step 2 Provision Passphrase Enabled
    In the example:
    • The Raleigh site is no longer referred to by an Erasure Coding profile that is used in an ILM rule.
    • The Raleigh site is still referred to by the 2 Copies at Raleigh and Sunnyvale rule, but this rule is no longer used in the active ILM policy or in any proposed ILM policy. Although you can now decommission the site, you should edit or remove this rule to remove all placements that refer to the site.
    • The Raleigh site is still referred to by the stock Make 2 Copies rule, and this rule is used in the active ILM policy. Because StorageGRID will update the stock ILM rule automatically, you can now start the decommission.
    • The Provisioning Passphrase field is enabled. You can proceed to the next step.