X-Git-Url: https://git.grml.org/?p=grml-debootstrap.git;a=blobdiff_plain;f=grml-debootstrap.8.txt;h=1ae3ff72f1f79815386564a91b67f36fa13ac06d;hp=0e69323ea63ff6d7cc4699fd8fac4b26a816f02e;hb=ad7c3cfdaa7c6354c951a9dbbad6ada40a1dc082;hpb=b901134bfb0a25bf1b6c8f25b953bb2231e21e90 diff --git a/grml-debootstrap.8.txt b/grml-debootstrap.8.txt index 0e69323..1ae3ff7 100644 --- a/grml-debootstrap.8.txt +++ b/grml-debootstrap.8.txt @@ -65,6 +65,16 @@ Options and environment variables Extra parameters passed to the debootstrap command. +*--filesystem* <_filesystem_>:: + + Filesystem that should be created when installing to a partition. + If unset defaults to ext3. Valid values are all filesystems that + can be created through mkfs.. + +*--force*:: + + Skip user acknowledgement and do not prompt for user input. + *--grub* <_device_>:: Device where grub should be installed to. Note that only the MBR (master @@ -103,6 +113,16 @@ Options and environment variables Skip debootstrap, only do configuration to the target. +*--nopackages*:: + + Skip installation of packages defined in /etc/debootstrap/packages. + +*--nopassword*:: + + Do not prompt for the root password. Note: Use the '--password' option if + you want to set the root password during an automatic installation but don't + want to use the interactive dialog. + *--insecure*:: Do not download and check signatures for retrieved Release files. @@ -128,9 +148,17 @@ Options and environment variables *-r*, *--release* <_releasename_>:: Specify release of new Debian system. Supported releases names: lenny, - squeeze (note: requires current version of debootstrap) and sid. + squeeze, wheezy (note: requires current version of debootstrap) and sid. Corresponding with configuration variable RELEASE. +*--pre-scripts* <_directory_>:: + + Execute scripts from specified directory before executing the chroot + script. This allows customisation of the system before 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/pre-scripts/ + *--scripts* <_directory_>:: Execute scripts from specified directory. This allows customisation of @@ -147,6 +175,18 @@ Options and environment variables *-v*, *--verbose*:: Increase verbosity. +*--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. + Usage example: --vmfile --target /mnt/sda1/qemu.img + +*--vmsize* <_size_>:: + Use specified size for size of Virtual Machine disk file. If not specified it + defaults to 2G (being 2GB). Syntax as supported by qemu-img (see manpage + qemu-img(1) for details. + Usage example: --vmsize 3G + *-V*, *--version*:: Show version of program and exit. @@ -159,7 +199,7 @@ Usage examples grml-debootstrap --target /dev/sda1 --grub /dev/sda -Install default Debian release (stable/lenny) on /dev/sda1 and install bootmanager +Install default Debian release (stable/squeeze) 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 @@ -170,19 +210,25 @@ 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 (stable/lenny) in directory /data/chroot (without +Install default Debian release (stable/squeeze) 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 (stable/lenny) on /dev/sda3 and install bootmanager +Install default debian release (stable/squeeze) in a Virtual Machine file with +3GB disk size (including Grub as bootmanager in MBR of the virtual disk file): + + mount /dev/sda1 /mnt/sda1 + grml-debootstrap --vmfile --vmsize 3G --target /mnt/sda1/qemu.img + +Install default Debian release (stable/squeeze) 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. mount -o loop /mnt/sda6/debian-40r0-i386-CD-1.iso /mnt/iso grml-debootstrap --target /dev/sda1 --grub /dev/sda --iso file:/mnt/iso/debian/ -Install Debian stable/lenny on /dev/sda1 using the loopback mounted Debian-ISO +Install Debian stable/squeeze 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 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 @@ -194,7 +240,8 @@ Files /etc/debootstrap/config Main configuration file. You have to adjust it according to your needs -before you are able to run grml-debootstrap. +if you want to execute grml-debootstrap in the non-interactive mode without +any special command line arguments. /etc/debootstrap/chroot-script @@ -262,8 +309,8 @@ Where do you want to install grub to? Usage example: grub=/dev/sda release=... -Specify release of new Debian system. Defaults to Debian stable. Supported -relases: lenny, squeeze and sid. Usage example: release=sid +Specify release of new Debian system. Defaults to Debian squeeze. Supported +relases: lenny, squeeze, wheezy and sid. Usage example: release=sid mirror=... @@ -301,7 +348,16 @@ include::releasetable.txt[] ================================================================================ [1] Please notice that Etch is the current old-stable within Debian. grml-debootstrap can handle the release but you really should not use Etch -anymore unless you really know what you are doing. Choose Lenny instead. +anymore unless you really know what you are doing. Choose Lenny or +Squeeze instead. +================================================================================ + +[NOTE] +.Lenny-Release +================================================================================ +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. ================================================================================ Bugs