X-Git-Url: https://git.grml.org/?p=grml-debootstrap.git;a=blobdiff_plain;f=grml-debootstrap.8.txt;h=ec14eb66de242e8e4bb852c4b9dcca76ebfaf12d;hp=cebb41f97ebc0ed70d0384b88d0701d110674b3b;hb=d919319a42917bd94b547dc1ce0db988dd189839;hpb=62cec4e9315f6c4978f0cd7da6f28512409e9a07 diff --git a/grml-debootstrap.8.txt b/grml-debootstrap.8.txt index cebb41f..ec14eb6 100644 --- a/grml-debootstrap.8.txt +++ b/grml-debootstrap.8.txt @@ -17,12 +17,14 @@ Introduction grml-debootstrap is a wrapper suite around debootstrap (and cdebootstrap if you want) for installing a plain Debian system (e.g. via Grml) very fast and easy. -All you have to do is adjust a few variables in configuration file -/etc/debootstrap/config (or specify some variables via command line) and invoke -grml-debootstrap without any further options then. +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 +configuration options. -A plain and base Debian system will be installed on the given device (or -directory) then. Customization of this process is possible as well. +A plain and base Debian system will be installed on the given device, directory +or virtual image file then. Customization of this process is possible as well. CAUTION: The Grml team does not take responsibility for loss of any data! @@ -36,6 +38,12 @@ Options and environment variables deploy an i386 system use this option. Note: deploying amd64 from an i386 kernel does *not* work. Example: "_--arch i386_" +*--backportrepos*:: + + Enable Debian's Backports repository (http://backports.debian.org/) via the + /etc/apt/sources.list.d/backports.list configuration file. This provides the + option to install Debian packages from Debian's backports repository. + *--bootappend* _appendline-for-the-kernel_:: Specify appendline for the kernel. @@ -65,10 +73,15 @@ Options and environment variables Extra parameters passed to the debootstrap command. +*--debug*:: + + Execute in very verbose way. Useful for debugging possible problems + with grml-debootstrap or identify what's actually executed. + *--filesystem* _filesystem_:: Filesystem that should be created when installing to a partition. - If unset defaults to ext3. Valid values are all filesystems that + If unset defaults to ext4. Valid values are all filesystems that can be created through mkfs._filesystem_. *--force*:: @@ -170,9 +183,7 @@ Options and environment variables *-t*, *--target* _target_:: Target partition (/dev/...) or directory (anything else without /dev at the - beginning). To install grub using *--grub* make sure to use a _device_ - instead of a directory as _target_ (installation of grub as bootloader when - using directories is NOT supported). + beginning). *-v*, *--verbose*:: Increase verbosity. @@ -201,7 +212,7 @@ Usage examples grml-debootstrap --target /dev/sda1 --grub /dev/sda -Install default Debian release (squeeze) on /dev/sda1 and install bootmanager +Install default Debian release (wheezy) 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 @@ -212,25 +223,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 (squeeze) in directory /data/chroot (without +Install default Debian release (wheezy) 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 (squeeze) in a Virtual Machine file with +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): mount /dev/sda1 /mnt/sda1 grml-debootstrap --vmfile --vmsize 3G --target /mnt/sda1/qemu.img -Install default Debian release (squeeze) on /dev/sda3 and install bootmanager +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. - mount -o loop /mnt/sda6/debian-40r0-i386-CD-1.iso /mnt/iso + 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 squeeze on /dev/sda1 using the loopback mounted Debian-ISO +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 /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 @@ -296,9 +307,9 @@ If environment variable AUTOINSTALL is set grml-debootstrap can be executed in a full automatic mode. While this mode isn't really useful for interactive execution (just configure /etc/debootstrap/configure or specify the relevant variables on the command line instead) it is meant for use via boot option -debian2hd. The boot option debian2hd (more precise: the kernelname on bootprompt) -supports the following boot options (they correspond with the command line options -mentioned above): +debian2hd on the Grml live system. The boot option debian2hd (more precise: the +kernelname at the bootprompt) supports the following boot options (they +correspond with the command line options mentioned above): target=... @@ -311,13 +322,13 @@ Where do you want to install grub to? Usage example: grub=/dev/sda release=... -Specify release of new Debian system. Defaults to Debian squeeze. Supported +Specify release of new Debian system. Defaults to Debian wheezy. Supported relases: lenny, squeeze, wheezy and sid. Usage example: release=sid mirror=... Specify mirror which should be used for apt-get/aptitude instead -of the default one (ftp://ftp.debian.de/debian). +of the default one (http://http.debian.net/debian). Usage example: mirror=ftp://ftp.tugraz.at/mirror/debian password=... @@ -354,7 +365,7 @@ anymore unless you really know what you are doing. Choose Debian 6.0 (squeeze) or Debian 7.0 (wheezy) instead. Notice that you need to specify a mirror providing the lenny release, the -default (http://cdn.debian.net/debian) doesn't provide it any longer nowadays. +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.