[151] | 1 | .\" Copyright (c) 2005 Andree Leidenfrost
|
---|
| 2 | .\"
|
---|
| 3 | .\" This is free documentation; you can redistribute it and/or
|
---|
| 4 | .\" modify it under the terms of the GNU General Public License as
|
---|
| 5 | .\" published by the Free Software Foundation; either version 2 of
|
---|
| 6 | .\" the License, or (at your option) any later version.
|
---|
| 7 | .\"
|
---|
| 8 | .\" The GNU General Public License's references to "object code"
|
---|
| 9 | .\" and "executables" are to be interpreted as the output of any
|
---|
| 10 | .\" document formatting or typesetting system, including
|
---|
| 11 | .\" intermediate and printed output.
|
---|
| 12 | .\"
|
---|
| 13 | .\" This manual is distributed in the hope that it will be useful,
|
---|
| 14 | .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
|
---|
| 15 | .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
---|
| 16 | .\" GNU General Public License for more details.
|
---|
| 17 | .\"
|
---|
| 18 | .\" You should have received a copy of the GNU General Public
|
---|
| 19 | .\" License along with this manual; if not, write to the Free
|
---|
| 20 | .\" Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139,
|
---|
| 21 | .\" USA.
|
---|
| 22 | .\"
|
---|
[1693] | 23 | .TH MINDI 8 "PBDATE" "Mondo Rescue PBVER-rPBREV"
|
---|
[151] | 24 | .SH NAME
|
---|
| 25 | mindi \- a tool for creating boot/root disks
|
---|
| 26 | .SH SYNOPSIS
|
---|
| 27 | .B mindi
|
---|
| 28 | .br
|
---|
| 29 | .BR "mindi -v"| " --version"| " -V"| " -version"
|
---|
| 30 | .br
|
---|
| 31 | .BI "mindi --findkernel"
|
---|
| 32 | .br
|
---|
| 33 | .BI "mindi --makemountlist "file
|
---|
| 34 | .br
|
---|
[1063] | 35 | .BI "mindi --usb "device
|
---|
| 36 | .br
|
---|
[1060] | 37 | .BI "mindi --printvar "variable
|
---|
[151] | 38 | .SH DESCRIPTION
|
---|
| 39 | .PP
|
---|
| 40 | .B mindi
|
---|
[1903] | 41 | creates a bootable ISO/USB image using files from the system it runs on.
|
---|
[151] | 42 | .B mindi
|
---|
| 43 | will try hard to reproduce the environment of its host system including loaded
|
---|
| 44 | modules to ensure that the system can be booted properly from the created
|
---|
| 45 | rescue media.
|
---|
| 46 | .B mindi
|
---|
| 47 | is used by
|
---|
| 48 | .B monodarchive(8)
|
---|
[1903] | 49 | to produce the required USB/ISO images but can also be used stand-alone.
|
---|
[151] | 50 |
|
---|
| 51 | For stand-alone usage,
|
---|
| 52 | .B mindi
|
---|
| 53 | is called without any parameters or switches. It will then interactively ask
|
---|
| 54 | the user for all information required to create a set of boot/root media.
|
---|
| 55 | .LP
|
---|
| 56 | The probably more frequent way of calling
|
---|
| 57 | .B mindi
|
---|
| 58 | is non-interactively from
|
---|
| 59 | .B mondoarchive(8)
|
---|
| 60 | using the
|
---|
| 61 | .B --custom
|
---|
| 62 | switch. All required information is then provided via command line parameters.
|
---|
| 63 | The sequence of these parameters is listed below.
|
---|
| 64 | .SH OPTIONS
|
---|
| 65 | .TP
|
---|
[1060] | 66 | .BI "-v"| " --version"| " -V"| " -version"
|
---|
| 67 | .RI Prints the version of mindi.
|
---|
[151] | 68 | .TP
|
---|
[1060] | 69 | .BI "--findkernel"
|
---|
| 70 | .RI Finds the image of the running kernel in the file system.
|
---|
[151] | 71 | .TP
|
---|
| 72 | .BI "--makemountlist "file
|
---|
| 73 | .RI "Creates a mount list and writes it to file "file ".
|
---|
| 74 | .TP
|
---|
[1063] | 75 | .BI "--usb "device
|
---|
| 76 | .RI Create a bootable USB device
|
---|
| 77 | .TP
|
---|
[1060] | 78 | .BI "--printvar "variable
|
---|
| 79 | .RI "prints the value of the variable (useful for mondo-archive and debug)"
|
---|
[151] | 80 | .TP
|
---|
| 81 | .BI "--custom " parameters
|
---|
[1060] | 82 | .RI "Provide all required parameters to"
|
---|
[151] | 83 | .B mindi
|
---|
[1060] | 84 | .RI "for non-interactive calling. This usually means a call from"
|
---|
[151] | 85 | .BR "mondoarchive(8)".
|
---|
| 86 | The following parameters are used:
|
---|
| 87 | .br
|
---|
| 88 | 01) directory to use for temporary files
|
---|
| 89 | .br
|
---|
| 90 | 02) directory to put disk images in
|
---|
| 91 | .br
|
---|
| 92 | 03) path to kernel image
|
---|
| 93 | .br
|
---|
| 94 | 04) tape device
|
---|
| 95 | .br
|
---|
| 96 | 05) tape size [MB]
|
---|
| 97 | .br
|
---|
| 98 | 06) total number of files in file list
|
---|
| 99 | .br
|
---|
| 100 | 07) use LZO [yes|no]
|
---|
| 101 | .br
|
---|
| 102 | 08) CD recovery media [yes|no]
|
---|
| 103 | .br
|
---|
| 104 | 09) devices to include
|
---|
| 105 | .br
|
---|
| 106 | 10) conservative LiLo settings [yes|no]
|
---|
| 107 | .br
|
---|
| 108 | 11) number of last file list
|
---|
| 109 | .br
|
---|
| 110 | 12) estimated total number of slices
|
---|
| 111 | .br
|
---|
| 112 | 13) devices to exclude
|
---|
| 113 | .br
|
---|
| 114 | 14) compare mode [yes|no]
|
---|
| 115 | .br
|
---|
| 116 | 15) use lilo [yes|no]
|
---|
| 117 | .br
|
---|
| 118 | 16) use star (rather than tar) [yes|no]
|
---|
| 119 | .br
|
---|
| 120 | 17) internal tape block size [bytes]
|
---|
| 121 | .br
|
---|
| 122 | 18) number of diffenrential backup
|
---|
| 123 | .br
|
---|
| 124 | 19) make non-bootable [yes|no]
|
---|
| 125 | .br
|
---|
[1060] | 126 | 20) use gzip [yes|no]
|
---|
| 127 | .br
|
---|
[151] | 128 | (Blank parameters must be specified as "" on the command line.)
|
---|
| 129 | .SH DIAGNOSTICS
|
---|
| 130 | .B mindi
|
---|
| 131 | writes some output to the console and extensive information to log file
|
---|
| 132 | .IR /var/log/mindi.log ".
|
---|
| 133 | When seeking technical support for
|
---|
| 134 | .BR "mindi",
|
---|
| 135 | please attach this file to your email.
|
---|
| 136 | .SH FILES
|
---|
| 137 | .TP
|
---|
| 138 | .I /var/log/mindi.log
|
---|
| 139 | Log file of mindi run. Contains important information to analyze mindi problem
|
---|
| 140 | reports.
|
---|
| 141 | .TP
|
---|
[1060] | 142 | .I /etc/mindi/deplist.d
|
---|
| 143 | Files containing the list of files to be included on boot/root disks.
|
---|
| 144 | .TP
|
---|
[151] | 145 | .I /etc/mindi/deplist.txt
|
---|
[1060] | 146 | List of additional files to be included on boot/root disks.
|
---|
[151] | 147 | .TP
|
---|
[978] | 148 | .I /var/cache/mindi/N.tar.gz
|
---|
[151] | 149 | Number N of multiple tar balls together containing root file system for rescue
|
---|
| 150 | media.
|
---|
| 151 | .TP
|
---|
[978] | 152 | .I /var/cache/mindi/all.tar.gz
|
---|
[151] | 153 | Single tar ball of root file system for rescue media.
|
---|
| 154 | .TP
|
---|
[978] | 155 | .I /var/cache/mindi/initrd.img
|
---|
[151] | 156 | initrd image for bootable ISO image.
|
---|
| 157 | .TP
|
---|
[978] | 158 | .I /var/cache/mindi/mindi-boot.F.img
|
---|
[151] | 159 | .B mindi
|
---|
[1903] | 160 | boot media of size F [KB].
|
---|
[151] | 161 | .TP
|
---|
[978] | 162 | .I /var/cache/mindi/mindi-root.F.img
|
---|
[151] | 163 | .B mindi
|
---|
[1903] | 164 | root media of size F [KB].
|
---|
[151] | 165 | .TP
|
---|
[978] | 166 | .I /var/cache/mindi/mindi-data.N.img
|
---|
[151] | 167 | .B mindi
|
---|
[1903] | 168 | data media number N for boot/root media.
|
---|
[151] | 169 | .TP
|
---|
[978] | 170 | .I /var/cache/mindi/mindi.iso
|
---|
[151] | 171 | .B mindi
|
---|
| 172 | bootable ISO image.
|
---|
[978] | 173 | .SH CONFIGURATION FILE
|
---|
| 174 | You may create a mindi configuration file under
|
---|
| 175 | .B /etc/mindi
|
---|
| 176 | called
|
---|
| 177 | .B mindi.conf
|
---|
[1060] | 178 | which overwrites default values described in
|
---|
| 179 | .B mindi.conf.dist
|
---|
[1489] | 180 | in the same directory. (Cf comments in this file)
|
---|
[978] | 181 | .br
|
---|
[151] | 182 | .SH "SEE ALSO"
|
---|
| 183 | mondoarchive(8), mondorestore(8).
|
---|
| 184 | .TP
|
---|
| 185 | See mailing list at http://www.mondorescue.org for technical support.
|
---|
| 186 | .SH AUTHORS
|
---|
[399] | 187 | Bruno Cornec (lead-development)
|
---|
[1500] | 188 | .I "bruno_at_mondorescue.org"
|
---|
[151] | 189 | .br
|
---|
[399] | 190 | Andree Leidenfrost (co-developper)
|
---|
| 191 | .I "aleidenf_at_bigpond.net.au"
|
---|
| 192 | .br
|
---|
| 193 | .SH ORIGINAL AUTHORS
|
---|
| 194 | Hugo Rabson (original author)
|
---|
| 195 | .I "hugo.rabson_at_mondorescue.org"
|
---|
| 196 | .br
|
---|
[151] | 197 | Jesse Keating (packaging)
|
---|
[399] | 198 | .I "hosting_at_j2solutions.net"
|
---|
[151] | 199 | .br
|
---|
| 200 | Stan Benoit (testing)
|
---|
[399] | 201 | .I "troff_at_nakedsoul.org"
|
---|
[151] | 202 | .br
|
---|
| 203 | Mikael Hultgren (docs)
|
---|
[399] | 204 | .I "mikael_hultgren_at_gmx.net"
|
---|
[151] | 205 | .br
|
---|
| 206 | .
|
---|