X-Git-Url: https://git.grml.org/?p=grml-debootstrap.git;a=blobdiff_plain;f=grml-debootstrap.8.txt;h=c4669e8983675640927e326febe97c83398598e8;hp=96338646889e484834c36cc2f3a2ef431296368e;hb=762d9ef1fc884dfc0ee1923a22cbadb3c5a3b053;hpb=6cf66c73c8d9067c5836246ad7c3d51529c683c5 diff --git a/grml-debootstrap.8.txt b/grml-debootstrap.8.txt index 9633864..c4669e8 100644 --- a/grml-debootstrap.8.txt +++ b/grml-debootstrap.8.txt @@ -135,7 +135,14 @@ Options and environment variables *--nointerfaces*:: Do not copy /etc/network/interfaces from host system to the target. - This option is automatically enabled when using --vmfile. + This option is automatically enabled when using --vm or --vmfile. + +*--nokernel*:: + + Skip installation of default kernel images. This option might be + interesting for you if you want a Debian system which doesn't + need to provide regular boot, e.g. a system which provides + ISOs for booting via GRUB using grml-rescueboot. *--nopackages*:: @@ -168,8 +175,8 @@ Options and environment variables *-r*, *--release* _releasename_:: Specify release of new Debian system. Supported releases names: lenny, - squeeze, wheezy (note: requires current version of debootstrap) and sid. - Corresponding with configuration variable RELEASE. + squeeze, wheezy, jessie (note: requires a recent version of debootstrap) + and sid. Corresponding with configuration variable RELEASE. *--pre-scripts* _directory_:: @@ -195,6 +202,14 @@ Options and environment variables Increase verbosity. +*--vm*:: + + Set up a Virtual Machine on an existing block device, which will be + partitioned. + This allows deployment of a Virtual Machine. The options needs to be + combined with the --target option. + Usage example: --vm --target /dev/mapper/your-vm-disk + *--vmfile*:: Set up a Virtual Machine instead of installing to a partition or directory. @@ -222,7 +237,7 @@ Usage examples grml-debootstrap --target /dev/sda1 --grub /dev/sda -Install default Debian release (wheezy) on /dev/sda1 and install bootmanager +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. grml-debootstrap --target /dev/sda6 --grub /dev/sda --release sid @@ -233,20 +248,20 @@ Install Debian unstable/sid on /dev/sda6, install bootmanager Grub in MBR mount /dev/sda1 /data/chroot grml-debootstrap --target /data/chroot -Install default Debian release (wheezy) in directory /data/chroot (without +Install default Debian release (jessie) 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 (wheezy) 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 (wheezy) 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/ @@ -321,8 +336,8 @@ Where do you want to install grub to? Usage example: grub=/dev/sda release=... -Specify release of new Debian system. Defaults to Debian wheezy. Supported -relases: lenny, squeeze, wheezy and sid. Usage example: release=sid +Specify release of new Debian system. Defaults to Debian jessie. Supported +relases: lenny, squeeze, wheezy, jessie and sid. Usage example: release=sid mirror=... @@ -360,14 +375,26 @@ include::releasetable.txt[] ================================================================================ [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 6.0 (squeeze) -or Debian 7.0 (wheezy) instead. +anymore unless you really know what you are doing. Choose Debian 7.0 (wheezy) or +something newer instead. Notice that you need to specify a mirror providing the lenny release, the 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. @@ -376,7 +403,7 @@ the advantage of grub-legacy actually being able to boot from it. [NOTE] .unstable and testing releases ================================================================================ -[2] Please notice that jessie (Debian/testing) and sid (Debian/unstable) might +[2] Please notice that Debian/testing and Debian/unstable (sid) might not be always installable due to their nature. What _might_ work instead is deploying a stable release and upgrade it after installation finished. ================================================================================