Skip to main content

Create a default ILM rule

Contributors netapp-lhalbert
PDFs

Before creating an ILM policy, you must create a default rule to place any objects not matched by another rule in the policy. The default rule can't use any filters. It must apply to all tenants, all buckets, and all object versions.

Before you begin
About this task

The default rule is the last rule to be evaluated in an ILM policy, so it can't use any filters. The placement instructions for the default rule are applied to any objects that aren't matched by another rule in the policy.

In this example policy, the first rule applies only to objects belonging to test-tenant-1. The default rule, which is last, applies to objects belonging to all other tenant accounts.

ILM Policies Page Default Rule

When you create the default rule, keep these requirements in mind:

  • The default rule will automatically be placed as the last rule when you add it to a policy.

  • The default rule can't use any basic or advanced filters.

  • The default rule must apply to all object versions.

  • The default rule should create replicated copies.

    Note Don't use a rule that creates erasure-coded copies as the default rule for a policy. Erasure-coding rules should use an advanced filter to prevent smaller objects from being erasure-coded.

  • In general, the default rule should retain objects forever.

  • If you are using (or you plan to enable) the global S3 Object Lock setting, the default rule must be compliant.

Steps

  1. Select ILM > Rules.

  2. Select Create.

    Step 1 (Enter details) of the Create ILM rule wizard appears.

  3. Enter a unique name for the rule in the Rule name field.

  4. Optionally, enter a short description for the rule in the Description field.

  5. Leave the Tenant accounts field blank.

    The default rule must apply to all tenant accounts.

  6. Leave the Bucket name drop-down selection as applies to all buckets.

    The default rule must apply to all S3 buckets.

  7. Keep the default answer, No, for the question, "Apply this rule to older object versions only (in S3 buckets with versioning enabled)?"

  8. Don't add advanced filters.

    The default rule can't specify any filters.

  9. Select Next.

    Step 2 (Define placements) appears.

  10. For Reference time, select any option.

    If you kept the default answer, No, for the question, "Apply this rule to older object versions only?" Noncurrent time will not be included in the pull-down list. The default rule must apply all object versions.

  11. Specify the placement instructions for the default rule.

    • The default rule should retain objects forever. A warning appears when you activate a new policy if the default rule does not retain objects forever. You must confirm this is the behavior you expect.

    • The default rule should create replicated copies.

      Note Don't use a rule that creates erasure-coded copies as the default rule for a policy. Erasure-coding rules should include the Object size (MB) greater than 200 KB advanced filter to prevent smaller objects from being erasure-coded.

    • If you are using (or you plan to enable) the global S3 Object Lock setting, the default rule must be compliant:

      • It must create at least two replicated object copies or one erasure-coded copy.

      • These copies must exist on Storage Nodes for the entire duration of each line in the placement instructions.

      • Object copies can't be saved in a Cloud Storage Pool.

      • At least one line of the placement instructions must start at day 0, using Ingest time as the reference time.

      • At least one line of the placement instructions must be "forever."

  12. Look at the Retention diagram to confirm your placement instructions.

  13. Select Continue.

    Step 3 (Select ingest behavior) appears.

  14. Select the ingest option to use, and select Create.