WARNING: This is the _old_ Lustre wiki, and it is in the process of being retired. The information found here is all likely to be out of date. Please search the new wiki for more up to date information.

Architecture - Space Manager

From Obsolete Lustre Wiki
Jump to navigationJump to search

Note: The content on this page reflects the state of design of a Lustre feature at a particular point in time and may contain outdated information.


This page describes uses cases for HSM space manager


space manager
Lustre component which manages the filesystem free space: punching filesystem objects and moving them to the archiving system using migration policy. It is responsible for checking the OST, OST pool and file system usage.
Action on a file to free allocated data without changing file attributes (size, mtime, ...). This action keeps first and last file blocks on disks.
Process or event in the file system which causes some purges.
migration policy
Rules describing the filters used to select migration candidates. They could be based on access time or object size by example.
Entity responsible for fastly building a candidate file list using policies that will be used for migration and purge.
High watermark and low watermark are 2 space usage values. When the high watermark is reached, a purge event is raised to free enough objects until the space usage does not exceed the low watermark. Watermarks could be defined for OST, OST pool or filesystem.

Uses Cases

id quality attribute summary
pre-migration performance The space manager is responsible for copying-out candidate files to the HSM when possible (see HSM Migration).
purge availability The space manager is requested to purge candidate files when a policy limit is reached.



Scenario: The space manager copies out candidate objects to the archiving system to be able to quickly purge them when needed.
Business Goals: File system disponibility.
Relevant QA's: Performance.
details Stimulus: Periodic event.
Stimulus source: N/A.
Environment: Lustre filesystem objects.
Artifact: Candidate objects to be copied out.
Response: Periodically, the space manager asks for a candidate list and requests the coordinator for migration of those objects. At the end, those objects are tagged being up-to-date in the HSM and ready to be punched if needed.
Response measure: Volume of candidate objects ready to be purged increased.
Questions: None.
Issues: None.


Scenario: A policy limit is reached and the space manager purges enough objects provided by the scanner to satisfy the policy rules.
Business Goals: Virtually extends the file system capacity using an archiving system.
Relevant QA's: Availability.
details Stimulus: A trigger is raised.
Stimulus source: Space manager or administrator request.
Environment: Lustre file system objects.
Artifact: Purge candidate objects.
Response: When a policy limit is reached inside the filesystem, the space manager is used to punch as many objects as needed to fall short of the limit.
Response measure: Objects have been purged.
Questions: None.
Issues: None.



  1. Periodically, the space manager asks the scanner for candidate objects matching the policy.
  2. For each candidate, it requests the coordinator to copy out this object (See corresponding scenarios).
  3. When the migration is finished or aborted, the space manager is warned.
  4. If the migration successed, the file is tagged being up-to-date in the archiving system.


  1. The space manager receives a purge trigger.
  2. It uses the scanner to build a candidate list to purge.
  3. It purges as much as needed file system objects, depending on policy, to fall short of the limit. Depending on the object type, the purge requests are sent to MDT or OST.
  4. The purge is finished when the requested threshold is reached

Implementation Constraints

  • A filesystem object can be purged only if an up-to-date copy is available on another storage (another OST pools or an external storage).
  • As space over high-watermark is wasted, the HW must be very high, so purge action must be very fast to avoid reaching file system getting full.

Space management interactions

Space management schema