1 .TH lustre_rsync 8 "2009 Apr 08" Lustre "Lustre Filesystem replication utility"
3 lustre_rsync \- Utility to replicate a Lustre Filesystem
6 .B lustre_rsync --source|-s <src> --target|-t <tgt>
8 .B\t\t\t --mdt|-m <mdt> [--user|-u <user id>]
10 .B\t\t\t [--xattr|-x <yes|no>] [--verbose|-v]
12 .B\t\t\t [--statuslog|-l <log>] [--dry-run] [--abort-on-err]
16 .B lustre_rsync --statuslog|-l <log>
20 .B lustre_rsync --statuslog|-l <log> --source|-s <source>
23 .B\t\t\t --target|-t <tgt> --mdt|-m <mdt>
26 is designed to replicate a Lustre filesystem (source filesystem) to
27 another target filesystem (any filesystem type) efficiently by
28 using Lustre MDT changelogs. A changelog user must be registered
29 (see lctl (8) changelog_register) before using this tool.
31 The source and the target filesystems must be identical before
32 the changelog user is registered. If the filesystems are discrepant,
33 a utility like rsync may be used to make them identical.
38 The path to the root of the Lustre filesytem which will be replicated.
39 Mandatory if a valid statuslog created during an previous replication operation
40 (--statuslog) is not specified.
44 The path to the root where the filesystem we be replicated. Mandatory
45 if a valid statuslog created during an previous replication operation
46 (--statuslog) is not specified. This option can be repeated if
47 multiple replication targets are desired.
51 The metadata device which is to be replicated. A changelog user must be
52 registered for this device. Mandatory if a valid statuslog created
53 during an previous replication operation (--statuslog) is not
58 The changelog user id for the above MDT device. See lctl(8) changelog_register.
59 Mandatory if a valid statuslog created during an previous replication operation
60 (--statuslog) is not specified.
64 A status log file to which the status of replication is saved.
65 When lustre_rsync is started, the state from a previous replication
66 will be read from here.
68 If a statuslog from a previous replication operation is specified, the
69 otherwise mandatory options like --source, --target and --mdt may be
72 By specifying the options like --source, --target and --mdt in
73 addition to the --statuslog option, the parameters in the statuslog
74 can be overridden. The command line options take precedence over the
75 ones from the statuslog.
79 Specify whether extended attributes are replicated or not. The default
80 is to replicate extended attributes. Disabling xattrs will mean that
81 Lustre striping information will not be replicated.
85 Produce a verbose output.
89 Shows what the program would do without actually replicating data.
93 Stop processing upon first error. Default is to continue processing.
98 Register a changelog consumer for MDT lustre-MDT0000
99 $ ssh $MDS lctl changelog_register \\
101 --device lustre-MDT0000 -n
106 Replicate the lustre filesystem /mnt/lustre to /mnt/target.
107 $ lustre_rsync --source=/mnt/lustre --target=/mnt/target \\
109 --mdt=lustre-MDT0000 --user=cl1 \\
111 --statuslog replicate.log --verbose
113 Lustre filesystem: lustre
115 MDT device: lustre-MDT0000
121 Statuslog: replicate.log
123 Changelog registration: cl1
125 Starting changelog record: 0
129 lustre_rsync took 1 seconds
131 Changelog records consumed: 22
136 After the filesystem undergoes some changes, replicate the \
137 changes. Only the statuslog needs to be specified as it has all the \
138 parameters passed earlier.
140 $ lustre_rsync --statuslog replicate.log --verbose
142 Replicating Lustre filesystem: lustre
144 MDT device: lustre-MDT0000
150 Statuslog: replicate.log
152 Changelog registration: cl1
154 Starting changelog record: 22
158 lustre_rsync took 2 seconds
160 Changelog records consumed: 42
164 To replicate the lustre filesystem /mnt/lustre to /mnt/target1 and /mnt/target2.
165 $ lustre_rsync --source=/mnt/lustre \\
167 --target=/mnt/target1 --target=/mnt/target2 \\
169 --mdt=lustre-MDT0000 --user=cl1
171 --statuslog replicate.log
176 The lustre_rsync command is part of the Lustre filesystem. Contact
177 http://www.lustre.org/