lfs-hsm(1)

NAME

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

SYNOPSIS

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

--help

Print usage message.

--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

AUTHORS

Written by Aurelien Degremont.

AVAILABILITY

lfs hsm_action, lfs hsm_clear, lfs hsm_set and lfs hsm_state are part of the lustre(7) filesystem package. lfs hsm_action was added in release 1.7.0. lfs hsm_clear was added in release 2.4.0. lfs hsm_set and lfs hsm_state were added in release 2.0.0.

SEE ALSO

lfs(1)