mondoarchive(8)                                                mondoarchive(8)



NNAAMMEE
       mondoarchive - a backup / disaster-recovery tool.


SSYYNNOOPPSSIISS
       mmoonnddooaarrcchhiivvee --OO [ _o_p_t_i_o_n_s ] : backup your PC
       mmoonnddooaarrcchhiivvee --VV [ _o_p_t_i_o_n_s ] : verify your backup


DDEESSCCRRIIPPTTIIOONN
       _m_o_n_d_o_a_r_c_h_i_v_e  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.


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


       With  --VV,  it  verifies  the  backup  against the live filesystem. This
       option may be used in combination with --O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.


       Call mondoarchive wwiitthhoouutt ffllaaggss to make it auto-detect as many settings
       as  possible, ask you politely for the rest, and then backup and verify
       your OS or a subset thereof.


       To restore data, either run _m_o_n_d_o_r_e_s_t_o_r_e from the command line or  boot
       from  the emergency media generated during the backup process. The lat-
       ter will come in handy if a gremlin wipes your hard disk.


BBAACCKKUUPP MMEEDDIIAA
       You must specify one of the following:-


       --cc _s_p_e_e_d     Use CD-R drive as backup device and its (write-once) disks
                    as backup media.


       --ww _s_p_e_e_d     Use  CD-RW  drive as backup device and its (write/rewrite)
                    disks as backup media.  Mondo will wipe media before writ-
                    ing to them.


       --rr           Use  DVD  drive  as  backup device and its disks as backup
                    media. Growisofs decides on the best speed for your drive.
                    Note  that calling mondoarchive uussiinngg ssuuddoo wwhheenn wwrriittiinngg ttoo
                    DDVVDDss wwiillll ffaaiill because growisofs does not support  this  -
                    see the growisofs manpage for details.


       --CC _s_p_e_e_d     Use  CD-R  drive as a streaming device, almost like a tape
                    streamer. Use write-once disks as backup  media.   EExxppeerrii--
                    mmeennttaall..


       --pp _p_r_e_f_i_x    Use  pprreeffiixx  to  generate the name of your ISO images.  By
                    default, mondoarchive names images mondorescue-1.iso, mon-
                    dorescue-2.iso,  ...   Using  --pp  mmaacchhiinnee  will  name your
                    images machine-1.iso, machine-2.iso, ...


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


       --nn _m_o_u_n_t     Use  files  residing  on  NFS  partition  as backup media.
                    _m_o_u_n_t     is     the     remote     mount-point,      e.g.
                    '192.168.1.3:/home/nfs'  for  my file server. Please mount
                    it before backing up/verifying.


       --tt           Use tape streamer as backup device and its tapes as backup
                    media.


       --UU           Use a generic USB device as backup device. Use this if you
                    want to write your backup to a USB key or USB disk,  which
                    will  be make bootable.  The USB device should be attached
                    to the system ir order for this to  work  and  its  device
                    name  passed  to  the --dd option.  WWAARRNNIINNGG:: AAllll tthhee ddaattaa oonn
                    tthhee rreellaatteedd ddeevviiccee wwiillll bbee rreemmoovveedd..


       --uu           Use a generic streaming device as backup device. Use  this
                    if  you  want to write your backup to a device that is not
                    directly support by mondoarchive. This will send the  data
                    directly to a raw device.  FFoorr eexxppeerriieenncceedd uusseerrss oonnllyy..


MMAAJJOORR OOPPTTIIOONNSS
       --D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.


       --EE _"_p_a_t_h _._._._"
                    Exclude path(s) from backup. The paths should be separated
                    with a whitespace.  Note that mondo automatically excludes
                    removable  media  (/mnt/floppy,  /mnt/cdrom,  /proc, /sys,
                    /tmp). 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  mount-point  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.  N.B.: If
                    you specify a directory with a final / its content will be
                    archived  so  it  won't  do what you expect.  You may also
                    specify full  disk  device  to  this  option  as  with  -E
                    "/dev/sda /dev/cciss/c0d0"


       --II _"_p_a_t_h _._._._"
                    Include paths(s) in backup. The default backup path is "/"
                    but you may specify alternatives, e.g. -I "/home /etc"  to
                    override  that.   You may also specify full disk device to
                    this option as with -I "/dev/sda /dev/cciss/c0d0"


       --JJ _f_i_l_e      Specify an explicit  list  of  files  and  directories  to
                    include in a plain text file, one item (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.


       --NN           Exclude all mounted network  filesystems.  This  currently
                    means NFS, SMB, Coda, MVFS, AFS OCFS and Netware. In other
                    words, only backup the local hard disk(s).


       --dd _d_e_v_|_d_i_r   Specify  the  backup  device  (CD/tape/USB)  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 streamers /dev entry, e.g. '/dev/st0'. For USB
                    users, this is the device name of  your  key  or  external
                    disk.  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 '/var/cache/mondo'.


       --gg           GUI mode. Without this switch, the screen output  of  mon-
                    doarchive  is suitable for processing by an 'expect' wrap-
                    per, enabling the user to backup nightly via a  cron  job.
                    However,  if  you want to run this program with an attrac-
                    tive but non-cron-friendly interface then use '-g'.


       --kk _p_a_t_h      Path of user's kernel. If you are a Debian or Gentoo  user
                    then  specify  --kk  FFAAIILLSSAAFFEE as your kernel. Otherwise, you
                    will rarely need this option.


       --mm           Manual (not self-retracting) CD trays are often  found  on
                    laptops.  If  you  are  a  laptop user, your CD burner has
                    BurnProof technology or you experience problems with mondo
                    then please call mondoarchive with this switch.


       --oo           Use OBDR (One Button Disaster Recovery) type of tapes.  By
                    default, tapes are not bootable. With this flag, tape will
                    be made bootable following the OBDR format.


       --ss _s_i_z_e      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.  You no longer need to specify the size
                    of your cartridges if you are backing up to tape.


       --xx _'_d_e_v _._._._' Specify non-Linux partitions which  you  want  to  backup,
                    e.g. NTFS or BeOS.



MMIINNOORR OOPPTTIIOONNSS
       --[[00--99]]       Specify  the  compression level. Default is 3. No compres-
                    sion is 0.


       --AA _c_o_m_m_a_n_d   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.  --AA understands two tokens - _ISO_
                    and _CD#_ - which will be translated into the ISO's  file-
                    name  and  its  index number (1, 2, ...) respectively. So,
                    you could use _-_A _'_f_o_o_b_a_c_k_u_p ___I_S_O___; _r_m _-_f  ___I_S_O___'  to  feed
                    each ISO to some magical new backup tool.


       --BB _c_o_m_m_a_n_d   This command will be called before each CD/NFS/ISO file is
                    written. See --AA for more information.


       --H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.  UUssee wwiitthh ccaauuttiioonn..


       --LL           Use  lzo, a fast compression engine, instead of bzip2. You
                    may find lzo on Mondo's website or via FreshMeat. WARNING!
                    Some versions of LZO are unstable.


       --GG           Use  gzip,  the  standard  and  quicker  Linux compression
                    engine, instead of bzip2.


       --RR           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  redun-
                    dant for now.


       --PP _t_a_r_b_a_l_l   Post-nuke  tarball.  If you boot into Nuke Mode and every-
                    thing is restored successfully then the  _p_o_s_t_-_n_u_k_e  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  the _p_o_s_t_-_n_u_k_e
                    script (or binary, or whatever it is) but also  any  files
                    it requires.


       --SS _p_a_t_h      Specify the full pathname of 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.


       --TT _p_a_t_h      Specify the full pathname of the  tempdir,  the  directory
                    where  temporary files (other than ISO images being assem-
                    bled) are stored. See --SS


       --WW           Don't make your backup self-booting. This is a really  bad
                    idea, IMO. Don't do this unless you have really great boot
                    disks in your hand and you are an anally retentive SOB who
                    can't  wait  2 minutes for Mindi to run in the background.
                    If you use -W then you'd better know what the hell  you're
                    doing, okay?


       --bb           Specify  the  internal  block size used by the tape drive.
                    This is usually 32K but some drives just don't like  that.
                    They  should but they don't. That's what happens when tape
                    drive vendors don't talk to kernel driver writers. Try 512
                    or 16384.


       --ee           Don't eject the CD or tape when backing up...


       --ff _d_e_v_i_c_e    Specify  the drive on which your Master Boot Record lives.
                    Usually, this is discovered automatically.


       --ll _G_R_U_B_|_L_I_L_O_|_E_L_I_L_O_|_R_A_W
                    Specify the boot loader.  By  default,  your  Master  Boot
                    Record is examined and the boot loader can usually be dis-
                    covered. If you specify RAW then the MBR will be backed up
                    and  restored  byte-for-byte  without  any analysis. It is
                    likely that you will also need to specify the boot  device
                    with -f <dev>. ELILO is mandatory for IA64 machines.


       --QQ           Give more detailed information about the boot loader.


       --KK _l_o_g_l_e_v_e_l  Specify  the  loglevel.  Use  99  for full debug. Standard
                    debug level is 4.


       --zz           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.



DDIIAAGGNNOOSSTTIICCSS
       Mondo   generates   one   additional,  and  extremely  important  file:
       //vvaarr//lloogg//mmoonnddooaarrcchhiivvee..lloogg..  When seeking technical support, attach this
       file to your email.




FFIILLEESS
       _/_v_a_r_/_l_o_g_/_m_o_n_d_o_a_r_c_h_i_v_e_._l_o_g   This  log  contains  important  information
       required to analyse mondoarchive problem reports. Did  I  already  said
       that  it's highly recommended to send this file with support questions.


NNOOTTEESS
       A link to Mondo's HTML-based manual (by Bruno Cornec, Mikael  Hultgren,
       Cafeole,  Randy  Delphs,  Stan Benoit, and Hugo Rabson) may be found at
       _h_t_t_p_:_/_/_w_w_w_._m_o_n_d_o_r_e_s_c_u_e_._o_r_g_/_d_o_c_s_._s_h_t_m_l - or in _/_u_s_r_/_s_h_a_r_e_/_d_o_c_/_m_o_n_d_o_-_x_._x_x
       on your hard drive.


BBUUGGSS
       It  is  recommend that your system has more than 64 MB ram. SCSI device
       order change with nuke can have unexpected results. It  is  recommended
       you use expert mode with drastic hardware reconfigurations.


EEXXAAMMPPLLEESS
       IISSOO::  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:-
       _m_o_n_d_o_a_r_c_h_i_v_e  _-_O_i  _-_d  _/_m_n_t_/_f_o_o  _-_E  _'_/_m_n_t_/_f_o_o  _/_m_n_t_/_f_o_o_2_'  _-_p   _`_h_o_s_t_-
       _n_a_m_e_`_-_`_d_a_t_e _+_%_Y_-_%_m_-_%_d_`

       Backup   to   ISO's   non-interactively,  e.g.  as  a  job  running  in
       /etc/cron.daily:
       _m_k_d_i_r _-_p _/_b_k_p_/_`_d_a_t_e _+_%_A_`_; _m_o_n_d_o_a_r_c_h_i_v_e _-_O_i _-_9  _-_d  _/_b_k_p_/_`_d_a_t_e  _+_%_A_`  _-_E
       _/_b_k_p

       DDVVDD:: Backup PC using DVD Media:
       _m_o_n_d_o_a_r_c_h_i_v_e _-_O_V_r _-_d _/_d_e_v_/_s_c_d_0 _-_g_F _-_s _4_4_8_0_m

       TTAAPPEE::  Backup  to  tape, using lzo compression (WARNING - can be unsta-
       ble):
       _m_o_n_d_o_a_r_c_h_i_v_e _-_O_t _-_d _/_d_e_v_/_s_t_0 _-_L

       Verify existing tape backup which was made with lzo compression:-
       _m_o_n_d_o_a_r_c_h_i_v_e _-_V_t _-_d _/_d_e_v_/_s_t_0 _-_L _-_g

       Backup to tape, using max compression:
       _m_o_n_d_o_a_r_c_h_i_v_e _-_O_t _-_9 _-_d _/_d_e_v_/_s_t_0

       CCDD--RR:: Backup to 700MB CD-R disks using a 16x CD burner:
       _m_o_n_d_o_a_r_c_h_i_v_e _-_O_c _1_6 _-_s _7_0_0_m _-_g

       Verify existing CD-R or CD-RW backup (works for either):-
       _m_o_n_d_o_a_r_c_h_i_v_e _-_V_c _1_6

       CCDD--RRWW:: Backup to 650MB CD-RW disks using a 4x CD ReWriter:
       _m_o_n_d_o_a_r_c_h_i_v_e _-_O_w _4

       Backup just your /home and /etc directory to 650MB CD-RW disks using  a
       4x CD ReWriter:
       _m_o_n_d_o_a_r_c_h_i_v_e _-_O_w _4 _-_I _"_/_h_o_m_e _/_e_t_c_"

       NNFFSS:: Backup to an NFS mount:
       _m_o_n_d_o_a_r_c_h_i_v_e _-_O_n _1_9_2_._1_6_8_._1_._2_:_/_h_o_m_e_/_n_f_s _-_d _/_M_o_n_d_a_y _-_E _/_m_n_t_/_n_f_s

       Verify existing NFS backup:-
       _m_o_n_d_o_a_r_c_h_i_v_e _-_V_n _1_9_2_._1_6_8_._1_._2_:_/_h_o_m_e_/_n_f_s _-_d _/_M_o_n_d_a_y

       UUSSBB:: Backup to your USB key, using gzip compression:
       _m_o_n_d_o_a_r_c_h_i_v_e _-_O_U _-_d _/_d_e_v_/_s_d_a _-_G

       RRAAIIDD:: Backup PC to a Software Raid mount point, iso size 700mb:
       _m_o_n_d_o_a_r_c_h_i_v_e _-_O _-_s _7_0_0_m _-_d _/_m_n_t_/_r_a_i_d



SSEEEE AALLSSOO
       afio(1), bzip2(1), find(1), mindi(8), mondorestore(8).

AAUUTTHHOORRSS
       Bruno Cornec (lead-development) _b_r_u_n_o___a_t___m_o_n_d_o_r_e_s_c_u_e_._o_r_g
       Andree Leidenfrost (co-developer) _a_l_e_i_d_e_n_f___a_t___b_i_g_p_o_n_d_._n_e_t_._a_u

OORRIIGGIINNAALL AAUUTTHHOORRSS
       Hugo Rabson (original author) _h_u_g_o_._r_a_b_s_o_n___a_t___m_o_n_d_o_r_e_s_c_u_e_._o_r_g
       Jesse Keating (original RPM packager) _h_o_s_t_i_n_g___a_t___j_2_s_o_l_u_t_i_o_n_s_._n_e_t
       Stan Benoit (testing) _t_r_o_f_f___a_t___n_a_k_e_d_s_o_u_l_._o_r_g
       Mikael Hultgren (docs) _m_i_k_a_e_l___h_u_l_t_g_r_e_n___a_t___g_m_x_._n_e_t
       See mailing list at http://www.mondorescue.org for technical support.



Mondo Rescue 2.2.8-r2139          2009-02-04                   mondoarchive(8)
