[LUDOC-462] Add feature documentation for directory restripe Created: 23/Jan/20  Updated: 02/Feb/21  Resolved: 25/Dec/20

Status: Resolved
Project: Lustre Documentation
Component/s: None
Affects Version/s: None
Fix Version/s: Lustre 2.14.0 Manual

Type: Improvement Priority: Blocker
Reporter: Joseph Gmitter (Inactive) Assignee: Lai Siyao
Resolution: Fixed Votes: 0
Labels: None

Issue Links:
Related
is related to LU-11025 DNE3: directory restripe Resolved
Rank (Obsolete): 9223372036854775807

 Description   

Add feature documentation for directory restripe added in LU-11025.



 Comments   
Comment by Andreas Dilger [ 28/May/20 ]

Functionality

The Directory Auto-Restriping feature will have the following functionality

  • When the number of sub files under a directory is more than 50k, it will trigger directory split, i.e. it will become a striped directory with two stripes, and "lfs getdirstripe <dir>" will show it’s in ‘splitting’ status. Then, nearly half of its sub files will be migrated to newly allocated stripe according to their name hash. Later when "lfs getdirstripe <dir>" doesn’t show ‘splitting’, it means sub-files have finished migration. This also applies on striped directory: when the number of sub files under one stripe is more than 50k, this striped directory will be split automatically, the target stripe count will be doubled, but if there aren’t enough MDTs, the target stripe count will be MDT count.
  • Directory auto-restripe is done on server, and doesn’t involve client, though it’s triggered by a readdir from client.
  • During directory auto-restripe, if some MDS is rebooted, sub file migrations will fail and report error messages, but when MDS gets back, sub file migrations will resume, and auto-restripe will finish.
  • Generally Directory auto-restriping is opaque to client, that is, most operations on/under this directory will run like on/under a normal directory, and NFS re-export is supported. In theory, it should be complete opaque, but there may be some corner cases, and will be addressed later.

Test Plan

  • Basic functionality test: plain directory auto-restripe; striped directory auto-restripe.
  • Directory auto-restripe with concurrent create and unlink.
  • Enable directory auto-restripe in racer.sh, but I’m afraid racer.sh is not stable.
  • Access NFS re-export during directory auto-restripe.
  • Performance test: evaluate system performance drop during directory auto-restripe.
Comment by Gerrit Updater [ 21/Dec/20 ]

Lai Siyao (lai.siyao@whamcloud.com) uploaded a new patch: https://review.whamcloud.com/41060
Subject: LUDOC-462 mdt: doc for directory restripe and auto-split
Project: doc/manual
Branch: master
Current Patch Set: 1
Commit: 6911d66fdc7da5dc79100989ba1bc3fd983bd5eb

Comment by Gerrit Updater [ 25/Dec/20 ]

Andreas Dilger (adilger@whamcloud.com) merged in patch https://review.whamcloud.com/41060/
Subject: LUDOC-462 mdt: doc for directory restripe and auto-split
Project: doc/manual
Branch: master
Current Patch Set:
Commit: 44b5721f899123b91de4ce795b218b1589130893

Generated at Sat Feb 10 03:43:08 UTC 2024 using Jira 9.4.14#940014-sha1:734e6822bbf0d45eff9af51f82432957f73aa32c.