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