source: MondoRescue/branches/2.2.10/mondo-doc/mondorescue-howto.sgml@ 2508

Last change on this file since 2508 was 2508, checked in by Bruno Cornec, 14 years ago

r3287@localhost (orig r2285): bruno | 2009-07-20 11:36:47 +0200

r3285@localhost: bruno | 2009-07-20 11:17:35 +0200
Apply fix in 2.2.10 around multi USB device handling to 2.2.9 as well


r3291@localhost (orig r2288): bruno | 2009-07-21 16:48:31 +0200
Copy 2.2.10 test script in to 2.2.9 for memory problm analysis


r3293@localhost (orig r2290): bruno | 2009-07-22 14:03:44 +0200

  • Fix a printing error in mindi for the tar command
  • Fix all mr_asprintf which had no second param as a string


r3295@localhost (orig r2292): bruno | 2009-07-22 16:55:00 +0200

  • Fix #160 and #346 by rewriting the message.txt file with more valid information gathered in mindi


r3300@localhost (orig r2294): bruno | 2009-07-23 01:58:08 +0200

Man pages patch from Joe Ross (joe.ross_at_gmail.com)


r3303@localhost (orig r2297): bruno | 2009-07-23 17:43:49 +0200
Fix a remaining display error for 2.2.9. That version has been tested OK in a lab.


r3304@localhost (orig r2298): bruno | 2009-07-23 18:18:27 +0200

  • Remove memory leak for the last modification


r3308@localhost (orig r2302): bruno | 2009-07-24 21:18:50 +0200
Improve logging of mountlist.txt


r3310@localhost (orig r2304): bruno | 2009-07-27 19:45:10 +0200

  • popup_and_get_string needs an allocated buffer for the moment so fixing the calls with dyn. ones
  • Fix a bug in mem.c for mr_strcat, which wasn't modifying the right pointer level


r3311@localhost (orig r2305): bruno | 2009-07-27 19:49:35 +0200
Avoid a memory leak in the previous patch


r3314@localhost (orig r2308): bruno | 2009-07-27 20:59:06 +0200
Fix a bug in mr_strcat backported from 2.2.10. Should solve our seg faults.


r3315@localhost (orig r2309): bruno | 2009-07-28 02:14:23 +0200
Cosmetic changes to allow for quality to not giv false positive


r3343@localhost (orig r2311): bruno | 2009-08-18 02:13:43 +0200
Fix for initramfs detection with 2.6.30 (Hugo Vanwoerkom hvw59601_at_care2.com)


r3367@localhost (orig r2333): bruno | 2009-08-18 16:26:26 +0200
Adds a precision for -U option in man page on raw device usage and not partition name


r3373@localhost (orig r2336): bruno | 2009-08-20 17:37:41 +0200

  • Precise the combined usage of -E and -I in mondoarchive (Case 4601017223)


r3379@localhost (orig r2342): bruno | 2009-08-21 16:27:10 +0200


r3383@localhost (orig r2344): bruno | 2009-08-24 13:37:09 +0200

r3382@localhost: bruno | 2009-08-24 13:30:25 +0200
In NFS mode also propose access to expert, interactive, ... entry at boot prompt


r3388@localhost (orig r2346): bruno | 2009-08-27 11:41:16 +0200
Adds fdisk -l result in Log File at restore time


r3389@localhost (orig r2347): bruno | 2009-08-27 13:51:00 +0200

  • Solve tmp dir creation which sometimes was trying to create /%xx dirs. Should fix #293 for good


r3390@localhost (orig r2348): bruno | 2009-08-27 13:54:25 +0200
Improve logging (minor)


r3394@localhost (orig r2350): bruno | 2009-08-28 02:24:19 +0200
Change inerface of evaluate_mountlist and spread_flaws_across_three_lines in order to solve bugs linked to strings management in these functions. May fix a restoration crash seen by some customers


r3397@localhost (orig r2353): bruno | 2009-08-28 19:03:45 +0200

  • Addition of a nomd option to avoid starting mdadm
  • mpath is now already started if there was a mpath entry in mountlist


r3399@localhost (orig r2355): bruno | 2009-08-29 00:56:50 +0200
Remove function spread_flaws_across_three_lines and expand it at the single place where it was useful, and fix memory allocation issues in it.


r3402@localhost (orig r2358): bruno | 2009-09-01 19:02:35 +0200
P2V doc updated (Lester Wade lester.wade_at_hp.com)


r3404@localhost (orig r2360): bruno | 2009-09-01 19:26:53 +0200
Website update to refer to new P2V document


r3405@localhost (orig r2361): bruno | 2009-09-03 13:54:25 +0200

  • Fix a case where the NFS dir in restore mode was mounted rw (linked to bug #291 could create a huge problem)


r3407@localhost (orig r2363): bruno | 2009-09-03 14:46:46 +0200
More verbose at installation of additional tools


r3409@localhost (orig r2365): bruno | 2009-09-03 18:08:32 +0200

  • New update from Lester Wade (lester.wade_at_hp.com) for P2V doc


r3410@localhost (orig r2366): bruno | 2009-09-05 01:28:18 +0200
place the code of mondo_makefilelist before its call



r3411@localhost (orig r2367): bruno | 2009-09-06 01:51:26 +0200

  • Advertising for project-builder on the website added


r3412@localhost (orig r2368): bruno | 2009-09-07 15:36:23 +0200
Fix compilation issue


r3413@localhost (orig r2369): bruno | 2009-09-07 18:03:40 +0200
Another compilation issue fixed.


r3415@localhost (orig r2371): bruno | 2009-09-08 13:40:25 +0200

  • Fix a problem a error detection in evaluate_mountlist which casued nuke mode to abort. Error string should also be better now.


r3417@localhost (orig r2373): bruno | 2009-09-08 13:55:31 +0200
Avoid asking the Prefix name in NFS mode twice


r3418@localhost (orig r2374): bruno | 2009-09-08 20:04:07 +0200

  • Try to fix garbled screen progression in text mode based on 2.2.10 modifications which are working


r3424@localhost (orig r2380): bruno | 2009-09-09 20:30:47 +0200

  • Change NFS support into a NetFS support to allow for multiple protocol in addition to NFS (NEEDS TESTING)
  • Better logging to detect a potential nuke issue


r3425@localhost (orig r2381): bruno | 2009-09-10 02:05:55 +0200
Fix a missing param for sshfs call


r3428@localhost (orig r2384): bruno | 2009-09-10 13:02:56 +0200

  • Remove separate function look_for_duplicate_mountpoints used only once and whose interface created problems with caller


r3430@localhost (orig r2386): bruno | 2009-09-10 16:06:52 +0200
Be compatible on backup type by making old nfs recognized as netfs and proto forced


r3431@localhost (orig r2387): bruno | 2009-09-10 18:40:47 +0200
Fix a problem in netfs analysis in mondoarchive


r3432@localhost (orig r2388): bruno | 2009-09-10 20:25:13 +0200
Fix mondoarchive CLI analysis for NETFS type of requests


r3434@localhost (orig r2390): bruno | 2009-09-11 03:05:20 +0200

  • Adds ext3 initrd support for 2.6.30


r3437@localhost (orig r2393): bruno | 2009-09-11 11:56:52 +0200

  • Tries to add support for bzip2 and lzma initramfs (preliminary, not tested) for 2.6.30


r3438@localhost (orig r2394): bruno | 2009-09-12 02:53:02 +0200
Fix interface of evaluate_mountlist (remove 2nd param useless) and fix nuke mode which wasn't working.


r3441@localhost (orig r2397): bruno | 2009-09-14 18:54:34 +0200
Fix a format issue in text mode on percentage


r3452@localhost (orig r2398): bruno | 2009-09-15 16:00:13 +0200

  • Fix a bug where flaws_str could be NULL and wasn't tested correctly.


r3453@localhost (orig r2399): bruno | 2009-09-15 19:28:39 +0200

  • Use protocol name when displaying restore progress instead of netfs
  • Ask for network protocol name at restore time


r3455@localhost (orig r2401): bruno | 2009-09-15 19:34:19 +0200
Wrong structure member name was used


r3456@localhost (orig r2402): bruno | 2009-09-16 13:04:17 +0200
Use dir for shell related commands and dir1 for C related actions in open_and_list_dir to avoid missing some files with { in names e.g.


r3457@localhost (orig r2403): bruno | 2009-09-16 16:32:03 +0200

  • At restore time read the netfs protocol in the conf file


r3462@localhost (orig r2408): bruno | 2009-09-18 15:17:08 +0200
Remove useless script


r3463@localhost (orig r2409): bruno | 2009-09-18 15:25:35 +0200

  • Split deplist.txt into multiple conf files under deplist.d in the conf dir. This will allow to have a minimal.conf file for initrd content to analyze to improve support of new embedded feature in the future (sshfs, live install). The other conf files contain the additional commands to put in the all.tar.gz. For the moment, mindi is still working the same. THis infra will allow that support in a near future. deplist.txt is now reserved for the admin additional commands.


r3465@localhost (orig r2410): bruno | 2009-09-18 19:10:54 +0200

  • Better list of mandatory tools
  • Adds fuse and sshfs support in initrd


r3466@localhost (orig r2411): bruno | 2009-09-18 20:32:47 +0200
sshfs also needs ssh at restore time in initrd


r3478@localhost (orig r2418): bruno | 2009-09-23 23:22:39 +0200
Modify getfattr call to have all extended attributes, including non user ones. (patch from Kevin Ritzenthaler Kevin.Ritzenthaler_at_hp.com) and fix #357


r3479@localhost (orig r2419): bruno | 2009-09-23 23:50:34 +0200
star only supports ACL when used with exustar mode. Fix #356.


r3482@localhost (orig r2422): bruno | 2009-09-24 16:53:24 +0200

  • Adds support for bnx2x (BL 460 G6) and auth_rpcgss (Debian 2.6.31)


r3485@localhost (orig r2423): bruno | 2009-09-25 16:38:40 +0200
Fix an issue in is_this_device_mounted (string freed before last usage)


r3486@localhost (orig r2424): bruno | 2009-09-25 18:44:01 +0200

  • analyze-my-lvm now removes excluded devices from list coming from mondoarchive
  • new mr_make_devlist_from_pathlist which handle the new bkpinfo->exclude_devs field containing the excluded devices and remove corresponding code from libmondo-cli.c
  • Move DSF code into libmondo-devices.c for coherency, and only the previous function is made externally available
  • Remove dev_to_exclude in libmondo-archive.c which wasn't working correctly and replace it with bkpinfo->exclude_devs


r3487@localhost (orig r2425): bruno | 2009-09-25 18:58:23 +0200

  • Improving ssh support at restore time by providing a shadow file


r3489@localhost (orig r2426): bruno | 2009-09-25 19:42:09 +0200

  • Attempt to stay backward compatible without protocol for -n option


r3490@localhost (orig r2427): bruno | 2009-09-28 02:08:06 +0200
Avoids null param for excludes_devs for mindi call


r3492@localhost (orig r2429): bruno | 2009-09-28 11:46:16 +0200

  • Simplify GetInitrdFilesystemToUse which doesn't need to detect everything, but just know if it's initramfs (new mode) or a compressed FS ext2/3 (older mode) as initrd is anyway re-made by mindi. Should fix #353


r3494@localhost (orig r2431): bruno | 2009-09-28 13:16:18 +0200

  • Use only the AWK veriable everywhere and not the awk command


r3495@localhost (orig r2432): bruno | 2009-09-28 14:16:31 +0200
Warning emited in case of duplicate mountpoints or devices in fstab found


r3496@localhost (orig r2433): bruno | 2009-09-28 15:55:17 +0200
ssh in the restore env needs some dlopened libs (libnss_compat|files)


r3497@localhost (orig r2434): bruno | 2009-09-28 16:33:14 +0200
Compiler warning fixed


r3498@localhost (orig r2435): bruno | 2009-09-28 17:55:26 +0200
Improve user management for NetFS cases


r3499@localhost (orig r2436): bruno | 2009-09-29 01:48:32 +0200

  • Improve deplist.d/* files
  • adds libnss for ssh support in boot disk
  • Solve a memory management issue in DSF module (strtok => mr_strtok)
  • DSF now also supports partitions in addition to full disks
  • Adds debug in open_and_list_dir


r3500@localhost (orig r2437): bruno | 2009-09-29 10:41:56 +0200

  • Fix udev support in init for Mandriva 2009.1 (udevadm settle is blocking)


r3501@localhost (orig r2438): bruno | 2009-09-29 14:41:36 +0200

  • Improvements on sshfs/ssh management in restore mode
  • Include now all minimal requirements for sshfs


r3502@localhost (orig r2439): bruno | 2009-09-29 18:46:08 +0200

  • Avoids error message if some ssh conf files do not exist


r3503@localhost (orig r2440): bruno | 2009-09-29 18:57:13 +0200

  • Avoids comment analysis in the new code handling deplist.d


r3504@localhost (orig r2441): bruno | 2009-09-29 19:34:34 +0200

  • fuse device is needed at restore time for sshfs


r3505@localhost (orig r2442): bruno | 2009-09-29 20:02:36 +0200

  • Improves udev timeout handling


r3506@localhost (orig r2443): bruno | 2009-09-29 20:43:38 +0200

  • priority given to env var for tmpdir
  • fuse FS excluded from tmpdir computation


r3518@localhost (orig r2447): bruno | 2009-10-04 01:58:08 +0200

  • Iprove USB log in case of error by adding the conf file


r3519@localhost (orig r2448): bruno | 2009-10-05 11:06:13 +0200


r3520@localhost (orig r2449): bruno | 2009-10-06 01:10:35 +0200

  • Adds support for grub2 conf file grub.cfg in addition to menu.lst


r3521@localhost (orig r2450): bruno | 2009-10-06 01:24:02 +0200

  • Fix a mr_asprintf usage without & causing a seg fault.


r3523@localhost (orig r2452): bruno | 2009-10-06 12:47:56 +0200
CIFS mounts shouldn't be part of the mountlist analysis (should help solving #288)


r3524@localhost (orig r2453): bruno | 2009-10-07 10:17:03 +0200

  • Fix a bug in handling of -E option with real devices (bad report in function mr_make_devlist_from_pathlist of the test between -E and -I)


r3525@localhost (orig r2454): bruno | 2009-10-07 10:19:02 +0200

  • Fix an error in the test for grub conf files (or used instead of and)


r3526@localhost (orig r2455): bruno | 2009-10-07 16:14:59 +0200
afio is under /bin on Debian


r3527@localhost (orig r2456): bruno | 2009-10-07 17:31:26 +0200

  • Adds support for libcrc32c (needed by bnx2x)


r3532@localhost (orig r2457): bruno | 2009-10-09 13:33:44 +0200

  • Apply path from Matthew Cline (matt_at_nightrealms.com) in order to fix #359


r3533@localhost (orig r2458): bruno | 2009-10-09 13:41:02 +0200
Adds a conf file example for mindi and fix #360


r3535@localhost (orig r2459): bruno | 2009-10-09 15:13:01 +0200
MOde of conf file


r3546@localhost (orig r2461): bruno | 2009-10-14 01:12:24 +0200

  • umount freshly created VFAT partition on USB key as Ubunu has an automounter mounting it as soon as created (Steffen Neumann sneumann_at_ipb-halle.de)


r3566@localhost (orig r2463): bruno | 2009-10-26 01:34:16 +0100

  • Reset an error counter before blanking a DVD to avoid always returning an error (Vincent Raman vincent.raman_at_macqel.eu)


r3567@localhost (orig r2464): bruno | 2009-10-26 13:57:14 +0100
bzip2 is under /bin on Debian


r3568@localhost (orig r2465): bruno | 2009-10-28 01:46:30 +0100
some distro hold lvm commands under /usr/sbin


r3595@localhost (orig r2469): bruno | 2009-11-10 12:22:10 +0100
/dev/shm is now part of the default exclude list


r3596@localhost (orig r2470): bruno | 2009-11-10 12:32:40 +0100
Remove useless pb_log and MONDO_TRACEFILE


r3597@localhost (orig r2471): bruno | 2009-11-10 12:57:58 +0100
Improve analysis of kernel modules by printing whether it's a live or extra module which has not been found (Matthew Cline) as reported in #362


r3598@localhost (orig r2472): bruno | 2009-11-10 13:21:46 +0100

  • Default to DVD size when in iso or netfs mode


r3599@localhost (orig r2473): bruno | 2009-11-10 14:13:10 +0100

  • Fix #363 where exclude_paths was extended up to memory limit dumping core


r3600@localhost (orig r2474): bruno | 2009-11-10 14:31:14 +0100

  • Update deplist for Debian support


r3602@localhost (orig r2476): bruno | 2009-11-11 02:44:42 +0100

  • small improvement for loging in USB case


r3603@localhost (orig r2477): bruno | 2009-11-11 13:29:27 +0100

  • Adds a nolvm boot option at restore time


r3604@localhost (orig r2478): bruno | 2009-11-11 19:54:51 +0100

  • Fix #367 - the for loop doesn't make any test now, as it was computed before entering the loop, leading to an error, and was also made inside the loop anyway.


r3605@localhost (orig r2479): bruno | 2009-11-12 00:32:45 +0100

  • Add support for diskdumplib driver useful for RHEL 3 and IBM xseries 336


r3606@localhost (orig r2480): bruno | 2009-11-12 01:09:40 +0100

  • If using nolvm, mondorestore should also not nalyze and handle i-want-my-lvm


r3608@localhost (orig r2482): bruno | 2009-11-14 12:54:11 +0100
Fix bunzip2 on debian as well


r3610@localhost (orig r2484): bruno | 2009-11-15 00:44:19 +0100

  • Adds support for variable serial port console, with defalut to /dev/ttyS0, and a boot param to change it with serial=/dev/ttySx


r3615@localhost (orig r2485): bruno | 2009-11-15 01:34:33 +0100

r3614@localhost: bruno | 2009-11-15 01:34:12 +0100
Adds a space in exclude paths


r3623@localhost (orig r2487): bruno | 2009-11-18 20:41:40 +0100

r3620@localhost: bruno | 2009-11-18 10:31:36 +0100

  • Only link /dev/tty to serial port when there is indeed a serial port. If not breaks mondorestore on normal console


r3631@localhost (orig r2490): bruno | 2009-11-24 01:48:29 +0100
Put news below in the main page to make it more readable


r3648@localhost (orig r2492): bruno | 2009-11-25 23:50:13 +0100

r3647@localhost: bruno | 2009-11-25 23:49:11 +0100

  • Add warning for -f and SW Raid as in 2.2.10


r3650@localhost (orig r2493): bruno | 2009-11-26 00:19:52 +0100

r3649@localhost: bruno | 2009-11-26 00:18:27 +0100

  • Addition of the german translation made by Magnus Rasche (Magnus.rasche_at_gmx.de) and Website inclusion


r3652@localhost (orig r2495): bruno | 2009-11-27 15:55:55 +0100
cosmetic display fix
r3659@localhost (orig r2498): bruno | 2009-12-05 17:53:03 +0100
nfsopt restore boot time option added to support custom mount options for network restore


r3684@localhost (orig r2501): bruno | 2009-12-17 00:35:08 +0100
Fix #375 mondo will segfault if the partition in sensibly_set_tmpdir_and_scratchdir() is read-only (cylau)


r3685@localhost (orig r2502): bruno | 2009-12-17 01:02:47 +0100

  • Fix an issue in the function listing kernel modules when not found


r3686@localhost (orig r2503): bruno | 2009-12-17 01:15:01 +0100
Adds scsi_dump_register to mindi SCSI_MODS for RHEL3 + IBM servers


r3701@localhost (orig r2504): bruno | 2009-12-23 02:24:33 +0100

  • Addition of the Lab for Mondorescue


r3702@localhost (orig r2505): bruno | 2009-12-23 02:41:17 +0100
Web site update for Lab MondoRescue delivery


r3706@localhost (orig r2506): bruno | 2010-01-04 11:31:53 +0100

  • Fix a bug when isodir is / only when splitting it in iso_path and iso_mnt


r3707@localhost (orig r2507): bruno | 2010-01-04 13:22:49 +0100

  • Fix #377: Segfault in pause_and_ask_for_cdr() (ggeens)


File size: 97.8 KB
Line 
1<!DOCTYPE BOOK PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
2<!ENTITY curdate "PBDATE">
3<!ENTITY curver "PBVER-rPBREV">
4
5<!ENTITY WWWB "http://www.mondorescue.org/">
6<!ENTITY WWW '<ulink url="http://www.mondorescue.org">MondoRescue</ulink>'>
7<!ENTITY ML '<ulink url="http://lists.sourceforge.net/lists/listinfo/mondo-devel">mondorescue mailing list</ulink>'>
8<!ENTITY gfdl SYSTEM "fdl.sgml">
9]>
10
11<book>
12
13<bookinfo>
14<title>MondoRescue HOWTO</title>
15<subtitle>
16Utilisation and Configuration of Mondo and Mindi under Linux (Version &curver;)
17</subtitle>
18<graphic fileref="images/protected-by-mondo" align="center">
19
20<pubdate>
21in its latest version the
22&curdate;
23</pubdate>
24
25<abstract>
26<para>
27This document describes the use of mondo and mindi tools to realize disaster recovery backup of your systems. It provides information on installation, backup and restore modes, hardware and software requirements, and answers to some frequently asked questions.
28The goals are to offer a general view of the functions and their best usages.
29Mondo Rescue is a Disaster Recovery Solution which allows you
30to effortlessly backup and interactively restore Linux, Windows and
31other supported filesystem partitions to/from CD/DVD-+R/RW media, tape,
32NFS, ... and Mindi Linux provides the bootable emergency restore
33media which Mondo uses at boot-time.
34</para>
35</abstract>
36
37<author>
38<firstname>Bruno</firstname>
39<surname>Cornec</surname>
40<affiliation>
41<orgname>MondoRescue Project</orgname>
42<address><email>bruno@mondorescue.org</email></address>
43</affiliation>
44</author>
45<author>
46<firstname>Conor</firstname>
47<surname>Daly</surname>
48<affiliation>
49<orgname>MondoRescue Project</orgname>
50<address><email>conor.daly_at_met.ie</email></address>
51</affiliation>
52</author>
53<!--
54Hugo Rabson
55Mikael Hultgren
56Stan Benoit
57Randy Delfs
58Cafeole
59Bryan J. Smith
60-->
61
62<copyright>
63<year>2000-2006</year>
64<holder role="mailto:bruno@mondorescue.org">Bruno Cornec</holder>
65</copyright>
66
67<legalnotice>
68<title>License</title>
69<para>
70</para>
71<para>
72This HOWTO is a free documentation. you may copy, redistribute and/or modify it under the terms of the
73<Link LinkEnd="gfdl">
74GNU Free Documentation License, Version 1.1
75</link>.</para>
76<para>
77or any later version published by the Free Software Foundation; with no Invariant Sections, Front-Cover Texts or Back-Cover Texts. This document is distributed hoping it will be useful, but <emphasis>without any guaranty</emphasis>; you're completely responsible of its use, and coulnd't complain in case it doesn't work, or even if it breaks the hardware. All the software included in it, if not already copyrighted is released under the GPL.
78</para>
79</legalnotice>
80
81<revhistory>
82<revision>
83 <revnumber>2.0.7</revnumber>
84 <date>2006-05-16</date>
85 <authorinitials>Bruno Cornec</authorinitials>
86 <revdescription>
87 <para>
88 Integration of a chapter on HOWTO run mondo interactively using cron written by Conor Daly
89 </para>
90 </revdescription>
91</revision>
92<revision>
93 <revnumber>2.06</revnumber>
94 <date>2006-01-16</date>
95 <authorinitials>Bruno Cornec</authorinitials>
96 <revdescription>
97 <para>
98 First SGML version publically available, remade from the HTML docs of the project.
99 </para>
100 </revdescription>
101</revision>
102</revhistory>
103</bookinfo>
104
105<toc></toc>
106<lot></lot>
107
108
109<chapter id="intro">
110<title>About this Guide</title>
111
112<sect1 id="intro-purpose">
113<title>Purpose / Scope of this Guide</title>
114
115<para>
116This HOWTO serves to help people get started with using
117mondo/mindi as way to backup/restore their system. This is a work
118constantly evolving. It was started by Hugo Rabson and has
119since been worked upon by a number of people. See the
120'<ulink url="&WWWB;about.shtml#devteam">About</ulink>' web
121page for a list of members of the development team.</para>
122
123<para>There are many ways to contribute to the Linux movement
124without actually writing code. One of the most important is writing
125documentation, allowing each person to share their knowledge with
126thousands of others around the world. This HOWTO is designed to
127help you get familiar with how Mondo/Mindi works.</para>
128
129<para>
130Opinions expressed here are those of the authors.
131Informations are provided in the aim to be useful to the readers.
132However, there can't be, through this document, any warranty of any kind
133on the way it works on your systems, nor the author could be responsible for any problem caused by the use of these informations.
134However, software editors don't garantee you a lot either (re-read the contracts).
135</para>
136</sect1>
137
138<sect1 id="intro-newversion"><title>New versions of this document</title>
139
140<para>The newest version of this document can always be found on
141MondoRescue's homepage &WWW;.</para>
142<para>
143If you make a translation of this document into another language, please let meknow so that I can include a reference to it here.
144</para>
145</sect1>
146
147<sect1><title>Suggestions / Feedback</title>
148<para>
149I rely on you, the reader, to make this HOWTO useful. THis HOWTO is probably incomplete even if it tries to be accurate to the best of our knowledge.
150If you have any suggestions, corrections, recommandations or congratulations :-) don't hesitate to send them to me
151<email>bruno@mondorescue.org</email>,
152and I will try to incorporate them in a next revision or to the &ML;;
153e-mail the list at
154<ulink url="mailto:mondo-devel@lists.sourceforge.net">mondo-devel@lists.sourceforge.net</ulink>;
155tell us what is wrong and how it should be fixed.
156Include the section title and recommended changes. Whenever possible, include
157the exact, spell-checked, grammar-checked text that you think would
158improve the document.
159</para>
160<para>See Mondo's
161 <ulink url="http://www.mondorescue.org/support.shtml">Support</ulink> page for
162more information.
163</para>
164<para>
165Please note that we do our best to help everyone but it is
166difficult for us to help you if you do not attach a log file to
167your e-mail. Let me say that again - attach your log file to your
168e-mail! Thank you. Without it we can't offer
169any tangible help because you aren't either. That's what the log
170file is for. It is located at <filename>/var/log/mondoarchive.log</filename>; and <filename>/var/log/mindi.log</filename> (if called alone) or at <filename>/var/log/mondorestore.log</filename>
171</para>
172<para>
173This document was originaly written by native english speakers, but is maintained by a non-native english speaker so help me correct mistaques (sic) instead of rumbling that I've done one :-)
174</para>
175<para>
176I am also willing to answer general questions on MondoRescue, the best I can.
177Before doing so, please read all of the information in this HOWTO, and then send me detailed information about the problem, especially including the logs generated by the tools, or traces obtained (Did I say that already :-].
178</para>
179<para>
180If you publish this document on a CD-ROM or in hardcopy form, a complimentary copy would be appreciated; mail me for my postal address. Also consider making a donation to the Linux Documentation Project to help support free documentation for Linux. Contact the Linux HOWTO coordinator,
181Guylhem AZNAR <email>guylhem@rrremovethis.oeil.qc.ca</email>.
182</para>
183</sect1>
184
185<sect1 id=intro-thanks><title>Aknowledgements</title>
186
187<para>Thanks goes to these people for helping and adding to this
188HOWTO.</para>
189
190<para>Document maintainer:</para>
191<itemizedlist mark="bullet" spacing="Compact">
192<listitem>
193<para>Bruno Cornec</para>
194</listitem>
195</itemizedlist>
196<para>Original Design Assistance by:</para>
197<itemizedlist>
198<listitem>
199<para>Xion Network.com</para>
200</listitem>
201</itemizedlist>
202<para>Original Document Assistance by:</para>
203<itemizedlist>
204<listitem>
205<para>Cafeole</para>
206</listitem>
207<listitem>
208<para>Troff</para>
209</listitem>
210<listitem>
211<para>Randy Delfs</para>
212</listitem>
213<listitem>
214<para>Mikael Hultgren</para>
215</listitem>
216</itemizedlist>
217<para>Original LinuxDoc and LaTeX Reformat by:</para>
218<itemizedlist>
219<listitem>
220<para>Bryan J. Smith</para>
221</listitem>
222</itemizedlist>
223<para>Original DocBook Reformat by:</para>
224<itemizedlist>
225<listitem>
226<para>Mikael Hultgren</para>
227</listitem>
228</itemizedlist>
229<para>Original author; 1.6x material:</para>
230<itemizedlist>
231<listitem>
232<para>Hugo Rabson</para>
233</listitem>
234</itemizedlist>
235
236</sect1>
237</chapter>
238
239<chapter id="quickstart"><title>QuickStart</title>
240<itemizedlist mark="bullet" spacing="Compact">
241<listitem>
242<para>We recommend that you read this complete
243HOWTO. However, if you are too busy or impatient, then
244please use this QuickStart guide to stay out of trouble.</para>
245</listitem>
246<listitem>
247<para>Install the tarball, RPM, or DEB mindi and mondo
248packages. (see <link linkend="installation">Installation</link>
249for more details)</para>
250</listitem>
251<listitem>
252<para>Execute as root (type 'su -' to become root if you are not
253logged in as root)</para>
254<para></para>
255
256<informaltable><tgroup cols="1"><tbody>
257<row>
258<entry>
259
260bash# mondoarchive
261
262</entry>
263</row>
264</tbody></tgroup></informaltable>
265
266</listitem>
267</itemizedlist>
268<para></para>
269
270<informaltable><tgroup cols="2"><tbody>
271<row>
272<entry>
273<ulink url="images/mamain.png"><inlinemediaobject><imageobject>
274<imagedata fileref="images/mamain-mini">
275</imageobject></inlinemediaobject>
276</ulink>
277</entry>
278<entry>
279Choose from the list of supported backup media types. The media you
280will use most often are CD/DVD-+R, CD/DVD-+RW, tape, NFS and hard disk. If
281you want to backup/restore over a network, choose 'NFS'. If you
282want to backup/restore to/from a local partition or if you simply
283want to store the ISO images in a local directory until you have
284time or facilities to burn them to CD's, choose 'hard disk'. If you
285choose 'CD/DVD-+R[W]' or 'tape' then in general your hardware will be
286detected and configured for you.
287</entry>
288</row>
289<row>
290<entry>
291<ulink url="images/maburnproof.png"><inlinemediaobject><imageobject>
292<imagedata fileref="images/maburnproof-mini">
293</imageobject></inlinemediaobject>
294</ulink>
295</entry>
296<entry>
297 If you are backing up to CD/DVD-+R[W] then Mondo will ask you if your CD
298burner has BurnProof technology, is inside a laptop, or is
299otherwise eccentric. If you are backing up to a tape streamer then
300you will not see this message.
301</entry>
302</row>
303<row>
304<entry>
305<ulink url="images/macompression.png"><inlinemediaobject><imageobject>
306<imagedata fileref="images/macompression-mini">
307</imageobject></inlinemediaobject>
308</ulink>
309</entry>
310<entry>
311How much compression do you want? None, if your tape streamer has
312built-in hardware compression. Maximum, if your CPU is blazingly
313fast. Average should do just fine for most situations.
314</entry>
315</row>
316<row>
317<entry>
318<ulink url="images/mainclude.png"><inlinemediaobject><imageobject>
319<imagedata fileref="images/mainclude-mini">
320</imageobject></inlinemediaobject>
321</ulink>
322</entry>
323<entry>
324If you want to backup the whole computer (excluding /sys and /proc,
325naturally) then leave this as / which is the default. Otherwise,
326specify subsets, (e.g. /usr/local /home ) being sure to put a space
327in between each path.
328</entry>
329</row>
330<row>
331<entry>
332<ulink url="images/maexclude.png"><inlinemediaobject><imageobject>
333<imagedata fileref="images/maexclude-mini">
334</imageobject></inlinemediaobject>
335</ulink>
336</entry>
337<entry>
338If you are backing up your whole computer then you might want to
339exclude certain directories, e.g. /shared/MP3. Please specify them
340in the 'exclude directories' dialog box. Please put a space in
341between each path, e.g. /shared/private /scratch /nfs /windows
342</entry>
343</row>
344<row>
345<entry>
346<ulink url="images/maverifyq.png"><inlinemediaobject><imageobject>
347<imagedata fileref="images/maverifyq-mini">
348</imageobject></inlinemediaobject>
349</ulink>
350</entry>
351<entry>
352If you want to verify the archives after writing them to media, say
353'yes' here. If you have absolute faith in your hardware and your
354Linux distribution, say 'no'... and a little prayer.
355</entry>
356</row>
357<row>
358<entry>
359<ulink url="images/maproceedq.png"><inlinemediaobject><imageobject>
360<imagedata fileref="images/maproceedq-mini">
361</imageobject></inlinemediaobject>
362</ulink>
363</entry>
364<entry>
365If you are sure you want to go ahead, say 'yes' and find something
366else to do while Mondo backs up your computer. If you say 'no' then
367you will be unceremoniously dumped at the shell prompt. :-)
368</entry>
369</row>
370<row>
371<entry>
372<ulink url="images/1.png"><inlinemediaobject><imageobject>
373<imagedata fileref="images/1-mini">
374</imageobject></inlinemediaobject>
375</ulink>
376</entry>
377<entry>
378The backup process will now commence. There are some pre-backup
379tasks to be carried out first but the backup is essentially
380underway. To simplify the backup process, you were asked a series
381of questions. Next time, if you like, you could call mondoarchive
382with various command-line switches to control its behavior, instead
383of answering a series of questions. See the man page for details.
384</entry>
385</row>
386<row>
387<entry>
388<ulink url="images/3.png"><inlinemediaobject><imageobject>
389<imagedata fileref="images/3-mini">
390</imageobject></inlinemediaobject>
391</ulink>
392</entry>
393<entry>
394Mondo will make a catalog of all files to be backed up. This may
395take up to five minutes. The list of files will be divided into
396sets, approximately 4 MB (before compression) of files per set.
397This typically takes one minute.
398</entry>
399</row>
400<row>
401<entry>
402<ulink url="images/4.png"><inlinemediaobject><imageobject>
403<imagedata fileref="images/1-mini">
404</imageobject></inlinemediaobject>
405</ulink>
406</entry>
407<entry>
408Mondo calls Mindi. Mindi generates bootable media image and
409auxiliary data disk images which are based on your existing Linux
410distribution and filesystem. That way, you can be sure Mondo's
411tools will be compatible with your existing filesystems and
412binaries: Mondo's tools are your tools. Mindi takes up to five
413minutes to run.
414</entry>
415</row>
416<row>
417<entry>
418<ulink url="images/5tape.png"><inlinemediaobject><imageobject>
419<imagedata fileref="images/5tape-mini">
420</imageobject></inlinemediaobject>
421</ulink>
422</entry>
423<entry>
424Finally, Mondo begins backing up your computer. This process may
425take a few minutes or a few hours, depending on how much data you
426are archiving, how fast your CPU is, how much RAM you have, and so
427on. It will backup your regular files and then your large files
428(files larger than approximately 32MB). If you have opted to verify
429your backups, Mondo will do that too.
430</entry>
431</row>
432</tbody></tgroup></informaltable>
433
434<itemizedlist>
435<listitem>
436<para>Try to boot from the first media of the backup.
437Choose 'Compare Mode' by typing compare at the boot screen.
438</para>
439</listitem>
440<listitem>
441<para>If you can boot, fine. If not, make a Mindi "Test" CD to
442checkout the compatibility of your system. (see
443<link linkend="test-mindi">Testing Mindi</link> for more
444details). Remove the media; boot your computer as usual;
445execute as root</para>
446<para></para>
447<informaltable><tgroup cols="1"><tbody>
448<row>
449<entry>
450
451 bash# mindi
452</entry>
453</row>
454<row>
455<entry>
456 bash# cd /var/cache/mindi
457
458</entry>
459</row>
460</tbody></tgroup></informaltable>
461
462<para>(for CD-R)</para>
463<para></para>
464<informaltable><tgroup cols="1"><tbody>
465<row>
466<entry>
467bash# cdrecord dev=0,0,0 speed=4 -eject -v mindi.iso
468</entry>
469</row>
470<row>
471<entry>
472bash# wodim dev=0,0,0 speed=4 -eject -v mindi.iso
473</entry>
474</row>
475</tbody></tgroup></informaltable>
476
477<para>(for CD-RW)</para>
478<para></para>
479<informaltable><tgroup cols="1"><tbody>
480<row>
481<entry>
482bash# cdrecord dev=0,0,0 speed=4 blank=fast -eject -v mindi.iso
483</entry>
484</row>
485<row>
486<entry>
487bash# wodim dev=0,0,0 speed=4 blank=fast -eject -v mindi.iso
488</entry>
489</row>
490</tbody></tgroup></informaltable>
491
492<para>Reboot your system with the created Mindi CD, with the BIOS
493set to boot from CD. If the result is a command line in 'Expert'
494mode, your system checks out. Remove the CD and reboot your
495system.</para>
496</listitem>
497<listitem>
498<para>If you still cannot boot from Mindi's CD then please e-mail
499the &ML; for help.
500</para>
501</listitem>
502</itemizedlist>
503<para>When making a backup on a live system, there will always be
504processes running that will write out data on the system after you
505have made the backup and before you have made the compare, this
506will result in difference showing up when comparing your backup.
507For a full explanation and what can be done to avoid this, please
508read this section.</para>
509<itemizedlist>
510
511 <listitem>
512<para>This QuickStart covers the ideal case. Upon receiving any
513system feedback/errors, read each related HOWTO section.</para>
514<para>Example 2-1. A test backup of your /home directory to CD-Rs
515using the command line</para>
516<para></para>
517<informaltable><tgroup cols="1"><tbody>
518<row>
519<entry>
520
521bash# mondoarchive -OVc 4 -I /home -gF
522
523</entry>
524</row>
525</tbody></tgroup></informaltable>
526
527<para>The 'c' means you must be writing to CD-Rs, not CD-RWs (the
528latter would require 'w' instead of 'c'). The '4' is the speed of
529your CD writer. The string after -I is the path to be backed up.
530The '-gF' means you are going to see the pretty yellow-on-blue
531screen instead of the boring white-on-black screen. :) It also
532means Mondo will not offer to create physical boot media for
533you. It is assumed that you are able to boot from the CD which
534Mondo has generated.</para>
535<para>Example 2-2. A backup of your whole filesystem to NFS using
536the command line</para>
537<para></para>
538<informaltable><tgroup cols="1"><tbody>
539<row>
540<entry>
541
542 bash# mkdir -p /mnt/nfs
543</entry>
544</row>
545<row>
546<entry>
547 bash# mount nfs://192.168.1.28:/home/nfs /mnt/nfs
548 </entry>
549</row>
550<row>
551<entry>
552 bash# mondoarchive -OVn nfs://192.168.1.28:/home/nfs -gF[...]
553 </entry>
554</row>
555<row>
556<entry>
557bash# umount /mnt/nfs
558 </entry>
559</row>
560<row>
561<entry>
562 bash# cdrecord dev=0,0,0 speed=4 -eject -v /var/cache/mindi/mindi.iso
563</entry>
564</row>
565</tbody></tgroup></informaltable>
566
567<para>Note that you have to mount the NFS partition, backup to it,
568unmount it, and create a boot CD to allow you to restore from
569scratch if necessary. To reassure yourself that you will be able to
570restore from the NFS share even if your PC is wiped, please boot
571from the Mindi CD and type 'compare'. The on-screen instructions
572from that point on should be sufficient.</para>
573<para>Example 2-3. A backup of your whole
574filesystem to tape using the command line</para>
575<para></para>
576<informaltable><tgroup cols="1"><tbody>
577<row>
578<entry>
579
580bash# mondoarchive -OVt -d /dev/st0 -9 -L -g
581
582</entry>
583</row>
584</tbody></tgroup></informaltable>
585
586<para>In this case, we assume Syslinux is incompatible with your
587boot media. For some reason, some BIOSes just don't like Syslinux.
588If you find this to be the case for your computer, please use '-L'
589to force Mondo to use LILO instead of Syslinux as the boot loader
590for its media. (NB: This has nothing to do with which boot
591loader your hard drive uses.) Also, it is a good habit to specify
592your tape streamer with '-d &lt;device&gt;'. You don't usually need
593to but it's good to be on the safe side. Some computers call your
594tape streamer /dev/osst0, some call it /dev/ftape, ...
595Also, depending on the tape streamer model, a tape should be inserted
596in the tape drive before starting mondoarchive, otherwise it may not
597recognize the drive.</para>
598</listitem>
599</itemizedlist>
600
601</chapter>
602
603<chapter id="overview"><title>Overview</title>
604
605<sect1 id="overview-mondorescue">
606<title>Mondo Rescue</title>
607<para>Mondo Rescue backs up your file system to CD, tape, NFS
608(archives stored remotely) or ISO's (archives stored locally).
609Mondo uses afio as the backup engine; afio is a well-respected
610replacement for tar. In the event of catastrophic data loss, you
611may restore some or all of your system, even if your hard drives
612are now blank. Mondo Rescue can do a lot of other cool
613things:</para>
614<itemizedlist>
615<listitem>
616<para>You can use Mondo to clone an installation of Linux. Just
617backup the crucial stuff and exclude /home, /var/log, etc.</para>
618</listitem>
619<listitem>
620<para>You can backup a non-RAID file system and restore it as RAID
621including the root partition (if your kernel supports that).</para>
622</listitem>
623<listitem>
624<para>You can backup a system running on one format and restore as
625another format.</para>
626</listitem>
627<listitem>
628<para>You can restructure your partitions, e.g. shrink/enlarge,
629reassign devices, add hard drives, etc, before you partition and
630format your drives. Mondo will restore your data and amend
631/etc/lilo.conf and /etc/fstab accordingly.</para>
632</listitem>
633<listitem>
634<para>You can backup Linux/Windows systems, including the boot
635sectors. Mondo will make everything right at restore-time.
636(However, do run "Scandisk" when you first boot into Windows, just
637in case.)</para>
638</listitem>
639<listitem>
640<para>You can use your Mondo backup CD to verify the integrity of
641your computer.</para>
642</listitem>
643</itemizedlist>
644<para>Mondo's principal virtue is that it protects you from the
645problems that can arise when you reinstall completely from scratch.
646If you want to wipe and restore your system every year just as a
647matter of 'good practice', Mondo is not for you. However, if you
648want to get up and running again in a hurry after someone breaks
649into your computer and wipes it (or if you accidentally wipe it
650yourself) then Mondo is definitely for you. It will permit you to
651roll back to a known-good installation in a very short period of
652time, sometimes as little as twenty minutes. Even if you backup
653large amounts of data to tape daily and do not want to add yet
654another backup regime, please consider backing up the core
655filesystem (i.e. everything but the directories containing your
656huge database and your prizewinning novel) every month or so, just
657in case. You will be glad you did.</para>
658<para>What is Mondo not?</para>
659<para>Mondo is not an everyday backup program. It is not designed
660to replace tar, afio, kbackup, etc. Mondo is designed to make it
661possible to recover from scratch if necessary. Tar and afio offer a
662quick, convenient way to backup small sets of files, sometimes to
663removable media.</para>
664</sect1>
665
666<sect1 id="overview-mindi">
667<title>Mindi</title>
668<para>
669Mindi Linux creates a set of boot/root media images
670that will let you perform basic system maintenance on your Linux
671distro. The principal virtues of Mindi's boot disks are the fact
672that they contain your kernel, modules, tools and libraries. You
673can ask for additional binaries (or other files) to be included on
674the kit. The libraries will be added for you.
675</para>
676<para>Whichever modules were loaded at backup-time, they are
677reloaded at boot-time. So, in theory, you will boot into almost the
678same environment as you were in when you backed up. If you want to
679add files to your Mindi boot disks, edit '&lt;INSTALLPATH OF
680MINDI&gt;/mindi/deplist.txt' and add the files to that list. The
681added files and dependencies, will be spread across the data disks
682at run-time.
683</para>
684<para>Mindi makes sure that Mondo has all the tools it needs at
685boot-time. Mondo uses fdisk, mkfs, cat, less, more, afio, gzip,
686bzip2, your keyboard configuration, your glibc libraries, your
687other libraries, your kernel, your modules, ... which is a lot of tools!
688Mindi takes care of all that, so that Mondo can get on with the job of backing
689up or restoring your data.
690</para>
691<para>Mindi is also handy for making boot CDs/disks which stand on
692their own. You do not need Mondo. Indeed, if you like, you could
693use another backup/restore program with Mindi. Just add it to
694Mindi's dependency list (type 'locate deplist.txt' to find it).
695Mindi will include your software on its boot CD/disks the next time
696you run mindi.
697</para>
698</sect1>
699
700
701<sect1 id="overview-linuxbackup">
702<title>Linux Backup</title>
703<para>Mondo Rescue and Mindi Linux are used primarily as Linux
704backup and cloning tools. The fall in prices of CD-RW drives and
705writable discs will allow current users to keep good backups and
706future users to leverage the cloning capability.</para>
707<para>Tape drives are more likely to suit your needs if you run a
708larger installation (or have lots of MP3's). Warning! OnStream
709drives do not play well with Mondo. I do not know why. It is, in my
710opinion, something which OnStream should look into. Mondo uses
711fopen(), fread(), fwrite() and fclose() to interact with tape
712drives. That works for most drives but some drives just don't like
713that.
714Also, depending on the tape streamer model, a tape should be inserted
715in the tape drive before starting mondoarchive, otherwise it may not
716recognize the drive.</para>
717<para>Mondo Rescue has been tested thousands of times on various computers.
718It has worked for them.
719Thousands of users testify to Mondo's stability and its ease of
720use. However, please test it on your own system before you rely on
721it. In fact, do not rely on any software until you have tested it
722to see if it performs as expected.</para>
723<para>To establish that Mondo will behave well in an emergency,
724please be prepared. Run a test backup as follows:-</para>
725<itemizedlist>
726<listitem>
727<para>Run mondoarchive without any command-line options.</para>
728</listitem>
729<listitem>
730 <para>Backup a subset of files - e.g. /usr/local - to CD or
731 tape. Say 'yes' when asked if you want to verify them.</para>
732</listitem>
733<listitem>
734 <para>If you are not backing up to CD, please create boot
735 media when prompted.</para>
736</listitem>
737</itemizedlist>
738<para>Next, restore archives to your live filesystem.</para>
739<itemizedlist>
740<listitem>
741<para>When mondoarchive terminates, run mondorestore without any
742command-line options.</para>
743</listitem>
744<listitem><para>Insert the media when prompted.
745 Press &lt;Enter&gt;. Wait a moment.</para></listitem>
746<listitem><para>Select a subset of files to restore, e.g. /usr/local/man
747 and /usr/local/bin. Hit OK.</para></listitem>
748<listitem><para>Restore files to /tmp or /root/RESTORED or something
749 similar.</para></listitem>
750<listitem><para>When mondorestore terminates, compare the restored files
751 to the originals using cmp or diff.</para></listitem>
752</itemizedlist>
753<para>Finally, simulate an emergency restore.</para>
754<itemizedlist>
755<listitem>
756<para>Boot from media.</para>
757</listitem>
758<listitem><para>Select 'Interactive Mode' at boot-time. (Type
759 'interactive' and hit &lt;Enter&gt;.)</para></listitem>
760<listitem><para>Hit OK when shown the mountlist. Say 'yes' when asked if
761 you accept the mountlist.</para></listitem>
762<listitem><para>Select files to restore, e.g. /usr/local/man and
763 /usr/local/bin. Hit OK.</para></listitem>
764<listitem><para>Restore files to /tmp or /root/RESTORED or something
765 similar.</para></listitem>
766<listitem><para>When mondorestore terminates, please reboot and compare
767 the restored files to the originals.</para></listitem>
768</itemizedlist>
769<para>FYI, the subroutines to repartition and reformat your drives
770are very stable. If you are a RAID or LVM user, you
771might&nbsp;encounter some difficulties when wiping and restoring
772from scratch because of the sheer range of filesystem layouts and
773the impossibility of testing Mondo on every single one. If you have
774trouble, just drop to the command-line and partition/format
775manually. Then, call mondorestore, select Interactive Mode, and say
776'no' when asked if you want Mondo to partition or format your
777drives for you.</para>
778<para>You see, even if you have trouble, you still have two hands
779and most of the tools you need - lvchange, pvcreate, fdisk, mkraid,
780etc. - to do it manually. After you have prepped and formatted your
781drives manually (if you have to), just run mondorestore again and
782say 'no' when asked if you want to prep or format your drives. What
783could be easier?</para>
784</sect1>
785
786<sect1 id="overview-winbackup">
787<title>Windows Backup</title>
788<para>Backing up windows partitions.</para>
789<sect2 id="overview-winbackup-win95"><title>Windows ME/95/98</title>
790<para>Verify that the partition is listed in /etc/fstab and is
791mounted (e.g. /dev/hda1). Mondo will take care of everything else.
792The files will be archived just like all other files in the live
793file system. At restore-time, Mondo will take care of the boot
794sector of /dev/hda1 prior to the restore.</para>
795<para>Note: if Windows ME/95/98 is not located on /dev/hda1 or
796/dev/sda1, then Mondo will not take care of the boot sector of
797/dev/hda1. The user will have to boot from a DOS floppy and run SYS
798C: to correct the Windows boot sector.</para>
799</sect2>
800<sect2 id="overview-winbackup-winnt"><title>Windows NT4/2K/XP</title>
801<para>Windows NT4/2K/XP typically use the NTFS file system, not
802VFAT.. The user should use '-x /dev/hda1' (or whichever device the
803Windows partition resides). Mondo will treat the partition as a
804biggiefile. Mondo will also add an entry to the mountlist to
805reflect the size and type of the partition. The user may not edit
806that partition's size at restore-time (for obvious reasons).</para>
807<para>Please bear in mind that Mondo was written for Linux users.
808If Mondo does not backup or restore your Windows system well, you
809might want to consider reporting it to the &ML;
810</para>
811</sect2>
812</sect1>
813
814<sect1 id="overview-history">
815<title>Mondo Rescue and Mindi Linux
816History</title>
817<para>Mondo Rescue was created in December 1999 by Hugo Rabson as a utility to
818clone Linux/Windows installations. Norton Ghost would not do the
819job, and his boss wanted to jump on the Linux bandwagon. So, he wrote
820a few scripts and shoehorned them into the latest Linux-Mandrake
821CD. Since that time, Mondo grew into a disaster recovery suite for
822Linux and Windows. Mondo forced him to learn about the kernel, its
823initrd initial ramdisk, modules, library dependencies, disk
824partitioning, and the myriad differences between the Top 10 Linux
825distributions.</para>
826<para>The first formal release was made on February 18th, 2000.
827Mondo is currently one of the top five Linux backup/restore
828programs. Mondo has been compared favorably to ArcServe, Arkeia and
829BRU. Although Mondo lacks the more advanced, enterprise-level
830features of ArcServe and Arkeia, for workstations and small- to
831medium-size servers it is ideal because it is small, fast,
832efficient, stable, comes with source code, and is being actively
833developed and supported.</para>
834<para>
835 Since November 2005, Hugo Rabson has tranfered the maintenance
836 of the Mondo Rescue suite to Andree Leidenfrost and Bruno Cornec,
837 both previous developers and packagers of the tool since nearly
838 the begining.
839</para>
840</sect1>
841
842<sect1 id="overview-sysreq">
843<title>System Requirements</title>
844<sect2 id="overview-sysrq-hwreq">
845<title>Hardware Requirements</title>
846
847<para>Your computer must have:</para>
848<itemizedlist>
849<listitem>
850 <para>Intel(R)-compatible CPU (ia32, x86_64/amd64 or ia64)</para>
851</listitem>
852<listitem>
853<para>64MB of RAM (128MB recommended)</para>
854</listitem>
855<listitem>
856<para>800MB of hard disk space free</para>
857</listitem>
858<listitem>
859<para>CD writer, tape streamer, NFS share or some way to backup the
860backups :)</para>
861</listitem>
862</itemizedlist>
863<para>It is recommended that your computer have very good airflow.
864The backup with Mondo Rescue and Mindi Linux will utilize your CPU,
865CD drive and fixed disk(s) like very few other applications. With a
866few hours of system backup activity, computers without sufficient
867airflow may show symptoms such as not burning full CD discs. The
868solution is a $20 or less additional fan at your local electronics
869discount store.</para>
870</sect2>
871
872<sect2 id="overview-sysrq-kernelreq">
873<title>Kernel Requirements</title>
874
875<para>Your kernel must have:</para>
876<itemizedlist>
877<listitem>
878<para>stable loopfs support, which means it really needs to be
8792.2.19 or 2.4.7 (or later)</para>
880</listitem>
881<listitem>
882<para>CD-ROM device support</para>
883</listitem>
884<listitem>
885<para>ISO9660 file system support</para>
886</listitem>
887<listitem>
888<para>initrd ramdisk support (built-in)</para>
889</listitem>
890<listitem>
891<para>Virtual memory file system support (built-in)</para>
892</listitem>
893<listitem>
894<para>ext2 file system support (built-in)</para>
895</listitem>
896<listitem>
897<para>Support for the backup media (Tape, CD-RW, NFS, Hard
898disk)</para>
899</listitem>
900<listitem>
901<para>If the backup media is CD-RW then you need SCSI emulation
902also</para>
903<para>vfat support in the active kernel - mindi needs this when creating
904syslinux boot media</para>
905</listitem>
906</itemizedlist>
907<para>Please note that the stock kernels of Red Hat/RHEL/Fedora,
908 Mandrake/Mandriva, SuSE/SLES/OpenSuSE, Debian and Slackware
909 all meet Mondo's requirements. If your kernel does not meet Mondo's
910 requirements then there is something wrong with it. Mondo's demands
911 are not unreasonable.</para>
912<para>Mondo (specifically Mindi) does not require any specific
913module. It does require that your kernel support the initrd
914initial ramdisk facility. Typically this is supported by the Linux
915kernel. Modules used are needed to support the CD,
916hard disks, etc. If the support is modular, then the modules will
917be incorporated in a boot disk by Mindi. If the support is built-in
918(static), then it will be available at boot-time by default.</para>
919</sect2>
920<sect2 id="overview-sysrq-swreq">
921<title>Software Requirements</title>
922<para>See Mondo's <ulink url="http://www.mondorescue.org/downloads.shtml">Download
923page</ulink> for details.</para>
924<para>Mondo requires afio, bzip2, cdrtools/cdrecord/growisofs (may be part of the dvd+rw-tools package), ncurses, newt,
925isolinux/syslinux, lzo (optional), lzop (optional), mkisofs, slang,
926and a few other packages.</para>
927<para>Good Linux distributions provide all these packages. If yours
928does not then please go to the aforementioned Download page or surf
929the Net, preferably the website of the distribution you are
930using.</para>
931<para>Mondo's expectations are not unreasonable, either of your
932Linux distribution or of your kernel. However, if your distribution
933fails to meet its expectations and you cannot find out how to
934resolve them, please feel free to e-mail the &ML;
935</para>
936</sect2>
937</sect1>
938</chapter>
939
940<chapter id="installation">
941<title>Installation</title>
942
943<sect1 id="installation-mindi">
944<title>Mindi Installation</title>
945<para>If you are installing from a tarball then copy it to wherever
946you have enough space, for example /tmp and type:</para>
947<para></para>
948<informaltable><tgroup cols="1"><tbody>
949<row>
950<entry>
951
952 bash# cd /tmp
953</entry>
954</row>
955<row>
956<entry>
957 bash# tar -zxvf mindi-1.x.tgz
958 </entry>
959</row>
960<row>
961<entry>
962bash# cd mindi-1.x
963</entry>
964</row>
965<row>
966<entry>
967 bash# ./install.sh
968
969</entry>
970</row>
971</tbody></tgroup></informaltable>
972
973<para>This installs mindi additional files into /usr/local/lib/mindi and
974the program into /usr/local/sbin</para>
975<para>Or, if you are installing from an RPM/deb then copy it to
976wherever you have enough space, for example /tmp and type:</para>
977<para></para>
978<informaltable><tgroup cols="1"><tbody>
979<row>
980<entry>
981
982bash# rpm -Uvh /tmp/mindi-1.x-x.i386.rpm
983</entry>
984</row>
985<row>
986<entry>
987
988or
989</entry>
990</row>
991<row>
992<entry>
993
994bash# dpkg -i /tmp/mindi-1.x-x.deb
995
996</entry>
997</row>
998</tbody></tgroup></informaltable>
999
1000<para>This installs mindi additional files into /usr/lib/mindi and
1001the program into /usr/sbin.
1002</para>
1003</sect1>
1004
1005<sect1 id="installation-mondo">
1006<title>Mondo Installation</title>
1007<para>If you are installing from a tarball then copy it to wherever
1008you have enough space, for example /tmp and type:</para>
1009<para></para>
1010<informaltable><tgroup cols="1"><tbody>
1011<row>
1012<entry>
1013
1014 bash# cd /tmp
1015</entry>
1016</row>
1017<row>
1018<entry>
1019 bash# tar -zxvf mondo-2.xx.tgz
1020 </entry>
1021</row>
1022<row>
1023<entry>
1024bash# cd mondo-2.xx
1025 </entry>
1026</row>
1027<row>
1028<entry>
1029 bash# ./configure
1030 </entry>
1031</row>
1032<row>
1033<entry>
1034bash# make &amp;&amp; make install
1035
1036</entry>
1037</row>
1038</tbody></tgroup></informaltable>
1039
1040<para>This installs mondo into /usr/local/lib/mondo and installs
1041the programs into /usr/local/sbin</para>
1042<para>Or, if you are installing from an RPM/deb then copy it to copy it
1043to wherever you have enough space, for example /tmp and
1044type:</para>
1045<para></para>
1046<informaltable><tgroup cols="1"><tbody>
1047<row>
1048<entry>
1049
1050bash# rpm -Uvh /tmp/mondo-2.x-x.i386.rpm
1051</entry>
1052</row>
1053<row>
1054<entry>
1055
1056or
1057</entry>
1058</row>
1059<row>
1060<entry>
1061
1062bash# dpkg -i /tmp/mondo-2.x-x.deb
1063
1064</entry>
1065</row>
1066</tbody></tgroup></informaltable>
1067
1068<para>This installs mondo into /usr/lib/mondo and installs
1069the programs into /usr/sbin</para>
1070</sect1>
1071
1072<sect1 id=rpm-verif>
1073 <title>RPM verifications</title>
1074 <para>For RPM based distributions (Fedora, OpenSuSE, Mandriva, ...), you may want to do this post-install in order to check the validity of your installation:</para>
1075<informaltable><tgroup cols="1"><tbody>
1076<row>
1077 <entry>
1078 bash# rpm -Va mindi mondo
1079 </entry>
1080</row>
1081</tbody></tgroup></informaltable>
1082<para>
1083 This gives some truly obtuse output. Basically it will list all files that do NOT pass the verify tests (done on size, MD5 signature, etc). Please read rpm man page to discover the meaning of the output.
1084 </para>
1085</sect1>
1086</chapter>
1087
1088<chapter id="test">
1089<title>Tests</title>
1090
1091<sect1 id="test-mindi">
1092<title>Testing Mindi</title>
1093
1094<para>Mindi is a vital part of the backup procedure. If you have
1095used Mondo before or if you are in a hurry, skip steps 6.2 and 6.3;
1096go straight to QuickStart.</para>
1097<para>However, if you have time or if you have been having trouble
1098getting Mondo to work, I would recommend trying out Mindi directly
1099(rather than via Mondo) to see if it can produce a bootable CD on
1100your system.</para>
1101<para>Make sure you are root while doing this, otherwise mindi will
1102fail, now do this.</para>
1103<para>If you have any problems, please:-</para>
1104<itemizedlist>
1105<listitem>
1106<para>less /var/log/mindi.log</para>
1107</listitem>
1108<listitem><para>feel free to edit mindi (it's a shell script, btw) to try
1109 to fix the problem yourself</para></listitem>
1110<listitem><para>contact the &ML; if you get stuck.</para></listitem>
1111</itemizedlist>
1112<para>Type:-</para>
1113<para></para>
1114<informaltable><tgroup cols="1"><tbody>
1115<row>
1116<entry>
1117
1118bash# mindi
1119
1120</entry>
1121</row>
1122</tbody></tgroup></informaltable>
1123
1124<para>Example screen output, selecting to use your own kernel, to
1125create boot disks, and to create a bootable CD image:</para>
1126<para></para>
1127<screen>
1128
1129# mindi
1130Mindi Linux mini-distro generator v1.09-r762
1131
1132Latest Mindi is available from http://www.mondorescueg
1133
1134------------------------------------------------------------------------------
1135Do you want to use your own kernel to build the boot disk (y/n) ?y
1136Would you like to use LILO (instead of syslinux)
1137for your boot media (y/n) ?n
1138Analyzing dependency requirements Done.
1139Making complete dependency list Done.
1140Analyzing your keyboard's configuration.
1141
1142Adding the following keyboard mapping tables: us-latin1 Done.
1143Assembling dependency files................................................................... Done.
1144The files have been subdivided into 5 directories. Your mountlist will look like this:-
1145 Finding all volume groups
1146 No volume groups found
1147 No volume groups found
1148 No volume groups found
1149 No volume groups found
1150 DEVICE MOUNTPOINT FORMAT SIZE (MB)
1151 /dev/hda1 / ext3 399
1152 /dev/hda9 /home ext3 48478
1153 /dev/hda6 /usr ext3 4999
1154 /dev/hda7 /var ext3 1000
1155 /dev/hda5 swap swap 349
1156 /dev/hda8 swap swap 2003
1157 Finding all volume groups
1158 No volume groups found
1159 No volume groups found
1160 No volume groups found
1161 No volume groups found
1162Tarring and zipping the groups.................. Done.
1163Creating data disk #1...#2...#3...#4...#5... Done.
1164Making 1722KB boot disk...........................1440+0 enregistrements lus.
11651440+0 enregistrements écrits.
1166mke2fs 1.38 (30-Jun-2005)
1167Failed to copy /boot/vmlinuz-2.6.12-15mdk-i686-up-4GB to ramdisk
1168
1169Making 2880KB boot disk...........................mkfs.vfat 2.10 (22 Sep 2003)
1170... 2880 KB boot disks were created OK Done.
1171In the directory '/var/cache/mindi' you will find the images:-
1172 mindi-data-1.img mindi-data-2.img mindi-data-3.img mindi-data-4.img mindi-data-5.img mindi-root.1440.img
1173Shall I make a bootable CD image? (y/n) y
1174NB: Mindi's bootable CD always uses isolinux.
1175
1176For a bootable CD w/LILO, please use Mondo.
1177
1178Finished.
1179
1180Boot and data disk images were created.
1181
1182#
1183
1184</screen>
1185
1186<para>If your kernel is too large (more than about 900KB) then you
1187cannot make boot media, although you can still make a bootable
1188CD image. The easiest way to test Mindi in either case is to say
1189'n' to its first question and 'y' to its second, then use the
1190separate application cdrecord or wodim to make a bootable CD-R or
1191CD-RW.</para>
1192<para>Use the cdrecord or wodim application to write the CD image:</para>
1193<para></para>
1194<informaltable><tgroup cols="1"><tbody>
1195<row>
1196<entry>
1197 bash# cd /var/cache/mindi
1198</entry>
1199</row>
1200<row>
1201 <entry>
1202 bash# cdrecord -scanbus
1203</entry>
1204</row>
1205<row>
1206 <entry>
1207 bash# wodim --devices
1208</entry>
1209</row>
1210</tbody></tgroup></informaltable>
1211
1212<para>The output of the above call will tell you your
1213CD writer's node. It is usually '0,0,0'. Choose one of the
1214following calls to write the CD, depending on whether the disk in
1215the drive is a CD-R or a CD-RW. Please replace 'x,x,x' with your
1216writer's node. For further information, type 'man cdrecord" from a
1217Linux command line.</para>
1218<para>If writing to a CD-RW Drive/Disc:</para>
1219<para></para>
1220<informaltable><tgroup cols="1"><tbody>
1221<row>
1222<entry>
1223bash# cdrecord -v blank=fast dev=x,x,x speed=4 mindi.iso (for CD-RW)
1224</entry>
1225</row>
1226<row>
1227<entry>
1228 bash# wodim -v blank=fast dev=/dev/xxx speed=4 mindi.iso (for CD-RW)
1229</entry>
1230</row>
1231</tbody></tgroup></informaltable>
1232
1233<para>If writing to a CD-R Drive/Disc:</para>
1234<para></para>
1235<informaltable><tgroup cols="1"><tbody>
1236<row>
1237<entry>
1238bash# cdrecord -v dev=x,x,x speed=4 mindi.iso (for CD-R)
1239</entry>
1240</row>
1241<row>
1242<entry>
1243 bash# wodim -v dev=/dev/xxx speed=4 mindi.iso (for CD-R)
1244</entry>
1245</row>
1246</tbody></tgroup></informaltable>
1247</sect1>
1248
1249<!--
1250<sect1 id="test-mondo">
1251<title>Testing Mondo</title>
1252</sect1>
1253-->
1254</chapter>
1255
1256<chapter id="backup">
1257<title>Backup</title>
1258
1259<sect1 id="backup-recommandations">
1260<title>Recommendations</title>
1261<itemizedlist>
1262<listitem>
1263<para>Shut down all possible applications (this minimizes any
1264 compare differences following the backup). Especially shutdown
1265 properly any running database on your system, as the recovery
1266 may lead to corrupted data. Or if applicable, boot to single user mode.</para>
1267</listitem>
1268<listitem>
1269<para>Type:</para>
1270</listitem>
1271</itemizedlist>
1272<para></para>
1273<informaltable><tgroup cols="1"><tbody>
1274<row>
1275<entry>
1276
1277bash# mondoarchive
1278
1279</entry>
1280</row>
1281</tbody></tgroup></informaltable>
1282
1283<para>For most users, that should be enough. :-) Mondoarchive will
1284usually autodetect your hardware and configure it for you.</para>
1285<para>If you are a power user (or you like to control every detail
1286of how Mondo runs) then you may want to look at the command-line
1287switches. For example:-</para>
1288<para></para>
1289<informaltable><tgroup cols="1"><tbody>
1290<row>
1291<entry>
1292
1293bash# mondoarchive -Ow9 -gF -I /home
1294
1295</entry>
1296</row>
1297</tbody></tgroup></informaltable>
1298
1299<para>cdrecord or wodim will tell you where your CD recorder lives, in SCSI
1300terms, which looks like '0,0,0'. The previous call to mondoarchive tells
1301Mondo to backup everything to a 4x CD-RW drive that has
1302a CD-RW disk in it. (Use -Oc instead of -Ow if you are using
1303CD-R.)</para>
1304<para>Please put the first CD-R(W) in the drive now. You will be
1305prompted to insert CD #2 but you will not be prompted to insert the
1306first disk. However, if you forget, do not worry: if Mondo fails to
1307write the first (or any) disk, it will offer to retry, abort or
1308fail.</para>
1309<para>Find the speed/compression
1310compromise that best suits your needs. Here maximum (-9) compression level is used.</para>
1311<para>If you are using cron then please consult the chapter that Conor Daly has dedicated to that <link linkend="backup-cron">topic</link>
1312</para>
1313</sect1>
1314
1315<sect1 id="backup-cmd">
1316<title>Backup Commands and Options</title>
1317
1318<para>Backup Command:</para>
1319<para></para>
1320<informaltable><tgroup cols="1"><tbody>
1321<row>
1322<entry>
1323
1324mondoarchive &lt;-option1&gt; &lt;-option2&gt; ... &lt;-optionN&gt;
1325
1326</entry>
1327</row>
1328</tbody></tgroup></informaltable>
1329
1330<para>E.g.,</para>
1331<para></para>
1332<informaltable><tgroup cols="1"><tbody>
1333<row>
1334<entry>
1335
1336bash# mondoarchive -E "/mnt/dos /mnt/cdrom" -9 -Oc 8
1337
1338</entry>
1339</row>
1340</tbody></tgroup></informaltable>
1341
1342<para>Would create backup CD to a CD-R disc at the highest
1343compression level, writing at speed 8 and ignoring the /mnt/dos and
1344/mnt/cdrom directories.</para>
1345<para>To see a detailed list of switches and their meaning, see the
1346<ulink url="http://www.mondorescue.org/docs/mondoarchive.8.html">HTML
1347man page</ulink> on the website or type 'man mondoarchive' at the
1348console.</para>
1349<sect2 id="backup-cmd-cdr">
1350<title>Standard Example With CD-R</title>
1351<para></para>
1352<informaltable><tgroup cols="1"><tbody>
1353<row>
1354<entry>
1355
1356bash# mondoarchive -Oc 2 -g
1357
1358</entry>
1359</row>
1360</tbody></tgroup></informaltable>
1361
1362<para>Replace '2' in '-Oc 2' with the writer's speed. If
1363mondoarchive cannot find your CD-R then please add '-d 0,0,0' (or
1364whatever your CD writer's SCSI node is; usually, it is 0,0,0) to
1365the call.</para>
1366<para>Please insert the first disk in the writer while the PC is
1367chugging away. If Mondo needs additional CD-R(W) then it will ask
1368for them.</para>
1369</sect2>
1370<sect2 id="backup-cmd-cdrw">
1371<title>Standard Example With CD-RW</title>
1372<para></para>
1373<informaltable><tgroup cols="1"><tbody>
1374<row>
1375<entry>
1376
1377bash# mondoarchive -Ow 2 -g
1378
1379</entry>
1380</row>
1381</tbody></tgroup></informaltable>
1382
1383<para>Replace '2' in '-Ow 2' with the writer's speed.</para>
1384</sect2>
1385<sect2 id="backup-cmd-tape">
1386 <title>Standard Example With Tape</title>
1387<para></para>
1388<informaltable><tgroup cols="1"><tbody>
1389<row>
1390<entry>
1391
1392bash# mondoarchive -Ot -d /dev/st0 -g
1393
1394</entry>
1395</row>
1396</tbody></tgroup></informaltable>
1397
1398</sect2>
1399<sect2 id="backup-cmd-network">
1400 <title>Standard Example With Network Backup</title>
1401<para></para>
1402<informaltable><tgroup cols="1"><tbody>
1403<row>
1404<entry>
1405
1406 bash# mount 192.168.1.3:/home/nfs -t nfs /mnt/nfs
1407</entry>
1408</row>
1409<row>
1410 <entry>
1411 bash# mondoarchive -OVn nfs://192.168.1.3:/home/nfs -g -s 200m
1412</entry>
1413</row>
1414<row>
1415 <entry>
1416 bash# umount /mnt/nfs
1417
1418</entry>
1419</row>
1420</tbody></tgroup></informaltable>
1421
1422<para>The resultant ISO's can be burned to CD's if you want (which
1423isn't a good idea unless you're a Mondo expert because they'll try
1424to restore over a network by default, which is silly because the
1425archives are on the CD's). Or, you can boot from the Mindi media
1426(or mondorescue.iso) and hit ENTER a few times to restore.</para>
1427<para>Those ISO images can also be used for a PXE restore. For this
1428 to work, please refer to the file README.pxe provided with
1429 your mindi package.
1430</para>
1431</sect2>
1432
1433</sect1>
1434</chapter>
1435
1436<chapter id="backup-cron">
1437<title>HOWTO run mondo interactively using cron</title>
1438
1439<sect1 id="backup-cron-overview">
1440<title>Overview</title>
1441
1442<para>
1443 Mondoarchive is designed to run interactively (at least where
1444 media changes are necessary). Cron does not allow user interaction
1445 with a job. This section addresses the problem by using screen as a
1446 wrapper for mondo.
1447</para>
1448<para>
1449 This section is Copyright 2003 Conor Daly.
1450</para>
1451</sect1>
1452<sect1 id="backup-cron-intro">
1453 <title>Introduction</title>
1454
1455<para>
1456Mondoarchive is designed to run interactively. That's not strictly
1457 true, if you run mondoarchive without the '-g' switch, it will just
1458 run. However, there is a problem where media changes are necessary.
1459 The user must change the media and tell mondoarchive that the change
1460 has been done. The problem lies in the fact that cron does not allow
1461 user interaction with a job. If you schedule a mondoarchive job via
1462 cron, you better be sure it needs only one media. In practical terms,
1463 this means using tapes or ISOs (if CD-R(W) is your backup medium).
1464 However, for tape users, there's always the possibility that the
1465 backup will overflow the tape while for CD-R(W) users, there is the
1466 added hassle of burning the ISOs in the morning. If your CD_R(W)
1467 backup routinely occupies more than one media, this is not for you
1468 (use the ISO option and burn the CDs in the morning). This HOWTO
1469 addresses the problem by using screen as a wrapper for mondo.
1470</para>
1471</sect1>
1472<sect1 id="backup-cron-who">
1473 <title>Who should read this?</title>
1474<sect2><title>Insurance</title>
1475<para>
1476Mondo users who wish to automate the backup and whose backups
1477 routinely occupy close to one media are the best audience. If you
1478 backup to tape, the occasion will arise when the backup will overflow
1479 your tape. In this instance, mondoarchive will ask for another tape.
1480 If you're using cron to start the backup, you won't be able to tell
1481 mondo that the new tape is mounted and the backup will fail. If you
1482 backup to CD-R(W), the same situation will arise but sooner.
1483 </para>
1484 </sect2>
1485 <sect2><title>Efficiency</title>
1486<para>
1487If your backup already occupies two media, this method will allow
1488 as much of the backup as possible to proceed during quiet periods.
1489 Time the backup to start with enough time to complete the first media
1490 shortly before the operator arrives for work. The next media can
1491 be mounted and the backup completed asap and minimises the time for
1492 which users are inconvenienced by the backup (eg. database locked...).
1493 </para>
1494 </sect2>
1495 </sect1>
1496 <sect1 id="backup-cron-problem">
1497 <title>The Problem</title>
1498<sect2><title>Cron's environment</title>
1499<para>
1500When a user submits a job with cron, their environment is not
1501 preserved. This is reasonable since cron jobs are typically ongoing
1502 and may be adversely affected if the user's environment changes subsequent
1503 to the cron submission. Thus, a cron job should call a script that
1504 set's up the correct environment before starting the user's desired
1505 program. The 'at' command does this nicely.
1506 </para>
1507 </sect2>
1508 <sect2><title>Interactivity</title>
1509<para>
1510When a job is started with cron, it runs as a background process.
1511 No interaction with the program is possible (unless it is capable
1512 of interacting via a FIFO or some such) except termination via its
1513 pid. The only program that I know of that allows such interaction
1514 and serves as a wrapper for other processes is 'screen'
1515 </para>
1516 </sect2>
1517 <sect2><title>Screen</title>
1518<para>
1519There's one little problem with screen though. It expects to
1520 attach to a terminal when it first starts. This won't happen under
1521 cron so screen will fail. Fortunately, screen comes with a "start
1522 detached" (-d) option.
1523 </para>
1524 </sect2>
1525 </sect1>
1526 <sect1 id="backup-cron-solution">
1527 <title>The Solution</title>
1528<sect2><title>Briefly</title>
1529<para>
1530<itemizedlist>
1531<listitem>
1532 <para>Use 'at' to run your usual mondoarchive command</para>
1533</listitem>
1534<listitem>
1535 <para>Grab the script generated by 'at' and make a copy of it</para>
1536 </listitem>
1537<listitem>
1538 <para>Edit that script to use 'screen -m -d &lt;your mondoarchive command&gt;'</para>
1539 </listitem>
1540<listitem>
1541 <para>Run that script from your crontab</para>
1542 </listitem>
1543<listitem>
1544 <para>Use 'screen -r' to attach to the mondo screen to change CDs</para>
1545 </listitem>
1546<listitem>
1547 <para>Use '&lt;CTRL&gt;-a d' to detach the screen again</para>
1548</listitem>
1549</itemizedlist>
1550</para>
1551</sect2>
1552<sect2><title>In Detail</title>
1553 <sect3><title>at</title>
1554<para>
1555Use the 'at' command to submit your usual mondoarchive command.
1556My mondoarchive command is:
1557</para>
1558<informaltable><tgroup cols="1"><tbody>
1559<row>
1560<entry>
1561
1562 # mondoarchive -D -Ow 10 -S /home/mondo/ -T /home/mondo/ -g \
1563 -E "\"/home/cdaly/GIS/W2K /home/mondo/\"" -9
1564
1565</entry>
1566</row>
1567</tbody></tgroup></informaltable>
1568<para>
1569 To submit the mondoarchive command with 'at' do:
1570</para>
1571<informaltable><tgroup cols="1"><tbody>
1572<row>
1573<entry>
1574
1575 # at now + 5 min
1576mondoarchive -D -Ow 10 -S /home/mondo/ -T /home/mondo/ -g \
1577-E "\"/home/cdaly/GIS/W2K /home/mondo/\"" -9
1578&lt;CTRL&gt;-d
1579</entry>
1580</row>
1581</tbody></tgroup></informaltable>
1582<para>
1583
1584This generates a script in /var/spool/at/ which sets up your
1585 environment and runs your command. Grab this script to become your
1586 cron job.
1587 </para>
1588 </sect3>
1589 <sect3><title>Grab the 'at' script</title>
1590<para>
1591 Make a copy of the script generated by the 'at' command to use
1592 as the basis for your cron job.
1593 </para>
1594<informaltable><tgroup cols="1"><tbody>
1595<row>
1596<entry>
1597
1598grep mondo /var/spool/at/*
1599</entry>
1600</row>
1601<row>
1602 <entry>
1603cp /var/spool/at/&lt;file-from-grep&gt; /root/mondo-cronscript
1604</entry>
1605</row>
1606</tbody></tgroup></informaltable>
1607<para>
1608
1609 You'll need to edit this.
1610</para>
1611 </sect3>
1612<sect3><title>Edit mondo-cronscript</title>
1613<para>
1614To use screen, you'll need to edit the cronscript and add the
1615 screen command. My mondo-cronscript looks like:
1616</para>
1617<screen>
1618
1619#!/bin/sh
1620# atrun uid=0 gid=0
1621# mail cdaly 0 umask 22
1622PWD=/root; export PWD
1623XAUTHORITY=/root/.xauthyOrD4f; export XAUTHORITY
1624HOSTNAME=bofh.irmet.ie; export HOSTNAME
1625PVM_RSH=/usr/bin/rsh; export PVM_RSH
1626QTDIR=/usr/lib/qt-2.3.1; export QTDIR
1627LESSOPEN=\|/usr/bin/lesspipe.sh\ %s; export LESSOPEN
1628XPVM_ROOT=/usr/share/pvm3/xpvm; export XPVM_ROOT
1629KDEDIR=/usr; export KDEDIR
1630USER=root; export USER
1631LS_COLORS=no=00:fi=00:di=01\;34:ln=01\;36:pi=40\;33:so=01\;35:bd=40\;33\;01:cd=40\;33\;01:or=01\;05\;37\;41:mi=01\;05\;37\;41:ex=01\;32:\*.cmd=01\;32:\*.exe=01\;32:\*.com=01\;32:\*.btm=01\;32:\*.bat=01\;32:\*.sh=01\;32:\*.csh=01\;32:\*.tar=01\;31:\*.tgz=01\;31:\*.arj=01\;31:\*.taz=01\;31:\*.lzh=01\;31:\*.zip=01\;31:\*.z=01\;31:\*.Z=01\;31:\*.gz=01\;31:\*.bz2=01\;31:\*.bz=01\;31:\*.tz=01\;31:\*.rpm=01\;31:\*.cpio=01\;31:\*.jpg=01\;35:\*.gif=01\;35:\*.bmp=01\;35:\*.xbm=01\;35:\*.xpm=01\;35:\*.png=01\;35:\*.tif=01\;35:; export LS_COLORS
1632MACHTYPE=i386-redhat-linux-gnu; export MACHTYPE
1633MAIL=/var/spool/mail/root; export MAIL
1634INPUTRC=/etc/inputrc; export INPUTRC
1635BASH_ENV=/root/.bashrc; export BASH_ENV
1636LANG=en_US; export LANG
1637LOGNAME=root; export LOGNAME
1638SHLVL=1; export SHLVL
1639II_SYSTEM=/usr/local/ingres; export II_SYSTEM
1640USERNAME=root; export USERNAME
1641HOSTTYPE=i386; export HOSTTYPE
1642OSTYPE=linux-gnu; export OSTYPE
1643HISTSIZE=1000; export HISTSIZE
1644LAMHELPFILE=/etc/lam/lam-helpfile; export LAMHELPFILE
1645PVM_ROOT=/usr/share/pvm3; export PVM_ROOT
1646HOME=/root; export HOME
1647SSH_ASKPASS=/usr/libexec/openssh/gnome-ssh-askpass;
1648export SSH_ASKPASS
1649PATH=/usr/local/ingres/ingres/bin:/usr/local/ingres/ingres/utility:/usr/kerberos/sbin:/usr/kerberos/bin:/bin:/sbin:/usr/bin:/usr/sbin:/usr/local/bin:/usr/local/sbin:/usr/bin/X11:/usr/X11R6/bin:/root/bin; export PATH
1650cd /root || {
1651echo 'Execution directory inaccessible' >&2
1652exit 1
1653}
1654screen -m -d mondoarchive -D -Ow 10 -S /home/mondo/ \
1655-T /home/mondo/ -g -E "\"/home/cdaly/GIS/W2K /home/mondo/\"" -9
1656#done
1657
1658</screen>
1659<para>
1660 The crucial line is this one:
1661</para>
1662<informaltable><tgroup cols="1"><tbody>
1663<row>
1664<entry>
1665 screen -m -d mondoarchive -D -Ow 10 -S /home/mondo/ -T /home/mondo/ -g -E "\"/home/cdaly/GIS/W2K /home/mondo/\"" -9
1666</entry>
1667</row>
1668</tbody></tgroup></informaltable>
1669<para>
1670This uses 'screen -m -d' to <quote>-m -d Start screen in "detached" mode. This creates a new session
1671 but doesn't attach to it. This is useful for system startup scripts.
1672 (From 'man screen')
1673</quote>
1674</para>
1675<para>
1676 When screen starts, it will be in the background and "detached".
1677</para>
1678</sect3>
1679<sect3><title>Run the thing with cron</title>
1680<para>
1681 To get the whole thing running, do:
1682</para>
1683<informaltable><tgroup cols="1"><tbody>
1684<row>
1685<entry>
1686 crontab -e
1687 </entry>
1688</row>
1689</tbody></tgroup></informaltable>
1690<para>
1691and add the following lines:
1692</para>
1693<informaltable><tgroup cols="1"><tbody>
1694<row>
1695<entry>
1696&num; run mondoarchive at 23:59 weekdays
1697</entry>
1698</row>
1699<row>
1700 <entry>
170159 23 * * 1-5 /root/mondo-cronscript
1702</entry>
1703</row>
1704</tbody></tgroup></informaltable>
1705<para>
1706 Your mondoarchive job will run at 23:59 monday-friday.
1707</para>
1708<para>
1709DON'T FORGET TO CHANGE TAPES!
1710</para>
1711</sect3>
1712<sect3><title>Getting at it...</title>
1713<para>
1714Once your cron job is running regularly, you'll want to get to
1715 it to change tapes and check status etc.
1716</para>
1717<informaltable><tgroup cols="1"><tbody>
1718<row>
1719<entry>
1720screen -r
1721</entry>
1722</row>
1723</tbody></tgroup></informaltable>
1724<para>
1725attaches to the running screen where you can change CDs etc
1726</para>
1727<informaltable><tgroup cols="1"><tbody>
1728<row>
1729<entry>
1730&lt;CTRL&gt;-a d
1731</entry>
1732</row>
1733</tbody></tgroup></informaltable>
1734<para>
1735detaches the running screen again.
1736</para>
1737</sect3>
1738<sect3><title>Caveat</title>
1739<para>
1740The script generated by 'at' is unique to the user/machine combination.
1741 You MUST regenerate it on each machine where it will be used. Using
1742 the one above will NOT work for you. MAKE YOUR OWN!
1743</para>
1744</sect3>
1745</sect2>
1746</sect1>
1747</chapter>
1748
1749<chapter id="compare">
1750<title>Compare</title>
1751<para>Before you trust your backup CD, make sure your BIOS can boot
1752CD (and that it is configured to do so).</para>
1753<itemizedlist>
1754<listitem>
1755<para>Boot from the first CD.</para>
1756</listitem>
1757<listitem>
1758<para>Type:</para>
1759</listitem>
1760</itemizedlist>
1761<para></para>
1762<informaltable><tgroup cols="1"><tbody>
1763<row>
1764<entry>
1765
1766LILO: compare
1767
1768</entry>
1769</row>
1770</tbody></tgroup></informaltable>
1771
1772<para>Follow the on-screen instructions. This will compare your
1773backup against your original file system.</para>
1774<para>FYI, no bad archives have been created since May 2000. Having
1775said that, I would still encourage you to run Compare before
1776trusting the backups.</para>
1777<para>To view the file differences, look at the file
1778'/tmp/changed.txt'. Normal differences include logs and other
1779dynamic system files that changed during the time of the backup
1780process. If only a few files differ - e.g. files in /var, files
1781ending in '&amp;#732;', logs, temporary files, /etc/mtab,
1782/etc/adjtimex - then you know the archives are good. Your logs will
1783change over time, too. Bear in mind that a difference between the
1784backup and the live copy does not&nbsp;indicate a flaw in Mondo. It
1785indicates that you or your filesystem changed the files, so the
1786backup is no longer 100% up to date. However, that is inevitable,
1787as your filesystem changes from moment to moment (which is why you
1788back it up regularly).</para>
1789
1790</chapter>
1791
1792<chapter id="restore">
1793<title>Restore</title>
1794
1795<sect1 id="restore-overview">
1796<title>Overview</title>
1797
1798<para>I hope you don't have to restore from scratch very often.
1799It's nerve-wracking until you realize that Mondo's restore engine
1800is very reliable.
1801</para>
1802<para>If you find that you cannot make your PC boot from the CD,
1803take heart: the first backup media of each set contains disk
1804images to give you the same functionality as this media (minus the
1805archives, of course) on other boot media. Remember, your Mondo CD is a
1806fully functional CD-based mini-distribution as well as a recovery
1807CD.</para>
1808<para>You can choose from the following modes:</para>
1809
1810<variablelist>
1811<varlistentry><term>Interactive</term>
1812<listitem><para>Restore step-by-step, or restore a subset of the
1813archives. This is the method you should mainly use for your
1814recovery needs.</para>
1815</listitem></varlistentry>
1816<varlistentry><term>Nuke</term>
1817<listitem><para>Wipe your drives and restore everything,
1818automatically and unattended. Warning: This does exactly what is
1819says, so be careful using it.</para>
1820</listitem></varlistentry>
1821<varlistentry><term>Expert</term>
1822<listitem><para>Boot to a shell prompt. If you want to do anything
1823creative, you should boot into Expert Mode. It's called expert, I
1824think that says it all.</para>
1825</listitem>
1826</varlistentry>
1827</variablelist>
1828
1829<para>If the CD is not found during the initial restore CD boot
1830attempt, reboot the PC a second time prior to reporting failure.
1831Occasional timing errors and hardware/software/system conflicts do
1832occur.</para>
1833</sect1>
1834
1835<sect1 id="restore-tips">
1836<title>Tips and Tricks</title>
1837
1838<para>Ideally, restore your system to a spare hard drive to test
1839the integrity and reliability of your disks. To do that, either
1840edit your mountlist to make the devices point to your spare hard
1841drive, or swap your hard drive cables between boots.</para>
1842<para>At a bare minimum, compare your CD against your file system
1843before you decide whether to trust them.</para>
1844<para>To test Mondo's ability to handle your LILO or GRUB boot
1845loader and accompanying configuration file:</para>
1846<itemizedlist>
1847<listitem>
1848<para>Boot from the backup CD into Expert Mode</para>
1849</listitem>
1850<listitem>
1851<para>Type:</para>
1852</listitem>
1853</itemizedlist>
1854<para></para>
1855<informaltable><tgroup cols="1"><tbody>
1856<row>
1857<entry>
1858
1859bash# mondorestore -Z mbr
1860
1861</entry>
1862</row>
1863</tbody></tgroup></informaltable>
1864
1865<itemizedlist>
1866<listitem>
1867<para>To fix any mess it made (not that it should) type:</para>
1868</listitem>
1869</itemizedlist>
1870<para></para>
1871<informaltable><tgroup cols="1"><tbody>
1872<row>
1873<entry>
1874 bash# mount-me
1875</entry>
1876</row>
1877<row>
1878<entry>
1879 bash# chroot /mnt/RESTORING
1880 </entry>
1881</row>
1882<row>
1883<entry>
1884 </entry>
1885</row>
1886<row>
1887<entry>
1888bash# lilo OR grub-install '(hd0)'
1889 </entry>
1890</row>
1891<row>
1892<entry>
1893bash# exit
1894</entry>
1895</row>
1896<row>
1897<entry>
1898 bash# unmount-me
1899
1900</entry>
1901</row>
1902</tbody></tgroup></informaltable>
1903
1904<itemizedlist>
1905<listitem>
1906<para>If it did not work then please copy /tmp/mondorestore.log to
1907to your hard disk, USB key, ..., gzip it and e-mail it to the
1908&ML;.</para>
1909</listitem>
1910</itemizedlist>
1911
1912<sect2>
1913 <title>Barebones (Nuke) Restore</title>
1914<para>Imagine that your hard drives happen to be wiped,
1915deliberately or accidentally. Or, imagine that you want to clone
1916your existing operating system. In either case, you want to run in
1917Nuke Mode.</para>
1918<para>If you want to wipe everything and restore your whole system
1919from CD, please:</para>
1920<itemizedlist>
1921<listitem>
1922<para>Use the -H option when invoking mondoarchive</para>
1923</listitem>
1924<listitem>
1925<para>Boot from the first Mondo CD</para>
1926</listitem>
1927<listitem>
1928<para>Press RESTORE&lt;enter&gt;</para>
1929</listitem>
1930<listitem>
1931<para>Insert the subsequent CD when asked</para>
1932</listitem>
1933<listitem>
1934<para>Watch the screen for errors</para>
1935</listitem>
1936</itemizedlist>
1937<para>That's it. The restoration process for tape or NFS users is
1938similarly easy: just boot, answer the on-screen prompts, and
1939wait.</para>
1940<para>Now, should something go wrong, you will be able to examine
1941/tmp/mondorestore.log to see what happened. All is not lost. You
1942can fdisk and format the partitions yourself, using the tools that
1943come with the CD. You can then run mondorestore in Interactive Mode
1944and say 'no' when asked if you want Mondo to partition/format your
1945drives.</para>
1946<para>If you want to see exactly what Mondo is doing while it is
1947restoring, press &lt;Alt&gt;&lt;left cursor&gt; to view its
1948logfile, in a virtual console, scrolling past.</para>
1949</sect2>
1950<sect2>
1951<title>Interactive Restore</title>
1952<para>Interactive Mode is for people who have lost a subset of data
1953from their live file system, or perhaps who have lost some data
1954from their latest backup and want to restore a subset of data from
1955an earlier backup. If you want to restore only some files or if you
1956do not want to prep/format your drives, then you should boot into
1957Interactive Mode. The interactive mode will provide an 'Editing
1958mountlist screen' that allows you to setup a different disk
1959geometry.</para>
1960<para>To move up and down between partitions in the 'Editing
1961mountlist screen', use the Up and Down arrows. To move between the
1962main window and the buttons at the bottom, use the Left and Right
1963cursor keys. TAB shifts focus from one screen item to the other in
1964a haphazard fashion, owing to the complexities of the Newt
1965library.</para>
1966<para>If you want to restore selectively, just press &lt;enter&gt;
1967and follow the on-screen instructions. You will be asked to say
1968yes/no to a range of questions.</para>
1969<para>If you are planning to modify your partition table, you would
1970do well to read up on the partition layout and the use of fdisk, it
1971gives you some pointers on how to best lay out partitions.
1972You 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>
1974</para>
1975<para>If you want to restore a subset of the backup then:</para>
1976<itemizedlist>
1977<listitem>
1978<para>Boot from the CD</para>
1979</listitem>
1980<listitem>
1981<para>Type:</para>
1982</listitem>
1983</itemizedlist>
1984<para></para>
1985<informaltable><tgroup cols="1"><tbody>
1986<row>
1987<entry>
1988
1989bash# interactive
1990
1991</entry>
1992</row>
1993</tbody></tgroup></informaltable>
1994
1995<itemizedlist>
1996<listitem>
1997<para>Then, after booting, answer the questions as follows:</para>
1998</listitem>
1999</itemizedlist>
2000<para></para>
2001<informaltable><tgroup cols="1"><tbody>
2002<row>
2003<entry>
2004
2005 Do you want to partition your devices? no
2006 </entry>
2007</row>
2008<row>
2009<entry>
2010Do you want to format them? no
2011 </entry>
2012</row>
2013<row>
2014<entry>
2015Do you want to restore everything? no
2016 </entry>
2017</row>
2018<row>
2019<entry>
2020Do you want to restore something? yes
2021 </entry>
2022</row>
2023<row>
2024<entry>
2025Which path do you want to restore? /mydata [e.g.]
2026 </entry>
2027</row>
2028<row>
2029<entry>
2030Do you want to run LILO to setup your boot sectors? Yes
2031
2032</entry>
2033</row>
2034</tbody></tgroup></informaltable>
2035
2036</sect2>
2037
2038<sect2>
2039<title>Expert Restore</title>
2040<para>If you are planning to modify your partition table, you would
2041do well to read up on the partition layout and the use of fdisk, it
2042gives you some could pointers on how to best lay out partitions.
2043You 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
2045rg/pub/Linux/docs/HOWTO/mini/Partition/index.html</ulink></para>
2046<para>To restore manually, please:</para>
2047<itemizedlist>
2048<listitem>
2049<para>Boot from the first CD, then type:</para>
2050</listitem>
2051</itemizedlist>
2052<para></para>
2053<informaltable><tgroup cols="1"><tbody>
2054<row>
2055<entry>
2056
2057bash# expert
2058
2059</entry>
2060
2061</row>
2062</tbody></tgroup></informaltable>
2063
2064<itemizedlist>
2065<listitem>
2066<para>Then do whatever you like. :) You may type the following, of
2067course:</para>
2068</listitem>
2069</itemizedlist>
2070<para></para>
2071<informaltable><tgroup cols="1"><tbody>
2072<row>
2073<entry>
2074
2075bash# mondorestore
2076
2077</entry>
2078</row>
2079</tbody></tgroup></informaltable>
2080</sect2>
2081
2082<sect2>
2083<title>Modified partitions - Restore to a different disk geometry</title>
2084<para>One of the nice things about Mondo is that it lets you wipe
2085your existing system and restore it in any layout you like (within
2086reason). You can move from non-RAID to RAID,install and utilize
2087additional drives, move from ext2 to ReiserFS, etc., all without
2088risking the loss of data.</para>
2089<para>If the user excluded a particular partition from backup and
2090specifically excluded it from the mountlist itself using -E then
2091Mondo will insert a small (32MB) partition at restore-time, in
2092order to avoid having to re-jig fstab, the partition table,
2093etc.</para>
2094<para>To do this:</para>
2095<itemizedlist>
2096<listitem>
2097<para>Boot into Expert Mode, then type:</para>
2098</listitem>
2099</itemizedlist>
2100<para></para>
2101<informaltable><tgroup cols="1"><tbody>
2102<row>
2103<entry>
2104
2105bash# mondorestore
2106
2107</entry>
2108</row>
2109</tbody></tgroup></informaltable>
2110
2111<itemizedlist>
2112<listitem>
2113<para>(edit the mountlist using the on-screen editor)</para>
2114</listitem>
2115</itemizedlist>
2116<para>If you want to move from ext2 to ReiserFS, you can do it here
2117(so long as your kernel supports ReiserFS). Ditto for XFS, JFS or
2118ext3, ext4.</para>
2119<para>Mondorestore will try to modify your /etc/fstab to reflect
2120changes you have made to the mountlist. If you are not using LILO,
2121you can still create your own /mnt/RESTORING/etc/lilo.conf and run
2122lilo -r /mnt/RESTORING to configure your boot sectors and Master
2123Boot Record.</para>
2124<para>Mondo (technically, Mindi on behalf of Mondo) creates a file
2125called a mountlist. This can be found on the ramdisk at
2126/var/cache/mindi/mountlist.txt; it looks something like this:</para>
2127<para></para>
2128<informaltable><tgroup cols="1"><tbody>
2129<row>
2130<entry>
2131
2132 /dev/hda1 /mnt/windows vfat 4096000
2133</entry>
2134</row>
2135<row>
2136<entry>
2137 /dev/hda5 / reiserfs 6023000
2138</entry>
2139</row>
2140<row>
2141<entry>
2142 /dev/hda6 /tmp xfs 955000
2143</entry>
2144</row>
2145<row>
2146<entry>
2147 /dev/hda7 /usr ext3 4096000
2148
2149</entry>
2150</row>
2151</tbody></tgroup></informaltable>
2152
2153<para>It is fairly easy to understand the list. Each line refers to
2154a single device/partition. The line format is:</para>
2155<para></para>
2156<informaltable><tgroup cols="1"><tbody>
2157<row>
2158<entry>
2159
2160&lt;device&gt; &lt;partition&gt; &lt;format&gt; &lt;Kilobytes&gt;
2161
2162</entry>
2163</row>
2164</tbody></tgroup></informaltable>
2165
2166<para>If you have added a hard drive and want to take advantage of
2167the additional space, you could amend the above mountlist to
2168read:</para>
2169<para></para>
2170<informaltable><tgroup cols="1"><tbody>
2171<row>
2172<entry>
2173
2174 /dev/hda1 /mnt/windows vfat 6096000
2175</entry>
2176</row>
2177<row>
2178<entry>
2179 /dev/hda5 / reiserfs 9123000
2180</entry>
2181</row>
2182<row>
2183<entry>
2184 /dev/hda6 /tmp xfs 955000
2185</entry>
2186</row>
2187<row>
2188<entry>
2189 /dev/hdb1 /usr ext3 8192000
2190</entry>
2191</row>
2192<row>
2193<entry>
2194 /dev/hdb2 /home xfs 8192000
2195
2196</entry>
2197</row>
2198</tbody></tgroup></informaltable>
2199
2200<para>This assumes that your old hard drive is /dev/hda and the new
2201hard drive is /dev/hdb.</para>
2202<para>Or, if you want to add RAID support, create a new
2203/etc/raidtab on the ramdisk (which is beyond the scope of this
2204HOWTO) and then write a mountlist like this:</para>
2205<para></para>
2206<informaltable><tgroup cols="1"><tbody>
2207<row>
2208<entry>
2209
2210 /dev/hda1 /mnt/windows vfat 6096000
2211</entry>
2212</row>
2213<row>
2214<entry>
2215 /dev/md0 / reiserfs 9123000
2216</entry>
2217</row>
2218<row>
2219<entry>
2220 /dev/md1 /tmp xfs 955000
2221</entry>
2222</row>
2223<row>
2224<entry>
2225 /dev/md2 /usr ext3 8192000
2226</entry>
2227</row>
2228<row>
2229<entry>
2230 /dev/md3 /home xfs 8192000
2231
2232</entry>
2233</row>
2234</tbody></tgroup></informaltable>
2235
2236<para>So long as your /etc/raidtab file is sane, Mondo can
2237automatically partition and format your disks for you, including
2238the RAID devices.</para>
2239<para>Once you have finished editing /var/cache/mindi/mountlist.txt using
2240mondorestore's built-in editor then you may choose 'OK'. Please
2241note that this will not write anything to your hard disk. You will
2242only reformat or repartition your disks if you say 'Yes' when asked
2243if you want to do those things.</para>
2244</sect2>
2245
2246<sect2>
2247<title>Advanced</title>
2248<para>It is now possible to restore to a live filesystem using
2249Mondo. In other words, you do not have to boot your PC from your
2250media in order to restore files. Mondo was originally designed
2251for disaster recovery - situations in which you cannot boot your
2252PC. If you can boot your PC, it is not really a disaster, is it? :)
2253Well, if you have wiped out your priceless collection of "MTV's
2254Bjork Unplugged" MP3's, perhaps it is. Anyway, just type this as
2255root</para>
2256<para></para>
2257<informaltable><tgroup cols="1"><tbody>
2258<row>
2259<entry>
2260
2261bash# mondorestore
2262
2263</entry>
2264</row>
2265</tbody></tgroup></informaltable>
2266
2267<para></para>
2268<informaltable><tgroup cols="2"><tbody>
2269<row>
2270<entry>
2271<ulink url="images/rest1.png"><inlinemediaobject><imageobject>
2272<imagedata fileref="images/rest1-mini">
2273</imageobject></inlinemediaobject>
2274</ulink>
2275</entry>
2276<entry>
2277Choose your type of backup media. The live restoration process is
2278very similar to what you'll experience if you type mondorestore
2279with no parameters after booting from a Mondo media.
2280</entry>
2281</row>
2282<row>
2283<entry>
2284<ulink url="images/rest2.png"><inlinemediaobject><imageobject>
2285<imagedata fileref="images/rest2-mini">
2286</imageobject></inlinemediaobject>
2287</ulink>
2288</entry>
2289<entry>
2290Hit 'OK' when you have inserted the tape/CD. If you generated a
2291tape backup, the tape itself should be enough. If you generated a
2292CD backup, the first CD should be enough. Otherwise, you may need
2293the boot media.
2294</entry>
2295</row>
2296<row>
2297<entry>
2298<ulink url="images/rest3.png"><inlinemediaobject><imageobject>
2299<imagedata fileref="images/rest3-mini">
2300</imageobject></inlinemediaobject>
2301</ulink>
2302</entry>
2303<entry>
2304Flag the files and directories you wish to restore. Use the 'More'
2305and 'Less' buttons to open and close subdirectories.
2306</entry>
2307</row>
2308<row>
2309<entry>
2310<ulink url="images/rest4.png"><inlinemediaobject><imageobject>
2311<imagedata fileref="images/rest4-mini">
2312</imageobject></inlinemediaobject>
2313</ulink>
2314</entry>
2315<entry>
2316Specify the location to restore the files to. In general, '/' is
2317appropriate. If you do not want to overwrite newer versions of the
2318files you are restoring then specify /tmp/BKP or similar as the
2319restore path.
2320</entry>
2321</row>
2322<row>
2323<entry>
2324<ulink url="images/rest5.png"><inlinemediaobject><imageobject>
2325<imagedata fileref="images/rest5-mini">
2326</imageobject></inlinemediaobject>
2327</ulink>
2328</entry>
2329<entry>
2330Mondorestore will retrieve configuration information from the
2331media. (The sample screen is for tape users. CD users will see
2332something different.)
2333</entry>
2334</row>
2335<row>
2336<entry>
2337<ulink url="images/rest6.png"><inlinemediaobject><imageobject>
2338<imagedata fileref="images/rest6-mini">
2339</imageobject></inlinemediaobject>
2340</ulink>
2341</entry>
2342<entry>
2343Data will be restored to the hard disk - first the regular files,
2344then any big (32MB or greater) files in the restore set.
2345</entry>
2346</row>
2347</tbody></tgroup></informaltable>
2348
2349<para>I hope this manual was useful for you.</para>
2350</sect2>
2351</sect1>
2352
2353</chapter>
2354
2355<chapter id="faq">
2356<title>FAQ</title>
2357
2358<sect1 id="faq-overview">
2359<title>Overview</title>
2360<para>Are the errors from Mindi or Mondo? Look at
2361 /var/log/mondoarchive.log or /var/log/mindi.log (if run alone). Pipe
2362screen errors which relate to the creation of boot disk(s) and or
2363data disk(s) to a text file.</para>
2364<para>See the &WWW; for details. If you are going to e-mail
2365&ML; then
2366please attach that text file (zipped!) and give :</para>
2367<itemizedlist>
2368<listitem>
2369<para>Your kernel version (uname -a)</para>
2370</listitem>
2371<listitem>
2372 <para>Your Linux distro's name and version (/etc/distro-release)</para>
2373</listitem>
2374<listitem>
2375 <para>Whether your kernel supports initrd and loopfs; it should! (grep -E '^CONFIG_BLK_DEV_LOOP|^CONFIG_BLK_DEV_INITRD' /usr/src/linux/.config </para>
2376</listitem>
2377<listitem>
2378<para>What sort of PC you are using, including hard disk configurations (results of dmidecode, lshw, fdisk -l are useful here)</para>
2379</listitem>
2380</itemizedlist>
2381<para>Mondo is freely available under the GPL and you are given it for no charge.
2382When you e-mail the &ML;, please bear that in mind.</para>
2383</sect1>
2384<sect1 id="faq-general">
2385<title>General Questions</title>
2386
2387<qandaset>
2388<qandaentry>
2389 <question><para>Q: What is "Mindi"?</para></question>
2390 <answer>
2391<para>A: Mindi, a.k.a. Mindi-Linux, makes a mini-distribution from
2392your kernel, modules, modules, tools and libraries. It can also
2393generate an El Torito 2.88/5.76MB boot disk image. Mondo uses Mindi to
2394create a mini-distro, then boots from it and runs on it.</para>
2395</answer>
2396</qandaentry>
2397<qandaentry>
2398 <question><para>Q: Why is it called "Mondo"?</para></question>
2399 <answer>
2400<para>A: The Teenage Mutant Ninja Turtles described cool things as
2401'mondo'. Hugo Rabson wasn't sure what to call this project. 'Faust' was one
2402idea he had, partly as a dig at his former boss who practically owned
2403him because of his legal status at the time. In the end, he chose
2404something short and distinctive.</para>
2405</answer>
2406</qandaentry>
2407<qandaentry>
2408<question><para>Q: Mondo does not work on my system. It
2409 keels over and dies. What's wrong?</para></question>
2410<answer>
2411 <para>A: It works on Red Hat 7.x/8/9, RHEL 2.1/3/4, Mandrakelinux 8.x/9.x/10.x/200x, Fedora 4/5/6, Debian 3.x, most flavors
2412 of SuSE/SLES, some flavors of Slackware, etc.
2413The more distributions we support, the more moving targets we have to
2414hit. Please bear this in mind when e-mailing the list. :) If you
2415would like to help us by beta-testing Mondo (or Mindi) on your PC
2416then we would be very interested in working with you to work around
2417the eccentricities of your Linux distro. However, rest assured, 90%
2418of the bugs reported are actually symptoms of FooLinux X.Y's
2419unique way of doing things.</para>
2420<para>Please send a copy of <filename>/var/log/mondoarchive.log</filename> to the &ML;
2421along with a description of your distro, your kernel, etc.
2422Oh, and before sending it, please try to read it.</para>
2423</answer>
2424</qandaentry>
2425<qandaentry>
2426 <question><para>Q: What if the error is in Mindi?</para></question>
2427 <answer>
2428 <para>A: Please send a copy of <filename>/var/log/mindi.log</filename> to the &ML;
2429along with a description of your distro, your kernel, etc.
2430Oh, and before sending it, please read it as it is much easier to understand it.</para>
2431</answer>
2432</qandaentry>
2433<qandaentry>
2434 <question><para>Q: Can I trust Mondo?</para></question>
2435 <answer>
2436<para>A: Mondo has generated reliable archives since May 2000.
2437Lost data occured by using bad CD-R disks and not verifying their
2438contents. Some users have not tried booting from their CD until
2439crunch time. Remember to boot into Compare Mode to verify the
2440backup before you trust it. If Mondo did not work, you would not be
2441reading this. If it does not work for you, your kernel is usually
2442the culprit. Check <link linkend="overview-sysrq-kernelreq">Linux Kernel
2443support</link> to see what your kernel should support. Please
2444e-mail the list if you need some help with this.</para>
2445</answer>
2446</qandaentry>
2447<qandaentry>
2448 <question><para>Q: How do I report a bug?</para></question>
2449 <answer>
2450 <para>A: E-mail the bug report (mondo.err.xxxxx.tgz) to the &ML;.
2451 Ok you've read it already but it's really important if you want help.
2452If you don't send a logfile then there isn't a lot that we can do for you, so
2453PLEASE include a logfile at the very least.</para>
2454</answer>
2455</qandaentry>
2456<qandaentry>
2457<question><para>Q: I think Mondo should (...insert
2458suggestion here...) and I have rewritten it accordingly. Would you
2459like to see my patch?</para></question>
2460<answer>
2461<para>A: Absolutely! :-) The best way for you to make Mondo do what
2462you want is to modify it and then send the patch. That way, we
2463can all benefit.</para>
2464</answer>
2465</qandaentry>
2466<qandaentry>
2467<question><para>Q: I think Mondo should (...insert
2468suggestion here...); will you incorporate this feature for me,
2469please?</para></question>
2470<answer>
2471<para>A: Please enter the suggestion in our feature system at &WWW;
2472</para>
2473</answer>
2474</qandaentry>
2475<qandaentry>
2476<question><para>Q: Mondo says, "XXX is missing," and
2477 then terminates. What's wrong?</para></question>
2478<answer>
2479<para>A: A good Linux distribution should contain XXX but the
2480designers, in their infinite wisdom, decided not to include that
2481particular tool. Check <ulink url="http://www.mondorescue.org/downloads.shtml#dependencies">Related
2482 Linux Packages</ulink> and install the missing package. If that
2483fails, contact the vendor/distributor/manufacturer/designer of your
2484distro.</para>
2485</answer>
2486</qandaentry>
2487<qandaentry>
2488<question><para>Q: Can Mondo handle multi-CD backups and
2489 restores?</para></question>
2490<answer>
2491<para>A: Yes, up to twenty CD per set. This 20-CD limit results
2492from laziness on mondorescue's part. I'll be removed in the future. However, if
2493your system occupies more than 20 CD, may it's time for another type of media ?
2494</para>
2495</answer>
2496</qandaentry>
2497<qandaentry>
2498<question><para>Q: Can Mondo handle Linux/Windows
2499 dual-boot systems?</para></question>
2500<answer>
2501<para>A: Yes. If your system currently boots into Linux or Windows
2502via LILO, you can backup and restore both OSes at the same time
2503using Mondo. If you are using NTFS then add the switch, '-x
2504&lt;device&gt;'.</para>
2505</answer>
2506</qandaentry>
2507<qandaentry>
2508<question><para>Q: Can Mondo backup Windows-only
2509 systems?</para></question>
2510<answer>
2511<para>A: Not at the moment.
2512</para>
2513</answer>
2514</qandaentry>
2515<qandaentry>
2516 <question><para>Q: Does Mondo support LVM?</para></question>
2517 <answer>
2518<para>A: Mondo supports LVM v1 and v2. Mondo backs up and restores your
2519existing setup but it does not make it easy for you to change your
2520LVM configuration, at the moment. You have to edit <filename>/tmp/i-want-my-lvm</filename> at boot-time
2521to do that.</para>
2522</answer>
2523</qandaentry>
2524<qandaentry>
2525<question><para>Q: What if I don't use LILO? What if I
2526 use GRUB?</para></question>
2527<answer>
2528<para>A: GRUB is supported by Mondo.</para>
2529</answer>
2530</qandaentry>
2531<qandaentry>
2532<question><para>Q: I get the error, 'Cannot find
2533 /tmp/dev.0' or 'Cannot mount device 0x0701'; what do I do?</para></question>
2534<answer>
2535 <para>A: Please free up <filename>/dev/loop0</filename> using 'losetup /dev/loop0 -d' to
2536unmount that loop device. If your OS will not let you do that,
2537contact your local support group or Linux vendor.</para>
2538</answer>
2539</qandaentry>
2540<qandaentry>
2541<question><para>Q: Can I create a Mondo CD and then use
2542 it to create an archive of any OS on any PC?</para></question>
2543<answer>
2544<para>A: Not yet. You can use Mondo to backup Linux or
2545Linux/Windows dual boot. One day, Mondo will let you backup
2546partitions it can't read or write, by treating each partition as
2547one long file to be backed up. This file will be chopped,
2548compressed and archived like any other big file.</para>
2549</answer>
2550</qandaentry>
2551<qandaentry>
2552<question><para>Q: Why do you insist on putting media
2553disk images on Mondo CD? They waste space and I never use them. The
2554CD works just fine, so why keep the media disk images?</para>
2555</question>
2556<answer>
2557<para>A: Because. It helped us in the past. If you
2558really, truly want them gone then please submit a patch to make
2559them optional.</para>
2560</answer>
2561</qandaentry>
2562<qandaentry>
2563<question><para>Q: Why doesn't the Mondo project have a
2564cool-looking animal logo?</para></question>
2565<answer>
2566<para>A: Excellent question! Please submit graphics of candidate
2567 animal logos!</para>
2568 </answer>
2569</qandaentry>
2570<qandaentry>
2571<question><para>Q: Is there a Mondo user 'Code of
2572 Conduct?</para></question>
2573<answer>
2574<para>A: Yes. Read the HOWTO. Submit patches. Recommend realistic
2575improvements. Be courteous to other users on the discussion list.
2576Do not whine.</para>
2577</answer>
2578</qandaentry>
2579</qandaset>
2580</sect1>
2581
2582<sect1 id="faq-booting">
2583<title>Booting and Kernel related Questions</title>
2584<qandaset>
2585<qandaentry>
2586<question><para>Q: When I try to boot from the Mondo CD,
2587 it says, "UPGRADE YOUR RAM". What does that mean?</para></question>
2588<answer>
2589<para>A: Recompile your kernel and add Virtual memory file system
2590support. Take a look at <link linkend="overview-sysrq-kernelreq">Linux
2591Kernel support</link> to see what your kernel must support. (Of
2592course, if your PC has less than 64MB of RAM, you could always...
2593what's the phrase? I know, upgrade your RAM!)</para>
2594</answer>
2595</qandaentry>
2596<qandaentry>
2597<question><para>Q: When I try to boot from the Mondo CD,
2598it says something about not finding my CD-ROM drive and then it
2599blames the kernel. What does that mean?</para></question>
2600<answer>
2601 <para>A: Your kernel must support initrd, loopfs, IDE|SCSI|USB CD-ROM's, and
2602ramdisks. Take a look at <link linkend="overview-sysrq-kernelreq">Linux
2603Kernel support</link> to see what your kernel must support. If
2604your kernel does not support these things, Mondo will not boot from
2605your CD. However, when running Mindi, you may choose to use _its_
2606kernel instead of your own.
2607</para>
2608</answer>
2609</qandaentry>
2610<qandaentry>
2611<question><para>Q: The LILO Mondo media takes ages to
2612 boot. How can I speed it up?</para></question>
2613<answer>
2614<para>A: Edit mindi (it's a shell script, btw) and change
2615LILO_OPTIONS="" to LILO_OPTIONS="-c". This enables map compaction
2616in lilo and speeds up booting, for more info see the lilo man
2617page.</para>
2618</answer>
2619</qandaentry>
2620<qandaentry>
2621<question><para>Q: Why won't Mondo boot from my CD?
2622It says my kernel is flawed/outdated/ whatever, and when I wrote to
2623the ML, they told me the same thing... but I still don't get it. I
2624mean, my kernel works for everything else. Why not Mondo?</para></question>
2625<answer>
2626<para>A: Because Mondo makes a boot disk using your kernel. I bet
2627your other software doesn't do that. Also, not all kernels are
2628suitable for boot disks. I'm sorry but that's Life. Upgrade your
2629kernel and/or recompile it. Take a look at
2630<link linkend="overview-sysrq-kernelreq">Linux Kernel support</link> to see
2631what your kernel must support.</para>
2632</answer>
2633</qandaentry>
2634<qandaentry>
2635<question><para>Q: Why do I only need a boot disk if I'm
2636 using a tape drive? Where are the data disks?</para></question>
2637<answer>
2638<para>A: On the tape. :-) The first 32MB of the tape will be set
2639aside for a large tarball containing the data disks, a list of all
2640files backed up, and other sundries. If Mondo and Mindi do their
2641respective jobs then you won't need additional media, just the
2642boot media and the tape(s).</para>
2643<para>As of 2.2.6 mondorescue does support OBDR for tapes.
2644 So if you have a tape supporting that protocol such as HP tape readers, you may directly boot from the tape as well.</para>
2645</answer>
2646</qandaentry>
2647<qandaentry>
2648<question><para>Q: Why does it say, "Process accounting
2649 FAILED" when I reboot?</para></question>
2650<answer>
2651<para>A: You were using Process Accounting. Red Hat (or whichever
2652distro you are using) does not provide a startup/shutdown script
2653yet. So, when you try to backup the process log, it just grows and
2654grows as Mondo tries to back it up. Mondo doesn't back it up
2655anymore and that's why. The unfortunate side-effect is... well,
2656what you see on your screen. Type 'touch /var/log/pacct' and then
2657'paccton' to fix the error message.</para>
2658</answer>
2659</qandaentry>
2660<qandaentry>
2661<question><para>Q: Why does it say,
2662&amp;#8220;request_module[block-major-1]: Root fs not mounted VFS:
2663Cannot open root device "100" or 01:00 Please append a correct
2664"root=" boot option kernel panic: VFS: Unable to mount root fs on
266501:00&amp;#8221; when i boot from the CD?</para></question>
2666<answer>
2667<para>A: Recompile your kernel and add initrd support. Take a look
2668at <link linkend="overview-sysrq-kernelreq">Linux Kernel support</link> to
2669see what your kernel must support.</para>
2670</answer>
2671</qandaentry>
2672
2673<qandaentry>
2674<question><para id="TAPENICE">Q: My tape drive
2675doesn't play nicely with Mondo at boot-time. What do I do?</para></question>
2676<answer><para>A: Play with the 'mt' command (package mt-st). Use its setblksize and
2677defblksize switches to reconfigure your tape drive if necessary.
2678Some tape drives just are painful. If yours is one of
2679them then God help you. Mondo can handle any tape drive whose drive
2680and firmware can handle fopen(), fwrite(), fread() and fclose().
2681Mondo uses standard C libraries to talk to your tape streamer. If
2682your tape streamer can't handle that then you had better call a
2683priest. Either that or ask for a refund.
2684</para>
2685</answer>
2686</qandaentry>
2687</qandaset>
2688</sect1>
2689
2690<sect1 id="faq-install">
2691<title>Installation related Questions</title>
2692<qandaset>
2693<qandaentry>
2694<question><para>Q: Why do I get, "newt.h not found," or
2695"popt.h not found," several times when I try to install
2696Mondo?</para></question>
2697<answer>
2698<para>A: You have not installed libnewt and/or libnewt-devel.
2699Please do so. Check <ulink url="http://www.mondorescue.org/downloads.shtml#dependencies">Related Linux
2700Packages</ulink> to see what Mondo requires and where you can get
2701tarballs and RPM's. Make sure you are using the right version of
2702newt/libnewt. Read the error messages carefully.</para>
2703</answer>
2704</qandaentry>
2705<qandaentry>
2706<question><para>Q: Newt won't compile when I try. What's
2707 the problem?</para></question>
2708<answer>
2709<para>A: You are probably missing popt.h, which newt needs to
2710compile, it can be found in the 'popt' package. Check your
2711distribution and see if they have popt, if not check
2712<ulink url="http://www.mondorescue.org/downloads.shtml#dependencies">Related Linux Packages</ulink> to
2713see where you can get it.</para>
2714</answer>
2715</qandaentry>
2716<qandaentry>
2717<question><para>Q: I've just used up 6 CD-R, only to
2718 find that Mondo won't boot!</para></question>
2719<answer>
2720<para>A: You should have used CD-RW. ;) In the HOWTO, it gives
2721instructions on how to create a test CD (one, not six).</para>
2722</answer>
2723</qandaentry>
2724<qandaentry>
2725<question>
2726<para id="PACKREQ">Q: Lots of packages,
2727required by Mondo, are missing from my system. What do I do?</para>
2728</question>
2729<answer>
2730<para>
2731A: Install them. :) If you are using RPM or deb
2732then you'll be told which packages you need. Mondo offers a lot of
2733those packages on its
2734<ulink url="http://www.mondorescue.org/downloads.shtml">Download</ulink>
2735web page.</para>
2736</answer>
2737</qandaentry>
2738</qandaset>
2739</sect1>
2740
2741<sect1 id="faq-hardware">
2742<title>Hardware related Questions</title>
2743<qandaset>
2744<qandaentry>
2745 <question><para>Q: Can Mondo handle CD-RW?</para></question>
2746 <answer>
2747<para>A: Yes. Use '-Ow &lt;speed&gt; &lt;device&gt;' to make it
2748work.</para>
2749</answer>
2750</qandaentry>
2751<qandaentry>
2752<question><para>Q: Does Mondo support tape
2753 drives?</para></question>
2754<answer>
2755 <para>A: Yes. See above.</para>
2756 <para>Of course, mondo will relay on the kernel to support your tape drive. So you should first check that your kernel found it correctly. Use for example one of the following commands:</para>
2757<informaltable><tgroup cols="1"><tbody>
2758<row>
2759<entry>
2760 bash# dmesg | grep tape
2761</entry>
2762</row>
2763<row>
2764<entry>
2765 bash# cat /proc/scsi/scsi
2766</entry>
2767</row>
2768<row>
2769<entry>
2770 bash# mt -f /dev/st0 status
2771</entry>
2772</row>
2773</tbody></tgroup></informaltable>
2774
2775
2776</answer>
2777</qandaentry>
2778<qandaentry>
2779<question><para>Q: Does Mondo support my tape
2780 drive?</para></question>
2781<answer>
2782<para>A: If your tape drive and its firmware and the kernel-level
2783driver support fopen(), fread(), fwrite() and fclose() - standard C
2784library calls - then yes, Mondo should support it. If not, well,
2785you need a refund. :) Mondo plays nicely with any sane, sensible
2786drives. That's most of them, by the way. :) If your drive doesn't
2787play nicely with Mondo then you may try tinkering with setblksize
2788and defblksize using 'mt', or tweaking Mondo's block size by
2789recompiling it with make INTTAPE=4096 or INTTAPE=8192 or something.
2790Other than that, you need a priest or a refund.
2791Also, depending on the tape streamer model, a tape should be inserted
2792in the tape drive before starting mondoarchive, otherwise it may not
2793recognize the drive.</para>
2794</answer>
2795</qandaentry>
2796<qandaentry>
2797<question><para>Q: Sometimes, my laptop won't mount
2798 Mondo CD properly, or something. Umm...</para></question>
2799<answer>
2800<para>A: Please insert the CD, close the CD-ROM tray, wait a few
2801seconds and then press Enter to acknowledge insertion of the next
2802CD. Your laptop is on crack and is sucking a little too hard on the
2803pipe.</para>
2804</answer>
2805</qandaentry>
2806<qandaentry>
2807 <question><para>Q: Does Mondo support Hardware RAID?</para></question>
2808 <answer>
2809<para>A: Yes. You may backup and restore RAID systems. You may also
2810backup a non-RAID system and restore as RAID (or vice versa) by
2811using the mountlist editor to edit your RAID and non-RAID
2812partitions and their settings. Mondo will do the partitioning and
2813formatting for you.</para>
2814<para>Tested Raid controllers includes all those showing only classical devices
2815 such as /dev/sdx, and SmartArray cciss controllers.</para>
2816</answer>
2817</qandaentry>
2818<qandaentry>
2819<question><para>Q: Where is my CD burner, in SCSI terms?</para></question>
2820<answer>
2821<para>A: Type:</para>
2822<para></para>
2823<informaltable><tgroup cols="1"><tbody>
2824<row>
2825 <entry>
2826 bash# cdrecord -scanbus
2827 </entry>
2828</row>
2829<row>
2830 <entry>
2831 bash# wodim --devices
2832 </entry>
2833</row>
2834</tbody></tgroup></informaltable>
2835<para>or for ATAPI type of devices on older kernel versions:</para>
2836<para></para>
2837<informaltable><tgroup cols="1"><tbody>
2838<row>
2839 <entry>
2840 bash# cdrecord -scanbus dev=ATAPI
2841 </entry>
2842</row>
2843</tbody></tgroup></informaltable>
2844<para>you may replace ATAPI by ATA in the previous line with certain cdrecord versions and hadrware configurations</para>
2845
2846
2847<para>Find your CD burner's device# (e.g. '0,0,0'). Call Mondo with
2848the switch '-Oc &lt;speed&gt;' -d '&lt;device&gt;'. Or, if you feel
2849lucky, just use '-Oc 2'; Mondo will (a) assume you want to write at
28504x to a CD-R and (b) will do its best to find your CD burner.</para>
2851</answer>
2852</qandaentry>
2853<qandaentry>
2854 <question><para>Q: Can Mondo handle SCSI devices?</para></question>
2855 <answer>
2856<para>A: Mondo should be able to handle almost any hardware. So
2857long as your kernel and modules support it, Mindi will support it
2858and therefore so will Mondo.</para>
2859</answer>
2860</qandaentry>
2861<qandaentry>
2862 <question><para>Q: Why doesn't cdrecord -scanbus work ?</para></question>
2863 <answer>
2864 <para>A: If you have a 2.4.x kernel (typical example are fedora legacy kernels for redhat 7.X/8/9) and an IDE CDRW device, and the drive is not
2865listed when you run
2866
2867<informaltable><tgroup cols="1"><tbody>
2868<row>
2869<entry>
2870bash# cdrecord -scanbus
2871</entry>
2872</row>
2873</tbody></tgroup></informaltable>
2874
2875try adding the following kernel option to your boot script to enable
2876SCSI emulation: hdx=ide-scsi, where "hdx" should be replaced with the
2877appropriate drive letter of the CDRW device, e.g., "hdc".
2878(Answer provided by Christopher Moriarity cdm7_at_cdc.gov)
2879</para>
2880</answer>
2881</qandaentry>
2882</qandaset>
2883</sect1>
2884
2885<sect1 id="faq-backup">
2886<title>Backup related Questions</title>
2887
2888<qandaset>
2889<qandaentry>
2890<question><para id="MMKM">Q: Mondo says, 'Cannot
2891 run mindi --makemountlist' and aborts. What do I do?</para></question>
2892<answer>
2893 <para>
2894 A: Look at <filename>/var/log/mindi.log</filename> and see what it
2895 says. Also, try typing 'mindi --makemountlist /var/cache/mindi/mountlist.txt'
2896to see what Mindi says. Send the log to the &ML; if you get stuck.
2897</para>
2898</answer>
2899</qandaentry>
2900<qandaentry>
2901<question><para>Q: Can Mondo burn CD as they are
2902 created?</para></question>
2903<answer>
2904<para>A: Yes. Use the '-Oc &lt;speed&gt;' switch. Use a negative
2905number for a dummy burn.</para>
2906</answer>
2907</qandaentry>
2908<qandaentry>
2909<question><para>Q: Mondo failed to burn my CD. It said
2910something like, "Error CDB A1 01 02 53 ..." and so on. What does
2911that mean?</para></question>
2912<answer>
2913<para>A: Cdrecord reported some serious errors while trying to burn
2914your CD. Check your CD burner, your CD-R and your kernel.</para>
2915</answer>
2916</qandaentry>
2917<qandaentry>
2918<question><para>Q: May I backup my system with one
2919 partition layout and restore with another?</para></question>
2920<answer>
2921<para>A: Yes. Boot in Interactive Mode and edit the mountlist using
2922the snazzy new mountlist editor. Mondo can now edit your RAID
2923partitions for you. Just open /dev/md0 (or whatever) and select
2924"RAID.." to start. Or, to add a RAID device:</para>
2925<itemizedlist>
2926<listitem>
2927<para>Add two or more partitions, of type and mountpoint
2928'raid'</para>
2929</listitem>
2930<listitem>
2931<para>Add device '/dev/md0' and click OK</para>
2932</listitem>
2933<listitem>
2934<para>Follow the prompts and your own common-sense :)</para>
2935</listitem>
2936</itemizedlist>
2937</answer>
2938</qandaentry>
2939<qandaentry>
2940<question><para>Q: Why does Mondo need so much free disk
2941 space?</para></question>
2942<answer>
2943 <para>A: Because it need space to create the archive files with afio, then
2944 again space to create the ISO images that you'll be able to burn.
2945</para>
2946</answer>
2947</qandaentry>
2948<qandaentry>
2949<question><para>Q: I am trying to do something clever,
2950e.g. write my ISO's to an NFS mount, and I get some weird error
2951messages. What do I do?</para></question>
2952<answer>
2953<para>A: Well, (a) use '-T /tmp' or '-T /home' or something in your
2954 call to Mondo. Oh, and (b) check the <filename>/etc/exports</filename> file on your NFS server
2955 and verify the exported filesystem is writable for the client, and relaunch exportfs -a.
2956</para>
2957</answer>
2958</qandaentry>
2959<qandaentry>
2960<question><para>Q: Can Mondo backup to data files on
2961 another partition, e.g. an NFS mount?</para></question>
2962<answer>
2963<para>A: Yes. Just backup as usual but add '-d /mnt/nfs' or
2964wherever your partition is mounted; don't use '-Oc' or '-Ot' at
2965all; just '-Oi -d /root'. Then, after booting from the media
2966which Mondo generates, you need to type 'ISO' at the
2967console.</para>
2968</answer>
2969</qandaentry>
2970<qandaentry>
2971<question><para>Q: Can Mondo backup _to_ an NFS
2972 partition, i.e. backup over a network? How about restoring?</para></question>
2973<answer>
2974<para>A: Yes. Use '-On &lt;mount&gt; &lt;directory&gt;'. Example:
2975</para>
2976<informaltable><tgroup cols="1"><tbody>
2977<row>
2978<entry>
2979
2980 bash# mondoarchive -On nfs://192.168.1.3:/home/nfs
2981
2982</entry>
2983</row>
2984</tbody></tgroup></informaltable>
2985
2986</answer>
2987</qandaentry>
2988<qandaentry>
2989<question><para>Q: Does Mondo handle System or Hidden
2990 attributes when archiving Dos/Win files?</para></question>
2991<answer>
2992<para>A: No. It probably never will, either. Sorry.</para>
2993</answer>
2994</qandaentry>
2995</qandaset>
2996</sect1>
2997
2998<sect1 id="faq-compare">
2999<title>Compare related Questions</title>
3000
3001<qandaset>
3002<qandaentry>
3003<question><para>Q: When I compare my archives to my file
3004system, Mondo tells me there are differences or errors. Are the
3005archives bad?</para></question>
3006<answer>
3007 <para>A: Look at <filename>/tmp/changed.files</filename>; if the files are logfiles,
3008temp files or files which you think you may have changed recently
3009then the archives are simply out of date, albeit only by a few
3010minutes. Not a problem. However, if lots of files in /usr have
3011changed or if you get lots of errors then perhaps your CD, your
3012tapes or even your hardware could be to blame. Check your CD writer
3013or tape streamer.</para>
3014<para>Also, don't forget to review <filename>/var/log/mondoarchive.log</filename> for
3015more information.</para>
3016</answer>
3017</qandaentry>
3018</qandaset>
3019</sect1>
3020
3021<sect1 id="faq-restore">
3022<title>Restore related Questions</title>
3023<qandaset>
3024<qandaentry>
3025<question><para>Q: Can Mondo help me
3026 move/resize/re-allocate my partitions?</para></question>
3027<answer>
3028<para>A: Yes. Just backup your system in Interactive Mode using
3029Mondo. Edit the mountlist when prompted.</para>
3030</answer>
3031</qandaentry>
3032<qandaentry>
3033<question><para>Q: My zip drive is a SCSI drive. When I
3034restore, Mondo craps out, saying it can't mount the drive (because
3035there is no disk in it). What do I do?</para></question>
3036<answer>
3037<para>A: Restore in Interactive Mode. Delete the SCSI drive from
3038the mountlist before you restore. Then Mondo won't try to partition
3039or format it. Next time you backup, use -E /dev/sdd (or whatever
3040your zip drive is). The /dev entry will be excluded from the
3041mountlist but not from the filelist. So, when you restore, you
3042won't accidentally reformat your zip disk. However, after
3043restoring, you will find that /dev/sdd (the _file_) will still be
3044present in your /dev directory. Cool, eh?</para>
3045</answer>
3046</qandaentry>
3047<qandaentry>
3048<question><para>Q: I received a message like, 'Fileset
3049 NNN failed' during restore. What does it mean.</para></question>
3050<answer>
3051<para>A: It usually means either you had a very large (&gt;2GB)
3052file which was not archived owing to a flaw in your distro or your
3053filesystem has changed in relation to the backup.</para>
3054</answer>
3055</qandaentry>
3056<qandaentry>
3057<question><para>Q: Why does my ext3 partition have less
3058 space free than when I backed it up?</para></question>
3059<answer>
3060<para>A: Mondo creates a 10MB journal file area. Your journal was
3061probably smaller than that, hence the difference.</para>
3062</answer>
3063</qandaentry>
3064<qandaentry>
3065<question><para id="SEGF">Q: When I restore after
3066booting from the media, I sometimes get errors like, "Running
3067out of memory" or "Segmentation fault". What is going on?</para></question>
3068<answer><para>A: It sounds as if you are running out of disk
3069space, probably ram disk space. Type 'df -m' to see which
3070partitions are running low on space. Please send as much
3071information as you can to the &ML;. This problem is
3072believed to have been fixed in 1.63 and 1.71.</para>
3073</answer>
3074</qandaentry>
3075<qandaentry>
3076<question>
3077<para id="LVM">Q: I can't nuke-restore my LVM or RAID or
3078LVM-on-RAID setup. I have to do it manually. What now?</para></question>
3079<answer>
3080<para>A: You said it yourself. You have to do it manually. :) Sorry
3081but that's about it. At least you have all the tools to do it. I
3082assume you know how. If you don't, look at i-want-my-lvm (a script
3083on the ramdisk) if you're using LVM. It should give you a few
3084clues. RAID is harder but in general Mondo's RAID support is good.
3085After you've prepped and formatted your drives, run mondorestore
3086again but say 'no' when asked if you want Mondo to prep or format
3087your drives.</para>
3088</answer>
3089</qandaentry>
3090</qandaset>
3091</sect1>
3092</chapter>
3093
3094&gfdl;
3095
3096</book>
Note: See TracBrowser for help on using the repository browser.