Skip to main content
A newer release of this product is available.

Creating a proposed ILM policy

Contributors netapp-lhalbert

You can create a proposed ILM policy from scratch, or you can clone the current active policy if you want to start with the same set of rules.

What you'll need
  • You must be signed in to the Grid Manager using a supported browser.

  • You must have specific access permissions.

  • You must have created the ILM rules you want to add to the proposed policy. As required, you can save a proposed policy, create additional rules, and then edit the proposed policy to add the new rules.

  • You must have created a default ILM rule for the policy that does not contain any filters.

About this task

Typical reasons for creating a proposed ILM policy include:

  • You added a new site and need to use new ILM rules to place objects at that site.

  • You are decommissioning a site and you need to remove all rules that refer to the site.

  • You added a new tenant that has special data protection requirements.

  • You started to use a Cloud Storage Pool.

Important Use the system's built-in policy, Baseline 2 Copies Policy, in test systems only. The Make 2 Copies rule in this policy uses the All Storage Nodes storage pool, which contains all sites. If your StorageGRID system has more than one site, two copies of an object might be placed on the same site.
Note

If the global S3 Object Lock setting has been enabled, the steps for creating a policy are slightly different. You must ensure that the ILM policy is compliant with the requirements of buckets that have S3 Object Lock enabled.

Steps
  1. Select ILM > Policies.

    The ILM Policies page appears. From this page, you can review the list of proposed, active, and historical policies; create, edit, or remove a proposed policy; clone the active policy; or view the details for any policy.

    ILM Policies page
  2. Determine how you want to create the proposed ILM policy.

    Option Steps

    Create a new proposed policy that has no rules already selected

    1. If a proposed ILM policy currently exists, select that policy, and click Remove.

      You cannot create a new proposed policy if a proposed policy already exists.

    2. Click Create Proposed Policy.

    Create a proposed policy based on the active policy

    1. If a proposed ILM policy currently exists, select that policy, and click Remove.

      You cannot clone the active policy if a proposed policy already exists.

    2. Select the active policy from the table.

    3. Click Clone.

    Edit the existing proposed policy

    1. Select the proposed policy from the table.

    2. Click Edit.

    The Configure ILM Policy dialog box appears.

    If you are creating a new proposed policy, all fields are blank and no rules are selected.

    ILM Policies Configure ILM Policy

    If you are cloning the active policy, the Name field shows the name of the active policy, appended by a version number (“v2” in the example). The rules used in the active policy are selected and shown in their current order.

    ILM Policies Version
  3. Enter a unique name for the proposed policy in the Name field.

    You must enter at least 1 and no more than 64 characters. If you are cloning the active policy, you can use the current name with the appended version number or you can enter a new name.

  4. Enter the reason you are creating a new proposed policy in the Reason for change field.

    You must enter at least 1 and no more than 128 characters.

  5. To add rules to the policy, select Select Rules.

    The Select Rules for Policy dialog box appears, with all defined rules listed. If you are cloning a policy:

    • The rules used by the policy you are cloning are selected.

    • If the policy you are cloning used any rules with no filters that were not the default rule, you are prompted to remove all but one of those rules.

    • If the default rule used a filter, you are prompted to select a new default rule.

    • If the default rule was not the last rule, a button allows you to move the rule to the end of the new policy. ILM Policies Select Rules for Policy

  6. Select a rule name or the more details icon more details icon to view the settings for that rule.

    This example shows the details of an ILM rule that makes two replicated copies at two sites.

    ILM Rule Summary Page
  7. In the Select Default Rule section, select one default rule for the proposed policy.

    The default rule applies to any objects that do not match another rule in the policy. The default rule cannot use any filter and is always evaluated last.

    Note

    If no rule is listed in the Select Default Rule section, you must exit the ILM policy page and create a default rule.

    Important Do not use the Make 2 Copies stock rule as the default rule for a policy. The Make 2 Copies rule uses a single storage pool, All Storage Nodes, which contains all sites. If your StorageGRID system has more than one site, two copies of an object might be placed on the same site.
  8. In the Select Other Rules section, select any other rules you want to include in the policy.

    The other rules are evaluated before the default rule and must use at least one filter (tenant account, bucket name, or an advanced filter, such as object size).

  9. When you are done selecting rules, select Apply.

    The rules you selected are listed. The default rule is at the end, with the other rules above it.

    ILM Policies Selected Rules
    Note

    A warning appears if the default rule does not retain objects forever. When you activate this policy, you must confirm that you want StorageGRID to delete objects when the placement instructions for the default rule elapse (unless a bucket lifecycle keeps the objects for longer).

    ILM Policy Default Rule Not Forever
  10. Drag and drop the rows for the non-default rules to determine the order in which these rules will be evaluated.

    You cannot move the default rule.

    Important You must confirm that the ILM rules are in the correct order. When the policy is activated, new and existing objects are evaluated by the rules in the order listed, starting at the top.
  11. As required, click the delete icon delete icon to delete any rules that you do not want in the policy, or select Select Rules to add more rules.

  12. When you are done, select Save.

    The ILM Policies page is updated:

    • The policy you saved is shown as Proposed. Proposed policies do not have start and end dates.

    • The Simulate and Activate buttons are enabled. ILM Policy Proposed Policy Saved

  13. Go to Simulating an ILM policy.

Related information

What an ILM policy is