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 8.5.2" />
\r
7 <title>grml-debootstrap(8)</title>
\r
8 <style type="text/css">
\r
10 p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
\r
12 border: 1px solid red;
\r
17 margin: 1em 5% 1em 5%;
\r
22 text-decoration: underline;
\r
42 h1, h2, h3, h4, h5, h6 {
\r
44 font-family: sans-serif;
\r
46 margin-bottom: 0.5em;
\r
51 border-bottom: 2px solid silver;
\r
69 border: 1px solid silver;
\r
74 margin-bottom: 0.5em;
\r
88 font-family: sans-serif;
\r
94 span#revnumber, span#revdate, span#revremark {
\r
95 font-family: sans-serif;
\r
99 font-family: sans-serif;
\r
101 border-top: 2px solid silver;
\r
102 padding-top: 0.5em;
\r
107 padding-bottom: 0.5em;
\r
109 div#footer-badges {
\r
111 padding-bottom: 0.5em;
\r
116 margin-bottom: 1.5em;
\r
118 div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
\r
119 div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
\r
120 div.admonitionblock {
\r
122 margin-bottom: 1.5em;
\r
124 div.admonitionblock {
\r
126 margin-bottom: 2.0em;
\r
131 div.content { /* Block element content. */
\r
135 /* Block element titles. */
\r
136 div.title, caption.title {
\r
138 font-family: sans-serif;
\r
142 margin-bottom: 0.5em;
\r
148 td div.title:first-child {
\r
151 div.content div.title:first-child {
\r
154 div.content + div.title {
\r
158 div.sidebarblock > div.content {
\r
159 background: #ffffee;
\r
160 border: 1px solid silver;
\r
164 div.listingblock > div.content {
\r
165 border: 1px solid silver;
\r
166 background: #f4f4f4;
\r
170 div.quoteblock, div.verseblock {
\r
171 padding-left: 1.0em;
\r
172 margin-left: 1.0em;
\r
174 border-left: 5px solid #dddddd;
\r
178 div.quoteblock > div.attribution {
\r
179 padding-top: 0.5em;
\r
183 div.verseblock > div.content {
\r
186 div.verseblock > div.attribution {
\r
187 padding-top: 0.75em;
\r
190 /* DEPRECATED: Pre version 8.2.7 verse style literal block. */
\r
191 div.verseblock + div.attribution {
\r
195 div.admonitionblock .icon {
\r
196 vertical-align: top;
\r
199 text-decoration: underline;
\r
201 padding-right: 0.5em;
\r
203 div.admonitionblock td.content {
\r
204 padding-left: 0.5em;
\r
205 border-left: 3px solid #dddddd;
\r
208 div.exampleblock > div.content {
\r
209 border-left: 3px solid #dddddd;
\r
210 padding-left: 0.5em;
\r
213 div.imageblock div.content { padding-left: 0; }
\r
214 span.image img { border-style: none; }
\r
215 a.image:visited { color: white; }
\r
219 margin-bottom: 0.8em;
\r
224 font-style: normal;
\r
227 dd > *:first-child {
\r
232 list-style-position: outside;
\r
235 list-style-type: decimal;
\r
238 list-style-type: lower-alpha;
\r
241 list-style-type: upper-alpha;
\r
244 list-style-type: lower-roman;
\r
247 list-style-type: upper-roman;
\r
250 div.compact ul, div.compact ol,
\r
251 div.compact p, div.compact p,
\r
252 div.compact div, div.compact div {
\r
254 margin-bottom: 0.1em;
\r
257 div.tableblock > table {
\r
258 border: 3px solid #527bbd;
\r
260 thead, p.table.header {
\r
261 font-family: sans-serif;
\r
273 /* Because the table frame attribute is overriden by CSS in most browsers. */
\r
274 div.tableblock > table[frame="void"] {
\r
275 border-style: none;
\r
277 div.tableblock > table[frame="hsides"] {
\r
278 border-left-style: none;
\r
279 border-right-style: none;
\r
281 div.tableblock > table[frame="vsides"] {
\r
282 border-top-style: none;
\r
283 border-bottom-style: none;
\r
289 margin-bottom: 0.8em;
\r
292 padding-bottom: 15px;
\r
294 dt.hdlist1.strong, td.hdlist1.strong {
\r
298 vertical-align: top;
\r
299 font-style: normal;
\r
300 padding-right: 0.8em;
\r
304 vertical-align: top;
\r
306 div.hdlist.compact tr {
\r
312 background: yellow;
\r
315 .footnote, .footnoteref {
\r
319 span.footnote, span.footnoteref {
\r
320 vertical-align: super;
\r
324 margin: 20px 0 20px 0;
\r
325 padding: 7px 0 0 0;
\r
328 #footnotes div.footnote {
\r
334 border-top: 1px solid silver;
\r
344 div#footer-badges { display: none; }
\r
348 margin-bottom: 2.5em;
\r
353 font-family: sans-serif;
\r
357 margin-bottom: 0.1em;
\r
360 div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
\r
376 /* Workarounds for IE6's broken and incomplete CSS2. */
\r
378 div.sidebar-content {
\r
379 background: #ffffee;
\r
380 border: 1px solid silver;
\r
383 div.sidebar-title, div.image-title {
\r
385 font-family: sans-serif;
\r
388 margin-bottom: 0.5em;
\r
391 div.listingblock div.content {
\r
392 border: 1px solid silver;
\r
393 background: #f4f4f4;
\r
397 div.quoteblock-attribution {
\r
398 padding-top: 0.5em;
\r
402 div.verseblock-content {
\r
405 div.verseblock-attribution {
\r
406 padding-top: 0.75em;
\r
410 div.exampleblock-content {
\r
411 border-left: 3px solid #dddddd;
\r
412 padding-left: 0.5em;
\r
415 /* IE6 sets dynamically generated links as visited. */
\r
416 div#toc a:visited { color: blue; }
\r
418 <script type="text/javascript">
\r
420 window.onload = function(){asciidoc.footnotes();}
\r
421 var asciidoc = { // Namespace.
\r
423 /////////////////////////////////////////////////////////////////////
\r
424 // Table Of Contents generator
\r
425 /////////////////////////////////////////////////////////////////////
\r
427 /* Author: Mihai Bazon, September 2002
\r
428 * http://students.infoiasi.ro/~mishoo
\r
430 * Table Of Content generator
\r
433 * Feel free to use this script under the terms of the GNU General Public
\r
434 * License, as long as you do not remove or alter this notice.
\r
437 /* modified by Troy D. Hanson, September 2006. License: GPL */
\r
438 /* modified by Stuart Rackham, 2006, 2009. License: GPL */
\r
440 // toclevels = 1..4.
\r
441 toc: function (toclevels) {
\r
443 function getText(el) {
\r
445 for (var i = el.firstChild; i != null; i = i.nextSibling) {
\r
446 if (i.nodeType == 3 /* Node.TEXT_NODE */) // IE doesn't speak constants.
\r
448 else if (i.firstChild != null)
\r
449 text += getText(i);
\r
454 function TocEntry(el, text, toclevel) {
\r
457 this.toclevel = toclevel;
\r
460 function tocEntries(el, toclevels) {
\r
461 var result = new Array;
\r
462 var re = new RegExp('[hH]([2-'+(toclevels+1)+'])');
\r
463 // Function that scans the DOM tree for header elements (the DOM2
\r
464 // nodeIterator API would be a better technique but not supported by all
\r
466 var iterate = function (el) {
\r
467 for (var i = el.firstChild; i != null; i = i.nextSibling) {
\r
468 if (i.nodeType == 1 /* Node.ELEMENT_NODE */) {
\r
469 var mo = re.exec(i.tagName);
\r
470 if (mo && (i.getAttribute("class") || i.getAttribute("className")) != "float") {
\r
471 result[result.length] = new TocEntry(i, getText(i), mo[1]-1);
\r
481 var toc = document.getElementById("toc");
\r
482 var entries = tocEntries(document.getElementById("content"), toclevels);
\r
483 for (var i = 0; i < entries.length; ++i) {
\r
484 var entry = entries[i];
\r
485 if (entry.element.id == "")
\r
486 entry.element.id = "_toc_" + i;
\r
487 var a = document.createElement("a");
\r
488 a.href = "#" + entry.element.id;
\r
489 a.appendChild(document.createTextNode(entry.text));
\r
490 var div = document.createElement("div");
\r
491 div.appendChild(a);
\r
492 div.className = "toclevel" + entry.toclevel;
\r
493 toc.appendChild(div);
\r
495 if (entries.length == 0)
\r
496 toc.parentNode.removeChild(toc);
\r
500 /////////////////////////////////////////////////////////////////////
\r
501 // Footnotes generator
\r
502 /////////////////////////////////////////////////////////////////////
\r
504 /* Based on footnote generation code from:
\r
505 * http://www.brandspankingnew.net/archive/2005/07/format_footnote.html
\r
508 footnotes: function () {
\r
509 var cont = document.getElementById("content");
\r
510 var noteholder = document.getElementById("footnotes");
\r
511 var spans = cont.getElementsByTagName("span");
\r
514 for (i=0; i<spans.length; i++) {
\r
515 if (spans[i].className == "footnote") {
\r
517 // Use [\s\S] in place of . so multi-line matches work.
\r
518 // Because JavaScript has no s (dotall) regex flag.
\r
519 note = spans[i].innerHTML.match(/\s*\[([\s\S]*)]\s*/)[1];
\r
520 noteholder.innerHTML +=
\r
521 "<div class='footnote' id='_footnote_" + n + "'>" +
\r
522 "<a href='#_footnoteref_" + n + "' title='Return to text'>" +
\r
523 n + "</a>. " + note + "</div>";
\r
524 spans[i].innerHTML =
\r
525 "[<a id='_footnoteref_" + n + "' href='#_footnote_" + n +
\r
526 "' title='View footnote' class='footnote'>" + n + "</a>]";
\r
527 var id =spans[i].getAttribute("id");
\r
528 if (id != null) refs["#"+id] = n;
\r
532 noteholder.parentNode.removeChild(noteholder);
\r
534 // Process footnoterefs.
\r
535 for (i=0; i<spans.length; i++) {
\r
536 if (spans[i].className == "footnoteref") {
\r
537 var href = spans[i].getElementsByTagName("a")[0].getAttribute("href");
\r
538 href = href.match(/#.*/)[0]; // Because IE return full URL.
\r
540 spans[i].innerHTML =
\r
541 "[<a href='#_footnote_" + n +
\r
542 "' title='View footnote' class='footnote'>" + n + "</a>]";
\r
554 <h1>grml-debootstrap(8)</h1>
\r
557 <h2 id="_name">Name</h2>
\r
558 <div class="sectionbody">
\r
559 <div class="paragraph"><p>grml-debootstrap - wrapper around debootstrap for installing plain Debian via grml</p></div>
\r
561 <h2 id="_synopsis">Synopsis</h2>
\r
562 <div class="sectionbody">
\r
563 <div class="paragraph"><p>grml-debootstrap [ <em>options</em> ]</p></div>
\r
564 <div class="paragraph"><p><span class="image">
\r
565 <img src="images/screenshot.png" alt="Screenshot" />
\r
568 <h2 id="_introduction">Introduction</h2>
\r
569 <div class="sectionbody">
\r
570 <div class="paragraph"><p>grml-debootstrap is a wrapper suite around debootstrap (and cdebootstrap if you
\r
571 want) for installing a plain Debian system via grml very fast and easy.</p></div>
\r
572 <div class="paragraph"><p>All you have to do is adjust a few variables in configuration file
\r
573 /etc/debootstrap/config (or specify some variables via commandline) and invoke
\r
574 grml-debootstrap without any further options then.</p></div>
\r
575 <div class="paragraph"><p>A plain and base Debian system will be installed on the given device (or
\r
576 directory) then. Customization of this process is possible as well.</p></div>
\r
577 <div class="admonitionblock">
\r
580 <img src="./images/icons/caution.png" alt="Caution" />
\r
582 <td class="content">The grml team does not take responsibility for loss of any data!</td>
\r
586 <h2 id="_options_and_environment_variables">Options and environment variables</h2>
\r
587 <div class="sectionbody">
\r
588 <div class="dlist"><dl>
\r
589 <dt class="hdlist1">
\r
590 <strong>--arch</strong> <_architecture_>
\r
594 Architecture you want to bootstrap. Currently only i386 is supported.
\r
595 Defaults to the architecture that is currently running on your system. If
\r
596 you’re running an amd64 system and want to deploy a i386 system use this option.
\r
597 Note: deploying amd64 from a i386 system won’t work.
\r
600 <dt class="hdlist1">
\r
601 <strong>--bootappend</strong> <_appendline for the kernel_>
\r
605 Specify appendline for the kernel.
\r
606 E.g. "<em>pci=nomsi</em>"
\r
609 <dt class="hdlist1">
\r
610 <strong>-c</strong>, <strong>--config</strong> <_file_>
\r
614 Use specified configuration file, defaults to /etc/debootstrap/config.
\r
617 <dt class="hdlist1">
\r
618 <strong>--chroot-scripts</strong> <_directory_>
\r
622 Execute chroot scripts from specified directory. This allows customisation
\r
623 of the chroot setup, the executable script(s) present in the given directory
\r
624 are executed at the end of the chroot procedure.
\r
625 Default directory: /etc/debootstrap/chroot-scripts/
\r
628 <dt class="hdlist1">
\r
629 <strong>-d</strong>, <strong>--confdir</strong> <_path_>
\r
633 Place of configuration files for debootstrap, defaults to /etc/debootstrap.
\r
636 <dt class="hdlist1">
\r
637 <strong>--debconf</strong> <_file_>
\r
641 Use specified file for preseeding Debian packages instead of using
\r
642 the default <confdir>/debconf-selections.
\r
645 <dt class="hdlist1">
\r
646 <strong>--debopt</strong> <_params_>
\r
650 Extra parameters passed to the debootstrap command.
\r
653 <dt class="hdlist1">
\r
654 <strong>--grub</strong> <_device_>
\r
658 Device where grub should be installed to. Note that only the MBR (master
\r
659 boot record) can be used (/dev/sda, /dev/sdb,…). Partitions (like
\r
660 /dev/sda1, /dev/sdb2,…) are NOT supported because grub2 doesn’t support
\r
661 installation into the PBR (partition boot record) anymore. Usage example:
\r
662 <em>--grub /dev/sda</em>. Note: just do not set this option to avoid installation
\r
666 <dt class="hdlist1">
\r
667 <strong>--help</strong>, <strong>-h</strong>
\r
671 Show summary of options and exit.
\r
674 <dt class="hdlist1">
\r
675 <strong>--hostname</strong> <_hostname_>
\r
679 Use specified hostname instead of the default (being <em>grml</em>).
\r
682 <dt class="hdlist1">
\r
683 <strong>-i</strong>, <strong>--iso</strong> <_/mntpoint_>
\r
687 Specify mountpoint where you have a Debian ISO mounted loopback.
\r
688 Using this option instead of the mirror option gives you the possibility
\r
689 to install the base-system without network access. Make sure you
\r
690 mounted the according Debian-ISO to the given <_/mntpoint_>. See section
\r
691 <em>Usage examples</em> for a demonstration.
\r
694 <dt class="hdlist1">
\r
695 <strong>--keep_src_list</strong>
\r
699 Do not overwrite user provided /etc/apt/sources.list.
\r
702 <dt class="hdlist1">
\r
703 <strong>-m</strong>, <strong>--mirror</strong> <_URL_>
\r
707 Specify mirror which should be used for apt-get/aptitude.
\r
708 Corresponding with configuration variable MIRROR.
\r
711 <dt class="hdlist1">
\r
712 <strong>--nodebootstrap</strong>
\r
716 Skip debootstrap, only do configuration to the target.
\r
719 <dt class="hdlist1">
\r
720 <strong>--nopackages</strong>
\r
724 Skip installation of packages defined in /etc/debootstrap/packages.
\r
727 <dt class="hdlist1">
\r
728 <strong>--insecure</strong>
\r
732 Do not download and check signatures for retrieved Release files.
\r
735 <dt class="hdlist1">
\r
736 <strong>-p</strong>, <strong>--mntpoint</strong> <_/mntpoint_>
\r
740 Specify mountpoint that should be used for mounting the target system.
\r
741 Corresponding with configuration variable MNTPOINT.
\r
742 Note: this option has no effect if option -t is given and represents a
\r
746 <dt class="hdlist1">
\r
747 <strong>--packages</strong> <_file_>
\r
751 Use specified file as list for packages that should be installed instead of
\r
752 the default package list file <confdir>/packages.
\r
755 <dt class="hdlist1">
\r
756 <strong>--password</strong> <_password_>
\r
760 Use specified password as password for user root. Use with caution, as your
\r
761 commandline might be visible in the process list and the shell history.
\r
762 It’s meant for automatic installation only.
\r
765 <dt class="hdlist1">
\r
766 <strong>-r</strong>, <strong>--release</strong> <_releasename_>
\r
770 Specify release of new Debian system. Supported releases names: lenny,
\r
771 squeeze (note: requires current version of debootstrap) and sid.
\r
772 Corresponding with configuration variable RELEASE.
\r
775 <dt class="hdlist1">
\r
776 <strong>--pre-scripts</strong> <_directory_>
\r
780 Execute scripts from specified directory before executing the chroot
\r
781 script. This allows customisation of the system before the chroot has
\r
782 been set up. The environment variable $MNTPOINT is available inside the
\r
783 scripts for direct access of the chroot.
\r
784 Default directory: /etc/debootstrap/pre-scripts/
\r
787 <dt class="hdlist1">
\r
788 <strong>--scripts</strong> <_directory_>
\r
792 Execute scripts from specified directory. This allows customisation of
\r
793 the system after the chroot has been set up. The environment variable
\r
794 $MNTPOINT is available inside the scripts for direct access of the chroot.
\r
795 Default directory: /etc/debootstrap/scripts/
\r
798 <dt class="hdlist1">
\r
799 <strong>-t</strong>, <strong>--target</strong> <_target_>
\r
803 Target partition (/dev/…) or directory (anything else without /dev at the
\r
804 beginning). To install grub using <strong>--grub</strong> make sure to use a <em>device</em>
\r
805 instead of a directory as <em>target</em> (installation of grub as bootloader when
\r
806 using directories is NOT supported).
\r
809 <dt class="hdlist1">
\r
810 <strong>-v</strong>, <strong>--verbose</strong>
\r
814 Increase verbosity.
\r
817 <dt class="hdlist1">
\r
818 <strong>-V</strong>, <strong>--version</strong>
\r
822 Show version of program and exit.
\r
826 <div class="admonitionblock">
\r
829 <img src="./images/icons/warning.png" alt="Warning" />
\r
831 <td class="content">the commandline parsing of grml-debootstrap does not validate the provided
\r
832 arguments for the commandline options. Please be careful and check docs and
\r
833 /etc/debootstrap/config for further information.</td>
\r
837 <h2 id="_usage_examples">Usage examples</h2>
\r
838 <div class="sectionbody">
\r
839 <div class="literalblock">
\r
840 <div class="content">
\r
841 <pre><tt>grml-debootstrap --target /dev/sda1 --grub /dev/sda</tt></pre>
\r
843 <div class="paragraph"><p>Install default Debian release (stable/lenny) on /dev/sda1 and install bootmanager
\r
844 Grub in MBR (master boot record) of /dev/sda and use /dev/sda1 as system partition.</p></div>
\r
845 <div class="literalblock">
\r
846 <div class="content">
\r
847 <pre><tt>grml-debootstrap --target /dev/sda6 --grub /dev/sda --release sid</tt></pre>
\r
849 <div class="paragraph"><p>Install Debian unstable/sid on /dev/sda6, install bootmanager Grub in MBR
\r
850 (master boot record) of /dev/sda and use /dev/sda6 as system partition.</p></div>
\r
851 <div class="literalblock">
\r
852 <div class="content">
\r
853 <pre><tt>mount /dev/sda1 /data/chroot
\r
854 grml-debootstrap --target /data/chroot</tt></pre>
\r
856 <div class="paragraph"><p>Install default Debian release (stable/lenny) in directory /data/chroot (without
\r
857 any bootloader).</p></div>
\r
858 <div class="literalblock">
\r
859 <div class="content">
\r
860 <pre><tt>grml-debootstrap --target /dev/sda3 --grub /dev/sda --mirror ftp://ftp.tugraz.at/mirror/debian</tt></pre>
\r
862 <div class="paragraph"><p>Install default Debian release (stable/lenny) on /dev/sda3 and install bootmanager
\r
863 Grub in MBR (master boot record) of /dev/sda and use /dev/sda3 as system partition.
\r
864 Use specified mirror instead of the default (<a href="ftp://ftp.debian.de/debian">ftp://ftp.debian.de/debian</a>) one.</p></div>
\r
865 <div class="literalblock">
\r
866 <div class="content">
\r
867 <pre><tt>mount -o loop /mnt/sda6/debian-40r0-i386-CD-1.iso /mnt/iso
\r
868 grml-debootstrap --target /dev/sda1 --grub /dev/sda --iso file:/mnt/iso/debian/</tt></pre>
\r
870 <div class="paragraph"><p>Install Debian stable/lenny on /dev/sda1 using the loopback mounted Debian-ISO
\r
871 for the base-system and install bootmanager Grub in MBR (master boot record) of
\r
872 /dev/sda and use /dev/sda1 as system partition. Please notice, that the chroot
\r
873 system requires network access for all packages which are not part of the
\r
876 <h2 id="_files">Files</h2>
\r
877 <div class="sectionbody">
\r
878 <div class="literalblock">
\r
879 <div class="content">
\r
880 <pre><tt>/etc/debootstrap/config</tt></pre>
\r
882 <div class="paragraph"><p>Main configuration file. You have to adjust it according to your needs
\r
883 if you want to execute grml-debootstrap in the non-interactive mode without
\r
884 any special command line arguments.</p></div>
\r
885 <div class="literalblock">
\r
886 <div class="content">
\r
887 <pre><tt>/etc/debootstrap/chroot-script</tt></pre>
\r
889 <div class="paragraph"><p>The script executed within the new Debian system as soon as the main system
\r
890 has been installed via [c]debootstrap.</p></div>
\r
891 <div class="literalblock">
\r
892 <div class="content">
\r
893 <pre><tt>/etc/debootstrap/locale.gen</tt></pre>
\r
895 <div class="paragraph"><p>Defines the default locales used for generating locales via locale-gen.</p></div>
\r
896 <div class="literalblock">
\r
897 <div class="content">
\r
898 <pre><tt>/etc/debootstrap/packages</tt></pre>
\r
900 <div class="paragraph"><p>Defines the software packages which should be installed in the new
\r
901 Debian system by default.</p></div>
\r
902 <div class="literalblock">
\r
903 <div class="content">
\r
904 <pre><tt>/etc/debootstrap/extrapackages</tt></pre>
\r
906 <div class="paragraph"><p>Debian Packages dropped here will be installed into the new Debian system by
\r
907 default (Controlvariable: EXTRAPACKAGES)</p></div>
\r
908 <div class="literalblock">
\r
909 <div class="content">
\r
910 <pre><tt>/etc/debootstrap/stages/</tt></pre>
\r
912 <div class="paragraph"><p>The default directory for storing information about executed stages. Every
\r
913 single function of grml-debootstrap will write <em>done</em> to the stages directory
\r
914 into a file named as the function itself if it has been executed successfully.
\r
915 You can adjust the location of the directory via configuration variable STAGES
\r
916 via /etc/debootstrap/config. Please notice that you have to remove the stages
\r
917 directory on your own if you want to re-execute grml-debootstrap after running it
\r
918 successfully once. This should avoid recurrent execution by error of
\r
919 grml-debootstrap (which might delete present data).</p></div>
\r
921 <h2 id="_customization">Customization</h2>
\r
922 <div class="sectionbody">
\r
923 <div class="paragraph"><p>You can control execution of grml-debootstrap via adjusting
\r
924 /etc/debootstrap/config for some main stuff or via setting some selected
\r
925 variables via commandline. The packages which should be installed in the new
\r
926 Debian system can be defined via the file /etc/debootstrap/packages. If you
\r
927 want to put existing files to the new Debian system you can place them into the
\r
928 (by default non-existing) directories boot, etc, share, usr and var in
\r
929 /etc/debootstrap/. Every existing directory will be copied to the new Debian
\r
930 system then. If you want to install additional packages that are not available
\r
931 via the grml or debian mirror drop them into /etc/debootstrap/extrapackages and
\r
932 make sure that EXTRAPACKAGES is set to "yes".</p></div>
\r
934 <h2 id="_automatic_installation">Automatic installation</h2>
\r
935 <div class="sectionbody">
\r
936 <div class="paragraph"><p>If environment variable AUTOINSTALL is set grml-debootstrap can be executed in a
\r
937 full automatic mode. While this mode isn’t really useful for interactive
\r
938 execution (just configure /etc/debootstrap/configure or specify the relevant
\r
939 variables on the commandline instead) it is meant for use via bootoption
\r
940 debian2hd. The bootoption debian2hd (more precise: the kernelname on bootprompt)
\r
941 supports the following bootoptions (they correspond with the commandline options
\r
942 mentioned above):</p></div>
\r
943 <div class="literalblock">
\r
944 <div class="content">
\r
945 <pre><tt>target=...</tt></pre>
\r
947 <div class="paragraph"><p>The target partition/directory of the new Debian system. Usage example:
\r
948 target=/dev/sda1</p></div>
\r
949 <div class="literalblock">
\r
950 <div class="content">
\r
951 <pre><tt>grub=...</tt></pre>
\r
953 <div class="paragraph"><p>Where do you want to install grub to? Usage example: grub=/dev/sda</p></div>
\r
954 <div class="literalblock">
\r
955 <div class="content">
\r
956 <pre><tt>release=...</tt></pre>
\r
958 <div class="paragraph"><p>Specify release of new Debian system. Defaults to Debian stable. Supported
\r
959 relases: lenny, squeeze and sid. Usage example: release=sid</p></div>
\r
960 <div class="literalblock">
\r
961 <div class="content">
\r
962 <pre><tt>mirror=...</tt></pre>
\r
964 <div class="paragraph"><p>Specify mirror which should be used for apt-get/aptitude instead
\r
965 of the default one (<a href="ftp://ftp.debian.de/debian">ftp://ftp.debian.de/debian</a>).
\r
966 Usage example: mirror=ftp://ftp.tugraz.at/mirror/debian</p></div>
\r
967 <div class="literalblock">
\r
968 <div class="content">
\r
969 <pre><tt>password=...</tt></pre>
\r
971 <div class="paragraph"><p>Set password of user root without prompting for it but set it to the given
\r
972 argument. Usage example: password=AiTh5ahn</p></div>
\r
973 <h3 id="_usage_example_for_automatic_installation">Usage example for automatic installation:</h3><div style="clear:left"></div>
\r
974 <div class="literalblock">
\r
975 <div class="content">
\r
976 <pre><tt>debian2hd target=/dev/sda1 grub=/dev/sda mirror=ftp://ftp.tugraz.at/mirror/debian password=foobar</tt></pre>
\r
978 <div class="paragraph"><p>You have to enter this commandline at the bootprompt of grml. Please make sure
\r
979 that /dev/sda1 is the partition where you really want to install your new Debian
\r
981 <div class="admonitionblock">
\r
984 <img src="./images/icons/note.png" alt="Note" />
\r
986 <td class="content">Automatic installation within booting process is done in grml-autoconfig via
\r
987 setting environment variable AUTOINSTALL and creation of
\r
988 /usr/bin/grml-debootstrap_noninteractive with the available and relevant
\r
989 bootoptions for grml-debootstrap.</td>
\r
993 <h2 id="_supported_releases">Supported Releases</h2>
\r
994 <div class="sectionbody">
\r
995 <div class="tableblock">
\r
998 cellspacing="0" cellpadding="4">
\r
999 <caption class="title">TableCurrent status</caption>
\r
1000 <col width="114" />
\r
1001 <col width="205" />
\r
1002 <col width="182" />
\r
1005 <th align="right">
\r
1008 <th align="center">
\r
1011 <th align="center">
\r
1016 <tbody valign="top">
\r
1018 <td align="right">
\r
1021 <td align="center">
\r
1024 <td align="center">
\r
1029 <td align="right">
\r
1032 <td align="center">
\r
1035 <td align="center">
\r
1040 <td align="right">
\r
1043 <td align="center">
\r
1046 <td align="center">
\r
1053 <div class="admonitionblock">
\r
1056 <img src="./images/icons/note.png" alt="Note" />
\r
1058 <td class="content">
\r
1059 <div class="title">Etch-Release</div>
\r
1060 <div class="paragraph"><p>[1] Please notice that Etch is the current old-stable within Debian.
\r
1061 grml-debootstrap can handle the release but you really should not use Etch
\r
1062 anymore unless you really know what you are doing. Choose Lenny instead.</p></div>
\r
1067 <h2 id="_bugs">Bugs</h2>
\r
1068 <div class="sectionbody">
\r
1069 <div class="paragraph"><p>Probably. Please send bugreports to Michael Prokop <<a href="mailto:mika@grml.org">mika@grml.org</a>>.</p></div>
\r
1071 <h2 id="_see_also">See also</h2>
\r
1072 <div class="sectionbody">
\r
1073 <div class="paragraph"><p>debootstrap (8), cdebootstrap (1).</p></div>
\r
1075 <h2 id="_author">Author</h2>
\r
1076 <div class="sectionbody">
\r
1077 <div class="paragraph"><p>Michael Prokop <<a href="mailto:mika@grml.org">mika@grml.org</a>></p></div>
\r
1080 <div id="footnotes"><hr /></div>
\r
1082 <div id="footer-text">
\r
1083 Last updated 2010-02-23 00:21:26 CEST
\r