1 .TH LFS-HSM 1 "April 20, 2022" Lustre "Lustre/HSM binding utility"
3 hsm_state, hsm_action, hsm_set, hsm_clear \- lfs commands used to interact with HSM features
17 [\fB\-\-archive-id\fR \fINUM\fR]
29 These are a set of lfs commands used to interact with Lustre/HSM binding feature.
31 .B lfs hsm_state \fR[\fI\,FILE\/\fR]...
32 Display the current HSM flags and archive ID for provided files.
34 .B lfs hsm_action \fR[\fI\,FILE\/\fR]...
35 Display the in-progress HSM actions for provided files.
37 .B lfs hsm_set \fR[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR]...
38 Set provided HSM flags on file list.
40 .B lfs hsm_clear \fR[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR]...
41 Clear the HSM related flags on file list.
43 Non-privileged user can only change the following flags:
53 File should never be released. File data will stay in Lustre even if a copy exists in HSM backend.
56 File should never be archived. Useful if this is a temporary file, for example.
59 File content is not in sync with HSM backend. File should be archived again. (root only)
62 A file copy exists in HSM backend. Useful mostly for debugging. (root only)
65 An up-to-date file copy exists in HSM backend. Useful mostly for debugging. (root only)
68 File copy in HSM backend is not usable anymore and file could not be restored. It should be archived again. (root only)
70 .B \\--archive-id \fINUM\fR
71 Set archive number identifier to value \fINUM\fR. If archive-id is 0 or option is not provided, then default identifier 0 is used and means no identifier change.
74 .B Display current HSM flag for foo:
75 $ lfs hsm_state /mnt/lustre/foo
77 /mnt/lustre/foo: (0x0000000b) exists dirty archived, archive_id: 1
80 .B Force a file to be considered as modified in lustre (dirty)
81 $ lfs hsm_set --dirty /mnt/lustre/motd
84 Written by Aurelien Degremont.
88 Please report all bugs to https://jira.whamcloud.com/