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/nst0'. 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.
|
---|
202 |
|
---|
203 | .IR MRTMP
|
---|
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 | With none of these variables defined, nor the -T option on the CLI then
|
---|
209 | /tmp is used for temporary files.
|
---|
210 |
|
---|
211 | .IR dirimg
|
---|
212 | This variable is setup by the rcS script to store the network remote directory in PXE mode.
|
---|
213 | (managed internally)
|
---|
214 |
|
---|
215 | .IR imgname
|
---|
216 | This variable is setup by the rcS script to overwrite the prefix name in PXE mode.
|
---|
217 | (managed internally)
|
---|
218 |
|
---|
219 | .IR netfsmount
|
---|
220 | This variable is setup by the rcS script to store the network file system mount point in PXE mode.
|
---|
221 | (managed internally)
|
---|
222 |
|
---|
223 | .IR MRUSBDEV
|
---|
224 | This variable contains the device file of the USB device to restore from.
|
---|
225 | (equivalent if the usb-dev parameter of the mondorescue config file)
|
---|
226 |
|
---|
227 | .SH NOTES
|
---|
228 | A link to Mondo's HTML-based manual (by Bruno Cornec, Mikael Hultgren,
|
---|
229 | Cafeole, Randy Delphs, Stan Benoit, and Hugo Rabson) may be found at
|
---|
230 | .I http://www.mondorescue.org/docs.shtml
|
---|
231 | \- or in
|
---|
232 | .I /usr/share/doc/mondo-x.xx
|
---|
233 | on your hard drive.
|
---|
234 |
|
---|
235 | .SH BUGS
|
---|
236 | It is recommend that your system has more than 64 MB ram. SCSI device order
|
---|
237 | change with nuke can have unexpected results. It is recommended you use expert
|
---|
238 | mode with drastic hardware reconfigurations.
|
---|
239 |
|
---|
240 | .SH "SEE ALSO"
|
---|
241 | afio(1), bzip2(1), find(1), mindi(8), mondoarchive(8).
|
---|
242 | .SH AUTHORS
|
---|
243 | Bruno Cornec (lead-development)
|
---|
244 | .I "bruno_at_mondorescue.org"
|
---|
245 | .br
|
---|
246 | Andree Leidenfrost (co-developer)
|
---|
247 | .I "aleidenf_at_bigpond.net.au"
|
---|
248 | .br
|
---|
249 | .SH ORIGINAL AUTHORS
|
---|
250 | Hugo Rabson (original author)
|
---|
251 | .I "hugo.rabson_at_mondorescue.org"
|
---|
252 | .br
|
---|
253 | Jesse Keating (packaging)
|
---|
254 | .I "hosting_at_j2solutions.net"
|
---|
255 | .br
|
---|
256 | Stan Benoit (testing)
|
---|
257 | .I "troff_at_nakedsoul.org"
|
---|
258 | .br
|
---|
259 | Mikael Hultgren (docs)
|
---|
260 | .I "mikael_hultgren_at_gmx.net"
|
---|
261 | .br
|
---|
262 | See mailing list at http://www.mondorescue.org for technical support.
|
---|