LCTL-SNAPSHOT_CREATE(8)

NAME
lctl-snapshot_create - create Lustre snapshot

SYNOPSIS
lctl snapshot_create [-b|--barrier [on|off]] [-c|--comment COMMENT] {-F|--fsname FSNAME} [-h|--help] {-n|--name SSNAME} [-r|--rsh REMOTE_SHELL] [-t|--timeout TIMEOUT]

DESCRIPTION
Create snapshot with the given name. The tool loads system configuration from the file /etc/ldev.conf as described in the lctl(8) SNAPSHOT section. Then, the snapshot pieces are created on every Lustre target (MGT/MDT/OST).

OPTIONS

-b, --barrier [on|off]
    Set write barrier on all MDTs before creating the snapshot. The default value is on. If you are confident about the system consistency, or not require the full consistency and want to avoid blocking applications when creating the snapshot, then you can specify barrier off. That will save time when creating the snapshot. If the barrier is on, then the timeout of the barrier can be specified via -t option as described in the subsequent section.

-c, --comment COMMENT
    Add an optional comment to the snapshot_create request. The comment can include anything to describe what the snapshot is for or for a reminder. The comment can be shown via snapshot_list.

-F, --fsname FSNAME
    The filesystem name.

-h, --help
    For help information.

-n, --name SSNAME
    The snapshot's name must be specified. It follows the general ZFS snapshot name rules, such as the max length is 256 bytes, cannot conflict with the reserved names, and so on.

-r, --rsh REMOTE_SHELL
    Specify a shell to communicate with remote targets. The default value is ssh. It is the system admin's duty to guarantee that the specified REMOTE_SHELL works well among targets without password authentication.

-t, --timeout TIMEOUT
    If write barrier is on, then the TIMEOUT specifies the write barrier's lifetime in second. The default value is 30.

AVAILABILITY
lctl-snapshot-create is part of the lustre(7) filesystem package since release 2.10.0

SEE ALSO
lctl(8), lctl-barrier(8), lctl-lcfg(8), lctl-snapshot-destroy(8), lctl-snapshot-list(8), lctl-snapshot-modify(8), lctl-snapshot-mount(8), lctl-snapshot-umount(8)