From: Lai Siyao Date: Mon, 2 Aug 2021 11:55:12 +0000 (-0400) Subject: LU-14903 doc: update lfs-setdirstripe man page X-Git-Tag: 2.14.54~2 X-Git-Url: https://git.whamcloud.com/?p=fs%2Flustre-release.git;a=commitdiff_plain;h=a205334da5fcb150ba42505f735c26206321af9b LU-14903 doc: update lfs-setdirstripe man page Update lfs-setdirstripe man page to reflect the change of filesystem-wide default directory layout. Test-parameters: trivial Signed-off-by: Lai Siyao Change-Id: I1e7818679e057add4747565a2fc850e1857cd7b0 Reviewed-on: https://review.whamcloud.com/44481 Tested-by: jenkins Tested-by: Maloo Reviewed-by: Andreas Dilger Reviewed-by: Jian Yu --- diff --git a/lustre/doc/lfs-setdirstripe.1 b/lustre/doc/lfs-setdirstripe.1 index 4fff19e..c1be84f 100644 --- a/lustre/doc/lfs-setdirstripe.1 +++ b/lustre/doc/lfs-setdirstripe.1 @@ -174,18 +174,19 @@ to allow any user/group to create remote directories. By default, it is .B "0" to limit remote/striped directories to only the root user. -The root directory of the file system is on MDT0000, and directories and -files inherit the MDT of their parent directory unless a different MDT is -specified with this command. +The root directory of the file system is on MDT0000, and a filesystem-wide +default directory layout is set on it by default: +.B lfs setdirstripe -D -i -1 -c 1 --max-inherit -1 --max-inherit-rr 3 +, which is a space balanced directory layout, therefore new directories will be +created on all MDTs by inode and space usage, and the top three level of new +directories will be created in roundrobin mode if system is balanced. If user +doesn't want automatic space balance, deleting this default directory layout +won't work, because it will be recreated if not set, instead user can run +.B lfs setdirstripe -D -i -1 -c 1 --max-inherit 1 +to limit space balance in the top level, or run +.B lfs setdirstripe -D -i 0 -c 1 --max-inherit 1 +to disable it. -By default, only directories on MDT0000 can contain directories that are not on -the same MDT. However, if -.B "mdt.*.enable_remote_dir" -is set non-zero on an MDT (the default) -then it will allow creating remote directories that have parents other than -MDT0000. This is restricted to avoid creating directory trees that have -intermediate path components on a series different MDTs and become unavailable -if any of the intermediate MDTs are offline. .SH EXAMPLES .TP .B $ lfs setdirstripe -c 2 -i 1 -H all_char /mnt/lustre/dir1