source: trunk/mondo/mondo/mondoarchive/mondoarchive.8 @ 30

Last change on this file since 30 was 30, checked in by bcornec, 14 years ago

Id property added on files to allow for better conf. management

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