LFS-HSM(1)

NAME
hsm_state, hsm_action, hsm_set, hsm_clear - lfs commands used to interact with HSM features

SYNOPSIS
lfs hsm_state [FILE]...

lfs hsm_action [FILE]...

lfs hsm_set [--norelease] [--noarchive] [--exists] [--archived] [--lost] [--archive-id NUM] [FILE]...

lfs hsm_clear [--norelease] [--noarchive] [--exists] [--archived] [--lost] [FILE]...

DESCRIPTION
These are a set of lfs commands used to interact with Lustre/HSM binding feature.

lfs hsm_state [FILE]...
    Display the current HSM flags and archive ID for provided files.

lfs hsm_action [FILE]...
    Display the in-progress HSM actions for provided files.

lfs hsm_set [OPTION]... [FILE]...
    Set provided HSM flags on file list.

lfs hsm_clear [OPTION]... [FILE]...
    Clear the HSM related flags on file list.

Non-privileged user can only change the following flags: norelease , noarchive and dirty.

OPTIONS

\--norelease
    File should never be released. File data will stay in Lustre even if a copy exists in HSM backend.

\--noarchive
    File should never be archived. Useful if this is a temporary file, for example.

\--dirty
    File content is not in sync with HSM backend. File should be archived again. (root only)

\--exists
    A file copy exists in HSM backend. Useful mostly for debugging. (root only)

\--archived
    An up-to-date file copy exists in HSM backend. Useful mostly for debugging. (root only)

\--lost
    File copy in HSM backend is not usable anymore and file could not be restored. It should be archived again. (root only)

\--archive-id NUM
    Set archive number identifier to value NUM. If archive-id is 0 or option is not provided, then default identifier 0 is used and means no identifier change.

EXAMPLES

Display current HSM flag for foo:
    $ lfs hsm_state /mnt/lustre/foo /mnt/lustre/foo: (0x0000000b) exists dirty archived, archive_id: 1

Force a file to be considered as modified in lustre (dirty)
    $ lfs hsm_set --dirty /mnt/lustre/motd

AUTHOR
Written by Aurelien Degremont.

KNOWN BUGS

Please report all bugs to https://jira.whamcloud.com/

SEE ALSO
lfs(1)