mondorestore(8)                                                mondorestore(8)



[1mNAME[0m
       mondorestore - a restore / disaster-recovery tool.


[1mSYNOPSIS[0m
       [1mmondorestore [-p prefix][-K loglevel][-i][-U]...  [22m: restore your PC


[1mDESCRIPTION[0m
       [4mmondorestore[24m restores data previously backed up with [4mmondoarchive.[0m

       Note  that mondorestore will usually automatically be called when boot-
       ing a MondoRescue medium. The only exception is booting  a  MondoRescue
       medium in [1mExpert [22mmode in which case mondorestore can be evoked from the
       command line.


       [1m-p [4m[22mprefix[0m
              Use [1mprefix [22mto specify the name of your ISO images.  By  default,
              mondorestore  names images mondorescue-1.iso, mondorescue-2.iso,
              ...   Using  [1m-p  machine  mondorestore  [22mwill  use  images  named
              machine-1.iso, machine-2.iso, ...


       [1m-i     [22mUse  ISO  files  (CD images) as restore media. This is good when
              having backed up your system to  a  spare  hard  drive.  The  [1m-n[0m
              switch  is  a  wiser choice if you plan to restore from a remote
              filesystem.


       [1m-n [4m[22mmount[0m
              Use files residing on NFS partition as restore media.  [4mmount[24m  is
              the remote mount-point, e.g. nfs://192.168.1.3:/home/nfs' for my
              file server. Please mount it before restoring/verifying.


       [1m-t     [22mUse tape streamer as restore device and  its  tapes  as  restore
              media.


       [1m-U     [22mUse a generic USB device as restore device. Use this if you want
              to read your backup from a USB key or USB disk.  The USB  device
              should  be  attached to the system in order for this to work and
              its device name passed to the [1m-d [22moption.


       [1m-u     [22mUse a generic streaming device as restore device.  Use  this  if
              you  want to read your backup from a device that is not directly
              support by mondoarchive. This will get the data directly from  a
              raw device.  [1mFor experienced users only.[0m


       [1m-E [4m[22m"path[24m [4m..."[0m
              Exclude  path(s)  from restore (future dev). The paths should be
              separated with a pipe.  For example, if  you  are  restoring  up
              from  an  NFS mount but you do not want to restore some content,
              exclude it with that switch.


       [1m-I [4m[22m"path[24m [4m..."[0m
              Include paths(s) to restore (future dev).


       [1m-J [4m[22mfile[0m
              Specify an explicit list of files and directories to restore  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 (future dev).


       [1m-d [4m[22mdev|dir[0m
              Specify the restore 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'.


       [1m-g     [22mGUI mode. Without this switch, the screen output of mondorestore
              is text based.


       [1m-m     [22mManual  (not  self-retracting)  CD trays are often found on lap-
              tops. If you are a laptop user, your  CD  burner  has  BurnProof
              technology  or  you  experience  problems with mondo then please
              call mondorestore with this switch.


       [1m-o     [22mUse OBDR (One Button  Disaster  Recovery)  type  of  tapes.   By
              default,  tapes  are  not bootable. With this flag, tape will be
              read as bootable tapes following the OBDR format.


       [1m-x [4m[22m'dev[24m [4m...'[0m
              Specify non-Linux partitions which you want to  restore  (future
              dev).


       [1m-T [4m[22mpath[0m
              Specify  the  full  pathname of the tempdir, the directory where
              temporary files are stored.


       [1m-b     [22mSpecify 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.


       [1m-e     [22mDon't eject the CD or tape when restoring...


       [1m-f [4m[22mdevice[0m
              Specify  the  drive on which your Master Boot Record lives. Usu-
              ally, this is discovered automatically. (future dev)


       [1m-Q     [22mGive more detailed information about the boot loader.


       [1m-K [4m[22mloglevel[0m
              Specify the loglevel. Use 99  for  full  debug.  Standard  debug
              level is 4.


       [1m-z     [22mUse  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.


       [1m-Z     [22mSpecify  mondorestore mode. Mode could be one of [4mnuke:[24m This mode
              restore everything like on the original system  with  no/minimal
              questions  [4minteractive:[24m  This mode asks all the questions to the
              user [4mcompare:[24m This mode just compares the system with the backup
              [4miso:[24m  This  mode restores from iso images, instead of real media
              [4misonuke:[24m This mode restores from iso  images,  instead  of  real
              media,  with  no/minimal  questions [4mmbr:[24m This mode just restores
              the MBR (Master Boot Record)



[1mDIAGNOSTICS[0m
       mondorestore generates an Extremely important  file:  [1m/var/log/mondore-[0m
       [1mstore.log.   [22mWhen  seeking  technical support, attach this file to your
       email.


[1mFILES[0m
       [4m/var/log/mondorestore.log[24m  This  log  contains  important   information
       required  to analyse mondorestore problem reports. Mondo support highly
       recommends sending this file with support questions. It's located under
       /tmp during the restore process and moved under /var/log at the end.


[1mENVIRONMENT VARIABLES[0m
       [4mTMPDIR[24m  This  variable  is used, if defined, as the target directory to
       create all the temporary files needed during  the  operation  (not  the
       scratch files)

       [4mTMP[24m  This variable is used, if defined and if TMPDIR is not defined, as
       the target directory to create all the temporary  files  needed  during
       the operation (not the scratch files)

       [4mdirimg[24m  This  variable  is setup by the rcS script to store the network
       remote directory in PXE mode.  (managed internally)

       [4mimgname[24m This variable is setup by the rcS script to overwrite the  pre-
       fix name in PXE mode.  (managed internally)

       [4mnetfsmount[24m  This  variable is setup by the rcS script to store the net-
       work file system mount point in PXE mode.  (managed internally)

       [4mMRUSBDEV[24m This variable contains the device file of the  USB  device  to
       restore  from.  (equivalent if the usb-dev parameter of the mondorescue
       config file)


[1mNOTES[0m
       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
       [4mhttp://www.mondorescue.org/docs.shtml[24m - or in [4m/usr/share/doc/mondo-x.xx[0m
       on your hard drive.


[1mBUGS[0m
       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.


[1mSEE ALSO[0m
       afio(1), bzip2(1), find(1), mindi(8), mondoarchive(8).

[1mAUTHORS[0m
       Bruno Cornec (lead-development) [4mbruno_at_mondorescue.org[0m
       Andree Leidenfrost (co-developer) [4maleidenf_at_bigpond.net.au[0m

[1mORIGINAL AUTHORS[0m
       Hugo Rabson (original author) [4mhugo.rabson_at_mondorescue.org[0m
       Jesse Keating (packaging) [4mhosting_at_j2solutions.net[0m
       Stan Benoit (testing) [4mtroff_at_nakedsoul.org[0m
       Mikael Hultgren (docs) [4mmikael_hultgren_at_gmx.net[0m
       See mailing list at http://www.mondorescue.org for technical support.



Mondo Rescue 3.0.0-r2930          2011-12-23                   mondorestore(8)
