| 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 | .\"
|
|---|
| 21 | .TH mondorestore 8 "PBDATE" "Mondo Rescue PBVER-rPBREV"
|
|---|
| 22 |
|
|---|
| 23 | .SH NAME
|
|---|
| 24 | mondorestore \- a restore / disaster\-recovery tool.
|
|---|
| 25 |
|
|---|
| 26 | .SH SYNOPSIS
|
|---|
| 27 | .B mondorestore [\-p prefix][\-K loglevel][\-i][\-U]...
|
|---|
| 28 | : restore your PC
|
|---|
| 29 |
|
|---|
| 30 | .SH DESCRIPTION
|
|---|
| 31 | .PP
|
|---|
| 32 | .I mondorestore
|
|---|
| 33 | restores data previously backed up with
|
|---|
| 34 | .I mondoarchive.
|
|---|
| 35 |
|
|---|
| 36 | .
|
|---|
| 37 | Note that mondorestore will usually automatically be called when booting a
|
|---|
| 38 | MondoRescue medium. The only exception is booting a MondoRescue medium in
|
|---|
| 39 | .B Expert
|
|---|
| 40 | mode in which case mondorestore can be evoked from the command line.
|
|---|
| 41 |
|
|---|
| 42 | .TP
|
|---|
| 43 | .BI "\-p " prefix
|
|---|
| 44 | Use
|
|---|
| 45 | .B prefix
|
|---|
| 46 | to specify the name of your ISO images.
|
|---|
| 47 | By default, mondorestore names images mondorescue-1.iso, mondorescue-2.iso, ...
|
|---|
| 48 | Using
|
|---|
| 49 | .B \-p machine
|
|---|
| 50 | .B mondorestore
|
|---|
| 51 | will use images named machine-1.iso, machine-2.iso, ...
|
|---|
| 52 |
|
|---|
| 53 | .TP
|
|---|
| 54 | .BI "\-i "
|
|---|
| 55 | Use ISO files (CD images) as restore media. This is good when having backed up your
|
|---|
| 56 | system to a spare hard drive. The
|
|---|
| 57 | .B \-n
|
|---|
| 58 | switch is a wiser choice if you plan to restore from a remote filesystem.
|
|---|
| 59 |
|
|---|
| 60 | .TP
|
|---|
| 61 | .BI "\-n " mount
|
|---|
| 62 | Use files residing on NFS partition as restore media.
|
|---|
| 63 | .I mount
|
|---|
| 64 | is the remote mount-point, e.g. nfs://192.168.1.3:/home/nfs'
|
|---|
| 65 | for my file server. Please mount it before restoring/verifying.
|
|---|
| 66 |
|
|---|
| 67 | .TP
|
|---|
| 68 | .BI "\-t "
|
|---|
| 69 | Use tape streamer as restore device and its tapes as restore media.
|
|---|
| 70 |
|
|---|
| 71 | .TP
|
|---|
| 72 | .BI "\-U "
|
|---|
| 73 | Use a generic USB device as restore device. Use this if you want to read
|
|---|
| 74 | your backup from a USB key or USB disk.
|
|---|
| 75 | The USB device should be attached to the system in order for this to work and
|
|---|
| 76 | its device name passed to the
|
|---|
| 77 | .BR \-d
|
|---|
| 78 | option.
|
|---|
| 79 |
|
|---|
| 80 | .TP
|
|---|
| 81 | .BI "\-u "
|
|---|
| 82 | Use a generic streaming device as restore device. Use this if you want to read
|
|---|
| 83 | your backup from a device that is not directly support by mondoarchive. This will
|
|---|
| 84 | get the data directly from a raw device.
|
|---|
| 85 | .B For experienced users only.
|
|---|
| 86 |
|
|---|
| 87 | .TP
|
|---|
| 88 | .BI "\-E " "\*(lqpath ...\*(rq"
|
|---|
| 89 | Exclude path(s) from restore (future dev). The paths should be separated with a pipe.
|
|---|
| 90 | For example, if you are restoring up
|
|---|
| 91 | from an NFS mount but you do not want to restore some content, exclude it with that switch.
|
|---|
| 92 |
|
|---|
| 93 | .TP
|
|---|
| 94 | .BI "\-I " "\*(lqpath ...\*(rq"
|
|---|
| 95 | Include paths(s) to restore (future dev).
|
|---|
| 96 |
|
|---|
| 97 | .TP
|
|---|
| 98 | .BI "\-J " "file"
|
|---|
| 99 | Specify an explicit list of files and directories to restore in a plain
|
|---|
| 100 | text file, one item (file or directory) per line. Beware that
|
|---|
| 101 | directories placed in that file are not managed recursively contrary to
|
|---|
| 102 | what is done with the \-I option (future dev).
|
|---|
| 103 |
|
|---|
| 104 | .TP
|
|---|
| 105 | .BI "\-d " "dev|dir"
|
|---|
| 106 | Specify the restore device (CD/tape/USB) or directory (NFS/ISO). For CD-R[W] drives,
|
|---|
| 107 | this is the SCSI node where the drive may be found, e.g. '0,1,0'. For tape
|
|---|
| 108 | users, this is the tape streamers /dev entry, e.g. '/dev/st0'. For USB users,
|
|---|
| 109 | this is the device name of your key or external disk. For ISO users,
|
|---|
| 110 | this is the directory where the ISO images are stored. For NFS users, this is
|
|---|
| 111 | the directory within the NFS mount where the backups are stored. The default
|
|---|
| 112 | for ISO and NFS is '/var/cache/mondo'.
|
|---|
| 113 |
|
|---|
| 114 | .TP
|
|---|
| 115 | .BI "\-g "
|
|---|
| 116 | GUI mode. Without this switch, the screen output of mondorestore is text based.
|
|---|
| 117 |
|
|---|
| 118 | .TP
|
|---|
| 119 | .BI "\-m "
|
|---|
| 120 | Manual (not self-retracting) CD trays are often found on laptops. If you are
|
|---|
| 121 | a laptop user, your CD burner has BurnProof technology or you experience
|
|---|
| 122 | problems with mondo then please call mondorestore with this switch.
|
|---|
| 123 |
|
|---|
| 124 | .TP
|
|---|
| 125 | .BI "\-o "
|
|---|
| 126 | Use OBDR (One Button Disaster Recovery) type of tapes.
|
|---|
| 127 | By default, tapes are not bootable. With this flag, tape will be read as bootable tapes
|
|---|
| 128 | following the OBDR format.
|
|---|
| 129 |
|
|---|
| 130 | .TP
|
|---|
| 131 | .BI "\-x " "'dev ...'"
|
|---|
| 132 | Specify non-Linux partitions which you want to restore (future dev).
|
|---|
| 133 |
|
|---|
| 134 | .TP
|
|---|
| 135 | .BI "\-T " "path"
|
|---|
| 136 | Specify the full pathname of the tempdir, the directory where temporary files
|
|---|
| 137 | are stored.
|
|---|
| 138 |
|
|---|
| 139 | .TP
|
|---|
| 140 | .BI "\-b "
|
|---|
| 141 | Specify the internal block size used by the tape drive. This is usually 32K but
|
|---|
| 142 | some drives just don't like that. They should but they don't. That's what
|
|---|
| 143 | happens when tape drive vendors don't talk to kernel driver writers. Try 512 or
|
|---|
| 144 | 16384.
|
|---|
| 145 |
|
|---|
| 146 | .TP
|
|---|
| 147 | .BI "\-e "
|
|---|
| 148 | Don't eject the CD or tape when restoring...
|
|---|
| 149 |
|
|---|
| 150 | .TP
|
|---|
| 151 | .BI "\-f " "device"
|
|---|
| 152 | Specify the drive on which your Master Boot Record lives. Usually, this is
|
|---|
| 153 | discovered automatically. (future dev)
|
|---|
| 154 |
|
|---|
| 155 | .TP
|
|---|
| 156 | .BI "\-Q "
|
|---|
| 157 | Give more detailed information about the boot loader.
|
|---|
| 158 |
|
|---|
| 159 | .TP
|
|---|
| 160 | .BI "\-K " "loglevel"
|
|---|
| 161 | Specify the loglevel. Use 99 for full debug. Standard debug level is 4.
|
|---|
| 162 |
|
|---|
| 163 | .TP
|
|---|
| 164 | .BI "\-z "
|
|---|
| 165 | Use extended attributes and acl for each file and store them in the
|
|---|
| 166 | backup media. Use this option if you use SElinux e.g. but it will slow
|
|---|
| 167 | down backup and restore time of course.
|
|---|
| 168 |
|
|---|
| 169 | .TP
|
|---|
| 170 | .BI "\-Z "
|
|---|
| 171 | Specify mondorestore mode. Mode could be one of
|
|---|
| 172 | .IR nuke:
|
|---|
| 173 | This mode restore everything like on the original system with no/minimal questions
|
|---|
| 174 | .IR interactive:
|
|---|
| 175 | This mode asks all the questions to the user
|
|---|
| 176 | .IR compare:
|
|---|
| 177 | This mode just compares the system with the backup
|
|---|
| 178 | .IR iso:
|
|---|
| 179 | This mode restores from iso images, instead of real media
|
|---|
| 180 | .IR isonuke:
|
|---|
| 181 | This mode restores from iso images, instead of real media, with no/minimal questions
|
|---|
| 182 | .IR mbr:
|
|---|
| 183 | This mode just restores the MBR (Master Boot Record)
|
|---|
| 184 |
|
|---|
| 185 |
|
|---|
| 186 | .SH DIAGNOSTICS
|
|---|
| 187 | mondorestore generates an Extremely important file:
|
|---|
| 188 | .BI /var/log/mondorestore.log.
|
|---|
| 189 | When seeking technical support, attach this file to your email.
|
|---|
| 190 |
|
|---|
| 191 | .SH FILES
|
|---|
| 192 | .IR /var/log/mondorestore.log
|
|---|
| 193 | This log contains important information required to analyse mondorestore
|
|---|
| 194 | problem reports. Mondo support highly recommends sending this file with
|
|---|
| 195 | support questions. It's located under /tmp during the restore process
|
|---|
| 196 | and moved under /var/log at the end.
|
|---|
| 197 |
|
|---|
| 198 | .SH ENVIRONMENT VARIABLES
|
|---|
| 199 | .IR TMPDIR
|
|---|
| 200 | This variable is used, if defined, as the target directory to create
|
|---|
| 201 | all the temporary files needed during the operation (not the scratch files)
|
|---|
| 202 |
|
|---|
| 203 | .IR TMP
|
|---|
| 204 | This variable is used, if defined and if TMPDIR is not defined, as the target
|
|---|
| 205 | directory to create all the temporary files needed during the operation
|
|---|
| 206 | (not the scratch files)
|
|---|
| 207 |
|
|---|
| 208 | .IR dirimg
|
|---|
| 209 | This variable is setup by the rcS script to store the network remote directory in PXE mode.
|
|---|
| 210 | (managed internally)
|
|---|
| 211 |
|
|---|
| 212 | .IR imgname
|
|---|
| 213 | This variable is setup by the rcS script to overwrite the prefix name in PXE mode.
|
|---|
| 214 | (managed internally)
|
|---|
| 215 |
|
|---|
| 216 | .IR netfsmount
|
|---|
| 217 | This variable is setup by the rcS script to store the network file system mount point in PXE mode.
|
|---|
| 218 | (managed internally)
|
|---|
| 219 |
|
|---|
| 220 | .IR MRUSBDEV
|
|---|
| 221 | This variable contains the device file of the USB device to restore from.
|
|---|
| 222 | (equivalent if the usb-dev parameter of the mondorescue config file)
|
|---|
| 223 |
|
|---|
| 224 | .SH NOTES
|
|---|
| 225 | A link to Mondo's HTML-based manual (by Bruno Cornec, Mikael Hultgren,
|
|---|
| 226 | Cafeole, Randy Delphs, Stan Benoit, and Hugo Rabson) may be found at
|
|---|
| 227 | .I http://www.mondorescue.org/docs.shtml
|
|---|
| 228 | \- or in
|
|---|
| 229 | .I /usr/share/doc/mondo-x.xx
|
|---|
| 230 | on your hard drive.
|
|---|
| 231 |
|
|---|
| 232 | .SH BUGS
|
|---|
| 233 | It is recommend that your system has more than 64 MB ram. SCSI device order
|
|---|
| 234 | change with nuke can have unexpected results. It is recommended you use expert
|
|---|
| 235 | mode with drastic hardware reconfigurations.
|
|---|
| 236 |
|
|---|
| 237 | .SH "SEE ALSO"
|
|---|
| 238 | afio(1), bzip2(1), find(1), mindi(8), mondoarchive(8).
|
|---|
| 239 | .SH AUTHORS
|
|---|
| 240 | Bruno Cornec (lead-development)
|
|---|
| 241 | .I "bruno_at_mondorescue.org"
|
|---|
| 242 | .br
|
|---|
| 243 | Andree Leidenfrost (co-developer)
|
|---|
| 244 | .I "aleidenf_at_bigpond.net.au"
|
|---|
| 245 | .br
|
|---|
| 246 | .SH ORIGINAL AUTHORS
|
|---|
| 247 | Hugo Rabson (original author)
|
|---|
| 248 | .I "hugo.rabson_at_mondorescue.org"
|
|---|
| 249 | .br
|
|---|
| 250 | Jesse Keating (packaging)
|
|---|
| 251 | .I "hosting_at_j2solutions.net"
|
|---|
| 252 | .br
|
|---|
| 253 | Stan Benoit (testing)
|
|---|
| 254 | .I "troff_at_nakedsoul.org"
|
|---|
| 255 | .br
|
|---|
| 256 | Mikael Hultgren (docs)
|
|---|
| 257 | .I "mikael_hultgren_at_gmx.net"
|
|---|
| 258 | .br
|
|---|
| 259 | See mailing list at http://www.mondorescue.org for technical support.
|
|---|
