Managing legacy ILM rules

ILM rules that were created using StorageGRID Webscale 10.2 or earlier were deprecated in StorageGRID Webscale 10.4 and are not supported in StorageGRID Webscale 11.1. If your StorageGRID Webscale system still includes these legacy ILM rules, you must recreate any that you still want to use. Then, you must delete all legacy rules before upgrading to version 11.1.

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.
  • 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).

Before upgrading to StorageGRID Webscale 11.1, follow these steps to recreate and 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 instructions for administering StorageGRID Webscale.
    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.
    See instructions for administering StorageGRID Webscale.
    1. Clone the active policy.
    2. Select the new ILM rules and unselect the original legacy rules.
    3. Save the proposed policy.
    4. Simulate the proposed policy using ingested objects that are appropriate for testing the new ILM rules.
    5. Activate the proposed policy.
  4. As required, recreate any unused legacy rules, and then delete the legacy rules.
    You cannot delete active ILM rules or ILM rules currently selected for the proposed ILM policy.