Skip to content

Commit d1c6107

Browse files
authored
Add text that lustre striping settings are only applied to files copied after the command is run. (#218)
1 parent 0dc28dc commit d1c6107

File tree

1 file changed

+6
-2
lines changed

1 file changed

+6
-2
lines changed

docs/guides/storage.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -111,7 +111,7 @@ To set up a default so all newly created folders and dirs inside or your desired
111111
```
112112

113113
!!! info
114-
For more information read the `setfacl` man page: `man setfacl`.
114+
For more information read the `setfacl` man page: [`man setfacl`](https://linux.die.net/man/1/setfacl).
115115

116116
[](){#ref-guides-storage-lustre}
117117
## Lustre tuning
@@ -127,14 +127,18 @@ The data itself is subdivided in blocks of size `<blocksize>` and is stored by O
127127
The block size and number of OSTs to use is defined by the striping settings, which are applied to a path, with new files and directories inheriting them from their parent directory.
128128
The `lfs getstripe <path>` command can be used to get information on the stripe settings of a path.
129129
For directories and empty files `lfs setstripe --stripe-count <count> --stripe-size <size> <directory/file>` can be used to set the layout.
130-
The simplest way to have the correct layout is to copy to a directory with the correct layout
130+
131+
Striping settings on a directory are only applied to files added after the command is run.
132+
Existing files retain their original layout unless explicitly changed using `lfs migrate <striping settings>`, which takes the same arguments as `lfs setstripe`.
133+
The simplest way to have the correct layout is to copy to a directory with the correct layout.
131134

132135
!!! tip "A block size of 4MB gives good throughput, without being overly big..."
133136
... so it is a good choice when reading a file sequentially or in large chunks, but if one reads shorter chunks in random order it might be better to reduce the size, the performance will be smaller, but the performance of your application might actually increase.
134137
See the [Lustre documentation](https://doc.lustre.org/lustre_manual.xhtml#managingstripingfreespace) for more information.
135138

136139

137140
!!! example "Settings for large files"
141+
*Remember:* Settings only apply to files added to the directory after this command.
138142
```console
139143
lfs setstripe --stripe-count -1 --stripe-size 4M <big_files_dir>`
140144
```

0 commit comments

Comments
 (0)