Skip to main content

Work with ILM policies and ILM rules

Contributors

As your storage requirements change, you might need to put additional policies in place or modify the ILM rules associated with a policy. You can view ILM metrics to determine system performance.

Before you begin

View ILM policies

To view active and inactive ILM policies and policy activation history:

  1. Select ILM > Policies.

  2. Select Policies to view a list of active and inactive policies. The table lists the name of each policy, the tags the policy is assigned to, and whether the policy is active or inactive.

  3. Select Activation history to view a list of activation start and end dates for policies.

  4. Select a policy name to view the details for the policy.

    Note If you view the details for a policy whose status is Edited or Deleted, a message appears explaining that you are viewing the version of the policy that was active for the specified time span and has since been edited or deleted.

Edit an ILM policy

You can only edit an inactive policy. If you want to edit an active policy, deactivate it or create a clone and edit the clone.

To edit a policy:

  1. Select ILM > Policies.

  2. Select the checkbox for the policy you want to edit, then select Edit.

  3. Edit the policy by following the instructions in Create ILM policies.

  4. Simulate the policy before you re-activate it.

Caution An ILM policy that has been incorrectly configured can result in unrecoverable data loss. Before activating an ILM policy, carefully review the ILM policy and its ILM rules, and then simulate the ILM policy. Always confirm that the ILM policy will work as intended.

Clone an ILM policy

To clone an ILM policy:

  1. Select ILM > Policies.

  2. Select the checkbox for the policy you want to clone, then select Clone.

  3. Create a new policy starting with the policy you've cloned by following the instructions in Create ILM policies.

Caution An ILM policy that has been incorrectly configured can result in unrecoverable data loss. Before activating an ILM policy, carefully review the ILM policy and its ILM rules, and then simulate the ILM policy. Always confirm that the ILM policy will work as intended.

Remove an ILM policy

You can only remove an ILM policy if it is inactive. To remove a policy:

  1. Select ILM > Policies.

  2. Select the checkbox for the inactive policy you want to remove.

  3. Select Remove.

View ILM rule details

To view the details for an ILM rule, including the retention diagram and placement instructions for the rule:

  1. Select ILM > Rules.

  2. Select the name of the rule whose details you want to view. Example:

    ILM rule details page

Additionally, you can use the details page to clone, edit, or remove a rule. You can't edit or remove a rule if it's used in any policy.

Clone an ILM rule

You can clone an existing rule if you want to create a new rule that uses some of the settings of the existing rule. If you need to edit a rule that's used in any policy, you clone the rule instead and make changes to the clone. After you make changes to the clone, you can remove the original rule from the policy and replace it with the modified version as required.

Note You can't clone an ILM rule if it was created using StorageGRID version 10.2 or earlier.
Steps
  1. Select ILM > Rules.

  2. Select the checkbox for the rule you want to clone, then select Clone. Alternatively, select the rule name, then select Clone from the rule details page.

  3. Update the cloned rule by following the steps for editing an ILM rule and using advanced filters in ILM rules.

    When cloning an ILM rule, you must enter a new name.

Edit an ILM rule

You might need to edit an ILM rule to change a filter or placement instruction.

You can't edit a rule if it is used in any ILM policy. Instead, you can clone the rule and make any required changes to the cloned copy.

Caution An ILM policy that has been incorrectly configured can result in unrecoverable data loss. Before activating an ILM policy, carefully review the ILM policy and its ILM rules, and then simulate the ILM policy. Always confirm that the ILM policy will work as intended.
Steps
  1. Select ILM > Rules.

  2. Confirm that the rule you want to edit is not used in any ILM policy.

  3. If the rule you want to edit is not in use, select the checkbox for the rule and select Actions > Edit. Alternatively, select the name of the rule, then select Edit on the rule details page.

  4. Complete the steps of the Edit ILM rule wizard. As necessary, follow the steps for creating an ILM rule and using advanced filters in ILM rules.

    When editing an ILM rule, you can't change its name.

Remove an ILM rule

To keep the list of current ILM rules manageable, remove any ILM rules that you aren't likely to use.

Steps

To remove an ILM rule that is currently used in an active policy:

  1. Clone the policy.

  2. Remove the ILM rule from the policy clone.

  3. Save, simulate, and activate the new policy to make sure objects are protected as expected.

  4. Go to the steps for removing an ILM rule that is currently used in an inactive policy.

To remove an ILM rule that is currently used in an inactive policy:

  1. Select the inactive policy.

  2. Remove the ILM rule from the policy or remove the policy.

  3. Go to the steps for removing an ILM rule that is not currently used.

To remove an ILM rule that is not currently used:

  1. Select ILM > Rules.

  2. Confirm that the rule you want to remove is not used in any policy.

  3. If the rule you want to remove is not in use, select the rule and select Actions > Remove. You can select multiple rules and remove all of them at the same time.

  4. Select Yes to confirm that you want to remove the ILM rule.

View ILM metrics

You can view metrics for ILM, such as the number of objects in the queue and the evaluation rate. You can monitor these metrics to determine system performance. A large queue or evaluation rate might indicate that the system is not able to keep up with the ingest rate, the load from the client applications is excessive, or that some abnormal condition exists.

Steps
  1. Select Dashboard > ILM.

    Note Because the dashboard can be customized, the ILM tab might not be available.
  2. Monitor the metrics on the ILM tab.

    You can select the question mark question mark icon to see a description of the items on the ILM tab.

    ILM metrics on Grid Manager dashboard