1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
\r
2 "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
\r
3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
\r
5 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
\r
6 <meta name="generator" content="AsciiDoc 7.1.2" />
\r
7 <style type="text/css">
\r
9 p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
\r
11 border: 1px solid red;
\r
16 margin: 1em 5% 1em 5%;
\r
21 text-decoration: underline;
\r
39 h1, h2, h3, h4, h5, h6 {
\r
41 font-family: sans-serif;
\r
43 margin-bottom: 0.5em;
\r
48 border-bottom: 2px solid silver;
\r
51 border-bottom: 2px solid silver;
\r
61 border: 1px solid silver;
\r
66 margin-bottom: 0.5em;
\r
76 font-family: sans-serif;
\r
83 font-family: sans-serif;
\r
87 font-family: sans-serif;
\r
89 border-top: 2px solid silver;
\r
95 padding-bottom: 0.5em;
\r
99 padding-bottom: 0.5em;
\r
103 div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
\r
104 div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
\r
105 div.admonitionblock {
\r
108 margin-bottom: 1.5em;
\r
110 div.admonitionblock {
\r
112 margin-bottom: 2.5em;
\r
115 div.content { /* Block element content. */
\r
119 /* Block element titles. */
\r
120 div.title, caption.title {
\r
121 font-family: sans-serif;
\r
125 margin-bottom: 0.5em;
\r
131 td div.title:first-child {
\r
134 div.content div.title:first-child {
\r
137 div.content + div.title {
\r
141 div.sidebarblock > div.content {
\r
142 background: #ffffee;
\r
143 border: 1px solid silver;
\r
147 div.listingblock > div.content {
\r
148 border: 1px solid silver;
\r
149 background: #f4f4f4;
\r
153 div.quoteblock > div.content {
\r
154 padding-left: 2.0em;
\r
160 div.verseblock + div.attribution {
\r
164 div.admonitionblock .icon {
\r
165 vertical-align: top;
\r
168 text-decoration: underline;
\r
170 padding-right: 0.5em;
\r
172 div.admonitionblock td.content {
\r
173 padding-left: 0.5em;
\r
174 border-left: 2px solid silver;
\r
177 div.exampleblock > div.content {
\r
178 border-left: 2px solid silver;
\r
182 div.verseblock div.content {
\r
186 div.imageblock div.content { padding-left: 0; }
\r
187 div.imageblock img { border: 1px solid silver; }
\r
188 span.image img { border-style: none; }
\r
192 margin-bottom: 0.8em;
\r
197 font-style: italic;
\r
199 dd > *:first-child {
\r
204 list-style-position: outside;
\r
207 list-style-type: lower-alpha;
\r
210 div.tableblock > table {
\r
211 border: 3px solid #527bbd;
\r
214 font-family: sans-serif;
\r
223 margin-bottom: 0.8em;
\r
226 vertical-align: top;
\r
227 font-style: italic;
\r
228 padding-right: 0.8em;
\r
231 vertical-align: top;
\r
235 div#footer-badges { display: none; }
\r
237 /* Workarounds for IE6's broken and incomplete CSS2. */
\r
239 div.sidebar-content {
\r
240 background: #ffffee;
\r
241 border: 1px solid silver;
\r
244 div.sidebar-title, div.image-title {
\r
245 font-family: sans-serif;
\r
248 margin-bottom: 0.5em;
\r
251 div.listingblock div.content {
\r
252 border: 1px solid silver;
\r
253 background: #f4f4f4;
\r
257 div.quoteblock-content {
\r
258 padding-left: 2.0em;
\r
261 div.exampleblock-content {
\r
262 border-left: 2px solid silver;
\r
263 padding-left: 0.5em;
\r
266 <title>grml-debootstrap(8)</title>
\r
270 <h1>grml-debootstrap(8)</h1>
\r
273 <div class="sectionbody">
\r
274 <p>grml-debootstrap - wrapper around debootstrap for installing plain Debian via grml</p>
\r
277 <div class="sectionbody">
\r
278 <p>grml-debootstrap [ _options_ ]</p>
\r
279 <p><span class="image">
\r
280 <img src="images/screenshot.png" alt="Screenshot" title="Screenshot"/>
\r
283 <h2>Introduction</h2>
\r
284 <div class="sectionbody">
\r
285 <p>grml-debootstrap is a wrapper suite around debootstrap
\r
286 (and cdebootstrap if you want) for installing a plain Debian
\r
287 system via grml very fast and easy.</p>
\r
288 <p>All you have to do is adjust a few variables in configuration file
\r
289 /etc/debootstrap/config (or specify some variables via commandline) and invoke
\r
290 grml-debootstrap without any further options then.</p>
\r
291 <p>A plain and base Debian system will be installed on the given
\r
292 device (or directory) then. Customization of this process is
\r
293 possible as well.</p>
\r
294 <div class="admonitionblock">
\r
297 <img src="./images/icons/caution.png" alt="Caution" />
\r
299 <td class="content">The grml team does not take responsibility for loss of any data!</td>
\r
303 <h2>Options and environment variables</h2>
\r
304 <div class="sectionbody">
\r
307 <strong>-h</strong>, <strong>—help</strong>
\r
311 Show summary of options and exit.
\r
315 <strong>-v</strong>, <strong>—version</strong>
\r
319 Show version of program and exit.
\r
323 <strong>—grub</strong> <_device_>
\r
327 Where do you want to install grub to? Use grub syntax for specifying.
\r
328 Do not forget to set groot as well. Leave empty to avoid installation of grub.
\r
332 <strong>—groot</strong> <_device_>
\r
336 Specify root device for usage in grub (corresponds with $TARGET).
\r
337 Again, use grub syntax for specifying.
\r
338 Corresponding with configuration variable GROOT.
\r
342 <strong>—boot_append</strong> <_appendline for the kernel_>
\r
346 Specify appendline for the kernel.
\r
351 <strong>-m</strong>, <strong>—mirror</strong> <_URL_>
\r
355 Specify mirror which should be used for apt-get/aptitude. Notice that
\r
356 specifying the mirror also sets the chrootmirror to the given value.
\r
357 Corresponding with configuration variables MIRROR and CHROOTMIRROR.
\r
361 <strong>-i</strong>, <strong>—iso</strong> <_/mntpoint_>
\r
365 Specify mountpoint where you have a Debian ISO mounted loopback.
\r
366 Using this option instead of the mirror option gives you the possibility
\r
367 to install the base-system without network access. Make sure you
\r
368 mounted the according Debian-ISO to the given <_/mntpoint_>. See section
\r
369 <em>Usage examples</em> for a demonstration.
\r
373 <strong>-p</strong>, <strong>—mntpoint</strong> <_/mntpoint_>
\r
377 Specify mountpoint that should be used for mounting the target system.
\r
378 Corresponding with configuration variable MNTPOINT.
\r
382 <strong>—password</strong> <_password_>
\r
386 Use specified password as password for user root. Use with caution, as your
\r
387 commandline might be visible in the process list and the shell history.
\r
388 It's meant for automatic installation only.
\r
392 <strong>-r</strong>, <strong>—release</strong> <_releasename_>
\r
396 Specify release of new Debian system. Supported releases: sarge, etch, lenny and sid.
\r
397 Corresponding with configuration variable RELEASE.
\r
401 <strong>-t</strong>, <strong>—target</strong> <_target_>
\r
405 Target partition (/dev/…) or directory (anything else without /dev at the
\r
410 <div class="admonitionblock">
\r
413 <img src="./images/icons/warning.png" alt="Warning" />
\r
415 <td class="content">the commandline parsing of grml-debootstrap does not validate the provided
\r
416 arguments for the commandline options. Please be careful and check docs and
\r
417 /etc/debootstrap/config for further information.</td>
\r
421 <h2>Usage examples</h2>
\r
422 <div class="sectionbody">
\r
423 <div class="literalblock">
\r
424 <div class="content">
\r
425 <pre><tt>grml-debootstrap --target /dev/hda1 --grub hd0 --groot hd0,0</tt></pre>
\r
427 <p>Install default Debian release (stable/etch) on /dev/hda1 and install bootmanager
\r
428 Grub in MBR (master boot record) of /dev/hda and use /dev/hda1 as system partition.</p>
\r
429 <div class="literalblock">
\r
430 <div class="content">
\r
431 <pre><tt>grml-debootstrap --target /dev/hda6 --grub hd0 --groot hd0,5 --release sid</tt></pre>
\r
433 <p>Install Debian unstable/sid on /dev/hda6, install bootmanager
\r
434 Grub in MBR (master boot record) of /dev/hda and use /dev/hda6 as system partition.</p>
\r
435 <div class="literalblock">
\r
436 <div class="content">
\r
437 <pre><tt>grml-debootstrap --target /data/chroot</tt></pre>
\r
439 <p>Install default Debian release (stable/etch) in directory /data/chroot (without
\r
440 any bootloader).</p>
\r
441 <div class="literalblock">
\r
442 <div class="content">
\r
443 <pre><tt>grml-debootstrap --target /dev/sda3 --grub hd0 --groot hd0,2 --mirror ftp://ftp.tugraz.at/mirror/debian</tt></pre>
\r
445 <p>Install default Debian release (stable/etch) on /dev/sda3 and install bootmanager
\r
446 Grub in MBR (master boot record) of /dev/sda and use /dev/sda3 as system partition.
\r
447 Use specified mirror instead of the default (ftp://ftp.debian.de/debian) one.</p>
\r
448 <div class="literalblock">
\r
449 <div class="content">
\r
450 <pre><tt>mount -o loop /mnt/hda6/debian-40r0-i386-CD-1.iso /mnt/iso
\r
451 grml-debootstrap --target /dev/hda1 --grub hd0 --groot hd0,0 --iso file:/mnt/iso/debian/</tt></pre>
\r
453 <p>Install Debian stable/etch on /dev/hda1 using the loopback mounted Debian-ISO
\r
454 for the base-system and install bootmanager Grub in MBR (master boot record) of
\r
455 /dev/hda and use /dev/hda1 as system partition. Please notice, that the chroot
\r
456 system requires network access for all packages which are not part of the
\r
460 <div class="sectionbody">
\r
461 <div class="literalblock">
\r
462 <div class="content">
\r
463 <pre><tt>/etc/debootstrap/config</tt></pre>
\r
465 <p>Main configuration file. You have to adjust it according to your needs
\r
466 before you are able to run grml-debootstrap.</p>
\r
467 <div class="literalblock">
\r
468 <div class="content">
\r
469 <pre><tt>/etc/debootstrap/chroot-script</tt></pre>
\r
471 <p>The script executed within the new Debian system as soon as the main system
\r
472 has been installed via [c]debootstrap.</p>
\r
473 <div class="literalblock">
\r
474 <div class="content">
\r
475 <pre><tt>/etc/debootstrap/locale.gen</tt></pre>
\r
477 <p>Defines the default locales used for generating locales via locale-gen.</p>
\r
478 <div class="literalblock">
\r
479 <div class="content">
\r
480 <pre><tt>/etc/debootstrap/packages</tt></pre>
\r
482 <p>Defines the software packages which should be installed in the new
\r
483 Debian system by default.</p>
\r
484 <div class="literalblock">
\r
485 <div class="content">
\r
486 <pre><tt>/etc/debootstrap/extrapackages</tt></pre>
\r
488 <p>Debian Packages dropped here will be installed into the new Debian system by
\r
489 default (Controlvariable: EXTRAPACKAGES)</p>
\r
490 <div class="literalblock">
\r
491 <div class="content">
\r
492 <pre><tt>/etc/debootstrap/stages/</tt></pre>
\r
494 <p>The default directory for storing information about executed stages. Every
\r
495 single function of grml-debootstrap will write <em>done</em> to the stages directory
\r
496 into a file named as the function itself if it has been executed successfully.
\r
497 You can adjust the location of the directory via configuration variable STAGES
\r
498 via /etc/debootstrap/config. Please notice that you have to remove the stages
\r
499 directory on your own if you want to re-execute grml-debootstrap after running it
\r
500 successfully once. This should avoid recurrent execution by error of
\r
501 grml-debootstrap (which might delete present data).</p>
\r
503 <h2>Customization</h2>
\r
504 <div class="sectionbody">
\r
505 <p>You can control execution of grml-debootstrap via adjusting
\r
506 /etc/debootstrap/config for some main stuff or via setting some selected
\r
507 variables via commandline. The packages which should be installed in the new
\r
508 Debian system can be defined via the file /etc/debootstrap/packages. If you
\r
509 want to put existing files to the new Debian system you can place them into the
\r
510 (by default non-existing) directories boot, etc, share, usr and var in
\r
511 /etc/debootstrap/. Every existing directory will be copied to the new Debian
\r
512 system then. If you want to install additional packages that are not available
\r
513 via the grml or debian mirror drop them into /etc/debootstrap/extrapackages and
\r
514 take sure that EXTRAPACKAGES is set to "yes".</p>
\r
516 <h2>Automatic installation</h2>
\r
517 <div class="sectionbody">
\r
518 <p>If environment variable AUTOINSTALL is set grml-debootstrap can be executed in a
\r
519 full automatic mode. While this mode isn't really useful for interactive
\r
520 execution (just configure /etc/debootstrap/configure or specify the relevant
\r
521 variables on the commandline instead) it is meant for use via bootoption
\r
522 debian2hd. The bootoption debian2hd (more precise: the kernelname on bootprompt)
\r
523 supports the following bootoptions (they correspond with the commandline options
\r
524 mentioned above):</p>
\r
525 <div class="literalblock">
\r
526 <div class="content">
\r
527 <pre><tt>target=...</tt></pre>
\r
529 <p>The target partition/directory of the new Debian system. Usage example:
\r
530 target=/dev/hda1</p>
\r
531 <div class="literalblock">
\r
532 <div class="content">
\r
533 <pre><tt>grub=...</tt></pre>
\r
535 <p>Where do you want to install grub to? Use grub syntax for specifying.
\r
536 Usage example: grub=hd0</p>
\r
537 <div class="literalblock">
\r
538 <div class="content">
\r
539 <pre><tt>groot=...</tt></pre>
\r
541 <p>Specify root device for usage in grub (corresponds with $TARGET).
\r
542 Again, use grub syntax for specifying. Usage example: groot=hd0,0</p>
\r
543 <div class="literalblock">
\r
544 <div class="content">
\r
545 <pre><tt>release=...</tt></pre>
\r
547 <p>Specify release of new Debian system. Defaults to Debian stable.
\r
548 Supported relases: sarge, etch, lenny and sid. Usage example: release=sid</p>
\r
549 <div class="literalblock">
\r
550 <div class="content">
\r
551 <pre><tt>mirror=...</tt></pre>
\r
553 <p>Specify mirror which should be used for apt-get/aptitude instead
\r
554 of the default one (ftp://ftp.debian.de/debian).
\r
555 Usage example: mirror=ftp://ftp.tugraz.at/mirror/debian</p>
\r
556 <div class="literalblock">
\r
557 <div class="content">
\r
558 <pre><tt>password=...</tt></pre>
\r
560 <p>Set password of user root without prompting for it but set it to the given
\r
561 argument. Usage example: password=AiTh5ahn</p>
\r
562 <h3>Usage example for automatic installation:</h3>
\r
563 <div class="literalblock">
\r
564 <div class="content">
\r
565 <pre><tt>debian2hd target=/dev/hda1 grub=hd0 groot=hd0,0 mirror=ftp://ftp.tugraz.at/mirror/debian password=foobar</tt></pre>
\r
567 <p>You have to enter this commandline at the bootprompt of grml. Please make sure
\r
568 that /dev/hda1 is the partition where you really want to install your new Debian
\r
570 <div class="admonitionblock">
\r
573 <img src="./images/icons/note.png" alt="Note" />
\r
575 <td class="content">Automatic installation within booting process is done in grml-autoconfig via
\r
576 setting environment variable AUTOINSTALL and creation of
\r
577 /usr/bin/grml-debootstrap_noninteractive with the available and relevant
\r
578 bootoptions for grml-debootstrap.</td>
\r
582 <h2>Supported Releases</h2>
\r
583 <div class="sectionbody">
\r
584 <div class="tableblock">
\r
587 cellspacing="0" cellpadding="4">
\r
588 <caption class="title">Table: Current status</caption>
\r
589 <col width="114" />
\r
590 <col width="205" />
\r
591 <col width="182" />
\r
597 <th align="center">
\r
600 <th align="center">
\r
605 <tbody valign="top">
\r
610 <td align="center">
\r
613 <td align="center">
\r
621 <td align="center">
\r
624 <td align="center">
\r
632 <td align="center">
\r
635 <td align="center">
\r
643 <td align="center">
\r
646 <td align="center">
\r
653 <div class="admonitionblock">
\r
656 <img src="./images/icons/note.png" alt="Note" />
\r
658 <td class="content">
\r
659 <div class="title">Sarge-Release</div>
\r
660 <p>[1] Please notice that Sarge is the current old-stable within Debian.
\r
661 grml-debootstrap can handle the release but you really should not
\r
662 use Sarge anymore unless you really know what you are doing. Choose
\r
669 <div class="sectionbody">
\r
670 <p>Probably. Please send bugreports to Michael Prokop <mika@grml.org>.</p>
\r
673 <div class="sectionbody">
\r
674 <p>debootstrap (8), cdebootstrap (1).</p>
\r
677 <div class="sectionbody">
\r
678 <p>Michael Prokop <mika@grml.org></p>
\r
681 <div id="footer-text">
\r
682 Last updated 25-Oct-2007 04:31:34 CEST
\r