Changeset 2546 in MondoRescue for branches/2.2.10/mondo-doc
- Timestamp:
- Jan 21, 2010, 8:50:00 PM (15 years ago)
- Location:
- branches/2.2.10/mondo-doc
- Files:
-
- 3 edited
-
mondoarchive.8 (modified) (23 diffs)
-
mondorescue-howto.sgml (modified) (2 diffs)
-
mondorestore.8 (modified) (13 diffs)
Legend:
- Unmodified
- Added
- Removed
-
branches/2.2.10/mondo-doc/mondoarchive.8
r2508 r2546 25 25 26 26 .SH SYNOPSIS 27 .B mondoarchive -O27 .B mondoarchive \-O 28 28 [ 29 29 .I options 30 30 ] : backup your PC 31 31 .br 32 .B mondoarchive -V32 .B mondoarchive \-V 33 33 [ 34 34 .I options … … 41 41 non-Linux filesystems to CD's, tape, ISO images or an NFS mount. In the event of 42 42 catastrophic data loss, you will be able to restore everything, taking a PC from 43 bare metal to its original state if necessary. 43 bare metal to its original state if necessary. 44 44 45 45 .PP … … 60 60 61 61 .PP 62 Call mondoarchive 62 Call mondoarchive 63 63 .BR without 64 .BR flags 64 .BR flags 65 65 to make it auto-detect as many settings as possible, ask you politely for the 66 66 rest, and then backup and verify your OS or a subset thereof. 67 67 68 68 .PP 69 To restore data, either run 69 To restore data, either run 70 70 .I mondorestore 71 71 from the command line or boot from the emergency media generated during … … 78 78 79 79 .TP 80 .BI " -c " speed80 .BI "\-c " speed 81 81 Use CD-R drive as backup device and its (write-once) disks as backup media. 82 82 83 83 .TP 84 .BI " -w " speed84 .BI "\-w " speed 85 85 Use CD-RW drive as backup device and its (write/rewrite) disks as backup media. 86 86 Mondo will wipe media before writing to them. 87 87 88 88 .TP 89 .BI " -r "89 .BI "\-r " 90 90 Use DVD drive as backup device and its disks as backup media. Growisofs decides 91 91 on the best speed for your drive. Note that calling mondoarchive 92 92 .B using sudo when writing to DVDs will fail 93 because growisofs does not support this - see the growisofs manpage for93 because growisofs does not support this \- see the growisofs manpage for 94 94 details. 95 95 96 96 .TP 97 .BI " -C " speed97 .BI "\-C " speed 98 98 Use CD-R drive as a streaming device, almost like a tape streamer. Use 99 99 write-once disks as backup media. … … 101 101 102 102 .TP 103 .BI " -p " prefix104 Use 105 .B prefix 103 .BI "\-p " prefix 104 Use 105 .B prefix 106 106 to generate the name of your ISO images. 107 107 By default, mondoarchive names images mondorescue-1.iso, mondorescue-2.iso, ... 108 Using 109 .B -p machine108 Using 109 .B \-p machine 110 110 will name your images machine-1.iso, machine-2.iso, ... 111 111 112 112 .TP 113 .BI " -i "113 .BI "\-i " 114 114 Use ISO files (CD images) as backup media. This is good for backing up your 115 115 system to a spare hard drive. The … … 118 118 119 119 .TP 120 .BI " -n " mount120 .BI "\-n " mount 121 121 Use files residing on a remote share as backup media. 122 122 .I mount … … 130 130 131 131 .TP 132 .BI " -t "132 .BI "\-t " 133 133 Use tape streamer as backup device and its tapes as backup media. 134 134 135 135 .TP 136 .BI " -U "136 .BI "\-U " 137 137 Use a generic USB device as backup device. Use this if you want to write 138 your backup to a USB key or USB disk, which will be make bootable. 138 your backup to a USB key or USB disk, which will be make bootable. 139 139 The USB device should be attached to the system in order for this to work and 140 140 its device name passed to the 141 .BR \-d 141 .BR \-d 142 142 option. Do not use the partition name, but the raw device name (/dev/sda e.g.) 143 143 .B WARNING: All the data on the related device will be removed. 144 144 145 145 .TP 146 .BI " -u "146 .BI "\-u " 147 147 Use a generic streaming device as backup device. Use this if you want to write 148 148 your backup to a device that is not directly support by mondoarchive. This will … … 152 152 .SH MAJOR OPTIONS 153 153 .TP 13 154 .BI " -D "154 .BI "\-D " 155 155 Make a differential backup: examine the filesystem and find which files have 156 156 changed since the last full backup was carried out. Backup only those files. 157 157 158 158 .TP 159 .BI " -E " "\*(lqpath ...\*(rq"159 .BI "\-E " "\*(lqpath ...\*(rq" 160 160 Exclude path(s) from backup. The paths should be separated with a whitespace and surrounded by quotes. 161 161 This is the prefered and recommended option when doing partial archiving. … … 167 167 the mountlist. NB: If you exclude /dev/sdd4 then the /dev entry itself will 168 168 still be backed up, even though the mountlist entry will be suppressed. 169 N.B.: If you specify a directory with a final / its content will be archived so it won't do what you expect. 170 You may also specify full disk device to this option as with -E \*(lq/dev/sda /dev/cciss/c0d0\*(rq 169 N.B.: If you specify a directory with a final / its content will be 170 archived so it won't do what you expect. 171 You may also specify full disk device to this option as with \-E 172 \*(lq/dev/sda /dev/cciss/c0d0\*(rq 171 173 172 174 .TP 173 175 .BI "-I " "\*(lqpath ...\*(rq" 174 Include paths(s) in backup. This option is mainly use to perform tests in order to reduce the time taken by the archiving operation. 175 The default backup path is \*(lq/\*(rq but you may specify alternatives, e.g. -I \*(lq/home /etc\*(rq to override that. 176 You may also specify full disk device to this option as with -I \*(lq/dev/sda /dev/cciss/c0d0\*(rq 176 Include paths(s) in backup. This option is mainly use to perform tests 177 in order to reduce the time taken by the archiving operation. 178 The default backup path is \*(lq/\*(rq but you may specify alternatives, 179 e.g. \-I \*(lq/home /etc\*(rq to override that. 180 You may also specify full disk device to this option as with \-I 181 \*(lq/dev/sda /dev/cciss/c0d0\*(rq 177 182 N.B.: When using the 178 183 .BR \-I 179 option with the 184 option with the 180 185 .BR \-E 181 option, the -E content should be subdirectories of those mentioned in the -I only, as -I takes precedence. 186 option, the \-E content should be subdirectories of those mentioned in 187 the \-I only, as -I takes precedence. 182 188 183 189 .TP 184 190 .BI "-J " "file" 185 191 Specify an explicit list of files and directories to include in a plain text file, one item 186 (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.192 (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. 187 193 188 194 .TP … … 206 212 for processing by an 'expect' wrapper, enabling the user to backup nightly via 207 213 a cron job. However, if you want to run this program with an attractive but 208 non-cron-friendly interface then use ' -g'.214 non-cron-friendly interface then use '\-g'. 209 215 210 216 .TP 211 217 .BI "-k " "path" 212 Path of user's kernel, if you want to use another one than the running one. 218 Path of user's kernel. If you are a Debian (<3.0) or Gentoo (<1.4) user then specify 219 .B \-k FAILSAFE 220 as your kernel. Otherwise, you will rarely need this option. 213 221 214 222 .TP 215 223 .BI "-m " 216 224 Manual (not self-retracting) CD trays are often found on laptops. If you are 217 a laptop user, your CD burner has BurnProof technology or you experience 218 problems with mondo then please call mondoarchive with this switch. 225 a laptop user, your CD burner has BurnProof technology or you experience 226 problems with mondo then please call mondoarchive with this switch. 219 227 220 228 .TP … … 246 254 CD burner using a non-standard command. 247 255 .B -A 248 understands two tokens - _ISO_ and _CD#_ - which will be translated into the256 understands two tokens \- _ISO_ and _CD#_ - which will be translated into the 249 257 ISO's filename and its index number (1, 2, ...) respectively. So, you could use 250 .I -A 'foobackup _ISO_; rm-f _ISO_'258 .I \-A 'foobackup _ISO_; rm \-f _ISO_' 251 259 to feed each ISO to some magical new backup tool. 252 260 … … 254 262 .BI "-B " "command" 255 263 This command will be called before each CD/NFS/ISO file is written. See 256 .B -A264 .B \-A 257 265 for more information. 258 266 … … 279 287 .TP 280 288 .BI "-R " 281 EXPERIMENTAL. Do not use in mission-critical environments. Star is an alternative to afio. Mondo now supports POSIX ACLs and extended attributes, so -R is essentially redundant for now. 289 EXPERIMENTAL. Do not use in mission-critical environments. Star is an 290 alternative to afio. Mondo now supports POSIX ACLs and extended 291 attributes, so \-R is essentially redundant for now. 282 292 283 293 .TP 284 294 .BI "-P " "tarball" 285 295 Post-nuke tarball. If you boot into Nuke Mode and everything is restored 286 successfully then the 296 successfully then the 287 297 .I post-nuke 288 298 script will be sought and executed if found. This is useful for post-restore … … 290 300 just the 291 301 .I post-nuke 292 script (or binary, or whatever it is) but also any files it requires. 302 script (or binary, or whatever it is) but also any files it requires. 293 303 294 304 .TP 295 305 .BI "-S " "path" 296 Specify the full pathname of the scratchdir, the directory where ISO images are built before being297 archived. If you have plenty of RAM and want to use a ramdisk for scratch 298 space, specify its path here.306 Specify the full pathname of the scratchdir, the directory where ISO 307 images are built before being archived. If you have plenty of RAM and 308 want to use a ramdisk for scratch space, specify its path here. 299 309 300 310 .TP 301 311 .BI "-T " "path" 302 Specify the full pathname of the tempdir, the directory where temporary files (other than ISO images303 being assembled) are stored. See304 .B -S312 Specify the full pathname of the tempdir, the directory where temporary 313 files (other than ISO images being assembled) are stored. See 314 .B \-S 305 315 306 316 .TP … … 309 319 this unless you have really great boot disks in your hand and you are an anally 310 320 retentive SOB who can't wait 2 minutes for Mindi to run in the background. If 311 you use -W then you'd better know what the hell you're doing, okay?321 you use \-W then you'd better know what the hell you're doing, okay? 312 322 313 323 .TP … … 332 342 the boot loader can usually be discovered. If you specify RAW then the MBR will 333 343 be backed up and restored byte-for-byte without any analysis. It is likely that 334 you will also need to specify the boot device with -f <dev>. ELILO is mandatory344 you will also need to specify the boot device with \-f <dev>. ELILO is mandatory 335 345 for IA64 machines. 336 346 … … 345 355 .TP 346 356 .BI "-z " 347 Use 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. 357 Use extended attributes and acl for each file and store them in the 358 backup media. Use this option if you use SElinux e.g. but it will slow 359 down backup and restore time of course. 348 360 349 361 350 362 .SH DIAGNOSTICS 351 363 Mondo generates one additional, and extremely important file: 352 .BI /var/log/mondoarchive.log. 353 When seeking technical support, attach this file to your email. 354 364 .BI /var/log/mondoarchive.log. 365 When seeking technical support, attach this file to your email. 355 366 356 367 … … 361 372 support questions. 362 373 374 363 375 .SH NOTES 364 A link to Mondo's HTML-based manual (by Bruno Cornec, Mikael Hultgren, Cafeole, Randy Delphs,365 Stan Benoit, and Hugo Rabson) may be found at376 A link to Mondo's HTML-based manual (by Bruno Cornec, Mikael Hultgren, 377 Cafeole, Randy Delphs, Stan Benoit, and Hugo Rabson) may be found at 366 378 .I http://www.mondorescue.org/docs.shtml 367 - or in 379 \- or in 368 380 .I /usr/share/doc/mondo-x.xx 369 381 on your hard drive. … … 372 384 It is recommend that your system has more than 64 MB ram. SCSI device order 373 385 change with nuke can have unexpected results. It is recommended you use expert 374 mode with drastic hardware reconfigurations. 386 mode with drastic hardware reconfigurations. 375 387 376 388 .SH EXAMPLES … … 378 390 .BI ISO: 379 391 Backup to a directory; note that /mnt/foo's contents will be backed up except 380 for its ISO's unless you exclude it, as follows: -392 for its ISO's unless you exclude it, as follows: 381 393 .br 382 394 .I "mondoarchive -Oi -d /mnt/foo -E '/mnt/foo /mnt/foo2' -p \`hostname\`-\`date +%Y-%m-%d\`" … … 440 452 Backup PC to a Software Raid mount point, iso size 700mb: 441 453 .br 442 .I "mondoarchive -O -s 700m -d /mnt/raid" 454 .I "mondoarchive -O -s 700m -d /mnt/raid" 443 455 444 456 … … 446 458 afio(1), bzip2(1), find(1), mindi(8), mondorestore(8). 447 459 .SH AUTHORS 448 Bruno Cornec (lead-development) 460 Bruno Cornec (lead-development) 449 461 .I "bruno_at_mondorescue.org" 450 462 .br 451 Andree Leidenfrost (co-developer) 463 Andree Leidenfrost (co-developer) 452 464 .I "aleidenf_at_bigpond.net.au" 453 465 .br … … 466 478 .br 467 479 See mailing list at http://www.mondorescue.org for technical support. 468 . -
branches/2.2.10/mondo-doc/mondorescue-howto.sgml
r2508 r2546 1970 1970 do well to read up on the partition layout and the use of fdisk, it 1971 1971 gives you some pointers on how to best lay out partitions. 1972 You can find a good guide at 1973 <ulink url="http://www.tldp.org/HOWTO/Partition/index.html"> http://www.tldp.org/HOWTO/Partition/index.html</ulink>1972 You can find a good guide at the 1973 <ulink url="http://www.tldp.org/HOWTO/Partition/index.html">Partition HOWTO</ulink> 1974 1974 </para> 1975 1975 <para>If you want to restore a subset of the backup then:</para> … … 2041 2041 do well to read up on the partition layout and the use of fdisk, it 2042 2042 gives you some could pointers on how to best lay out partitions. 2043 You can find good a guide at 2044 <ulink url="http://www.ibiblio.org/pub/Linux/docs/HOWTO/mini/Partition/index.html">http://www.ibiblio.o 2045 rg/pub/Linux/docs/HOWTO/mini/Partition/index.html</ulink></para> 2043 You can find good a guide at the 2044 <ulink url="http://www.ibiblio.org/pub/Linux/docs/HOWTO/mini/Partition/index.html">Partition HOWTO</ulink></para> 2046 2045 <para>To restore manually, please:</para> 2047 2046 <itemizedlist> -
branches/2.2.10/mondo-doc/mondorestore.8
r2382 r2546 25 25 26 26 .SH SYNOPSIS 27 .B mondorestore [ -p prefix][-K loglevel][-i][-U]...27 .B mondorestore [\-p prefix][\-K loglevel][\-i][\-U]... 28 28 : restore your PC 29 29 … … 31 31 .PP 32 32 .I mondorestore 33 restores data previously backed up with 33 restores data previously backed up with 34 34 .I mondoarchive. 35 35 36 36 . 37 Note that mondorestore will usually automatically be called when booting a 37 Note that mondorestore will usually automatically be called when booting a 38 38 MondoRescue medium. The only exception is booting a MondoRescue medium in 39 39 .B Expert … … 42 42 .TP 43 43 .BI "-p " prefix 44 Use 45 .B prefix 44 Use 45 .B prefix 46 46 to specify the name of your ISO images. 47 47 By default, mondorestore names images mondorescue-1.iso, mondorescue-2.iso, ... 48 Using 49 .B -p machine48 Using 49 .B \-p machine 50 50 .B mondorestore 51 51 will use images named machine-1.iso, machine-2.iso, ... … … 55 55 Use ISO files (CD images) as restore media. This is good when having backed up your 56 56 system to a spare hard drive. The 57 .B -n57 .B \-n 58 58 switch is a wiser choice if you plan to restore from a remote filesystem. 59 59 … … 75 75 The USB device should be attached to the system in order for this to work and 76 76 its device name passed to the 77 .BR \-d 77 .BR \-d 78 78 option. 79 79 … … 88 88 .BI "-E " "\*(lqpath ...\*(rq" 89 89 Exclude 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 you91 do not want to restore some content, exclude it with that switch.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. 92 92 93 93 .TP 94 94 .BI "-I " "\*(lqpath ...\*(rq" 95 Include paths(s) to restore (future dev). 95 Include paths(s) to restore (future dev). 96 96 97 97 .TP 98 98 .BI "-J " "file" 99 Specify 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. 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. 101 103 102 104 .TP … … 117 119 .BI "-m " 118 120 Manual (not self-retracting) CD trays are often found on laptops. If you are 119 a laptop user, your CD burner has BurnProof technology or you experience 120 problems with mondo then please call mondorestore with this switch. 121 a laptop user, your CD burner has BurnProof technology or you experience 122 problems with mondo then please call mondorestore with this switch. 121 123 122 124 .TP … … 132 134 .TP 133 135 .BI "-T " "path" 134 Specify the full pathname of the tempdir, the directory where temporary files 135 are stored. 136 Specify the full pathname of the tempdir, the directory where temporary files 137 are stored. 136 138 137 139 .TP … … 144 146 .TP 145 147 .BI "-e " 146 Don't eject the CD or tape when restoring... 148 Don't eject the CD or tape when restoring... 147 149 148 150 .TP … … 161 163 .TP 162 164 .BI "-z " 163 Use 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. 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. 164 168 165 169 .TP 166 170 .BI "-Z " 167 171 Specify mondorestore mode. Mode could be one of 168 .IR nuke: 172 .IR nuke: 169 173 This mode restore everything like on the original system with no/minimal questions 170 .IR interactive: 174 .IR interactive: 171 175 This mode asks all the questions to the user 172 .IR compare: 176 .IR compare: 173 177 This mode just compares the system with the backup 174 .IR iso: 178 .IR iso: 175 179 This mode restores from iso images, instead of real media 176 .IR isonuke: 180 .IR isonuke: 177 181 This mode restores from iso images, instead of real media, with no/minimal questions 178 .IR mbr: 182 .IR mbr: 179 183 This mode just restores the MBR (Master Boot Record) 180 184 … … 182 186 .SH DIAGNOSTICS 183 187 mondorestore generates an Extremely important file: 184 .BI /var/log/mondorestore.log. 185 When seeking technical support, attach this file to your email. 188 .BI /var/log/mondorestore.log. 189 When seeking technical support, attach this file to your email. 186 190 187 191 .SH FILES 188 192 .IR /var/log/mondorestore.log 189 This log contains important information required to analyse mondorestore problem 190 reports. Mondo support highly recommends sending this file with support 191 questions. It's located under /tmp during the restore process and moved under /var/log at the end. 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. 192 197 193 198 .SH NOTES 194 A link to Mondo's HTML-based manual (by Bruno Cornec, Mikael Hultgren, Cafeole, Randy Delphs,195 Stan Benoit, and Hugo Rabson) may be found at199 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 196 201 .I http://www.mondorescue.org/docs.shtml 197 - or in 202 \- or in 198 203 .I /usr/share/doc/mondo-x.xx 199 204 on your hard drive. … … 202 207 It is recommend that your system has more than 64 MB ram. SCSI device order 203 208 change with nuke can have unexpected results. It is recommended you use expert 204 mode with drastic hardware reconfigurations. 209 mode with drastic hardware reconfigurations. 205 210 206 211 .SH "SEE ALSO" 207 212 afio(1), bzip2(1), find(1), mindi(8), mondoarchive(8). 208 213 .SH AUTHORS 209 Bruno Cornec (lead-development) 214 Bruno Cornec (lead-development) 210 215 .I "bruno_at_mondorescue.org" 211 216 .br 212 Andree Leidenfrost (co-developer) 217 Andree Leidenfrost (co-developer) 213 218 .I "aleidenf_at_bigpond.net.au" 214 219 .br … … 227 232 .br 228 233 See mailing list at http://www.mondorescue.org for technical support. 229 .
Note:
See TracChangeset
for help on using the changeset viewer.
