Updating a File System's Tiering Policy

Update a Lustre file system's tiering configuration to enable or disable file system tiering, and select the tiering policy.

See also File System Tiering with Object Storage.

    1. On the Lustre file systems list page, select the file system that you want to work with. If you need help finding the list page, see Listing File Systems.
    2. On the file system's details page, select the Tiering tab.
    3. In the Policy rules section, use the filters to search for existing rules in the tiering policy:
      • Path prefix: Return all rules that match the specified path prefix. Use this filter to inspect all similar, matching rules.
      • Find matching rule: Return the rule that matches the specified path prefix most closely. Use this filter to find the exact rule that will be applied to the specified file path when tiering happens.
    4. In the Tiering section, select Update tiering policy.
    5. Use the Enable tiering switch to enable or disable file system tiering.

      Before disabling tiering, be aware of any continuing storage charges. See Disabling Tiering.

    6. Select Default policy or Custom policy. See File System Tiering Policies.
      • If you select Default policy, the Policy rules table is read-only and its rule applies to all files greater than 1 MB in the file system.
      • If you select Custom policy, select Add rules to enter rules manually or import a rules file.
        • A custom policy must contain at least one rule.
        • Each file system supports up to 50 custom rules and 100 unique path prefixes across the entire custom policy.
        • Each rule must contain at least one path prefix.
    7. To edit an existing rule in a custom policy, identify the rule to change and select Edit from the row's Actions menu (three dots).
    8. You can also delete one or more rules from the Policy rules table:
      • Delete one rule: Select Delete from the row's Actions menu (three dots).
      • Delete multiple rules: Select the rules you want to delete, and then select Delete from the Actions menu above the table.
      Note

      You can delete all the rules in the Policy rules table, but a custom policy must have at least one rule. If you think you need to delete all the rules in a tiering policy, consider these other options:
      • Retain at least one rule.
      • Switch to the default policy.
      • Disable tiering.
      • Start a new custom policy.
    9. To export all the tiering rules, select the rules you want to export, and then select Export rules from the Actions menu above the table.
    10. Select Update.

    The policy update runs asynchronously. If tiering is disabled, policy changes don't take effect until it's enabled again.

  • Use the oci lfs lustre-file-system update command and required parameters to update a file system's tiering policy:

    oci lfs lustre-file-system update --lustre-file-system-id <file_system_OCID> [OPTIONS]

    For a complete list of parameters and values for CLI commands, see the CLI Command Reference.

  • Run the UpdateLustreFileSystem operation with required attributes to update a file system's tiering policy.

    To enable file system tiering, update the file system's tieringConfiguration attribute to isEnabled. Select policyMode as DEFAULT or CUSTOM. Custom mode requires validated rules.

    Updates are asynchronous and return 202 Accepted with opc-work-request-id.

    For information about using the API and signing requests, see REST API documentation and Security Credentials. For information about SDKs, see SDKs and the CLI.