source: branches/2.2.6/mondo-doc/mondorestore.8 @ 1967

Last change on this file since 1967 was 1967, checked in by bruno, 9 years ago
  • Remove all references to /root/images
  • Fix the lack of support for options in mondorestore by copying what is done for mondoarchive and sharing the functions analyzing the cli (getopt usage)
  • Review the now common handle_incoming_parameters to have it support correctly 2 modes (archiving and restoring)
  • Update mondorestore man page to take in account the options supported now
  • Replace mondorestore options --nuke, --interactive, with -Z nuke, -Z interactive ...
  • Property svn:keywords set to Id
File size: 6.7 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]
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. '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 ir 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 whitespace.
90/mnt/cdrom, /proc, /sys, /tmp). For example, if you are restoring up from an NFS mount but you
91do not want to restore some content, exclude it with that switch.
92
93.TP
94.BI "-I " "\*(lqpath ...\*(rq"
95Include paths(s) to retore (future dev).
96
97.TP
98.BI "-J " "file"
99Specify an explicit list of files and directories to restore in a plain text file, one item
100(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.
101
102.TP
103.BI "-d " "dev|dir"
104Specify the restore device (CD/tape/USB) or directory (NFS/ISO). For CD-R[W] drives,
105this is the SCSI node where the drive may be found, e.g. '0,1,0'. For tape
106users, this is the tape streamers /dev entry, e.g. '/dev/st0'. For USB users,
107this is the device name of your key or external disk. For ISO users,
108this is the directory where the ISO images are stored. For NFS users, this is
109the directory within the NFS mount where the backups are stored. The default
110for ISO and NFS is '/var/cache/mondo'.
111
112.TP
113.BI "-g "
114GUI mode. Without this switch, the screen output of mondorestore is text based.
115
116.TP
117.BI "-m "
118Manual (not self-retracting) CD trays are often found on laptops. If you are
119a laptop user, your CD burner has BurnProof technology or you experience
120problems with mondo then please call mondorestore with this switch.
121
122.TP
123.BI "-o "
124Use OBDR (One Button Disaster Recovery) type of tapes.
125By default, tapes are not bootable. With this flag, tape will be read as bootable tapes
126following the OBDR format.
127
128.TP
129.BI "-x " "'dev ...'"
130Specify non-Linux partitions which you want to restore (future dev).
131
132.TP
133.BI "-T " "path"
134Specify the full pathname of the tempdir, the directory where temporary files
135are stored.
136
137.TP
138.BI "-b "
139Specify the internal block size used by the tape drive. This is usually 32K but
140some drives just don't like that. They should but they don't. That's what
141happens when tape drive vendors don't talk to kernel driver writers. Try 512 or
14216384.
143
144.TP
145.BI "-e "
146Don't eject the CD or tape when restoring...
147
148.TP
149.BI "-f " "device"
150Specify the drive on which your Master Boot Record lives. Usually, this is
151discovered automatically. (future dev)
152
153.TP
154.BI "-Q "
155Give more detailed information about the boot loader.
156
157.TP
158.BI "-K " "loglevel"
159Specify the loglevel. Use 99 for full debug. Standard debug level is 4.
160
161.TP
162.BI "-z "
163Use 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.
164
165.SH DIAGNOSTICS
166mondorestore generates an Extremely important file:
167.BI /var/log/mondorestore.log.
168When seeking technical support, attach this file to your email.
169
170.SH FILES
171.IR /var/log/mondorestore.log
172This log contains important information required to analyse mondorestore problem
173reports. Mondo support highly recommends sending this file with support
174questions. It's located under /tmp during the restore process and moved under /var/log at the end.
175
176.SH NOTES
177A link to Mondo's HTML-based manual (by Bruno Cornec, Mikael Hultgren, Cafeole, Randy Delphs,
178Stan Benoit, and Hugo Rabson) may be found at
179.I http://www.mondorescue.org/docs.shtml
180- or in
181.I /usr/share/doc/mondo-x.xx
182on your hard drive.
183
184.SH BUGS
185It is recommend that your system has more than 64 MB ram. SCSI device order
186change with nuke can have unexpected results. It is recommended you use expert
187mode with drastic hardware reconfigurations.
188
189.SH "SEE ALSO"
190afio(1), bzip2(1), find(1), mindi(8), mondoarchive(8).
191.SH AUTHORS
192Bruno Cornec (lead-development)
193.I "bruno_at_mondorescue.org"
194.br
195Andree Leidenfrost (co-developper)
196.I "aleidenf_at_bigpond.net.au"
197.br
198.SH ORIGINAL AUTHORS
199Hugo Rabson (original author)
200.I "hugo.rabson_at_mondorescue.org"
201.br
202Jesse Keating (packaging)
203.I "hosting_at_j2solutions.net"
204.br
205Stan Benoit (testing)
206.I "troff_at_nakedsoul.org"
207.br
208Mikael Hultgren (docs)
209.I "mikael_hultgren_at_gmx.net"
210.br
211See mailing list at http://www.mondorescue.org for technical support.
212.
Note: See TracBrowser for help on using the repository browser.