X-Git-Url: https://git.grml.org/?p=grml-debootstrap.git;a=blobdiff_plain;f=grml-debootstrap.8.txt;h=4882d2b321d447c80556309fb25be568a0589296;hp=69af5f4004a05121c8ab8a27d376f669e403504a;hb=070010f3b89fedea00ca8da305efeaf5ee5692b4;hpb=10ad4699c352b3537625085370051b9be83d2036 diff --git a/grml-debootstrap.8.txt b/grml-debootstrap.8.txt index 69af5f4..4882d2b 100644 --- a/grml-debootstrap.8.txt +++ b/grml-debootstrap.8.txt @@ -20,7 +20,7 @@ want) for installing a plain Debian system very fast and easy. All you have to do is adjust a few variables in the configuration file /etc/debootstrap/config or specify some command line options and invoke grml-debootstrap. If invoked without any configuration modifications or command -line options a dialog based frontend will be available to control some basic +line options a dialog based front end will be available to control some basic configuration options. A plain and base Debian system will be installed on the given device, directory @@ -40,7 +40,7 @@ Options and environment variables *--backportrepos*:: - Enable Debian's Backports repository (http://backports.debian.org/) via the + Enable Debian's Backports repository via the /etc/apt/sources.list.d/backports.list configuration file. This provides the option to install Debian packages from Debian's backports repository. @@ -83,6 +83,11 @@ Options and environment variables Execute in very verbose way. Useful for debugging possible problems with grml-debootstrap or identify what's actually executed. +*--defaultinterfaces*:: + + Install a default /etc/network/interfaces file (enabling DHCP for eth0) + instead of taking over config from host system. + *--efi* _device_:: Partition where EFI boot manager should be installed to. If the @@ -211,8 +216,8 @@ Options and environment variables *-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. + squeeze, wheezy, jessie, stretch, buster, bullseye and sid. Corresponding with configuration + variable RELEASE. Default release: buster *--remove-configs*:: @@ -264,37 +269,43 @@ Usage examples grml-debootstrap --target /dev/sda1 --grub /dev/sda -Install default Debian release (jessie) on /dev/sda1 and install bootmanager -Grub in MBR (master boot record) of /dev/sda and use /dev/sda1 as system partition. +Install default Debian release (buster) on /dev/sda1 and install bootmanager +GRUB in MBR (master boot record) of /dev/sda and use /dev/sda1 as system partition. + + grml-debootstrap --release stretch --target /dev/sda1 --grub /dev/sda --hostname foobar --password changeme + +Install Debian release stretch on /dev/sda1 and install bootmanager +GRUB in MBR (master boot record) of /dev/sda and use /dev/sda1 as system partition. +Set hostname to 'foobar' and password for user root to 'changeme'. grml-debootstrap --target /dev/sda6 --grub /dev/sda --release sid -Install Debian unstable/sid on /dev/sda6, install bootmanager Grub in MBR +Install Debian unstable/sid on /dev/sda6, install bootmanager GRUB in MBR (master boot record) of /dev/sda and use /dev/sda6 as system partition. mount /dev/sda1 /data/chroot grml-debootstrap --target /data/chroot -Install default Debian release (jessie) in directory /data/chroot (without +Install default Debian release (buster) in directory /data/chroot (without any bootloader). grml-debootstrap --target /dev/sda3 --grub /dev/sda --mirror ftp://ftp.tugraz.at/mirror/debian -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://httpredir.debian.org/debian) one. +Install default Debian release (buster) 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://deb.debian.org/debian) one. mount /dev/sda1 /mnt/sda1 grml-debootstrap --vmfile --vmsize 3G --target /mnt/sda1/qemu.img -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 (buster) 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/ 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 +for the base-system and install bootmanager GRUB in MBR (master boot record) of /dev/sda and use /dev/sda1 as system partition. Please notice, that the chroot system requires network access for all packages which are not part of the ISO. @@ -363,13 +374,13 @@ 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 -releases: lenny, squeeze, wheezy, jessie, stretch and sid. Usage example: release=sid +Specify release of new Debian system. Defaults to Debian buster. Supported +releases: lenny, squeeze, wheezy, jessie, stretch, buster, bullseye and sid. Usage example: release=stretch mirror=... Specify mirror which should be used for apt-get/aptitude instead -of the default one (http://httpredir.debian.org/debian). +of the default one (http://deb.debian.org/debian). Usage example: mirror=ftp://ftp.tugraz.at/mirror/debian password=... @@ -398,17 +409,26 @@ Supported Releases include::releasetable.txt[] [NOTE] -.lenny release +.lenny/squeeze/wheezy release ================================================================================ -[1] Please notice that lenny is an unsupported release within Debian nowadays. -grml-debootstrap can handle the release but you really should not use lenny -anymore unless you really know what you are doing. Choose Debian 8.0 (jessie) or -something newer instead. - -Notice that you need to specify a mirror providing the lenny release, the -default (http://httpredir.debian.org/debian) doesn't provide it any longer nowadays. +[1] Please notice that releases like lenny, squeeze and wheezy are unsupported releases within Debian nowadays. +grml-debootstrap can handle the releases but you really should not use them +anymore unless you really know what you are doing. +Choose the current Debian stable version instead. +See https://wiki.debian.org/DebianReleases for the list of supported releases. + +Notice that you need to specify a mirror providing the lenny and squeeze releases, the +default (http://deb.debian.org/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. +your own lenny/squeeze mirror. + +Older releases might also fail to install when running on top of recent kernel versions, +throwing segfaults during debootstrap. This can be identified by the following messages inside kernel log (check with 'dmesg'): + + dpkg[...] vsyscall attempted with vsyscall=none ip:[...] + dpkg[...]: segfault at [...] + +To work around this issue boot your system with the kernel boot option 'vsyscall=emulate'. You also need to specify a filesystem that's supported by lenny, e.g. '--filesystem ext3' since grml-debootstrap's current default (ext4) isn't