[402] | 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 | .\"
|
---|
[2062] | 21 | .TH mondoarchive 8 "PBDATE" "Mondo Rescue PBVER-rPBREV"
|
---|
[1] | 22 |
|
---|
| 23 | .SH NAME
|
---|
| 24 | mondoarchive \- a backup / disaster\-recovery tool.
|
---|
| 25 |
|
---|
| 26 | .SH SYNOPSIS
|
---|
[2543] | 27 | .B mondoarchive \-O
|
---|
[1] | 28 | [
|
---|
| 29 | .I options
|
---|
[3653] | 30 | ] : backup your machine
|
---|
[1] | 31 | .br
|
---|
[2543] | 32 | .B mondoarchive \-V
|
---|
[1] | 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
|
---|
[3653] | 42 | catastrophic data loss, you will be able to restore everything, taking a
|
---|
| 43 | machine from bare metal to its original state if necessary.
|
---|
[1] | 44 |
|
---|
[2045] | 45 | .PP
|
---|
[1] | 46 | With
|
---|
| 47 | .BR \-O ,
|
---|
[1885] | 48 | it backs up your filesystem to CD, tape, ISO images or NFS share. Boot media
|
---|
[1] | 49 | or a special boot CD will be created to allow you to restore from bare metal if
|
---|
| 50 | necessary.
|
---|
| 51 |
|
---|
[2045] | 52 | .PP
|
---|
[1] | 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 |
|
---|
[2045] | 61 | .PP
|
---|
[2543] | 62 | Call mondoarchive
|
---|
[1] | 63 | .BR without
|
---|
[2543] | 64 | .BR flags
|
---|
[1] | 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 |
|
---|
[2045] | 68 | .PP
|
---|
[2543] | 69 | To restore data, either run
|
---|
[1] | 70 | .I mondorestore
|
---|
[1885] | 71 | from the command line or boot from the emergency media generated during
|
---|
[1] | 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
|
---|
[2543] | 80 | .BI "\-c " speed
|
---|
[1] | 81 | Use CD-R drive as backup device and its (write-once) disks as backup media.
|
---|
| 82 |
|
---|
| 83 | .TP
|
---|
[2543] | 84 | .BI "\-w " speed
|
---|
[1] | 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
|
---|
[2543] | 89 | .BI "\-r "
|
---|
[1] | 90 | Use DVD drive as backup device and its disks as backup media. Growisofs decides
|
---|
[116] | 91 | on the best speed for your drive. Note that calling mondoarchive
|
---|
| 92 | .B using sudo when writing to DVDs will fail
|
---|
[2543] | 93 | because growisofs does not support this \- see the growisofs manpage for
|
---|
[116] | 94 | details.
|
---|
[1] | 95 |
|
---|
| 96 | .TP
|
---|
[2543] | 97 | .BI "\-C " speed
|
---|
[1] | 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
|
---|
[2543] | 103 | .BI "\-p " prefix
|
---|
| 104 | Use
|
---|
| 105 | .B prefix
|
---|
[20] | 106 | to generate the name of your ISO images.
|
---|
[907] | 107 | By default, mondoarchive names images mondorescue-1.iso, mondorescue-2.iso, ...
|
---|
[2543] | 108 | Using
|
---|
| 109 | .B \-p machine
|
---|
[907] | 110 | will name your images machine-1.iso, machine-2.iso, ...
|
---|
[20] | 111 |
|
---|
| 112 | .TP
|
---|
[2543] | 113 | .BI "\-i "
|
---|
[1] | 114 | Use ISO files (CD images) as backup media. This is good for backing up your
|
---|
| 115 | system to a spare hard drive. The
|
---|
[2870] | 116 | .B \-n
|
---|
[1] | 117 | switch is a wiser choice if you plan to restore from a remote filesystem.
|
---|
| 118 |
|
---|
| 119 | .TP
|
---|
[2543] | 120 | .BI "\-n " mount
|
---|
[2380] | 121 | Use files residing on a remote share as backup media.
|
---|
[1] | 122 | .I mount
|
---|
[3280] | 123 | is the remote mount-point, e.g. 'nfs://192.168.1.3/home/nfs'
|
---|
[2224] | 124 | for my file server. If not mounted, mondoarchive will do it for you. So nice ;-)
|
---|
| 125 | If your NFS server only accept write from a backup user, you may specify it with the syntax:
|
---|
[3280] | 126 | .B nfs://user@machine/mount/path
|
---|
[2225] | 127 | and mondoarchive will try to do its best to support it.
|
---|
[2380] | 128 | Other protocols are available such as sshfs for fuse SSH based filesystem
|
---|
[3280] | 129 | mount, with the same syntax e.g. 'sshfs://user@192.168.1.3/home/nfs' and
|
---|
[3111] | 130 | smbfs (aka cifs) for SaMBa or Windows based filesystem mount.
|
---|
[3681] | 131 | .B WARNING for NFS you may want to use no_root_squash in /etc/exports eg:
|
---|
| 132 | /mnt/nfs-share 192.168.x.y(rw,sync,no_subtree_check,no_root_squash)
|
---|
[1] | 133 |
|
---|
| 134 | .TP
|
---|
[2543] | 135 | .BI "\-t "
|
---|
[1] | 136 | Use tape streamer as backup device and its tapes as backup media.
|
---|
| 137 |
|
---|
| 138 | .TP
|
---|
[2543] | 139 | .BI "\-U "
|
---|
[1762] | 140 | Use a generic USB device as backup device. Use this if you want to write
|
---|
[2543] | 141 | your backup to a USB key or USB disk, which will be make bootable.
|
---|
[2294] | 142 | The USB device should be attached to the system in order for this to work and
|
---|
[1762] | 143 | its device name passed to the
|
---|
[2543] | 144 | .BR \-d
|
---|
[2333] | 145 | option. Do not use the partition name, but the raw device name (/dev/sda e.g.)
|
---|
[1762] | 146 | .B WARNING: All the data on the related device will be removed.
|
---|
| 147 |
|
---|
| 148 | .TP
|
---|
[2543] | 149 | .BI "\-u "
|
---|
[1] | 150 | Use a generic streaming device as backup device. Use this if you want to write
|
---|
| 151 | your backup to a device that is not directly support by mondoarchive. This will
|
---|
| 152 | send the data directly to a raw device.
|
---|
| 153 | .B For experienced users only.
|
---|
| 154 |
|
---|
| 155 | .SH MAJOR OPTIONS
|
---|
| 156 | .TP 13
|
---|
[2543] | 157 | .BI "\-D "
|
---|
[1] | 158 | Make a differential backup: examine the filesystem and find which files have
|
---|
| 159 | changed since the last full backup was carried out. Backup only those files.
|
---|
| 160 |
|
---|
| 161 | .TP
|
---|
[3068] | 162 | .BI "\-E " "\*(lqdir|...\*(rq"
|
---|
| 163 | Exclude dir(s) from backup. The dirs should be separated with a pipe and surrounded by quotes.
|
---|
[2336] | 164 | This is the prefered and recommended option when doing partial archiving.
|
---|
[1] | 165 | Note that mondo automatically excludes removable media (/mnt/floppy,
|
---|
[2918] | 166 | /mnt/cdrom, /proc, /sys, /run, /tmp). For example, if you are backing up to an NFS mount but you
|
---|
[1] | 167 | do not want to include the contents of the mount in a backup, exclude your
|
---|
| 168 | local mount-point with this switch. It will also work with partitions, e.g.
|
---|
| 169 | /dev/sdd4 if you have a peculiar SCSI zip drive which insists on showing up in
|
---|
| 170 | the mountlist. NB: If you exclude /dev/sdd4 then the /dev entry itself will
|
---|
| 171 | still be backed up, even though the mountlist entry will be suppressed.
|
---|
[2543] | 172 | N.B.: If you specify a directory with a final / its content will be
|
---|
| 173 | archived so it won't do what you expect.
|
---|
| 174 | You may also specify full disk device to this option as with \-E
|
---|
[2714] | 175 | \*(lq/dev/sda|/dev/cciss/c0d0\*(rq
|
---|
[3132] | 176 | N.B.: If for example you have a disk /dev/mapper/vgsan-lvdir mounted on a /mnt mountpoint
|
---|
| 177 | excluding the /dev/mapper/vgsan-lvdir device prevents mondorestore to touch the LVM structure
|
---|
| 178 | of this device at restore time (no pv|vg|lvcreate will occur).
|
---|
| 179 | However, if you exclude the mount point /mnt, the LVM structure will be re-created at restore time.
|
---|
| 180 | ALL DATA WILL THEN BE LOST ON THIS DEVICE. Use what is required for your configuration.
|
---|
[1] | 181 |
|
---|
| 182 | .TP
|
---|
[3068] | 183 | .BI "\-I " "\*(lqdir|...\*(rq"
|
---|
| 184 | Include dirs(s) in backup. The dirs should be separated with a pipe and surrounded by quotes.
|
---|
[2835] | 185 | This option is mainly used to perform tests
|
---|
[2543] | 186 | in order to reduce the time taken by the archiving operation.
|
---|
[3068] | 187 | The default backup dir is \*(lq/\*(rq but you may specify alternatives,
|
---|
[2714] | 188 | e.g. \-I \*(lq/home|/etc\*(rq to override that.
|
---|
[2543] | 189 | You may also specify full disk device to this option as with \-I
|
---|
[2714] | 190 | \*(lq/dev/sda|/dev/cciss/c0d0\*(rq
|
---|
[2336] | 191 | N.B.: When using the
|
---|
| 192 | .BR \-I
|
---|
[2543] | 193 | option with the
|
---|
[2336] | 194 | .BR \-E
|
---|
[2543] | 195 | option, the \-E content should be subdirectories of those mentioned in
|
---|
[2870] | 196 | the \-I only, as \-I takes precedence.
|
---|
[1] | 197 |
|
---|
| 198 | .TP
|
---|
[2870] | 199 | .BI "\-J " "file"
|
---|
[791] | 200 | Specify an explicit list of files and directories to include in a plain text file, one item
|
---|
[2543] | 201 | (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.
|
---|
[1] | 202 |
|
---|
| 203 | .TP
|
---|
[2870] | 204 | .BI "\-N"
|
---|
[791] | 205 | Exclude all mounted network filesystems. This currently means NFS, SMB, Coda, MVFS, AFS
|
---|
[1488] | 206 | OCFS and Netware. In other words, only backup the local hard disk(s).
|
---|
[1] | 207 |
|
---|
| 208 | .TP
|
---|
[2870] | 209 | .BI "\-d " "dev|dir"
|
---|
[3841] | 210 | Specify the backup device (CD/tape/USB) or directory (NFS/ISO).
|
---|
| 211 | For CD-R[W] drives, this is either the SCSI node where the drive may be found, e.g. '0,1,0'. Or it can be the device file such as '/dev/sr0'.
|
---|
| 212 | For tape users, this is the tape streamers /dev entry, e.g. '/dev/st0'.
|
---|
| 213 | For USB users, this is the device name of your key or external disk.
|
---|
| 214 | For ISO users, this is the directory where the ISO images are stored.
|
---|
| 215 | For NFS users, this is the subdirectory under the NFS mount where the backups are stored.
|
---|
| 216 | The default for ISO and NFS is '/var/cache/mondo'.
|
---|
[1] | 217 |
|
---|
| 218 | .TP
|
---|
[2870] | 219 | .BI "\-g "
|
---|
[1] | 220 | GUI mode. Without this switch, the screen output of mondoarchive is suitable
|
---|
| 221 | for processing by an 'expect' wrapper, enabling the user to backup nightly via
|
---|
| 222 | a cron job. However, if you want to run this program with an attractive but
|
---|
[2543] | 223 | non-cron-friendly interface then use '\-g'.
|
---|
[1] | 224 |
|
---|
| 225 | .TP
|
---|
[2870] | 226 | .BI "\-k " "path"
|
---|
[3322] | 227 | Full path name of the kernel to use. Generally your native kernel should be
|
---|
| 228 | found and work appropriately. Otherwise, you may use this option to point to
|
---|
| 229 | another one. E.g. '\-k /boot/myvmlinuz'.
|
---|
[1] | 230 |
|
---|
| 231 | .TP
|
---|
[2870] | 232 | .BI "\-m "
|
---|
[1] | 233 | Manual (not self-retracting) CD trays are often found on laptops. If you are
|
---|
[2543] | 234 | a laptop user, your CD burner has BurnProof technology or you experience
|
---|
| 235 | problems with mondo then please call mondoarchive with this switch.
|
---|
[1] | 236 |
|
---|
| 237 | .TP
|
---|
[2870] | 238 | .BI "\-o "
|
---|
[1948] | 239 | Use OBDR (One Button Disaster Recovery) type of tapes.
|
---|
| 240 | By default, tapes are not bootable. With this flag, tape will be made bootable
|
---|
| 241 | following the OBDR format.
|
---|
[1] | 242 |
|
---|
| 243 | .TP
|
---|
[2870] | 244 | .BI "\-s " "size"
|
---|
[1] | 245 | How much can each of your backup media hold? You may use 'm' and 'g' on the end
|
---|
| 246 | of the number, e.g. '700m' for an extra-large CD-R. You no longer need to
|
---|
| 247 | specify the size of your cartridges if you are backing up to tape.
|
---|
| 248 |
|
---|
| 249 | .TP
|
---|
[2870] | 250 | .BI "\-x " "'dev ...'"
|
---|
[1] | 251 | Specify non-Linux partitions which you want to backup, e.g. NTFS or BeOS.
|
---|
| 252 |
|
---|
| 253 |
|
---|
| 254 | .SH MINOR OPTIONS
|
---|
| 255 | .TP 13
|
---|
[2870] | 256 | .BI "\-[0-9] "
|
---|
[1] | 257 | Specify the compression level. Default is 3. No compression is 0.
|
---|
| 258 |
|
---|
| 259 | .TP
|
---|
[2870] | 260 | .BI "\-A " "command"
|
---|
[1] | 261 | This command will be called after each CD/NFS/ISO file is written. It is useful
|
---|
| 262 | if you want to do something with an ISO after creating it, e.g. write it to a
|
---|
| 263 | CD burner using a non-standard command.
|
---|
[2870] | 264 | .B \-A
|
---|
[2543] | 265 | understands two tokens \- _ISO_ and _CD#_ - which will be translated into the
|
---|
[1] | 266 | ISO's filename and its index number (1, 2, ...) respectively. So, you could use
|
---|
[2543] | 267 | .I \-A 'foobackup _ISO_; rm \-f _ISO_'
|
---|
[1] | 268 | to feed each ISO to some magical new backup tool.
|
---|
| 269 |
|
---|
| 270 | .TP
|
---|
| 271 | .BI "-B " "command"
|
---|
| 272 | This command will be called before each CD/NFS/ISO file is written. See
|
---|
[2543] | 273 | .B \-A
|
---|
[1] | 274 | for more information.
|
---|
| 275 |
|
---|
| 276 | .TP
|
---|
[3141] | 277 | .BI "\-F "
|
---|
| 278 | Do not retry when a command failed but just exits. This is useful for an
|
---|
| 279 | automated mode launched from cron where you want to avoid filling your logs
|
---|
| 280 | due to an answer which is impossible to give.
|
---|
| 281 |
|
---|
| 282 | .TP
|
---|
[3138] | 283 | .BI "\-G "
|
---|
| 284 | Use gzip, the standard and quicker Linux compression engine, instead of bzip2.
|
---|
| 285 |
|
---|
| 286 | .TP
|
---|
[2870] | 287 | .BI "\-H "
|
---|
[1] | 288 | When you boot from the tape/CD, your hard drive will be wiped and the archives
|
---|
| 289 | will be restored. Your decision to boot from the tape/CD will be taken as
|
---|
| 290 | consent. No further permission will be sought.
|
---|
| 291 | .B Use with caution.
|
---|
| 292 |
|
---|
| 293 | .TP
|
---|
[2870] | 294 | .BI "\-L "
|
---|
[1] | 295 | Use lzo, a fast compression engine, instead of bzip2. You may find lzo on
|
---|
| 296 | Mondo's website or via FreshMeat. WARNING! Some versions of LZO are unstable.
|
---|
| 297 |
|
---|
| 298 | .TP
|
---|
[3138] | 299 | .BI "\-M " "max-size"
|
---|
| 300 | Gives the maximum size of a biggie file (by default 64 MB). The value should
|
---|
| 301 | be given in kB. Example use \-M 128000 to have biggie being more than 128 MB.
|
---|
[998] | 302 |
|
---|
| 303 | .TP
|
---|
[3202] | 304 | .BI "\-Y "
|
---|
| 305 | Use lzma, the new quicker and optimized Linux compression engine, instead of bzip2.
|
---|
| 306 |
|
---|
| 307 | .TP
|
---|
[2870] | 308 | .BI "\-R "
|
---|
[3138] | 309 | Star is an alternative to afio. Can be useful for distributions considering
|
---|
| 310 | that afio is not free enough due to its age and old licenses (wrongly in our
|
---|
| 311 | opinion). Star can be used to have a better support of sparse file compared to
|
---|
[3248] | 312 | afio. Also star supports natively POSIX ACLs, whereas afio requires a special
|
---|
[3138] | 313 | additional handlling.
|
---|
[1] | 314 |
|
---|
| 315 | .TP
|
---|
[2870] | 316 | .BI "\-P " "tarball"
|
---|
[1] | 317 | Post-nuke tarball. If you boot into Nuke Mode and everything is restored
|
---|
[2543] | 318 | successfully then the
|
---|
[1] | 319 | .I post-nuke
|
---|
| 320 | script will be sought and executed if found. This is useful for post-restore
|
---|
| 321 | customization. It is assumed that the tarball (.tar.gz format) will contain not
|
---|
| 322 | just the
|
---|
| 323 | .I post-nuke
|
---|
[2543] | 324 | script (or binary, or whatever it is) but also any files it requires.
|
---|
[1] | 325 |
|
---|
| 326 | .TP
|
---|
[2870] | 327 | .BI "\-S " "path"
|
---|
[2543] | 328 | Specify the full pathname of the scratchdir, the directory where ISO
|
---|
| 329 | images are built before being archived. If you have plenty of RAM and
|
---|
| 330 | want to use a ramdisk for scratch space, specify its path here.
|
---|
[1] | 331 |
|
---|
| 332 | .TP
|
---|
[2870] | 333 | .BI "\-T " "path"
|
---|
[2543] | 334 | Specify the full pathname of the tempdir, the directory where temporary
|
---|
| 335 | files (other than ISO images being assembled) are stored. See
|
---|
| 336 | .B \-S
|
---|
[1] | 337 |
|
---|
| 338 | .TP
|
---|
[2870] | 339 | .BI "\-W "
|
---|
[1] | 340 | Don't make your backup self-booting. This is a really bad idea, IMO. Don't do
|
---|
| 341 | this unless you have really great boot disks in your hand and you are an anally
|
---|
| 342 | retentive SOB who can't wait 2 minutes for Mindi to run in the background. If
|
---|
[2543] | 343 | you use \-W then you'd better know what the hell you're doing, okay?
|
---|
[1] | 344 |
|
---|
| 345 | .TP
|
---|
[2870] | 346 | .BI "\-b "
|
---|
[1] | 347 | Specify the internal block size used by the tape drive. This is usually 32K but
|
---|
| 348 | some drives just don't like that. They should but they don't. That's what
|
---|
| 349 | happens when tape drive vendors don't talk to kernel driver writers. Try 512 or
|
---|
| 350 | 16384.
|
---|
| 351 |
|
---|
| 352 | .TP
|
---|
[2870] | 353 | .BI "\-e "
|
---|
[1967] | 354 | Don't eject the CD or tape when backing up...
|
---|
[1] | 355 |
|
---|
| 356 | .TP
|
---|
[2870] | 357 | .BI "\-f " "device"
|
---|
[1] | 358 | Specify the drive on which your Master Boot Record lives. Usually, this is
|
---|
[2492] | 359 | discovered automatically. A good use case may be when you have software RAID.
|
---|
[1] | 360 |
|
---|
| 361 | .TP
|
---|
[2870] | 362 | .BI "\-l " "GRUB|LILO|ELILO|RAW"
|
---|
[3429] | 363 | Specify the boot loader. By default, your environment is examined and
|
---|
[1] | 364 | the boot loader can usually be discovered. If you specify RAW then the MBR will
|
---|
| 365 | be backed up and restored byte-for-byte without any analysis. It is likely that
|
---|
[2543] | 366 | you will also need to specify the boot device with \-f <dev>. ELILO is mandatory
|
---|
[3429] | 367 | for IA64 machines. GRUB is mandatory for now for UEFI systems.
|
---|
[1] | 368 |
|
---|
| 369 | .TP
|
---|
[2870] | 370 | .BI "\-Q "
|
---|
[1] | 371 | Give more detailed information about the boot loader.
|
---|
| 372 |
|
---|
| 373 | .TP
|
---|
[2870] | 374 | .BI "\-K " "loglevel"
|
---|
[907] | 375 | Specify the loglevel. Use 99 for full debug. Standard debug level is 4.
|
---|
[1] | 376 |
|
---|
[948] | 377 | .TP
|
---|
[2870] | 378 | .BI "\-v "
|
---|
[2752] | 379 | Gives mondoarchive version.
|
---|
| 380 |
|
---|
| 381 | .TP
|
---|
[2870] | 382 | .BI "\-z "
|
---|
[2543] | 383 | Use extended attributes and acl for each file and store them in the
|
---|
| 384 | backup media. Use this option if you use SElinux e.g. but it will slow
|
---|
| 385 | down backup and restore time of course.
|
---|
[1] | 386 |
|
---|
[948] | 387 |
|
---|
[1] | 388 | .SH DIAGNOSTICS
|
---|
[1315] | 389 | Mondo generates one additional, and extremely important file:
|
---|
[2543] | 390 | .BI /var/log/mondoarchive.log.
|
---|
| 391 | When seeking technical support, attach this file to your email.
|
---|
[1] | 392 |
|
---|
| 393 |
|
---|
| 394 | .SH FILES
|
---|
[1315] | 395 | .IR /var/log/mondoarchive.log
|
---|
[1] | 396 | This log contains important information required to analyse mondoarchive
|
---|
[1315] | 397 | problem reports. Did I already said that it's highly recommended to send this file with
|
---|
[1] | 398 | support questions.
|
---|
| 399 |
|
---|
[2897] | 400 | .SH ENVIRONMENT VARIABLES
|
---|
| 401 | .IR ARCH
|
---|
| 402 | This variable is passed to the environment by mondoarchive so that
|
---|
[3371] | 403 | other tools are aware of the underlying hardware architecture.
|
---|
[2543] | 404 |
|
---|
[2897] | 405 | .IR MONDO_SHARE
|
---|
| 406 | This variable is passed to the environment by mondoarchive so that
|
---|
| 407 | mindi is aware that it's called from it and act accordingly. It contains
|
---|
| 408 | the shared directory for the mondo package.
|
---|
| 409 |
|
---|
| 410 | .IR PATH
|
---|
| 411 | This variable is modified internally by mondoarchive so that /sbin:/usr/sbin:/usr/local/sbin
|
---|
| 412 | are appended to it systematically in order to find the required tools.
|
---|
| 413 |
|
---|
| 414 | .IR TMPDIR
|
---|
[3155] | 415 | This variable is used, if defined, as the target directory to create
|
---|
[2897] | 416 | all the temporary files needed during the operation (not the scratch files)
|
---|
| 417 |
|
---|
[3155] | 418 | .IR MRTMP
|
---|
| 419 | This variable is used, if defined and if TMPDIR is not defined, as the target
|
---|
| 420 | directory to create all the temporary files needed during the operation
|
---|
[2897] | 421 | (not the scratch files)
|
---|
| 422 |
|
---|
[3155] | 423 | With none of these variables defined, nor the -T option on the CLI then
|
---|
| 424 | /tmp is used for temporary files.
|
---|
| 425 |
|
---|
| 426 | .IR MRSCRATCH
|
---|
| 427 | This variable is used, if defined, as the target directory to create all the
|
---|
| 428 | scratch files needed during the operation such as the archives (not the temp
|
---|
| 429 | files). If this variable is not defined, /tmp is used for scratch files if
|
---|
| 430 | using the CLI without -S option specified, and the largest partition available
|
---|
| 431 | is proposed in the GUI if that one is used.
|
---|
| 432 |
|
---|
[1] | 433 | .SH NOTES
|
---|
[2543] | 434 | A link to Mondo's HTML-based manual (by Bruno Cornec, Mikael Hultgren,
|
---|
| 435 | Cafeole, Randy Delphs, Stan Benoit, and Hugo Rabson) may be found at
|
---|
[399] | 436 | .I http://www.mondorescue.org/docs.shtml
|
---|
[2543] | 437 | \- or in
|
---|
[1] | 438 | .I /usr/share/doc/mondo-x.xx
|
---|
| 439 | on your hard drive.
|
---|
| 440 |
|
---|
| 441 | .SH BUGS
|
---|
| 442 | It is recommend that your system has more than 64 MB ram. SCSI device order
|
---|
| 443 | change with nuke can have unexpected results. It is recommended you use expert
|
---|
[2543] | 444 | mode with drastic hardware reconfigurations.
|
---|
[1] | 445 |
|
---|
| 446 | .SH EXAMPLES
|
---|
| 447 |
|
---|
| 448 | .BI ISO:
|
---|
| 449 | Backup to a directory; note that /mnt/foo's contents will be backed up except
|
---|
[2543] | 450 | for its ISO's unless you exclude it, as follows:
|
---|
[1] | 451 | .br
|
---|
[2835] | 452 | .I "mondoarchive -Oi -d /mnt/foo -E '/mnt/foo|/mnt/foo2' -p \`hostname\`-\`date +%Y-%m-%d\`"
|
---|
[1] | 453 |
|
---|
| 454 | Backup to ISO's non-interactively, e.g. as a job running in /etc/cron.daily:
|
---|
| 455 | .br
|
---|
[954] | 456 | .I "mkdir -p /bkp/\`date +%A\`; mondoarchive -Oi -9 -d /bkp/\`date +%A\` -E /bkp"
|
---|
[1] | 457 |
|
---|
| 458 | .BI DVD:
|
---|
[3653] | 459 | Backup machine using DVD Media:
|
---|
[1] | 460 | .br
|
---|
[570] | 461 | .I "mondoarchive -OVr -d /dev/scd0 -gF -s 4480m"
|
---|
[1] | 462 |
|
---|
| 463 | .BI TAPE:
|
---|
| 464 | Backup to tape, using lzo compression (WARNING - can be unstable):
|
---|
| 465 | .br
|
---|
| 466 | .I "mondoarchive -Ot -d /dev/st0 -L"
|
---|
| 467 |
|
---|
| 468 | Verify existing tape backup which was made with lzo compression:-
|
---|
| 469 | .br
|
---|
| 470 | .I "mondoarchive -Vt -d /dev/st0 -L -g"
|
---|
| 471 |
|
---|
| 472 | Backup to tape, using max compression:
|
---|
| 473 | .br
|
---|
| 474 | .I "mondoarchive -Ot -9 -d /dev/st0 "
|
---|
| 475 |
|
---|
| 476 | .BI CD-R:
|
---|
| 477 | Backup to 700MB CD-R disks using a 16x CD burner:
|
---|
| 478 | .br
|
---|
| 479 | .I "mondoarchive -Oc 16 -s 700m -g"
|
---|
| 480 |
|
---|
| 481 | Verify existing CD-R or CD-RW backup (works for either):-
|
---|
| 482 | .br
|
---|
| 483 | .I "mondoarchive -Vc 16"
|
---|
| 484 |
|
---|
| 485 | .BI CD-RW:
|
---|
| 486 | Backup to 650MB CD-RW disks using a 4x CD ReWriter:
|
---|
| 487 | .br
|
---|
| 488 | .I "mondoarchive -Ow 4"
|
---|
| 489 |
|
---|
| 490 | Backup just your /home and /etc directory to 650MB CD-RW disks using a 4x CD
|
---|
| 491 | ReWriter:
|
---|
| 492 | .br
|
---|
[2835] | 493 | .I "mondoarchive -Ow 4 -I \*(lq/home|/etc\*(rq"
|
---|
[1] | 494 |
|
---|
| 495 | .BI NFS:
|
---|
| 496 | Backup to an NFS mount:
|
---|
| 497 | .br
|
---|
[3280] | 498 | .I "mondoarchive -On nfs://192.168.1.2/home/nfs -d /Monday -E /mnt/nfs"
|
---|
[1] | 499 |
|
---|
| 500 | Verify existing NFS backup:-
|
---|
| 501 | .br
|
---|
[3280] | 502 | .I "mondoarchive -Vn nfs://192.168.1.2/home/nfs -d /Monday"
|
---|
[1] | 503 |
|
---|
[1762] | 504 | .BI USB:
|
---|
[2902] | 505 | Backup to your 4GB USB key, using gzip compression:
|
---|
[1762] | 506 | .br
|
---|
[2902] | 507 | .I "mondoarchive -OU -d /dev/sda -s 4g -G"
|
---|
[1762] | 508 |
|
---|
[1] | 509 | .BI RAID:
|
---|
[3653] | 510 | Backup machine to a Software Raid mount point, iso size 700mb:
|
---|
[1] | 511 | .br
|
---|
[2543] | 512 | .I "mondoarchive -O -s 700m -d /mnt/raid"
|
---|
[1] | 513 |
|
---|
| 514 |
|
---|
| 515 | .SH "SEE ALSO"
|
---|
[175] | 516 | afio(1), bzip2(1), find(1), mindi(8), mondorestore(8).
|
---|
[1] | 517 | .SH AUTHORS
|
---|
[2543] | 518 | Bruno Cornec (lead-development)
|
---|
[569] | 519 | .I "bruno_at_mondorescue.org"
|
---|
[1] | 520 | .br
|
---|
[2543] | 521 | Andree Leidenfrost (co-developer)
|
---|
[399] | 522 | .I "aleidenf_at_bigpond.net.au"
|
---|
[175] | 523 | .br
|
---|
[399] | 524 | .SH ORIGINAL AUTHORS
|
---|
| 525 | Hugo Rabson (original author)
|
---|
| 526 | .I "hugo.rabson_at_mondorescue.org"
|
---|
[175] | 527 | .br
|
---|
| 528 | Jesse Keating (original RPM packager)
|
---|
[399] | 529 | .I "hosting_at_j2solutions.net"
|
---|
[1] | 530 | .br
|
---|
| 531 | Stan Benoit (testing)
|
---|
[399] | 532 | .I "troff_at_nakedsoul.org"
|
---|
[1] | 533 | .br
|
---|
| 534 | Mikael Hultgren (docs)
|
---|
[399] | 535 | .I "mikael_hultgren_at_gmx.net"
|
---|
[1] | 536 | .br
|
---|
[116] | 537 | See mailing list at http://www.mondorescue.org for technical support.
|
---|