1 .TH LFS-SETDIRSTRIPE 1 2017-11-07 "Lustre" "Lustre Utilities"
3 lfs setdirstripe, mkdir \- set striping pattern of a directory.
5 .B lfs setdirstripe [\fR-cdDHioT\fR] \fIDIR\fR...
8 Create a striped directory with specified striping pattern. This lfs utility
11 , but is used to create striped directory.
13 is an alias for this command.
16 .BR \-c ", " \-T ", " \-\-mdt\-count =\fICOUNT\fR
17 Stripe the new directory over
21 .BR \-i ", " \-\-mdt\-index =\fISTART_MDT_INDEX\fR
22 Use the MDT whose index is
24 as the master/starting MDT for the directory. If -1 (default) is set, it will randomly pick
28 .BR \-H ", " \-\-mdt-hash =\fIHASH_TYPE\fR
31 for the striped directory.
35 Fowler-Noll-Vo (FNV-1a) hash algorithm. This provides
36 reasonably uniform, but not cryptographically strong,
37 hashing of the filename. (default)
40 Sum of ASCII characters modulo number of MDTs. This
41 provides weak hashing of the filename, and is suitable
42 for only testing or when the input is known to have
43 perfectly uniform distribution (e.g. sequential numbers).
46 .BR \-d ", " \-\-delete
47 Delete the default striping layout from the directory. New subdirectories
48 created in this directory will inherit the global default directory layout
49 (by default they will not be striped).
51 .BR \-D ", " \-\-default
52 Set the default striping pattern of subdirectories. Newly created
53 sub-directories will use the new default striping pattern,
54 but existing sub-directories will not be affected. The newly
55 created sub-directories will also inherit the specified default
56 striping pattern. Only default stripe count is supported for now.
58 Note that striping all directories across all MDTs by default is not
59 recommended at this time, as the clients will have to do more RPCs to
60 create and access each directory, hurting performance rather than
61 improving it. Default striped directories are preferred for cases
62 where large subdirectories will be created (e.g. file-per-process
63 job output directories).
65 .BR \-o ", " \-\-mode =\fIMODE\fR
66 Set the file access permissions of the new directory to the specified
69 (typically octal), as with
71 It is not affected by the current
77 command is only executable by root unless
78 .B "mdt.*.enable_remote_dir_gid"
81 to be either a non-zero GID to limit it to a single group
82 (e.g. "operator" or "admin"), or "-1" to allow any group
83 to create remote directories.
85 The root of the file system is on MDT0000, and directories and files inherit the
86 MDT of their parent directory unless a different MDT is specified with this
89 By default, only directories on MDT0000 can contain directories that are not on
90 the same MDT. However, if "mdt.*.enable_remote_dir" is set non-zero on an MDT
91 then it will allow creating remote directories that have parents other than
92 MDT0000. This is restricted to avoid creating directory trees that have
93 intermediate path components on a series different MDTs and become unavailable
94 if any of the intermediate MDTs are offline.
97 .B $ lfs setdirstripe -c 2 -i 1 -H all_char /mnt/lustre/dir1
98 This creates a directory striped on two MDTs, whose first stripe is on
100 (MDT index 1), and whose hash type is
105 command is part of the Lustre filesystem.
109 .BR lfs-getdirstripe (1),
110 .BR lfs-setstripe (1),