1 .TH lfs-hsm 1 "November 20, 2017" Lustre "Lustre/HSM binding utility"
4 lfs commands used to interact with HSM features
12 .B lfs hsm_set|hsm_clear
23 These are a set of lfs commands used to interact with Lustre/HSM binding feature.
25 .B lfs hsm_state <FILE> ...
26 Display the current HSM flags and archive ID for provided files.
28 .B lfs hsm_set <FILE>...
29 Set provided HSM flags on file list.
31 .B lfs hsm_clear <FILE>...
32 Clear the HSM related flags on file list.
34 .B lfs hsm_action <FILE>...
35 Display the in-progress HSM actions for provided files.
37 Non-privileged user can only change the following flags:
47 File should never be released. File data will stay in Lustre even if a copy exists in HSM backend.
50 File should never be archived. Useful if this is a temporary file, for example.
53 File content is not in sync with HSM backend. File should be archived again. (root only)
56 A file copy exists in HSM backend. Useful mostly for debugging. (root only)
59 An up-to-date file copy exists in HSM backend. Useful mostly for debugging. (root only)
62 File copy in HSM backend is not usable anymore and file could not be restored. It should be archived again. (root only)
65 Set archive number identifier in hsm_set command. If archive-id is 0 or option is not provided, then default identifier 0 is used and means no identifier change.
68 .B Display current HSM flag for foo:
69 $ lfs hsm_state /mnt/lustre/foo
71 /mnt/lustre/foo: (0x0000000b) exists dirty archived, archive_id: 1
74 .B Force a file to be considered as modified in lustre (dirty)
75 $ lfs hsm_set --dirty /mnt/lustre/motd
78 Written by Aurelien Degremont.
82 Please report all bugs to https://jira.whamcloud.com/