source: branches/stable/mondo-doc/mondoarchive.8 @ 1770

Last change on this file since 1770 was 1770, checked in by bruno, 12 years ago
  • Better output for mindi-busybox revision
  • Remove dummy file created on NFS - report from Arnaud Tiger <arnaud.tiger_at_hp.com>
  • strace useful for debug
  • fix new versions for pb (2.0.0 for mindi and 1.7.2 for mindi-busybox)
  • fix build process for mindi-busybox + options used in that version (dd for label-partitions-as-necessary)
  • fix typo in label-partitions-as-necessary which doesn't seem to work
  • Update to busybox 1.7.2
  • perl is now required at restore time to support uuid swap partitions (and will be used for many other thigs

in the future for sure)

  • next mindi version will be 2.0.0 due to all the changes made in it (udev may break working distros)
  • small optimization in mindi on keyboard handling (one single find instead of multiple)
  • better interaction for USB device when launching mindi manually
  • attempt to automatically guess block disk size for ramdisk
  • fix typos in bkphw
  • Fix the remaining problem with UUID support for swap partitions
  • Updates mondoarchive man page for USB support
  • Adds preliminary Hardware support to mindi (Proliant SSSTK)
  • Tries to add udev support also for rhel4
  • Fix UUID support which was still broken.
  • Be conservative in test for the start-nfs script
  • Update config file for mindi-busybox for 1.7.2 migration
  • Try to run around a busybox bug (1.2.2 pb on inexistant links)
  • Add build content for mindi-busybox in pb
  • Remove distributions content for mindi-busybox
  • Fix a warning on inexistant raidtab
  • Solve problem on tmpfs in restore init (Problem of inexistant symlink and busybox)
  • Create MONDO_CACHE and use it everywhere + creation at start
  • Really never try to eject a USB device
  • Fix a issue with &> usage (replaced with 1> and 2>)
  • Adds magic file to depllist in order to have file working + ldd which helps for debugging issues
  • tty modes correct to avoid sh error messages
  • Use ext3 normally and not ext2 instead
  • USB device should be corrected after reading (take 1st part)
  • Adds a mount_USB_here function derived from mount_CDROM_here
  • usb detection place before /dev detection in device name at restore time
  • Fix when restoring from USB: media is asked in interactive mode
  • Adds USB support for mondorestore
  • mount_cdrom => mount_media
  • elilo.efi is now searched throughout /boot/efi and not in a fixed place as there is no standard
  • untar-and-softlink => untar (+ interface change)
  • suppress useless softlinks creation/removal in boot process
  • avoids udevd messages on groups
  • Increase # of disks to 99 as in mindi at restore time (should be a conf file parameter)
  • skip existing big file creation
  • seems to work correctly for USB mindi boot
  • Adds group and tty link to udev conf
  • Always load usb-torage (even 2.6) to initiate USB bus discovery
  • Better printing of messages
  • Attempt to fix a bug in supporting OpenSusE 10.3 kernel for initramfs (mindi may now use multiple regex for kernel initrd detection)
  • Links were not correctly done as non relative for modules in mindi
  • exclusion of modules denied now works
  • Also create modules in their ordinary place, so that classical modprobe works + copy modules.dep
  • Fix bugs for DENY_MODS handling
  • Add device /dev/console for udev
  • ide-generic should now really be excluded
  • Fix a bug in major number for tty
  • If udev then adds modprobe/insmod to rootfs
  • tty0 is also cretaed with udev
  • ide-generic put rather in DENY_MODS
  • udevd remove from deplist s handled in mindi directly
  • better default for mindi when using --usb
  • Handles dynamically linked busybox (in case we want to use it soon ;-)
  • Adds fixed devices to create for udev
  • ide-generic should not be part of the initrd when using libata v2
  • support a dynamically linked udev (case on Ubuntu 7.10 and Mandriva 2008.0 so should be quite generic) This will give incitation to move to dyn. linked binaries in the initrd which will help for other tasks (ia6 4)
  • Improvement in udev support (do not use cl options not available in busybox)
  • Udev in mindi
    • auto creation of the right links at boot time with udev-links.conf(from Mandriva 2008.0)
    • rework startup of udev as current makes kernel crash (from Mandriva 2008.0)
    • add support for 64 bits udev
  • Try to render MyInsmod? silent at boot time
  • Adds udev support (mandatory for newest distributions to avoid remapping of devices in a different way as on the original system)
  • We also need vaft format support for USB boot
  • Adds libusual support (Ubuntu 7.10 needs it for USB)
  • Improve Ubuntu/Debian? keyboard detection and support
  • pbinit adapted to new pb (0.8.10). Filtering of docs done in it
  • Suppress some mondo warnings and errors on USB again
  • Tries to fix lack of files in deb mindi package
  • Verify should now work for USB devices
  • More log/mesages improvement for USB support
  • - Supress g_erase_tmpdir_and_scratchdir
  • Improve some log messages for USB support
  • Try to improve install in mindi to avoid issues with isolinux.cfg not installed vene if in the pkg :-(
  • Improve mindi-busybox build
  • In conformity with pb 0.8.9
  • Add support for Ubuntu 7.10 in build process
  • Add USB Key button to Menu UI (CD streamer removed)
  • Attempt to fix error messages on tmp/scratch files at the end by removing those dir at the latest possible.
  • Fix a bug linked to the size of the -E param which could be used (Arnaud Tiger/René? Ribaud).
  • Integrate ~/.pbrc content into mondorescue.pb (required project-builder >= 0.8.7)
  • Put mondorescue in conformity with new pb filtering rules
  • Add USB support at restore time (no test done yet). New start-usb script PB varibale added where useful
  • Unmounting USB device before removal of temporary scratchdir
  • Stil refining USB copy back to mondo (one command was not executed)
  • No need to have the image subdor in the csratchdir when USB.
  • umount the USB partition before attempting to use it
  • Remove useless copy from mindi to mondo at end of USB handling

(risky merge, we are raising the limits of 2 diverging branches. The status of stable is not completely sure as such. Will need lots of tests, but it's not yet done :-()
(merge -r1692:1769 $SVN_M/branches/2.2.5)

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