</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>--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
</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 (note: requires a recent version of debootstrap)\r
+ and sid. Corresponding with configuration variable RELEASE.\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
</dt>\r
<dd>\r
<p>\r
- Set up a Virtual Machine instead of installing to a partition or directory.\r
- This allows deployment of a Virtual Machine. The options needs to be\r
- combined with the --target option.\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
Usage example: --vmfile --target /mnt/sda1/qemu.img\r
</p>\r
</dd>\r
<div class="content">\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 (wheezy) on /dev/sda1 and install bootmanager\r
+<div class="paragraph"><p>Install default Debian release (jessie) 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="literalblock">\r
<div class="content">\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) in directory /data/chroot (without\r
+<div class="paragraph"><p>Install default Debian release (jessie) in directory /data/chroot (without\r
any bootloader).</p></div>\r
<div class="literalblock">\r
<div class="content">\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 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 (jessie) 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="http://httpredir.debian.org/debian">http://httpredir.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 (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 (jessie) 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="literalblock">\r
<div class="content">\r
<pre><code>mount -o loop /mnt/sda6/debian-CD-1.iso /mnt/iso\r
<div class="content">\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 jessie. Supported\r
+releases: lenny, squeeze, wheezy, jessie, stretch and sid. Usage example: release=sid</p></div>\r
<div class="literalblock">\r
<div class="content">\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://httpredir.debian.org/debian">http://httpredir.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
<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</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</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">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
<div class="title">lenny release</div>\r
<div class="paragraph"><p>[1] Please notice that lenny is an unsupported release within Debian nowadays.\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
+anymore unless you really know what you are doing. Choose Debian 8.0 (jessie) or\r
+something newer 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
+default (<a href="http://httpredir.debian.org/debian">http://httpredir.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
+<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
</td>\r
<td class="content">\r
<div class="title">unstable and testing releases</div>\r
-<div class="paragraph"><p>[2] Please notice that jessie (Debian/testing) and sid (Debian/unstable) might\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
<div id="footer">\r
<div id="footer-text">\r
Last updated\r
- 2014-10-09 09:55:39 CEST\r
+ 2016-11-17 12:09:18 CET\r
</div>\r
</div>\r
</body>\r
projects / grml.org.git / blobdiff