+<?xml version="1.0" encoding="UTF-8"?>\r
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"\r
"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">\r
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">\r
<head>\r
<meta http-equiv="Content-Type" content="application/xhtml+xml; charset=UTF-8" />\r
-<meta name="generator" content="AsciiDoc 8.6.7" />\r
+<meta name="generator" content="AsciiDoc 9.0.0rc2" />\r
<title>grml-debootstrap(8)</title>\r
<style type="text/css">\r
/* Shared CSS for AsciiDoc xhtml11 and html5 backends */\r
ul > li { color: #aaa; }\r
ul > li > * { color: black; }\r
\r
-pre {\r
+.monospaced, code, pre {\r
+ font-family: "Courier New", Courier, monospace;\r
+ font-size: inherit;\r
+ color: navy;\r
padding: 0;\r
margin: 0;\r
}\r
+pre {\r
+ white-space: pre-wrap;\r
+}\r
\r
#author {\r
color: #527bbd;\r
}\r
\r
div.imageblock div.content { padding-left: 0; }\r
-span.image img { border-style: none; }\r
+span.image img { border-style: none; vertical-align: text-bottom; }\r
a.image:visited { color: white; }\r
\r
dl {\r
*\r
* */\r
\r
-tt {\r
- font-family: "Courier New", Courier, monospace;\r
- font-size: inherit;\r
- color: navy;\r
-}\r
-\r
div.tableblock {\r
margin-top: 1.0em;\r
margin-bottom: 1.5em;\r
p.table {\r
margin-top: 0;\r
}\r
-/* Because the table frame attribute is overriden by CSS in most browsers. */\r
+/* Because the table frame attribute is overridden by CSS in most browsers. */\r
div.tableblock > table[frame="void"] {\r
border-style: none;\r
}\r
*\r
* */\r
\r
-.monospaced {\r
- font-family: "Courier New", Courier, monospace;\r
- font-size: inherit;\r
- color: navy;\r
-}\r
-\r
table.tableblock {\r
margin-top: 1.0em;\r
margin-bottom: 1.5em;\r
@media print {\r
body.manpage div#toc { display: none; }\r
}\r
+\r
+\r
</style>\r
<script type="text/javascript">\r
/*<![CDATA[*/\r
<div class="sect1">\r
<h2 id="_introduction">Introduction</h2>\r
<div class="sectionbody">\r
-<div class="paragraph"><p>grml-debootstrap is a wrapper suite around debootstrap (and cdebootstrap if you\r
-want) for installing a plain Debian system (e.g. via Grml) very fast and easy.</p></div>\r
+<div class="paragraph"><p>grml-debootstrap is a wrapper suite around debootstrap (and cdebootstrap and mmdebstrap if you\r
+want) for installing a plain Debian system very fast and easy.</p></div>\r
<div class="paragraph"><p>All you have to do is adjust a few variables in the configuration file\r
/etc/debootstrap/config or specify some command line options and invoke\r
grml-debootstrap. If invoked without any configuration modifications or command\r
-line options a dialog based frontend will be available to control some basic\r
+line options a dialog based front end will be available to control some basic\r
configuration options.</p></div>\r
<div class="paragraph"><p>A plain and base Debian system will be installed on the given device, directory\r
or virtual image file then. Customization of this process is possible as well.</p></div>\r
</p>\r
</dd>\r
<dt class="hdlist1">\r
+<strong>--backportrepos</strong>\r
+</dt>\r
+<dd>\r
+<p>\r
+ Enable Debian’s Backports repository via the\r
+ /etc/apt/sources.list.d/backports.list configuration file. This provides the\r
+ option to install Debian packages from Debian’s backports repository.\r
+</p>\r
+</dd>\r
+<dt class="hdlist1">\r
<strong>--bootappend</strong> <em>appendline-for-the-kernel</em>\r
</dt>\r
<dd>\r
</p>\r
</dd>\r
<dt class="hdlist1">\r
+<strong>--contrib</strong>\r
+</dt>\r
+<dd>\r
+<p>\r
+ Enable the <em>contrib</em> repository in COMPONENTS. By default only\r
+ the <em>main</em> repository is enabled.\r
+</p>\r
+</dd>\r
+<dt class="hdlist1">\r
<strong>-d</strong>, <strong>--confdir</strong> <em>path</em>\r
</dt>\r
<dd>\r
</p>\r
</dd>\r
<dt class="hdlist1">\r
+<strong>--debug</strong>\r
+</dt>\r
+<dd>\r
+<p>\r
+ Execute in very verbose way. Useful for debugging possible problems\r
+ with grml-debootstrap or identify what’s actually executed.\r
+</p>\r
+</dd>\r
+<dt class="hdlist1">\r
+<strong>--defaultinterfaces</strong>\r
+</dt>\r
+<dd>\r
+<p>\r
+ Install a default /etc/network/interfaces file (enabling DHCP for all local\r
+ Ethernet, WLAN and WWAN interfaces using predictable network interface names\r
+ and using eth0 as traditional interface name for backward compatibility)\r
+ instead of taking over config from host system.\r
+ This option is automatically enabled when using --vm or --vmfile.\r
+</p>\r
+</dd>\r
+<dt class="hdlist1">\r
+<strong>--efi</strong> <em>device</em>\r
+</dt>\r
+<dd>\r
+<p>\r
+ Partition where EFI boot manager should be installed to. If the\r
+ specified device doesn’t use a FAT filesystem yet grml-debootstrap\r
+ automatically creates the filesystem. If a FAT filesystem is already\r
+ present the filesystem creation is skipped. Please ensure that it’s\r
+ a valid FAT32 filesystem and the partition has the <em>boot</em> and <em>esp</em>\r
+ flags enabled. This option requires EFI support on the running system\r
+ and the option is NOT supported for Virtual Machine deployments.\r
+</p>\r
+</dd>\r
+<dt class="hdlist1">\r
<strong>--filesystem</strong> <em>filesystem</em>\r
</dt>\r
<dd>\r
<p>\r
Filesystem that should be created when installing to a partition.\r
- If unset defaults to ext3. Valid values are all filesystems that\r
+ If unset defaults to ext4. Valid values are all filesystems that\r
can be created through mkfs.<em>filesystem</em>.\r
</p>\r
</dd>\r
</dt>\r
<dd>\r
<p>\r
- Use specified hostname instead of the default (being <em>grml</em>).\r
+ Use specified hostname instead of the default (being $HOSTNAME or if unset <em>grml</em>).\r
</p>\r
</dd>\r
<dt class="hdlist1">\r
</p>\r
</dd>\r
<dt class="hdlist1">\r
+<strong>--nointerfaces</strong>\r
+</dt>\r
+<dd>\r
+<p>\r
+ Do not copy /etc/network/interfaces from host system to the target.\r
+</p>\r
+</dd>\r
+<dt class="hdlist1">\r
+<strong>--nokernel</strong>\r
+</dt>\r
+<dd>\r
+<p>\r
+ Skip installation of default kernel images. This option might be\r
+ interesting for you if you want a Debian system which doesn’t\r
+ need to provide regular boot, e.g. a system which provides\r
+ ISOs for booting via GRUB using grml-rescueboot.\r
+</p>\r
+</dd>\r
+<dt class="hdlist1">\r
+<strong>--non-free</strong>\r
+</dt>\r
+<dd>\r
+<p>\r
+ Enable the <em>non-free</em> repository in COMPONENTS. By default only\r
+ the <em>main</em> repository is enabled.\r
+</p>\r
+</dd>\r
+<dt class="hdlist1">\r
<strong>--nopackages</strong>\r
</dt>\r
<dd>\r
</p>\r
</dd>\r
<dt class="hdlist1">\r
-<strong>-r</strong>, <strong>--release</strong> <em>releasename</em>\r
+<strong>--post-scripts</strong> <em>directory</em>\r
</dt>\r
<dd>\r
<p>\r
- Specify release of new Debian system. Supported releases names: lenny,\r
- squeeze, wheezy (note: requires current version of debootstrap) and sid.\r
- Corresponding with configuration variable RELEASE.\r
+ Execute scripts from specified directory after executing the chroot script.\r
+ This allows customisation of the system after the chroot has been set up.\r
+ The environment variable $MNTPOINT is available inside the scripts for\r
+ direct access of the chroot.\r
+ Default directory: /etc/debootstrap/post-scripts/\r
</p>\r
</dd>\r
<dt class="hdlist1">\r
</p>\r
</dd>\r
<dt class="hdlist1">\r
-<strong>--scripts</strong> <em>directory</em>\r
+<strong>-r</strong>, <strong>--release</strong> <em>releasename</em>\r
+</dt>\r
+<dd>\r
+<p>\r
+ Specify release of new Debian system. Supported releases names: lenny,\r
+ squeeze, wheezy, jessie, stretch, buster, bullseye and sid. Corresponding with configuration\r
+ variable RELEASE. Default release: buster\r
+</p>\r
+</dd>\r
+<dt class="hdlist1">\r
+<strong>--remove-configs</strong>\r
</dt>\r
<dd>\r
<p>\r
- Execute scripts from specified directory. This allows customisation of\r
- the system after the chroot has been set up. The environment variable\r
- $MNTPOINT is available inside the scripts for direct access of the chroot.\r
- Default directory: /etc/debootstrap/scripts/\r
+ Delete grml-debootstrap configuration files (/etc/debootstrap/*) from installed\r
+ system. Useful for reproducible builds or if you don’t want to leak information.\r
+</p>\r
+</dd>\r
+<dt class="hdlist1">\r
+<strong>--sshcopyauth</strong>\r
+</dt>\r
+<dd>\r
+<p>\r
+ Use locally available <em>$HOME/.ssh/authorized_keys</em> to authorise root login on the target system.\r
+ This installs <em>$HOME/.ssh/authorized_keys</em> as <em>/root/.ssh/authorized_keys</em> on\r
+ the target system. If a different file than <em>$HOME/.ssh/authorized_keys</em> should\r
+ be used, the environment variable <em>AUTHORIZED_KEYS_SOURCE</em> can be used.\r
+</p>\r
+</dd>\r
+<dt class="hdlist1">\r
+<strong>--sshcopyid</strong>\r
+</dt>\r
+<dd>\r
+<p>\r
+ Use locally available public keys to authorise root login on the target system.\r
+ Similar to ssh-copy-id(1) (without the -i option) it checks if <code>ssh-add -L</code>\r
+ provides any output, and if so those keys are appended to\r
+ <em>/root/.ssh/authorized_keys</em> (creating the file and directory (with mode 0700)).\r
</p>\r
</dd>\r
<dt class="hdlist1">\r
<dd>\r
<p>\r
Target partition (/dev/…) or directory (anything else without /dev at the\r
- beginning). To install grub using <strong>--grub</strong> make sure to use a <em>device</em>\r
- instead of a directory as <em>target</em> (installation of grub as bootloader when\r
- using directories is NOT supported).\r
+ beginning).\r
</p>\r
</dd>\r
<dt class="hdlist1">\r
</p>\r
</dd>\r
<dt class="hdlist1">\r
-<strong>--vmfile</strong>\r
+<strong>--vm</strong>\r
</dt>\r
<dd>\r
<p>\r
- Set up a Virtual Machine instead of installing to a partition or directory.\r
+ Set up a Virtual Machine on an existing block device, which will be\r
+ partitioned.\r
This allows deployment of a Virtual Machine. The options needs to be\r
combined with the --target option.\r
+ This option automatically enables the --defaultinterfaces option.\r
+ Usage example: --vm --target /dev/mapper/your-vm-disk\r
+</p>\r
+</dd>\r
+<dt class="hdlist1">\r
+<strong>--vmfile</strong>\r
+</dt>\r
+<dd>\r
+<p>\r
+ Set up a Virtual Machine using a regular file instead of installing to a\r
+ partition/block device or directory. This allows deployment of a Virtual\r
+ Machine. The options needs to be combined with the --target option\r
+ (<em>qemu-img create -f raw …</em> is executed on the specified target).\r
+ This option automatically enables the --defaultinterfaces option.\r
Usage example: --vmfile --target /mnt/sda1/qemu.img\r
</p>\r
</dd>\r
<td class="icon">\r
<img src="./images/icons/warning.png" alt="Warning" />\r
</td>\r
-<td class="content">the command line parsing of grml-debootstrap does not validate the provided\r
-arguments for the command line options. Please be careful and check docs and\r
-/etc/debootstrap/config for further information.</td>\r
+<td class="content">the command line parsing of grml-debootstrap usually does not validate\r
+the provided arguments for the command line options. Please be careful and check\r
+docs and /etc/debootstrap/config for further information.</td>\r
</tr></table>\r
</div>\r
</div>\r
</div>\r
<div class="sect1">\r
+<h2 id="_networking">Networking</h2>\r
+<div class="sectionbody">\r
+<div class="paragraph"><p>By default (that is, if none of the options <strong>--nointerfaces</strong>,\r
+<strong>--defaultinterfaces</strong>, <strong>--vmfile</strong> or <strong>--vm</strong> are given) /etc/network/interfaces\r
+will be copied from the host to the target system.</p></div>\r
+</div>\r
+</div>\r
+<div class="sect1">\r
<h2 id="_usage_examples">Usage examples</h2>\r
<div class="sectionbody">\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt>grml-debootstrap --target /dev/sda1 --grub /dev/sda</tt></pre>\r
+<pre><code>grml-debootstrap --target /dev/sda1 --grub /dev/sda</code></pre>\r
+</div></div>\r
+<div class="paragraph"><p>Install default Debian release (buster) on /dev/sda1 and install bootmanager GRUB in MBR (master boot record) of /dev/sda.</p></div>\r
+<div class="literalblock">\r
+<div class="content">\r
+<pre><code>grml-debootstrap --release stretch --target /dev/sda1 --grub /dev/sda --hostname debian01 --password changeme</code></pre>\r
+</div></div>\r
+<div class="paragraph"><p>Install Debian release stretch on /dev/sda1 and install bootmanager GRUB in MBR (master boot record) of /dev/sda.\r
+Set hostname to <em>debian01</em> and password for user root to <em>changeme</em>.</p></div>\r
+<div class="literalblock">\r
+<div class="content">\r
+<pre><code>grml-debootstrap --target /dev/sda6 --grub /dev/sda --release sid</code></pre>\r
</div></div>\r
-<div class="paragraph"><p>Install default Debian release (wheezy) on /dev/sda1 and install bootmanager\r
-Grub in MBR (master boot record) of /dev/sda and use /dev/sda1 as system partition.</p></div>\r
+<div class="paragraph"><p>Install Debian unstable/sid on /dev/sda6 and install bootmanager GRUB in MBR (master boot record) of /dev/sda.</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt>grml-debootstrap --target /dev/sda6 --grub /dev/sda --release sid</tt></pre>\r
+<pre><code>DEBOOTSTRAP=mmdebstrap grml-debootstrap --target /dev/sda1 --grub /dev/sda</code></pre>\r
</div></div>\r
-<div class="paragraph"><p>Install Debian unstable/sid on /dev/sda6, install bootmanager Grub in MBR\r
-(master boot record) of /dev/sda and use /dev/sda6 as system partition.</p></div>\r
+<div class="paragraph"><p>Install default Debian release (buster) on /dev/sda1 and install bootmanager GRUB in MBR (master boot record) of /dev/sda.\r
+Use mmdebstrap instead of default debootstrap tool for bootstrapping.</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt>mount /dev/sda1 /data/chroot\r
-grml-debootstrap --target /data/chroot</tt></pre>\r
+<pre><code>grml-debootstrap --target /dev/mapper/vg0-rootfs --grub /dev/sda</code></pre>\r
</div></div>\r
-<div class="paragraph"><p>Install default Debian release (wheezy) in directory /data/chroot (without\r
-any bootloader).</p></div>\r
+<div class="paragraph"><p>Install default Debian release (buster) on LVM device /dev/mapper/vg0-rootfs and install bootmanager GRUB in MBR (master boot record) of /dev/sda.</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt>grml-debootstrap --target /dev/sda3 --grub /dev/sda --mirror ftp://ftp.tugraz.at/mirror/debian</tt></pre>\r
+<pre><code>grml-debootstrap --efi /dev/sda1 --target /dev/sda2 --grub /dev/sda</code></pre>\r
</div></div>\r
-<div class="paragraph"><p>Install default debian release (wheezy) in a Virtual Machine file with\r
-3GB disk size (including Grub as bootmanager in MBR of the virtual disk file):</p></div>\r
+<div class="paragraph"><p>Install default Debian release (buster) on /dev/sda2 and install bootmanager GRUB in MBR (master boot record) of /dev/sda.\r
+Use /dev/sda1 as EFI partition (requires EFI support in booted system).</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt>mount /dev/sda1 /mnt/sda1\r
-grml-debootstrap --vmfile --vmsize 3G --target /mnt/sda1/qemu.img</tt></pre>\r
+<pre><code>mount /dev/sda1 /data/chroot\r
+grml-debootstrap --target /data/chroot</code></pre>\r
</div></div>\r
-<div class="paragraph"><p>Install default Debian release (wheezy) on /dev/sda3 and install bootmanager\r
-Grub in MBR (master boot record) of /dev/sda and use /dev/sda3 as system partition.\r
-Use specified mirror instead of the default (<a href="ftp://ftp.debian.de/debian">ftp://ftp.debian.de/debian</a>) one.</p></div>\r
+<div class="paragraph"><p>Install default Debian release (buster) in directory /data/chroot (without any bootloader).</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt>mount -o loop /mnt/sda6/debian-CD-1.iso /mnt/iso\r
-grml-debootstrap --target /dev/sda1 --grub /dev/sda --iso file:/mnt/iso/debian/</tt></pre>\r
+<pre><code>grml-debootstrap --target /dev/sda3 --grub /dev/sda --mirror ftp://ftp.tugraz.at/mirror/debian</code></pre>\r
</div></div>\r
-<div class="paragraph"><p>Install Debian on /dev/sda1 using the loopback mounted Debian-ISO\r
-for the base-system and install bootmanager Grub in MBR (master boot record) of\r
-/dev/sda and use /dev/sda1 as system partition. Please notice, that the chroot\r
-system requires network access for all packages which are not part of the\r
-ISO.</p></div>\r
+<div class="paragraph"><p>Install default Debian release (buster) on /dev/sda3 and install bootmanager GRUB in MBR (master boot record) of /dev/sda.\r
+Use specified mirror instead of the default (<a href="http://deb.debian.org/debian">http://deb.debian.org/debian</a>) one.</p></div>\r
+<div class="literalblock">\r
+<div class="content">\r
+<pre><code>mount /dev/sda1 /mnt/sda1\r
+grml-debootstrap --vmfile --vmsize 3G --target /mnt/sda1/qemu.img</code></pre>\r
+</div></div>\r
+<div class="paragraph"><p>Install default debian release (buster) in a Virtual Machine file with 3GB disk size (including GRUB as bootmanager in MBR of the virtual disk file):</p></div>\r
+<div class="literalblock">\r
+<div class="content">\r
+<pre><code>mount -o loop ./debian-CD-1.iso /media/cdrom\r
+grml-debootstrap --target /dev/sda1 --grub /dev/sda --iso /media/cdrom</code></pre>\r
+</div></div>\r
+<div class="paragraph"><p>Install Debian on /dev/sda1 using the loopback mounted Debian-ISO for the base-system and install bootmanager GRUB in MBR (master boot record) of /dev/sda.\r
+Please notice, that the chroot system requires network access for all packages which are not part of the ISO.</p></div>\r
</div>\r
</div>\r
<div class="sect1">\r
<div class="sectionbody">\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt>/etc/debootstrap/config</tt></pre>\r
+<pre><code>/etc/debootstrap/config</code></pre>\r
</div></div>\r
-<div class="paragraph"><p>Main configuration file. You have to adjust it according to your needs\r
-if you want to execute grml-debootstrap in the non-interactive mode without\r
-any special command line arguments.</p></div>\r
+<div class="paragraph"><p>Main configuration file. Adjust it according to your needs if you want to\r
+execute grml-debootstrap in the non-interactive mode without any special command\r
+line arguments.</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt>/etc/debootstrap/chroot-script</tt></pre>\r
+<pre><code>/etc/debootstrap/chroot-script</code></pre>\r
</div></div>\r
<div class="paragraph"><p>The script executed within the new Debian system as soon as the main system\r
has been installed via [c]debootstrap.</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt>/etc/debootstrap/locale.gen</tt></pre>\r
+<pre><code>/etc/debootstrap/locale.gen</code></pre>\r
</div></div>\r
<div class="paragraph"><p>Defines the default locales used for generating locales via locale-gen.</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt>/etc/debootstrap/packages</tt></pre>\r
+<pre><code>/etc/debootstrap/packages</code></pre>\r
</div></div>\r
<div class="paragraph"><p>Defines the software packages which should be installed in the new\r
Debian system by default.</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt>/etc/debootstrap/extrapackages/</tt></pre>\r
+<pre><code>/etc/debootstrap/extrapackages/</code></pre>\r
</div></div>\r
<div class="paragraph"><p>Debian Packages dropped in this directory will be installed into the new Debian\r
system by default (Control variable: EXTRAPACKAGES)</p></div>\r
-<div class="literalblock">\r
-<div class="content">\r
-<pre><tt>/etc/debootstrap/stages/</tt></pre>\r
-</div></div>\r
-<div class="paragraph"><p>The default directory for storing information about executed stages. Every\r
-single function of grml-debootstrap will write <em>done</em> to the stages directory\r
-into a file named as the function itself if it has been executed successfully.\r
-You can adjust the location of the directory via configuration variable STAGES\r
-via /etc/debootstrap/config. Please notice that you have to remove the stages\r
-directory on your own if you want to re-execute grml-debootstrap after running it\r
-successfully once. This should avoid recurrent execution by error of\r
-grml-debootstrap (which might delete present data).</p></div>\r
</div>\r
</div>\r
<div class="sect1">\r
correspond with the command line options mentioned above):</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt>target=...</tt></pre>\r
+<pre><code>target=...</code></pre>\r
</div></div>\r
<div class="paragraph"><p>The target partition/directory of the new Debian system. Usage example:\r
target=/dev/sda1</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt>grub=...</tt></pre>\r
+<pre><code>grub=...</code></pre>\r
</div></div>\r
<div class="paragraph"><p>Where do you want to install grub to? Usage example: grub=/dev/sda</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt>release=...</tt></pre>\r
+<pre><code>release=...</code></pre>\r
</div></div>\r
-<div class="paragraph"><p>Specify release of new Debian system. Defaults to Debian wheezy. Supported\r
-relases: lenny, squeeze, wheezy and sid. Usage example: release=sid</p></div>\r
+<div class="paragraph"><p>Specify release of new Debian system. Defaults to Debian buster. Supported\r
+releases: lenny, squeeze, wheezy, jessie, stretch, buster, bullseye and sid. Usage example: release=stretch</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt>mirror=...</tt></pre>\r
+<pre><code>mirror=...</code></pre>\r
</div></div>\r
<div class="paragraph"><p>Specify mirror which should be used for apt-get/aptitude instead\r
-of the default one (<a href="http://http.debian.net/debian">http://http.debian.net/debian</a>).\r
+of the default one (<a href="http://deb.debian.org/debian">http://deb.debian.org/debian</a>).\r
Usage example: mirror=ftp://ftp.tugraz.at/mirror/debian</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt>password=...</tt></pre>\r
+<pre><code>password=...</code></pre>\r
</div></div>\r
<div class="paragraph"><p>Set password of user root without prompting for it but set it to the given\r
argument. Usage example: password=AiTh5ahn</p></div>\r
<div class="sect2">\r
-<h3 id="_usage_example_for_automatic_installation">Usage example for automatic installation:</h3>\r
+<h3 id="_usage_example_for_automatic_installation">Usage example for automatic installation</h3>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt>debian2hd target=/dev/sda1 grub=/dev/sda mirror=ftp://ftp.tugraz.at/mirror/debian password=foobar</tt></pre>\r
+<pre><code>debian2hd target=/dev/sda1 grub=/dev/sda mirror=ftp://ftp.tugraz.at/mirror/debian password=foobar</code></pre>\r
</div></div>\r
<div class="paragraph"><p>You have to enter this command line at the bootprompt of the Grml live system.\r
Please make sure that /dev/sda1 is the partition where you really want to\r
<div class="sectionbody">\r
<div class="tableblock">\r
<table rules="all"\r
+width="40%"\r
frame="hsides"\r
cellspacing="0" cellpadding="4">\r
-<caption class="title">TableCurrent status</caption>\r
-<col width="114" />\r
-<col width="205" />\r
-<col width="182" />\r
+<caption class="title">Table 1. Current status</caption>\r
+<col width="50%" />\r
+<col width="50%" />\r
<thead>\r
- <tr>\r
- <th align="right">\r
- Release /\r
- </th>\r
- <th align="center">\r
- Tool debootstrap\r
- </th>\r
- <th align="center">\r
- cdebootstrap\r
- </th>\r
- </tr>\r
+<tr>\r
+<th align="left" valign="top">Release </th>\r
+<th align="left" valign="top">Status</th>\r
+</tr>\r
</thead>\r
-<tbody valign="top">\r
- <tr>\r
- <td align="right">\r
- Lenny\r
- </td>\r
- <td align="center">\r
- works [1]\r
- </td>\r
- <td align="center">\r
- works [1]\r
- </td>\r
- </tr>\r
- <tr>\r
- <td align="right">\r
- Squeeze\r
- </td>\r
- <td align="center">\r
- works\r
- </td>\r
- <td align="center">\r
- works\r
- </td>\r
- </tr>\r
- <tr>\r
- <td align="right">\r
- Wheezy\r
- </td>\r
- <td align="center">\r
- works\r
- </td>\r
- <td align="center">\r
- works\r
- </td>\r
- </tr>\r
- <tr>\r
- <td align="right">\r
- Sid\r
- </td>\r
- <td align="center">\r
- works [2]\r
- </td>\r
- <td align="center">\r
- works [2]\r
- </td>\r
- </tr>\r
+<tbody>\r
+<tr>\r
+<td align="left" valign="top"><p class="table">lenny</p></td>\r
+<td align="left" valign="top"><p class="table">works[1]</p></td>\r
+</tr>\r
+<tr>\r
+<td align="left" valign="top"><p class="table">squeeze</p></td>\r
+<td align="left" valign="top"><p class="table">works[1]</p></td>\r
+</tr>\r
+<tr>\r
+<td align="left" valign="top"><p class="table">wheezy</p></td>\r
+<td align="left" valign="top"><p class="table">works[1]</p></td>\r
+</tr>\r
+<tr>\r
+<td align="left" valign="top"><p class="table">jessie</p></td>\r
+<td align="left" valign="top"><p class="table">works</p></td>\r
+</tr>\r
+<tr>\r
+<td align="left" valign="top"><p class="table">stretch</p></td>\r
+<td align="left" valign="top"><p class="table">works</p></td>\r
+</tr>\r
+<tr>\r
+<td align="left" valign="top"><p class="table">buster</p></td>\r
+<td align="left" valign="top"><p class="table">works</p></td>\r
+</tr>\r
+<tr>\r
+<td align="left" valign="top"><p class="table">bullseye</p></td>\r
+<td align="left" valign="top"><p class="table">works[2]</p></td>\r
+</tr>\r
+<tr>\r
+<td align="left" valign="top"><p class="table">sid</p></td>\r
+<td align="left" valign="top"><p class="table">works[2]</p></td>\r
+</tr>\r
</tbody>\r
</table>\r
</div>\r
<img src="./images/icons/note.png" alt="Note" />\r
</td>\r
<td class="content">\r
-<div class="title">lenny release</div>\r
-<div class="paragraph"><p>[1] Please notice that lenny is the current old-stable release within Debian.\r
-grml-debootstrap can handle the release but you really should not use lenny\r
-anymore unless you really know what you are doing. Choose Debian 6.0 (squeeze)\r
-or Debian 7.0 (wheezy) instead.</p></div>\r
-<div class="paragraph"><p>Notice that you need to specify a mirror providing the lenny release, the\r
-default (<a href="http://http.debian.net/debian">http://http.debian.net/debian</a>) doesn’t provide it any longer nowadays.\r
+<div class="title">lenny/squeeze/wheezy release</div>\r
+<div class="paragraph"><p>[1] Please notice that releases like lenny, squeeze and wheezy are unsupported releases within Debian nowadays.\r
+grml-debootstrap can handle the releases but you really should not use them\r
+anymore unless you really know what you are doing.\r
+Choose the current Debian stable version instead.\r
+See <a href="https://wiki.debian.org/DebianReleases">https://wiki.debian.org/DebianReleases</a> for the list of supported releases.</p></div>\r
+<div class="paragraph"><p>Notice that you need to specify a mirror providing the lenny and squeeze releases, the\r
+default (<a href="http://deb.debian.org/debian">http://deb.debian.org/debian</a>) doesn’t provide it any longer nowadays.\r
Set the mirror to e.g. <a href="http://archive.debian.org/debian/">http://archive.debian.org/debian/</a> if you don’t have\r
-your own lenny mirror.</p></div>\r
+your own lenny/squeeze mirror.</p></div>\r
+<div class="paragraph"><p>Older releases might also fail to install when running on top of recent kernel versions,\r
+throwing segfaults during debootstrap. This can be identified by the following messages inside kernel log (check with <em>dmesg</em>):</p></div>\r
+<div class="literalblock">\r
+<div class="content">\r
+<pre><code>dpkg[...] vsyscall attempted with vsyscall=none ip:[...]\r
+dpkg[...]: segfault at [...]</code></pre>\r
+</div></div>\r
+<div class="paragraph"><p>To work around this issue boot your system with the kernel boot option <em>vsyscall=emulate</em>.</p></div>\r
+<div class="paragraph"><p>You also need to specify a filesystem that’s supported by lenny, e.g.\r
+<em>--filesystem ext3</em> since grml-debootstrap’s current default (ext4) isn’t\r
+supported by lenny.</p></div>\r
+<div class="paragraph"><p>Also when debootstrapping lenny on a live system with a kernel version\r
+like "3.16-1-grml-amd64" lenny’s libc will fail to install with:</p></div>\r
+<div class="literalblock">\r
+<div class="content">\r
+<pre><code>[...]\r
+/var/lib/dpkg/tmp.ci/preinst: line 265: [: 3.16-1-grml-amd64: integery expression expected\r
+/var/lib/dpkg/tmp.ci/preinst: line 231: 3.16-1-grml-amd64: syntax error: invalid arithemtic operator (error token is ".16-1-grml-amd64")\r
+dpkg: error processing /var/cache/apt/archives/libc6_2.7-18lenny7_amd64.deb (--install):\r
+[....]</code></pre>\r
+</div></div>\r
+<div class="paragraph"><p>To workaround this either debootstrap from a system with an according\r
+kernel version or use the "fake uname" workaround (just google for it).</p></div>\r
<div class="paragraph"><p>When installing lenny to a new mdraid, grml-debootstrap will use md metadata\r
format version 0.90. This limits the device to a maximum size of 2TB, but has\r
the advantage of grub-legacy actually being able to boot from it.</p></div>\r
<img src="./images/icons/note.png" alt="Note" />\r
</td>\r
<td class="content">\r
-<div class="title">sid release</div>\r
-<div class="paragraph"><p>[2] Please notice that sid is Debian/unstable and due to its nature might not be\r
-always installable. What <em>might</em> work instead is deploying a stable or testing\r
-release and upgrade it after installation finished.</p></div>\r
+<div class="title">unstable and testing releases</div>\r
+<div class="paragraph"><p>[2] Please notice that Debian/testing and Debian/unstable (sid) might\r
+not be always installable due to their nature. What <em>might</em> work instead is\r
+deploying a stable release and upgrade it after installation finished.</p></div>\r
</td>\r
</tr></table>\r
</div>\r
<div class="sect1">\r
<h2 id="_bugs">Bugs</h2>\r
<div class="sectionbody">\r
-<div class="paragraph"><p>Probably. Please send bugreports to Michael Prokop <<a href="mailto:mika@grml.org">mika@grml.org</a>>.</p></div>\r
+<div class="paragraph"><p>Please report bugs towards <a href="https://github.com/grml/grml-debootstrap/issues">https://github.com/grml/grml-debootstrap/issues</a></p></div>\r
</div>\r
</div>\r
<div class="sect1">\r
<h2 id="_see_also">See also</h2>\r
<div class="sectionbody">\r
-<div class="paragraph"><p>debootstrap (8), cdebootstrap (1).</p></div>\r
+<div class="paragraph"><p>debootstrap (8), cdebootstrap (1), mmdebstrap(1).</p></div>\r
</div>\r
</div>\r
<div class="sect1">\r
<div id="footnotes"><hr /></div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 2013-02-19 00:04:27 CET\r
+Last updated\r
+ 2020-06-03 14:44:11 UTC\r
</div>\r
</div>\r
</body>\r