X-Git-Url: https://git.grml.org/?p=grml-debootstrap.git;a=blobdiff_plain;f=grml-debootstrap.8.txt;h=a836fa8c01e6ecc8f6f9213c71e1bc46ddb1b066;hp=fa68864c1e423bca90b7fd54960f2a7489a7aa12;hb=00642691771b3adcc1fc6223d8f928c229989434;hpb=add7aab78973ac9a01be11d108a6eb80db05f3a4 diff --git a/grml-debootstrap.8.txt b/grml-debootstrap.8.txt index fa68864..a836fa8 100644 --- a/grml-debootstrap.8.txt +++ b/grml-debootstrap.8.txt @@ -60,6 +60,11 @@ Options and environment variables are executed at the end of the chroot procedure. Default directory: /etc/debootstrap/chroot-scripts/ +*--contrib*:: + + Enable the 'contrib' repository in COMPONENTS. By default only + the 'main' repository is enabled. + *-d*, *--confdir* _path_:: Place of configuration files for debootstrap, defaults to /etc/debootstrap. @@ -144,6 +149,11 @@ Options and environment variables need to provide regular boot, e.g. a system which provides ISOs for booting via GRUB using grml-rescueboot. +*--non-free*:: + + Enable the 'non-free' repository in COMPONENTS. By default only + the 'main' repository is enabled. + *--nopackages*:: Skip installation of packages defined in /etc/debootstrap/packages. @@ -172,11 +182,13 @@ Options and environment variables command line might be visible in the process list and the shell history. It's meant for automatic installation only. -*-r*, *--release* _releasename_:: +*--post-scripts* _directory_:: - Specify release of new Debian system. Supported releases names: lenny, - squeeze, wheezy, jessie (note: requires a recent version of debootstrap) - and sid. Corresponding with configuration variable RELEASE. + Execute scripts from specified directory after executing the chroot script. + This allows customisation of the system after the chroot has been set up. + The environment variable $MNTPOINT is available inside the scripts for + direct access of the chroot. + Default directory: /etc/debootstrap/post-scripts/ *--pre-scripts* _directory_:: @@ -186,12 +198,16 @@ Options and environment variables scripts for direct access of the chroot. Default directory: /etc/debootstrap/pre-scripts/ -*--scripts* _directory_:: +*-r*, *--release* _releasename_:: + + Specify release of new Debian system. Supported releases names: lenny, + squeeze, wheezy, jessie, stretch (note: requires a recent version of debootstrap) + and sid. Corresponding with configuration variable RELEASE. + +*--remove-configs*:: - Execute scripts from specified directory. This allows customisation of - the system after the chroot has been set up. The environment variable - $MNTPOINT is available inside the scripts for direct access of the chroot. - Default directory: /etc/debootstrap/scripts/ + Delete grml-debootstrap configuration files (/etc/debootstrap/*) from installed + system. Useful for reproducible builds or if you don't want to leak information. *-t*, *--target* _target_:: @@ -212,9 +228,10 @@ Options and environment variables *--vmfile*:: - Set up a Virtual Machine instead of installing to a partition or directory. - This allows deployment of a Virtual Machine. The options needs to be - combined with the --target option. + Set up a Virtual Machine using a regular file instead of installing to a + partition/block device or directory. This allows deployment of a Virtual + Machine. The options needs to be combined with the --target option + ('qemu-img create -f raw ...' is executed on the specified target). Usage example: --vmfile --target /mnt/sda1/qemu.img *--vmsize* _size_:: @@ -253,15 +270,15 @@ any bootloader). grml-debootstrap --target /dev/sda3 --grub /dev/sda --mirror ftp://ftp.tugraz.at/mirror/debian -Install default debian release (jessie) in a Virtual Machine file with -3GB disk size (including Grub as bootmanager in MBR of the virtual disk file): +Install default Debian release (jessie) on /dev/sda3 and install bootmanager +Grub in MBR (master boot record) of /dev/sda and use /dev/sda3 as system partition. +Use specified mirror instead of the default (http://http.debian.net/debian) one. mount /dev/sda1 /mnt/sda1 grml-debootstrap --vmfile --vmsize 3G --target /mnt/sda1/qemu.img -Install default Debian release (jessie) on /dev/sda3 and install bootmanager -Grub in MBR (master boot record) of /dev/sda and use /dev/sda3 as system partition. -Use specified mirror instead of the default (ftp://ftp.debian.de/debian) one. +Install default debian release (jessie) in a Virtual Machine file with +3GB disk size (including Grub as bootmanager in MBR of the virtual disk file): mount -o loop /mnt/sda6/debian-CD-1.iso /mnt/iso grml-debootstrap --target /dev/sda1 --grub /dev/sda --iso file:/mnt/iso/debian/ @@ -337,7 +354,7 @@ Where do you want to install grub to? Usage example: grub=/dev/sda release=... Specify release of new Debian system. Defaults to Debian jessie. Supported -relases: lenny, squeeze, wheezy, jessie and sid. Usage example: release=sid +releases: lenny, squeeze, wheezy, jessie, stretch and sid. Usage example: release=sid mirror=... @@ -383,6 +400,18 @@ default (http://http.debian.net/debian) doesn't provide it any longer nowadays. Set the mirror to e.g. http://archive.debian.org/debian/ if you don't have your own lenny mirror. +Also when debootstrapping lenny on a live system with a kernel version +like "3.16-1-grml-amd64" lenny's libc will fail to install with: + + [...] + /var/lib/dpkg/tmp.ci/preinst: line 265: [: 3.16-1-grml-amd64: integery expression expected + /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") + dpkg: error processing /var/cache/apt/archives/libc6_2.7-18lenny7_amd64.deb (--install): + [....] + +To workaround this either debootstrap from a system with an according +kernel version or use the "fake uname" workaround (just google for it). + When installing lenny to a new mdraid, grml-debootstrap will use md metadata format version 0.90. This limits the device to a maximum size of 2TB, but has the advantage of grub-legacy actually being able to boot from it.