source: branches/2.2.10/mondo-doc/mondorestore.8 @ 2715

Last change on this file since 2715 was 2715, checked in by bruno, 7 years ago
  • Document in man page and HOWTO the previous syntax modifications for -E/-I options and '|' separator
  • Fix #444. mondoarchive now supports inclusion/exclusion of dirs with spaces in their name. this required a syntax change for the -E/-I options where the list of dirs needs to be separated by '|' now instead of ' '.
  • Fix issus with mindi when launched from a dir containing spaces
  • Fix a but when no -E option is give on CLI (null) string generated
  • Fix #459 by correcting an old README containing info on the edit-mountlist binary which doesn't exist.

svn merge -r 2709:2714 svn+ssh://bruno@svn.mondorescue.org/mondo/svn/mondorescue/branches/2.2.9 .

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