Managing legacy ILM rules

ILM rules that were created using StorageGRID Webscale 10.2 or earlier were deprecated in StorageGRID Webscale 10.4. If your StorageGRID Webscale system still includes these legacy ILM rules, you must understand how to manage them after the upgrade to version 11.0.

Before you begin

About this task

The following conditions apply to legacy ILM rules (rules created before version 10.3):
  • When a legacy rule is displayed, a warning icon warning icon indicates that it is a legacy rule.
  • You can continue to use a legacy rule in the active policy, but you cannot edit the rule.
  • You can add a legacy rule to a new policy as long as that rule already exists in the active policy.
  • You cannot add a legacy rule to a new policy unless that rule is already part of the active policy. This is true even if the legacy rule is part of a historical policy.
  • If you remove a legacy rule from a policy and then activate that policy, you cannot subsequently add the legacy rule to that policy.
  • The Grid Management Interface displays version numbers for legacy rules.
    Note: Rules created in version 10.3 or later all have version 1.0 internally, and the version is not shown.
  • A policy might contain different versions of a legacy ILM rule (for example, a policy might include both v1.0 and v1.1 of Rule A).

After upgrading to StorageGRID Webscale 11.0, follow these steps to recreate or delete any legacy rules.


  1. Determine which legacy ILM rules are currently in use, and note all settings for those ILM rules.
  2. Use the Create New ILM Rules wizard to create new ILM rules with equivalent settings.
    See the "Configuring ILM rules" section of the Administrator Guide for instructions.
    Note: You might need to replace a single legacy rule with multiple new rules. When ILM rules changed in version 10.3, certain rule features also changed. For example, you can no longer have multiple APIs in one ILM rule.
  3. If the legacy rules are being used in the active policy, create a new proposed ILM policy.
    1. Clone the active policy.
    2. Select the new ILM rules and unselect the original legacy rules.
    3. Save the proposed policy.
    4. Follow the instructions in the Administrator Guide to simulate the proposed policy using ingested objects that are appropriate for testing the new ILM rules.
    5. Activate the proposed policy.
  4. Recreate or delete any unused legacy rules.
    You cannot delete active ILM rules or ILM rules currently selected for the proposed ILM policy.