1 | .\" This is free documentation; you can redistribute it and/or
|
---|
2 | .\" modify it under the terms of the GNU General Public License as
|
---|
3 | .\" published by the Free Software Foundation; either version 2 of
|
---|
4 | .\" the License, or (at your option) any later version.
|
---|
5 | .\"
|
---|
6 | .\" The GNU General Public License's references to "object code"
|
---|
7 | .\" and "executables" are to be interpreted as the output of any
|
---|
8 | .\" document formatting or typesetting system, including
|
---|
9 | .\" intermediate and printed output.
|
---|
10 | .\"
|
---|
11 | .\" This manual is distributed in the hope that it will be useful,
|
---|
12 | .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
|
---|
13 | .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
---|
14 | .\" GNU General Public License for more details.
|
---|
15 | .\"
|
---|
16 | .\" You should have received a copy of the GNU General Public
|
---|
17 | .\" License along with this manual; if not, write to the Free
|
---|
18 | .\" Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139,
|
---|
19 | .\" USA.
|
---|
20 | .\"
|
---|
21 | .TH mondoarchive 8 "DDD" "Mondo Rescue VVV-rRRR"
|
---|
22 |
|
---|
23 | .SH NAME
|
---|
24 | mondoarchive \- a backup / disaster\-recovery tool.
|
---|
25 |
|
---|
26 | .SH SYNOPSIS
|
---|
27 | .B mondoarchive -O
|
---|
28 | [
|
---|
29 | .I options
|
---|
30 | ] : backup your PC
|
---|
31 | .br
|
---|
32 | .B mondoarchive -V
|
---|
33 | [
|
---|
34 | .I options
|
---|
35 | ] : verify your backup
|
---|
36 |
|
---|
37 | .SH DESCRIPTION
|
---|
38 | .PP
|
---|
39 | .I mondoarchive
|
---|
40 | backs up a subset of your files, your entire filesystem, or even images of
|
---|
41 | non-Linux filesystems to CD's, tape, ISO images or an NFS mount. In the event of
|
---|
42 | catastrophic data loss, you will be able to restore everything, taking a PC from
|
---|
43 | bare metal to its original state if necessary.
|
---|
44 |
|
---|
45 | .pp
|
---|
46 | With
|
---|
47 | .BR \-O ,
|
---|
48 | it backs up your filesystem to CD, tape, ISO images or NFS share. Boot floppies
|
---|
49 | or a special boot CD will be created to allow you to restore from bare metal if
|
---|
50 | necessary.
|
---|
51 |
|
---|
52 | .pp
|
---|
53 | With
|
---|
54 | .BR \-V ,
|
---|
55 | it verifies the backup against the live filesystem. This option may be used in
|
---|
56 | combination with
|
---|
57 | .BR \-O
|
---|
58 | to verify a backup after its creation, or on its own to see how much the live
|
---|
59 | filesystem has changed since the backup was made.
|
---|
60 |
|
---|
61 | .pp
|
---|
62 | Call mondoarchive
|
---|
63 | .BR without
|
---|
64 | .BR flags
|
---|
65 | to make it auto-detect as many settings as possible, ask you politely for the
|
---|
66 | rest, and then backup and verify your OS or a subset thereof.
|
---|
67 |
|
---|
68 | .pp
|
---|
69 | To restore data, either run
|
---|
70 | .I mondorestore
|
---|
71 | from the command line or boot from the emergency CD/floppies generated during
|
---|
72 | the backup process. The latter will come in handy if a gremlin wipes your hard
|
---|
73 | disk.
|
---|
74 |
|
---|
75 | .SH BACKUP MEDIA
|
---|
76 | .TP 13
|
---|
77 | You must specify one of the following:-
|
---|
78 |
|
---|
79 | .TP
|
---|
80 | .BI "-c " speed
|
---|
81 | Use CD-R drive as backup device and its (write-once) disks as backup media.
|
---|
82 |
|
---|
83 | .TP
|
---|
84 | .BI "-w " speed
|
---|
85 | Use CD-RW drive as backup device and its (write/rewrite) disks as backup media.
|
---|
86 | Mondo will wipe media before writing to them.
|
---|
87 |
|
---|
88 | .TP
|
---|
89 | .BI "-r "
|
---|
90 | Use DVD drive as backup device and its disks as backup media. Growisofs decides
|
---|
91 | on the best speed for your drive. Note that calling mondoarchive
|
---|
92 | .B using sudo when writing to DVDs will fail
|
---|
93 | because growisofs does not support this - see the growisofs manpage for
|
---|
94 | details.
|
---|
95 |
|
---|
96 | .TP
|
---|
97 | .BI "-C " speed
|
---|
98 | Use CD-R drive as a streaming device, almost like a tape streamer. Use
|
---|
99 | write-once disks as backup media.
|
---|
100 | .B Experimental.
|
---|
101 |
|
---|
102 | .TP
|
---|
103 | .BI "-p " prefix
|
---|
104 | Use
|
---|
105 | .B prefix
|
---|
106 | to generate the name of your ISO images.
|
---|
107 | By default, mondoarchive calls images mondorescue-1.iso, mondorescue-2.iso, ...
|
---|
108 | Using
|
---|
109 | .B -p machine
|
---|
110 | it will call your images machine-1.iso, machine-2.iso, ...
|
---|
111 |
|
---|
112 | .TP
|
---|
113 | .BI "-i "
|
---|
114 | Use ISO files (CD images) as backup media. This is good for backing up your
|
---|
115 | system to a spare hard drive. The
|
---|
116 | .B -n
|
---|
117 | switch is a wiser choice if you plan to restore from a remote filesystem.
|
---|
118 |
|
---|
119 | .TP
|
---|
120 | .BI "-n " mount
|
---|
121 | Use files residing on NFS partition as backup media.
|
---|
122 | .I mount
|
---|
123 | is the remote mount-point, e.g. '192.168.1.3:/home/nfs'
|
---|
124 | for my file server. Please mount it before backing up/verifying.
|
---|
125 |
|
---|
126 | .TP
|
---|
127 | .BI "-t "
|
---|
128 | Use tape streamer as backup device and its tapes as backup media.
|
---|
129 |
|
---|
130 | .TP
|
---|
131 | .BI "-u "
|
---|
132 | Use a generic streaming device as backup device. Use this if you want to write
|
---|
133 | your backup to a device that is not directly support by mondoarchive. This will
|
---|
134 | send the data directly to a raw device.
|
---|
135 | .B For experienced users only.
|
---|
136 |
|
---|
137 | .SH MAJOR OPTIONS
|
---|
138 | .TP 13
|
---|
139 | .BI "-D "
|
---|
140 | Make a differential backup: examine the filesystem and find which files have
|
---|
141 | changed since the last full backup was carried out. Backup only those files.
|
---|
142 |
|
---|
143 | .TP
|
---|
144 | .BI "-E " "\*(lqpath ...\*(rq"
|
---|
145 | Exclude path(s) from backup. The paths should be separated with a whitespace.
|
---|
146 | Note that mondo automatically excludes removable media (/mnt/floppy,
|
---|
147 | /mnt/cdrom, etc.). For example, if you are backing up to an NFS mount but you
|
---|
148 | do not want to include the contents of the mount in a backup, exclude your
|
---|
149 | local mount-point with this switch. It will also work with partitions, e.g.
|
---|
150 | /dev/sdd4 if you have a peculiar SCSI zip drive which insists on showing up in
|
---|
151 | the mountlist. NB: If you exclude /dev/sdd4 then the /dev entry itself will
|
---|
152 | still be backed up, even though the mountlist entry will be suppressed.
|
---|
153 |
|
---|
154 | .TP
|
---|
155 | .BI "-I " "\*(lqpath ...\*(rq"
|
---|
156 | Include paths(s) in backup. The default backup path is \*(lq/\*(rq but you may
|
---|
157 | specify alternatives, e.g. -I \*(lq/home /etc\*(rq to override that.
|
---|
158 |
|
---|
159 | .TP
|
---|
160 | .BI "-J " "file"
|
---|
161 | Specify an explicit list of files and directories in a plain text file, one item
|
---|
162 | (file or directory) per line.
|
---|
163 |
|
---|
164 | .TP
|
---|
165 | .BI "-N"
|
---|
166 | Exclude all mounted network filesystems. This currently means NFS, SMB, Coda
|
---|
167 | and Netware. In other words, only backup the local hard disk(s).
|
---|
168 |
|
---|
169 | .TP
|
---|
170 | .BI "-d " "dev|dir"
|
---|
171 | Specify the backup device (CD/tape) or directory (NFS/ISO). For CD-R[W] drives,
|
---|
172 | this is the SCSI node where the drive may be found, e.g. '0,1,0'. For tape
|
---|
173 | users, this is the tape streamers /dev entry, e.g. '/dev/st0'. For ISO users,
|
---|
174 | this is the directory where the ISO images are stored. For NFS users, this is
|
---|
175 | the directory within the NFS mount where the backups are stored. The default
|
---|
176 | for ISO and NFS is '/root/images/mondo'.
|
---|
177 |
|
---|
178 | .TP
|
---|
179 | .BI "-g "
|
---|
180 | GUI mode. Without this switch, the screen output of mondoarchive is suitable
|
---|
181 | for processing by an 'expect' wrapper, enabling the user to backup nightly via
|
---|
182 | a cron job. However, if you want to run this program with an attractive but
|
---|
183 | non-cron-friendly interface then use '-g'.
|
---|
184 |
|
---|
185 | .TP
|
---|
186 | .BI "-k " "path"
|
---|
187 | Path of user's kernel. If you are a Debian or Gentoo user then specify
|
---|
188 | .B -k FAILSAFE
|
---|
189 | as your kernel. Otherwise, you will rarely need this option.
|
---|
190 |
|
---|
191 | .TP
|
---|
192 | .BI "-m "
|
---|
193 | Manual (not self-retracting) CD trays are often found on laptops. If you are
|
---|
194 | a laptop user, your CD burner has BurnProof technology or you experience
|
---|
195 | problems with mondo then please call mondoarchive with this switch.
|
---|
196 |
|
---|
197 | .TP
|
---|
198 | .BI "-o "
|
---|
199 | Use LILO as boot loader of boot floppy/CD instead of SYSLINUX/ISOLINUX. By
|
---|
200 | default, SYSLINUX is used for floppies and ISOLINUX for CD's. Use LILO if you
|
---|
201 | prefer to use that boot loader. NB: This does not affect which boot loader you
|
---|
202 | use to boot your PC, merely the boot loader used by the CD's/floppies created
|
---|
203 | by Mondo. Use ELILO instead which is mandatory for IA64 machines.
|
---|
204 |
|
---|
205 | .TP
|
---|
206 | .BI "-s " "size"
|
---|
207 | How much can each of your backup media hold? You may use 'm' and 'g' on the end
|
---|
208 | of the number, e.g. '700m' for an extra-large CD-R. You no longer need to
|
---|
209 | specify the size of your cartridges if you are backing up to tape.
|
---|
210 |
|
---|
211 | .TP
|
---|
212 | .BI "-x " "'dev ...'"
|
---|
213 | Specify non-Linux partitions which you want to backup, e.g. NTFS or BeOS.
|
---|
214 |
|
---|
215 |
|
---|
216 | .SH MINOR OPTIONS
|
---|
217 | .TP 13
|
---|
218 | .BI "-[0-9] "
|
---|
219 | Specify the compression level. Default is 3. No compression is 0.
|
---|
220 |
|
---|
221 | .TP
|
---|
222 | .BI "-A " "command"
|
---|
223 | This command will be called after each CD/NFS/ISO file is written. It is useful
|
---|
224 | if you want to do something with an ISO after creating it, e.g. write it to a
|
---|
225 | CD burner using a non-standard command.
|
---|
226 | .B -A
|
---|
227 | understands two tokens - _ISO_ and _CD#_ - which will be translated into the
|
---|
228 | ISO's filename and its index number (1, 2, ...) respectively. So, you could use
|
---|
229 | .I -A 'foobackup _ISO_; rm -f _ISO_'
|
---|
230 | to feed each ISO to some magical new backup tool.
|
---|
231 |
|
---|
232 | .TP
|
---|
233 | .BI "-B " "command"
|
---|
234 | This command will be called before each CD/NFS/ISO file is written. See
|
---|
235 | .B -A
|
---|
236 | for more information.
|
---|
237 |
|
---|
238 | .TP
|
---|
239 | .BI "-F "
|
---|
240 | Do not offer to write boot+data floppy disk images to 3.5-inch floppy disks.
|
---|
241 | The images will remain in /root/images/mindi until your next backup run,
|
---|
242 | however.
|
---|
243 |
|
---|
244 | .TP
|
---|
245 | .BI "-H "
|
---|
246 | When you boot from the tape/CD, your hard drive will be wiped and the archives
|
---|
247 | will be restored. Your decision to boot from the tape/CD will be taken as
|
---|
248 | consent. No further permission will be sought.
|
---|
249 | .B Use with caution.
|
---|
250 |
|
---|
251 | .TP
|
---|
252 | .BI "-L "
|
---|
253 | Use lzo, a fast compression engine, instead of bzip2. You may find lzo on
|
---|
254 | Mondo's website or via FreshMeat. WARNING! Some versions of LZO are unstable.
|
---|
255 |
|
---|
256 | .TP
|
---|
257 | .BI "-R "
|
---|
258 | EXPERIMENTAL. Do not use in mission-critical environments. Star is an alternative to afio. Mondo now supports POSIX ACLs and extended attributes, so -R is essentially redundant for now.
|
---|
259 |
|
---|
260 | .TP
|
---|
261 | .BI "-P " "tarball"
|
---|
262 | Post-nuke tarball. If you boot into Nuke Mode and everything is restored
|
---|
263 | successfully then the
|
---|
264 | .I post-nuke
|
---|
265 | script will be sought and executed if found. This is useful for post-restore
|
---|
266 | customization. It is assumed that the tarball (.tar.gz format) will contain not
|
---|
267 | just the
|
---|
268 | .I post-nuke
|
---|
269 | script (or binary, or whatever it is) but also any files it requires.
|
---|
270 |
|
---|
271 | .TP
|
---|
272 | .BI "-S " "path"
|
---|
273 | Specify the scratchdir, the directory where ISO images are built before being
|
---|
274 | archived. If you have plenty of RAM and want to use a ramdisk for scratch
|
---|
275 | space, specify its path here.
|
---|
276 |
|
---|
277 | .TP
|
---|
278 | .BI "-T " "path"
|
---|
279 | Specify the tempdir, the directory where temporary files (other than ISO images
|
---|
280 | being assembled) are stored. See
|
---|
281 | .B -S
|
---|
282 |
|
---|
283 | .TP
|
---|
284 | .BI "-W "
|
---|
285 | Don't make your backup self-booting. This is a really bad idea, IMO. Don't do
|
---|
286 | this unless you have really great boot disks in your hand and you are an anally
|
---|
287 | retentive SOB who can't wait 2 minutes for Mindi to run in the background. If
|
---|
288 | you use -W then you'd better know what the hell you're doing, okay?
|
---|
289 |
|
---|
290 | .TP
|
---|
291 | .BI "-b "
|
---|
292 | Specify the internal block size used by the tape drive. This is usually 32K but
|
---|
293 | some drives just don't like that. They should but they don't. That's what
|
---|
294 | happens when tape drive vendors don't talk to kernel driver writers. Try 512 or
|
---|
295 | 16384.
|
---|
296 |
|
---|
297 | .TP
|
---|
298 | .BI "-e "
|
---|
299 | Don't eject the CD or tape when backing up or restoring... unless cdrecord
|
---|
300 | insists on it. If it does, well, tough. Sorry. :)
|
---|
301 |
|
---|
302 | .TP
|
---|
303 | .BI "-f " "device"
|
---|
304 | Specify the drive on which your Master Boot Record lives. Usually, this is
|
---|
305 | discovered automatically.
|
---|
306 |
|
---|
307 | .TP
|
---|
308 | .BI "-l " "GRUB|LILO|ELILO|RAW"
|
---|
309 | Specify the boot loader. By default, your Master Boot Record is examined and
|
---|
310 | the boot loader can usually be discovered. If you specify RAW then the MBR will
|
---|
311 | be backed up and restored byte-for-byte without any analysis. It is likely that
|
---|
312 | you will also need to specify the boot device with -f <dev>. ELILO is mandatory
|
---|
313 | for IA64 machines.
|
---|
314 |
|
---|
315 | .TP
|
---|
316 | .BI "-Q "
|
---|
317 | Give more detailed information about the boot loader.
|
---|
318 |
|
---|
319 | .TP
|
---|
320 | .BI "-K " "loglevel"
|
---|
321 | Specify the loglevel.
|
---|
322 |
|
---|
323 |
|
---|
324 | .SH DIAGNOSTICS
|
---|
325 | Mondo generates two additional, and Extremely important files:
|
---|
326 | .BI /var/log/mindi.log
|
---|
327 | and
|
---|
328 | .BI /var/log/mondo-archive.log.
|
---|
329 | When seeking technical support, attach these two files to your email.
|
---|
330 |
|
---|
331 |
|
---|
332 |
|
---|
333 | .SH FILES
|
---|
334 | .IR /var/log/mindi.log
|
---|
335 | This log contains important information required to analyse mindi problem
|
---|
336 | reports.
|
---|
337 |
|
---|
338 | .IR /var/log/mondo-archive.log
|
---|
339 | This log contains important information required to analyse mondoarchive
|
---|
340 | problem reports. Mondo support highly recommends sending these files with
|
---|
341 | support questions.
|
---|
342 |
|
---|
343 | .SH NOTES
|
---|
344 | A link to Mondo's HTML-based manual (by Bruno Cornec, Mikael Hultgren, Cafeole, Randy Delphs,
|
---|
345 | Stan Benoit, and Hugo Rabson) may be found at
|
---|
346 | .I http://www.mondorescue.org/docs.shtml
|
---|
347 | - or in
|
---|
348 | .I /usr/share/doc/mondo-x.xx
|
---|
349 | on your hard drive.
|
---|
350 |
|
---|
351 | .SH BUGS
|
---|
352 | It is recommend that your system has more than 64 MB ram. SCSI device order
|
---|
353 | change with nuke can have unexpected results. It is recommended you use expert
|
---|
354 | mode with drastic hardware reconfigurations.
|
---|
355 |
|
---|
356 | .SH EXAMPLES
|
---|
357 |
|
---|
358 | .BI ISO:
|
---|
359 | Backup to a directory; note that /mnt/foo's contents will be backed up except
|
---|
360 | for its ISO's unless you exclude it, as follows:-
|
---|
361 | .br
|
---|
362 | .I "mondoarchive -Oi -d /mnt/foo -E \"/mnt/foo /mnt/foo2\""
|
---|
363 |
|
---|
364 | Backup to ISO's non-interactively, e.g. as a job running in /etc/cron.daily:
|
---|
365 | .br
|
---|
366 | .I "mkdir -p /bkp/`date +%A`; mondoarchive -Oi -9 -d /bkp/`date +%A` -E /bkp"
|
---|
367 |
|
---|
368 | .BI DVD:
|
---|
369 | Backup PC using DVD Media:
|
---|
370 | .br
|
---|
371 | .I "mondoarchive -OVr -d /dev/scd0 -gF -s 4480m"
|
---|
372 |
|
---|
373 | .BI TAPE:
|
---|
374 | Backup to tape, using lzo compression (WARNING - can be unstable):
|
---|
375 | .br
|
---|
376 | .I "mondoarchive -Ot -d /dev/st0 -L"
|
---|
377 |
|
---|
378 | Verify existing tape backup which was made with lzo compression:-
|
---|
379 | .br
|
---|
380 | .I "mondoarchive -Vt -d /dev/st0 -L -g"
|
---|
381 |
|
---|
382 | Backup to tape, using max compression:
|
---|
383 | .br
|
---|
384 | .I "mondoarchive -Ot -9 -d /dev/st0 "
|
---|
385 |
|
---|
386 | .BI CD-R:
|
---|
387 | Backup to 700MB CD-R disks using a 16x CD burner:
|
---|
388 | .br
|
---|
389 | .I "mondoarchive -Oc 16 -s 700m -g"
|
---|
390 |
|
---|
391 | Verify existing CD-R or CD-RW backup (works for either):-
|
---|
392 | .br
|
---|
393 | .I "mondoarchive -Vc 16"
|
---|
394 |
|
---|
395 | .BI CD-RW:
|
---|
396 | Backup to 650MB CD-RW disks using a 4x CD ReWriter:
|
---|
397 | .br
|
---|
398 | .I "mondoarchive -Ow 4"
|
---|
399 |
|
---|
400 | Backup just your /home and /etc directory to 650MB CD-RW disks using a 4x CD
|
---|
401 | ReWriter:
|
---|
402 | .br
|
---|
403 | .I "mondoarchive -Ow 4 -I \*(lq/home /etc\*(rq"
|
---|
404 |
|
---|
405 | .BI NFS:
|
---|
406 | Backup to an NFS mount:
|
---|
407 | .br
|
---|
408 | .I "mondoarchive -On 192.168.1.2:/home/nfs -d /Monday -E /mnt/nfs"
|
---|
409 |
|
---|
410 | Verify existing NFS backup:-
|
---|
411 | .br
|
---|
412 | .I "mondoarchive -Vn 192.168.1.2:/home/nfs -d /Monday"
|
---|
413 |
|
---|
414 | .BI RAID:
|
---|
415 | Backup PC to a Software Raid mount point, iso size 700mb:
|
---|
416 | .br
|
---|
417 | .I "mondoarchive -O -s 700m -d /mnt/raid"
|
---|
418 |
|
---|
419 |
|
---|
420 | .SH "SEE ALSO"
|
---|
421 | afio(1), bzip2(1), find(1), mindi(8), mondorestore(8).
|
---|
422 | .SH AUTHORS
|
---|
423 | Bruno Cornec (lead-development)
|
---|
424 | .I "bruno_at_mondorescue.org"
|
---|
425 | .br
|
---|
426 | Andree Leidenfrost (co-developper)
|
---|
427 | .I "aleidenf_at_bigpond.net.au"
|
---|
428 | .br
|
---|
429 | .SH ORIGINAL AUTHORS
|
---|
430 | Hugo Rabson (original author)
|
---|
431 | .I "hugo.rabson_at_mondorescue.org"
|
---|
432 | .br
|
---|
433 | Jesse Keating (original RPM packager)
|
---|
434 | .I "hosting_at_j2solutions.net"
|
---|
435 | .br
|
---|
436 | Stan Benoit (testing)
|
---|
437 | .I "troff_at_nakedsoul.org"
|
---|
438 | .br
|
---|
439 | Mikael Hultgren (docs)
|
---|
440 | .I "mikael_hultgren_at_gmx.net"
|
---|
441 | .br
|
---|
442 | See mailing list at http://www.mondorescue.org for technical support.
|
---|
443 | .
|
---|