Changeset 2546 in MondoRescue for branches/2.2.10/mondo-doc/mondoarchive.8


Ignore:
Timestamp:
Jan 21, 2010, 8:50:00 PM (14 years ago)
Author:
Bruno Cornec
Message:

svn merge -r 2523:2545 /mondorescue/branches/2.2.9

  • Adds the --rescue flag to ntfsclone (Andree Leidenfrost andree_at_debian.org)
  • Fix 2 typos in the HOWTO (reported by Bram Mertens bram-mertens_at_linux.be)
  • Patch from Rogério Brito rbrito_at_ime.usp.br which fixes errors in man pages format
  • Fix syntax issue in analyze-my-lvm
  • Better doc for pre and post
  • Finally the function ListLvmDrivesAndPartitions is used, as it creates info parsed by mindi !! So reverting back to filter excluded devices in it
  • Better exclusion of the LVs from the mountlist at restore time if excludedevs used
  • Exclude LVs whose VGs are excluded now in analyze-my-lvm
  • First attempt to support device exclusion at restore time through a new boot param excludedevs
  • Fix a bug preventing execution of the pre script in init
  • LVM exclusion based on devices was flawed as the function targeted was not really useful. That script shold be fully rewritten to have a data structure contaiing what is needed. Anyway the current patch should allow to have some improvements
  • Do not report Duplicate mount point when lvm is used
  • each device of the EXCLUDE_DEVS list is now used correctly and partitions found on this device are excluded
  • Fix the way the dsf is declared in the linked list to have it work
  • Fix #383 by using pvdisplay instead of relying on 8e as partition type
  • Try to fix #384 by always excluding the dfs per users wish
  • Also use the exclude dev feature in case of multipath and exclude resulting /dev/mapper/mpath type of files
  • Fix #381 by postfixing spaces at the end of the strings to be cheked in strstr
File:
1 edited

Legend:

Unmodified
Added
Removed

  • branches/2.2.10/mondo-doc/mondoarchive.8

    r2508 r2546  
    2525
    2626.SH SYNOPSIS
    27 .B mondoarchive -O
     27.B mondoarchive \-O
    2828[
    2929.I options
    3030] : backup your PC
    3131.br
    32 .B mondoarchive -V
     32.B mondoarchive \-V
    3333[
    3434.I options
    … …  
    4141non-Linux filesystems to CD's, tape, ISO images or an NFS mount. In the event of
    4242catastrophic data loss, you will be able to restore everything, taking a PC from
    43 bare metal to its original state if necessary. 
     43bare metal to its original state if necessary.
    4444
    4545.PP
    … …  
    6060
    6161.PP
    62 Call mondoarchive 
     62Call mondoarchive
    6363.BR without
    64 .BR flags 
     64.BR flags
    6565to make it auto-detect as many settings as possible, ask you politely for the
    6666rest, and then backup and verify your OS or a subset thereof.
    6767
    6868.PP
    69 To restore data, either run 
     69To restore data, either run
    7070.I mondorestore
    7171from the command line or boot from the emergency media generated during
    … …  
    7878
    7979.TP
    80 .BI "-c " speed
     80.BI "\-c " speed
    8181Use CD-R drive as backup device and its (write-once) disks as backup media.
    8282
    8383.TP
    84 .BI "-w " speed
     84.BI "\-w " speed
    8585Use CD-RW drive as backup device and its (write/rewrite) disks as backup media.
    8686Mondo will wipe media before writing to them.
    8787
    8888.TP
    89 .BI "-r "
     89.BI "\-r "
    9090Use DVD drive as backup device and its disks as backup media. Growisofs decides
    9191on the best speed for your drive. Note that calling mondoarchive
    9292.B using sudo when writing to DVDs will fail
    93 because growisofs does not support this - see the growisofs manpage for
     93because growisofs does not support this \- see the growisofs manpage for
    9494details.
    9595
    9696.TP
    97 .BI "-C " speed
     97.BI "\-C " speed
    9898Use CD-R drive as a streaming device, almost like a tape streamer. Use
    9999write-once disks as backup media.
    … …  
    101101
    102102.TP
    103 .BI "-p " prefix
    104 Use 
    105 .B prefix 
     103.BI "\-p " prefix
     104Use
     105.B prefix
    106106to generate the name of your ISO images.
    107107By default, mondoarchive names images mondorescue-1.iso, mondorescue-2.iso, ...
    108 Using 
    109 .B -p machine
     108Using
     109.B \-p machine
    110110will name your images machine-1.iso, machine-2.iso, ...
    111111
    112112.TP
    113 .BI "-i "
     113.BI "\-i "
    114114Use ISO files (CD images) as backup media. This is good for backing up your
    115115system to a spare hard drive. The
    … …  
    118118
    119119.TP
    120 .BI "-n " mount
     120.BI "\-n " mount
    121121Use files residing on a remote share as backup media.
    122122.I mount
    … …  
    130130
    131131.TP
    132 .BI "-t "
     132.BI "\-t "
    133133Use tape streamer as backup device and its tapes as backup media.
    134134
    135135.TP
    136 .BI "-U "
     136.BI "\-U "
    137137Use a generic USB device as backup device. Use this if you want to write
    138 your backup to a USB key or USB disk, which will be make bootable. 
     138your backup to a USB key or USB disk, which will be make bootable.
    139139The USB device should be attached to the system in order for this to work and
    140140its device name passed to the
    141 .BR \-d 
     141.BR \-d
    142142option. Do not use the partition name, but the raw device name (/dev/sda e.g.)
    143143.B WARNING: All the data on the related device will be removed.
    144144
    145145.TP
    146 .BI "-u "
     146.BI "\-u "
    147147Use a generic streaming device as backup device. Use this if you want to write
    148148your backup to a device that is not directly support by mondoarchive. This will
    … …  
    152152.SH MAJOR OPTIONS
    153153.TP 13
    154 .BI "-D "
     154.BI "\-D "
    155155Make a differential backup: examine the filesystem and find which files have
    156156changed since the last full backup was carried out. Backup only those files.
    157157
    158158.TP
    159 .BI "-E " "\*(lqpath ...\*(rq"
     159.BI "\-E " "\*(lqpath ...\*(rq"
    160160Exclude path(s) from backup. The paths should be separated with a whitespace and surrounded by quotes.
    161161This is the prefered and recommended option when doing partial archiving.
    … …  
    167167the mountlist. NB: If you exclude /dev/sdd4 then the /dev entry itself will
    168168still be backed up, even though the mountlist entry will be suppressed.
    169 N.B.: If you specify a directory with a final / its content will be archived so it won't do what you expect.
    170 You may also specify full disk device to this option as with -E \*(lq/dev/sda /dev/cciss/c0d0\*(rq
     169N.B.: If you specify a directory with a final / its content will be
     170archived so it won't do what you expect.
     171You may also specify full disk device to this option as with \-E
     172\*(lq/dev/sda /dev/cciss/c0d0\*(rq
    171173
    172174.TP
    173175.BI "-I " "\*(lqpath ...\*(rq"
    174 Include paths(s) in backup. This option is mainly use to perform tests in order to reduce the time taken by the archiving operation.
    175 The default backup path is \*(lq/\*(rq but you may specify alternatives, e.g. -I \*(lq/home /etc\*(rq to override that.
    176 You may also specify full disk device to this option as with -I \*(lq/dev/sda /dev/cciss/c0d0\*(rq
     176Include paths(s) in backup. This option is mainly use to perform tests
     177in order to reduce the time taken by the archiving operation.
     178The default backup path is \*(lq/\*(rq but you may specify alternatives,
     179e.g. \-I \*(lq/home /etc\*(rq to override that.
     180You may also specify full disk device to this option as with \-I
     181\*(lq/dev/sda /dev/cciss/c0d0\*(rq
    177182N.B.: When using the
    178183.BR \-I
    179 option with the 
     184option with the
    180185.BR \-E
    181 option, the -E content should be subdirectories of those mentioned in the -I only, as -I takes precedence.
     186option, the \-E content should be subdirectories of those mentioned in
     187the \-I only, as -I takes precedence.
    182188
    183189.TP
    184190.BI "-J " "file"
    185191Specify an explicit list of files and directories to include in a plain text file, one item
    186 (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.
     192(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.
    187193
    188194.TP
    … …  
    206212for processing by an 'expect' wrapper, enabling the user to backup nightly via
    207213a cron job. However, if you want to run this program with an attractive but
    208 non-cron-friendly interface then use '-g'.
     214non-cron-friendly interface then use '\-g'.
    209215
    210216.TP
    211217.BI "-k " "path"
    212 Path of user's kernel, if you want to use another one than the running one.
     218Path of user's kernel. If you are a Debian (<3.0) or Gentoo (<1.4) user then specify
     219.B \-k FAILSAFE
     220as your kernel. Otherwise, you will rarely need this option.
    213221
    214222.TP
    215223.BI "-m "
    216224Manual (not self-retracting) CD trays are often found on laptops. If you are
    217 a laptop user, your CD burner has BurnProof technology or you experience 
    218 problems with mondo then please call mondoarchive with this switch. 
     225a laptop user, your CD burner has BurnProof technology or you experience
     226problems with mondo then please call mondoarchive with this switch.
    219227
    220228.TP
    … …  
    246254CD burner using a non-standard command.
    247255.B -A
    248 understands two tokens - _ISO_ and _CD#_ - which will be translated into the
     256understands two tokens \- _ISO_ and _CD#_ - which will be translated into the
    249257ISO's filename and its index number (1, 2, ...) respectively. So, you could use
    250 .I -A 'foobackup _ISO_; rm -f _ISO_'
     258.I \-A 'foobackup _ISO_; rm \-f _ISO_'
    251259to feed each ISO to some magical new backup tool.
    252260
    … …  
    254262.BI "-B " "command"
    255263This command will be called before each CD/NFS/ISO file is written. See
    256 .B -A
     264.B \-A
    257265for more information.
    258266
    … …  
    279287.TP
    280288.BI "-R "
    281 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.
     289EXPERIMENTAL. Do not use in mission-critical environments. Star is an
     290alternative to afio. Mondo now supports POSIX ACLs and extended
     291attributes, so \-R is essentially redundant for now.
    282292
    283293.TP
    284294.BI "-P " "tarball"
    285295Post-nuke tarball. If you boot into Nuke Mode and everything is restored
    286 successfully then the 
     296successfully then the
    287297.I post-nuke
    288298script will be sought and executed if found. This is useful for post-restore
    … …  
    290300just the
    291301.I post-nuke
    292 script (or binary, or whatever it is) but also any files it requires. 
     302script (or binary, or whatever it is) but also any files it requires.
    293303
    294304.TP
    295305.BI "-S " "path"
    296 Specify the full pathname of the scratchdir, the directory where ISO images are built before being
    297 archived. If you have plenty of RAM and want to use a ramdisk for scratch
    298 space, specify its path here.
     306Specify the full pathname of the scratchdir, the directory where ISO
     307images are built before being archived. If you have plenty of RAM and
     308want to use a ramdisk for scratch space, specify its path here.
    299309
    300310.TP
    301311.BI "-T " "path"
    302 Specify the full pathname of the tempdir, the directory where temporary files (other than ISO images
    303 being assembled) are stored. See
    304 .B -S
     312Specify the full pathname of the tempdir, the directory where temporary
     313files (other than ISO images being assembled) are stored. See
     314.B \-S
    305315
    306316.TP
    … …  
    309319this unless you have really great boot disks in your hand and you are an anally
    310320retentive SOB who can't wait 2 minutes for Mindi to run in the background. If
    311 you use -W then you'd better know what the hell you're doing, okay?
     321you use \-W then you'd better know what the hell you're doing, okay?
    312322
    313323.TP
    … …  
    332342the boot loader can usually be discovered. If you specify RAW then the MBR will
    333343be backed up and restored byte-for-byte without any analysis. It is likely that
    334 you will also need to specify the boot device with -f <dev>. ELILO is mandatory
     344you will also need to specify the boot device with \-f <dev>. ELILO is mandatory
    335345for IA64 machines.
    336346
    … …  
    345355.TP
    346356.BI "-z "
    347 Use 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.
     357Use extended attributes and acl for each file and store them in the
     358backup media. Use this option if you use SElinux e.g. but it will slow
     359down backup and restore time of course.
    348360
    349361
    350362.SH DIAGNOSTICS
    351363Mondo generates one additional, and extremely important file:
    352 .BI /var/log/mondoarchive.log.
    353 When seeking technical support, attach this file to your email.
    354 
     364.BI /var/log/mondoarchive.log.
     365When seeking technical support, attach this file to your email.
    355366
    356367
    … …  
    361372support questions.
    362373
     374
    363375.SH NOTES
    364 A link to Mondo's HTML-based manual (by Bruno Cornec, Mikael Hultgren, Cafeole, Randy Delphs,
    365 Stan Benoit, and Hugo Rabson) may be found at
     376A link to Mondo's HTML-based manual (by Bruno Cornec, Mikael Hultgren,
     377Cafeole, Randy Delphs, Stan Benoit, and Hugo Rabson) may be found at
    366378.I http://www.mondorescue.org/docs.shtml
    367 - or in
     379\- or in
    368380.I /usr/share/doc/mondo-x.xx
    369381on your hard drive.
    … …  
    372384It is recommend that your system has more than 64 MB ram. SCSI device order
    373385change with nuke can have unexpected results. It is recommended you use expert
    374 mode with drastic hardware reconfigurations. 
     386mode with drastic hardware reconfigurations.
    375387
    376388.SH EXAMPLES
    … …  
    378390.BI ISO:
    379391Backup to a directory; note that /mnt/foo's contents will be backed up except
    380 for its ISO's unless you exclude it, as follows:-
     392for its ISO's unless you exclude it, as follows:
    381393.br
    382394.I "mondoarchive -Oi -d /mnt/foo -E '/mnt/foo /mnt/foo2' -p \`hostname\`-\`date +%Y-%m-%d\`"
    … …  
    440452Backup PC to a Software Raid mount point, iso size 700mb:
    441453.br
    442 .I "mondoarchive -O -s 700m -d /mnt/raid" 
     454.I "mondoarchive -O -s 700m -d /mnt/raid"
    443455
    444456
    … …  
    446458afio(1), bzip2(1), find(1), mindi(8), mondorestore(8).
    447459.SH AUTHORS
    448 Bruno Cornec (lead-development) 
     460Bruno Cornec (lead-development)
    449461.I "bruno_at_mondorescue.org"
    450462.br
    451 Andree Leidenfrost (co-developer) 
     463Andree Leidenfrost (co-developer)
    452464.I "aleidenf_at_bigpond.net.au"
    453465.br
    … …  
    466478.br
    467479See mailing list at http://www.mondorescue.org for technical support.
    468 .
Note: See TracChangeset for help on using the changeset viewer.