1 .TH lctl-snapshot-create 8 "2017 Apr 13" Lustre "create Lustre snapshot"
4 .B lctl snapshot_create \fR[-b | --barrier [on | off]] [-c | --comment comment]
5 {-F | --fsname fsname} [-h | --help] {-n | --name ssname}
6 [-r | --rsh remote_shell] [-t | --timeout timeout]
9 Create snapshot with the given name. The tool loads system configuration from
15 section. Then, the snapshot pieces are created on every Lustre target
19 .BR -b ", " --barrier " [" on | off ]
20 Set write barrier on all MDTs before creating the snapshot. The default value is
22 If you are confident about the system consistency, or not require the full
23 consistency and want to avoid blocking applications when creating the snapshot,
24 then you can specify barrier
26 That will save your time of creating the snapshot. If the barrier is
28 then the timeout of the barrier can be specified via
30 option as described in the subsequent section.
32 .BR -c ", " --comment " "\fIcomment
33 Add an optional comment to the
35 request. The comment can include anything to describe what the snapshot is for
36 or for a reminder. The comment can be shown via
39 .BR -F ", " --fsname " "\fIfsname
45 .BR -n ", " --name " "\fIssname
46 The snapshot's name must be specified. It follows the general ZFS snapshot name
47 rules, such as the max length is 256 bytes, cannot conflict with the reserved
50 .BR -r ", " --rsh " "\fIremote_shell
51 Specify a shell to communicate with remote targets. The default value is
53 It is the system admin's duty to guarantee that the specified
55 works well among targets without password authentication.
57 .BR -t ", " --timeout " "\fItimeout
62 specifies the write barrier's lifetime in second. The default vaule is 30.
65 .B lctl-snapshot-create
73 .BR lctl-snapshot-destroy (8),
74 .BR lctl-snapshot-modify (8),
75 .BR lctl-snapshot-list (8),
76 .BR lctl-snapshot-mount (8),
77 .BR lctl-snapshot-umount (8)