[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 | .\"
|
---|
[1691] | 21 | .TH mondorestore 8 "PBDATE" "Mondo Rescue PBVER-rPBREV"
|
---|
[1] | 22 |
|
---|
| 23 | .SH NAME
|
---|
| 24 | mondorestore \- a restore / disaster\-recovery tool.
|
---|
| 25 |
|
---|
| 26 | .SH SYNOPSIS
|
---|
[2543] | 27 | .B mondorestore [\-p prefix][\-K loglevel][\-i][\-U]...
|
---|
[1] | 28 | : restore your PC
|
---|
| 29 |
|
---|
| 30 | .SH DESCRIPTION
|
---|
| 31 | .PP
|
---|
| 32 | .I mondorestore
|
---|
[2543] | 33 | restores data previously backed up with
|
---|
[1236] | 34 | .I mondoarchive.
|
---|
[1494] | 35 |
|
---|
[1] | 36 | .
|
---|
[2543] | 37 | Note that mondorestore will usually automatically be called when booting a
|
---|
[1] | 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 |
|
---|
[1494] | 42 | .TP
|
---|
| 43 | .BI "-p " prefix
|
---|
[2543] | 44 | Use
|
---|
| 45 | .B prefix
|
---|
[1494] | 46 | to specify the name of your ISO images.
|
---|
[1967] | 47 | By default, mondorestore names images mondorescue-1.iso, mondorescue-2.iso, ...
|
---|
[2543] | 48 | Using
|
---|
| 49 | .B \-p machine
|
---|
[1494] | 50 | .B mondorestore
|
---|
| 51 | will use images named machine-1.iso, machine-2.iso, ...
|
---|
| 52 |
|
---|
[1872] | 53 | .TP
|
---|
[1967] | 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
|
---|
[2543] | 57 | .B \-n
|
---|
[1967] | 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
|
---|
[2380] | 64 | is the remote mount-point, e.g. nfs://192.168.1.3:/home/nfs'
|
---|
[1967] | 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.
|
---|
[2294] | 75 | The USB device should be attached to the system in order for this to work and
|
---|
[1967] | 76 | its device name passed to the
|
---|
[2543] | 77 | .BR \-d
|
---|
[1967] | 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 whitespace.
|
---|
[2543] | 90 | /mnt/cdrom, /proc, /sys, /tmp). 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.
|
---|
[1967] | 92 |
|
---|
| 93 | .TP
|
---|
| 94 | .BI "-I " "\*(lqpath ...\*(rq"
|
---|
[2543] | 95 | Include paths(s) to restore (future dev).
|
---|
[1967] | 96 |
|
---|
| 97 | .TP
|
---|
| 98 | .BI "-J " "file"
|
---|
[2543] | 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.
|
---|
[1967] | 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
|
---|
[2543] | 121 | a laptop user, your CD burner has BurnProof technology or you experience
|
---|
| 122 | problems with mondo then please call mondorestore with this switch.
|
---|
[1967] | 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"
|
---|
[2543] | 136 | Specify the full pathname of the tempdir, the directory where temporary files
|
---|
| 137 | are stored.
|
---|
[1967] | 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 "
|
---|
[2543] | 148 | Don't eject the CD or tape when restoring...
|
---|
[1967] | 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
|
---|
[1872] | 160 | .BI "-K " "loglevel"
|
---|
| 161 | Specify the loglevel. Use 99 for full debug. Standard debug level is 4.
|
---|
| 162 |
|
---|
[1967] | 163 | .TP
|
---|
| 164 | .BI "-z "
|
---|
[2543] | 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.
|
---|
[1967] | 168 |
|
---|
[1985] | 169 | .TP
|
---|
| 170 | .BI "-Z "
|
---|
| 171 | Specify mondorestore mode. Mode could be one of
|
---|
[2543] | 172 | .IR nuke:
|
---|
[1985] | 173 | This mode restore everything like on the original system with no/minimal questions
|
---|
[2543] | 174 | .IR interactive:
|
---|
[1985] | 175 | This mode asks all the questions to the user
|
---|
[2543] | 176 | .IR compare:
|
---|
[1985] | 177 | This mode just compares the system with the backup
|
---|
[2543] | 178 | .IR iso:
|
---|
[1985] | 179 | This mode restores from iso images, instead of real media
|
---|
[2543] | 180 | .IR isonuke:
|
---|
[1985] | 181 | This mode restores from iso images, instead of real media, with no/minimal questions
|
---|
[2543] | 182 | .IR mbr:
|
---|
[1985] | 183 | This mode just restores the MBR (Master Boot Record)
|
---|
| 184 |
|
---|
| 185 |
|
---|
[1] | 186 | .SH DIAGNOSTICS
|
---|
| 187 | mondorestore generates an Extremely important file:
|
---|
[2543] | 188 | .BI /var/log/mondorestore.log.
|
---|
| 189 | When seeking technical support, attach this file to your email.
|
---|
[1] | 190 |
|
---|
| 191 | .SH FILES
|
---|
[1315] | 192 | .IR /var/log/mondorestore.log
|
---|
[2543] | 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.
|
---|
[1] | 197 |
|
---|
| 198 | .SH NOTES
|
---|
[2543] | 199 | A link to Mondo's HTML-based manual (by Bruno Cornec, Mikael Hultgren,
|
---|
| 200 | Cafeole, Randy Delphs, Stan Benoit, and Hugo Rabson) may be found at
|
---|
[399] | 201 | .I http://www.mondorescue.org/docs.shtml
|
---|
[2543] | 202 | \- or in
|
---|
[1] | 203 | .I /usr/share/doc/mondo-x.xx
|
---|
| 204 | on your hard drive.
|
---|
| 205 |
|
---|
| 206 | .SH BUGS
|
---|
| 207 | It is recommend that your system has more than 64 MB ram. SCSI device order
|
---|
| 208 | change with nuke can have unexpected results. It is recommended you use expert
|
---|
[2543] | 209 | mode with drastic hardware reconfigurations.
|
---|
[1] | 210 |
|
---|
| 211 | .SH "SEE ALSO"
|
---|
[399] | 212 | afio(1), bzip2(1), find(1), mindi(8), mondoarchive(8).
|
---|
[1] | 213 | .SH AUTHORS
|
---|
[2543] | 214 | Bruno Cornec (lead-development)
|
---|
[569] | 215 | .I "bruno_at_mondorescue.org"
|
---|
[1] | 216 | .br
|
---|
[2543] | 217 | Andree Leidenfrost (co-developer)
|
---|
[399] | 218 | .I "aleidenf_at_bigpond.net.au"
|
---|
| 219 | .br
|
---|
| 220 | .SH ORIGINAL AUTHORS
|
---|
| 221 | Hugo Rabson (original author)
|
---|
| 222 | .I "hugo.rabson_at_mondorescue.org"
|
---|
| 223 | .br
|
---|
[1] | 224 | Jesse Keating (packaging)
|
---|
[399] | 225 | .I "hosting_at_j2solutions.net"
|
---|
[1] | 226 | .br
|
---|
| 227 | Stan Benoit (testing)
|
---|
[399] | 228 | .I "troff_at_nakedsoul.org"
|
---|
[1] | 229 | .br
|
---|
| 230 | Mikael Hultgren (docs)
|
---|
[399] | 231 | .I "mikael_hultgren_at_gmx.net"
|
---|
[1] | 232 | .br
|
---|
[116] | 233 | See mailing list at http://www.mondorescue.org for technical support.
|
---|