source: branches/3.1/mondo-doc/mondorestore.8 @ 2937

Last change on this file since 2937 was 2937, checked in by bruno, 6 years ago

svn merge -r 2849:2935 ../3.0

  • Adds 3 binaries called potentially by udev o support USB key mount at restore time (Victor Gattegno)
  • mindi only sets the boot flag of a USB device if none is present already (should avoid flip/flop situation)
  • Fix a compatibility bug in analyze-my-lvm whete exclude lists with '|' was incorrectly analyzed (' ' still expected)
  • Precise that -J is not supported by mondorestore yet.
  • Fix a compatibility bug in mindi where exclude lists with '|' was incorrectly analyzed (' ' still expected)
  • Install an MBR on USB devices when possible
  • Improve error message in case mondorestore isn't found
  • Adds support for more virtio devices for KVM restore
  • Improve mbr.bin handling
  • Fix an issue in test of FindKernel? for Xen and non Xen cases
    • Fix #492 by removing an extra useless fi
    • Move fvat nd fat modules to CDROM_MODS in order to have them in the initrd to support saving logs to a USB device e.g.
    • Fix an error when dmidecode reports comments before system name
    • Fix previous broken patch on comment management for bkphw
    • Improve msgs printed during kbd analysis
    • Fix a small remaining pb with new comment support
    • Try to again improve the mount/umount stuff in mondo -Adds mention to OEL, CentOS, ScientifLinux? as RHEL clones
  • Fix a panadoid_free done on the wrong variable (solve a memory leak)
  • Solve #495 by skipping the potential (auto-read-only) when analyzin /proc/mdstat result
  • Fix some markup in man pages
  • adds the post-nuke script sample for Debian (Guillaume Pernot/Andrée? Leidenfrost)
  • Avoid a useless umount when changing of afio set, let insist_on_cd check and perform if needed
  • Copy everything under .ssh of root account to allow for sshfs mount without passwd at restore time.
  • Adds support for bnx2i driver
  • Try to fix #496 by supporting the protocol in the output of the mount command (sshfs#...)
  • Uses the -d option of the mount command to avoid leaving loop devices in use. Probably provoked by the usage of a more recent busybox, but anyway that option doesn't hurt, and does nothing for non-loop devices. Should fix the problems reported on the ML with NFS and more than 8 ISO images (8 being the default number of loop devices available)
  • Attempt to fix #436 by adding some newtDrawForm where appropriate.
  • Fix bugs in the kernel detection routine of mindi (some echo were done without capturing their output, confusing the return). This should also help the Xen detection issue
  • Change the logging function to be nearer from 2.2.10, and start using some
  • Initialize some global fields with an empty string, now that newt Draws more regularly progress forms
  • Mindi progression still not good, but showing now 3% when calling mindi. Would need a specific handling for the progress bar to evolve more afterwards
  • Add compatibility with the latest SSSTK + PSP content for HP ProLiant? + branding homogeneous now. We only take conrep out of the SSSTK pending a package availability. Using hpacuscripting now. Review of parameters called following test made.
  • Fix #501 by pushing BOOT_SIZE to 36864 for certain Ubuntu cases
  • Fix some remaining inconsistencis in the ProLiant? HW backup. ready for usage.
  • Fix an issue on udevadm call (needs an intermediate variable)
  • Fix a remaining ProLiant? tool call
  • Remove again some wrong variable initialization for Net in order to not have strange messages now we call Draw more often
  • Adds support for hwaddr (MAC addresses) at restore time, and map to the correct NIC if it's found at restore time (based on code from Stefan Heijmans)
  • Try to Fix #499 by changing init in order to never exit, and rebooting using sysrq in /proc (not portable). Maybe should move to using a real init, and a separated rcS script.
  • Fixes the shell msg error by using setsid as per Busybox FAQ
  • Fix #491 by correctly checking Xen kernel used for a dom0 env (apollo13)
  • Improves logging in Die()
  • Improve again ProLiant? HW support, by adding references to the yet to come SSSTK rpm so that conrep is called at its future right place.
  • Improve mindi support for kernel 3.x
  • Fix #499 for good, by using a real init from busybox and moving our init script to etc/init.d/rcS. We also now call the reboot from busybox to exit, which indeed reset the system correctly (in a VM at least which wasn't the case before). Reauires a new mindi-busybox as well.
  • Attempt to solve #503 by handling /lib64 separately for udev and only if not a link (to /lib) for Ubuntu 64
  • Improve again previous tests for bug #503
  • Improve -d option description for NFS
  • Allow http download for ftp content
  • New italian mirror
  • Fix #505 by documenting environment variables
    • Fix a bug where on OBDR mode compression was turned off to create the OBDR content but not back on (report from the mailing list)
  • solve http://trac.mondorescue.org/ticket/520 by Victor Gattegno
  • Fix #524 as option -U needs a size also
  • Removes useless gendf option
  • Fix #511 now stabgrub is called also after conf file modifications
  • Adds support for SUID binaries
  • remove a useless xenkernelname variable from mindi
  • Should fix #512 by clearing old scratchdir before changing to a new
  • Simplify the function engaging SCSI for Smart Array controllers, and support as many controller as we have
  • Add some binaries used on SLES 10 by udev
  • Fix a syntax issue in newt-specific.c
  • Fix a memory free bug where a used variable was freed to early
  • Fix a memory free bug where a used variable was misused in asprintf/free
  • Fix #498 by using an external program (hpsa_obdr_mode) which can set the mode of the tape to CD-ROM or Sequential at will.

That program will have to be downloaded from http://cciss.sf.net

  • Adds support for the route command in mindi-busybox
  • Force block size back to 32768 in OBDR mode after skipping the 2 tape marks, to read the additional rootfs data corerctly - Fix #498 for good it seems
  • Adds support for a new pata_atiixp driver
  • Fix #525 and improve printing when no /etc/raidtab, but still md devices
  • Exclude /run similarly to /sys and /proc
  • Fix a bug in mindi when having multiple swap partiions with same starting string (/dev/dm-1 and /dev/dm-16). We now add a space in the grep to avoid mischoice.
  • Fix grub installation if we had to go in the hack part which wasn't using the correct variables to make decisions !
  • Remove all mention of mondorescue.com from code
  • Fix some website typo on the download page and precise that we now develop on Mageia
  • Exclude sysfs devpts and tmpfs partitions found in RHEL 6.2 from analyze by mindi (made error messages)
  • Force activation of first partition which should not be optional as everything is destroyed before
  • Fix a bug in analyze-my-lvm where LVs were created in random order (the one of lvscan) instead of using the dm-xxx order, which creates issues at restore time between the mapping created then and the one we had at backup time which could be inconssistent

-mondoarchive now exists if the mt command is missing when needed

  • Proper fix for analyze-my-lvm
  • Fix #500 and #473 by adding support of old metadata format for mdadm if using grub < 0.9x or lilo on a md boot device (to be tested)
  • Really never inject or eject when the -e option is passed or device is inappropriate (USB, Net, ...)
  • Fix #577 by having factor back as a float (not a long ! it's a decimal value) and making the appropriate cast.
  • Fix #578 by improving the regexp used for CD/DVD detection with -scanbus option
  • Adds more verbosity when LVM creation fails.
  • Fix #579 by checking with pipes on both sides of the string
  • debugfs should be excluded from the device considered for fstab analysis
  • Property svn:keywords set to Id
File size: 8.1 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 (future dev).
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 ENVIRONMENT VARIABLES
199.IR TMPDIR
200This variable is used, if defined, as the target directory to create
201all the temporary files needed during the operation (not the scratch files)
202
203.IR TMP
204This variable is used, if defined and if TMPDIR is not defined, as the target
205directory to create all the temporary files needed during the operation
206(not the scratch files)
207
208.IR dirimg
209This variable is setup by the rcS script to store the network remote directory in PXE mode.
210(managed internally)
211
212.IR imgname
213This variable is setup by the rcS script to overwrite the prefix name in PXE mode.
214(managed internally)
215
216.IR netfsmount
217This 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
221This 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
225A link to Mondo's HTML-based manual (by Bruno Cornec, Mikael Hultgren,
226Cafeole, 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
230on your hard drive.
231
232.SH BUGS
233It is recommend that your system has more than 64 MB ram. SCSI device order
234change with nuke can have unexpected results. It is recommended you use expert
235mode with drastic hardware reconfigurations.
236
237.SH "SEE ALSO"
238afio(1), bzip2(1), find(1), mindi(8), mondoarchive(8).
239.SH AUTHORS
240Bruno Cornec (lead-development)
241.I "bruno_at_mondorescue.org"
242.br
243Andree Leidenfrost (co-developer)
244.I "aleidenf_at_bigpond.net.au"
245.br
246.SH ORIGINAL AUTHORS
247Hugo Rabson (original author)
248.I "hugo.rabson_at_mondorescue.org"
249.br
250Jesse Keating (packaging)
251.I "hosting_at_j2solutions.net"
252.br
253Stan Benoit (testing)
254.I "troff_at_nakedsoul.org"
255.br
256Mikael Hultgren (docs)
257.I "mikael_hultgren_at_gmx.net"
258.br
259See mailing list at http://www.mondorescue.org for technical support.
Note: See TracBrowser for help on using the repository browser.