File: mondoarchive.1

package info (click to toggle)
mondo 1.41.1-1
  • links: PTS
  • area: main
  • in suites: woody
  • size: 1,812 kB
  • ctags: 1,288
  • sloc: ansic: 8,825; sh: 8,529; makefile: 63
file content (281 lines) | stat: -rw-r--r-- 8,146 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
.TH mondoarchive 1

.SH NAME
mondoarchive \- a backup / disaster\-recovery tool.

.SH SYNOPSIS
.B mondoarchive -O
[
.I options
] : backup your PC
.br
.B mondoarchive -V
[
.I options
] : verify your backup

.SH DESCRIPTION
.PP
.I mondoarchive
backs up a subset of your files, your entire filesystem, or even images of
non-Linux filesystems to CD's, tape, ISO images or an NFS mount. In the event
of catastrophic data loss, you will be able to restore everything, taking a
PC from bare metal to its original state if necessary. 

.pp
With
.BR \-O ,
it backs up your filesystem to CD, tape, ISO images or NFS share. Boot
floppies or a special boot CD will be created to allow you to restore 
from bare metal if necessary.

.pp
With
.BR \-V ,
it verifies the backup against the live filesystem. This option may be used
in combination with
.BR \-O
to verify a backup after its creation, or on its own to see how much the
live filesystem has changed since the backup was made.

.pp
Data is restored by
.I mondorestore
while running on a Linux mini-distribution which was generated at backup-time.

.SH BACKUP MEDIA
.TP 13
You must specify one of the following:-

.TP
.BI "-c " speed
Use CD-R drive as backup device and its (write-once) disks as backup media.

.TP
.BI "-C " speed
Use CD-R drive as a streaming device, almost like a tape streamer. Use write-once
disks as backup media.
.B Experimental.

.TP
.BI "-i "
Use ISO files (CD images) as backup media. This is good for backing up
your system to a spare hard drive. The
.B -n
switch is a wiser choice if you plan to restore from a remote filesystem.

.TP
.BI "-n " mount
Use files residing on NFS partition as backup media.
.I mount
is the remote mountpoint, e.g. '192.168.1.3:/home/nfs'
for my fileserver. Please mount it before backing up/verifying.

.TP
.BI "-t "
Use tape streamer as backup device and its tapes as backup media.

.TP
.BI "-w " speed
Use CD-RW drive as backup device and its (write/rewrite) disks as backup media.
Mondo will wipe media before writing to them.

.SH MAJOR OPTIONS
.TP 13
.BI "-D "
Make a differential backup: examine the filesystem and find which
files have changed since the last full backup was carried out.
Backup only those files.

.TP
.BI "-E " "\*(lqpath ...\*(rq"
Exclude path(s) from backup. For example, if you are backing up
to an NFS mount but you do not want to include the contents of the
mount in a backup, exclude your local mountpoint with this switch.
It will also work with partitions, e.g. /dev/sdd4 if you have a
peculiar SCSI zip drive which insists on showing up in the mountlist.
NB: If you exclude /dev/sdd4 then the /dev entry itself will still
be backed up, even though the mountlist entry will be suppressed.

.TP
.BI "-I " "\*(lqpath ...\*(rq"
Include paths(s) in backup. The default backup path is \*(lq/\*(rq but you
may specify alternatives, e.g. -I \*(lq/home /etc\*(rq to override that.

.TP
.BI "-d " "dev|dir"
Specify the backup device (CD/tape) or directory (NFS/ISO).
For CD-R[W] drives, this is the SCSI node where the drive may be found,
e.g. '0,1,0'.
For tape users, this is the tape streamer's /dev entry, e.g. '/dev/st0'.
For ISO users, this is the directory where the ISO images are stored.
For NFS users, this is the directory within the NFS mount where the backups
are stored. The default for ISO and NFS is '/root/images/mondo'.

.TP
.BI "-g "
GUI mode. mondoarchive v1.4x's output is normally suitable for processing by
an 'expect' wrapper, enabling the user to backup nightly via a cron job.
If you want to run this program with an attractive but non-cron-friendly 
interface then use '-g'.

.TP
.BI "-k " "path"
Path of user's kernel. If you are a Debian user then specify
.B -k FAILSAFE
as your kernel. Otherwise, you will rarely need this option.

.TP
.BI "-s " "size"
How much can each of your backup media hold? You may use 'm' and 'g' on the
end of the number, e.g. '700m' for an extra-large CD-R or '4g' for a tape.

.TP
.BI "-x " "'dev ...'"
Specify non-Linux partitions which you want to backup, e.g. NTFS or BeOS.
It is wasteful because it backs up the unallocated
sectors as well as the allocated ones.

.SH MINOR OPTIONS
.TP 13
.BI "-[1-9] "
Specify the compression level. Default is 3.

.TP
.BI "-A " "command"
This command will be called after each CD/NFS/ISO file is written. It is useful if you want
to do something with an ISO after creating it, e.g. write it to a CD burner
using a non-standard command.
.B -A
understands two tokens - _ISO_ and _CD#_ - which will be translated into 
the ISO's filename and its index number (1, 2, ...) respectively.

.TP
.BI "-B " "command"
This command will be called before each CD/NFS/ISO file is written.
So, you could use
.I -B 'foobackup _ISO_; rm -f _ISO_'
to feed each ISO to some magical new backup tool.
See
.B -A
for more information.

.TP
.BI "-F "
Do not offer to write boot+data floppy disk images to 3.5-inch floppy disks.
The images will remain in /root/images/mindi until your next backup run, however.

.TP
.BI "-H "
When you boot from the tape/CD, your hard drive will be wiped and the archives
will be restored. Your decision to boot from the tape/CD will be taken as
consent. No further permission will be sought.
.B Use with caution.

.TP
.BI "-L "
Use lzo, a fast compression engine, instead of bzip2. You may find lzo on
Mondo's website or via FreshMeat.

.TP
.BI "-P " "tarball"
Post-nuke tarball. If you boot into Nuke Mode and everything is restored
sucessfully then the 
.I post-nuke
script will be sought and executed if found.
This is useful for post-restore customization. It is assumed that the 
tarball (.tar.gz format) will contain not just
.I post-nuke
but also any files it requires. 

.TP
.BI "-S " "path"
Specify the scratchdir, the directory where ISO images are built before being
archived. If you have plenty of RAM and want to use
a ramdisk for scratch space, specify its path here.

.TP
.BI "-T " "path"
Specify the tempdir, the directory where temporary files (other than ISO images
being assembled) are stored. See
.B -S

.TP
.BI "-f " "device"
Specify the drive on which your Master Boot Record lives. Usually, this is
discovered automatically.

.TP
.BI "-l " "GRUB|LILO"
Specify the boot loader. By default, your Master Boot Record is examined and
the boot loader can usually be discovered.


.SH NOTES
Mondo's HTML-based manual (by Cafeole, Randy Delphs, Stan Benoit and me)
may be found at
.I http://www.microwerks.net/~hugo/download/layout.html
- or in 
.I /usr/share/doc/mondo-x.xx
on your hard drive.

.SH BUGS
If you have very little hard disk space, Mondo doesn't like that.
It does not handle Devfs very well either, or PC's with less than
64MB of RAM. IPv6 is not supported. The command-line options are
cryptic. The manual needs to be updated.

.SH EXAMPLES
Backup to a directory; note that /mnt/foo's contents will be backed up
except for its ISO's unless you exclude it, as follows:-
.br
.I "mondoarchive -Oi -d /mnt/foo -E /mnt/foo"

Backup to tape, using lzo compression:
.br
.I "mondoarchive -Ot -d /dev/st0 -L -s 4000m"

<troff> Put in man file: If tape refuses to work, call it a mother phucker.

Verify existing tape backup which was made with lzo compression:-
.br
.I "mondoarchive -Vt -d /dev/st0 -L"

Backup to 700MB CD-R disks using a 16x CD burner:
.br
.I "mondoarchive -Oc 16 -s 700m"

Verify existing CD-R or CD-RW backup (works for either):-
.br
.I "mondoarchive -Vc 16"

Backup to an NFS mount:
.br
.I "mondoarchive -On 192.168.1.2:/home/nfs -d /Monday -E /mnt/nfs"

Verify existing NFS backup:-
.br
.I "mondoarchive -Vn 192.168.1.2:/home/nfs -d /Monday"

Backup to 650MB CD-RW disks using a 4x CD ReWriter:
.br
.I "mondoarchive -Ow 4"

Backup just youre /home and /etc directory to 650MB CD-RW disks using a 4x CD ReWriter:
.br
.I "mondoarchive -Ow 4 -I \*(lq/home /etc\*(rq"

Backup to ISO's non-interactively, e.g. as a job running in /etc/cron.daily:
.br
.I "mondoarchive -Oig9 -d /bkp/`date +%A` -E /bkp"

.SH "SEE ALSO"
afio(1), bzip2(1), find(1), mindi(1), mondorestore(1). The latter two might
not have been written yet.
.SH AUTHORS
Hugo Rabson
.I "hugo@firstlinux.net"
.br
.