X-Git-Url: https://git.grml.org/?p=grml-debootstrap.git;a=blobdiff_plain;f=grml-debootstrap.8.txt;h=4f6fa97dcc7f65f3c9101e3a134acca67e7c7419;hp=d45a3d083dd5745301e088a85d3ba66a442d98a7;hb=95f4b7c479cce25127be9d0ccc160d8bf179b37c;hpb=06fc8bd266ad5f2ca4f28af7ae636f5db3c3bc57 diff --git a/grml-debootstrap.8.txt b/grml-debootstrap.8.txt index d45a3d0..4f6fa97 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. @@ -68,7 +76,7 @@ Options and environment variables *--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*:: @@ -201,7 +209,7 @@ Usage examples grml-debootstrap --target /dev/sda1 --grub /dev/sda -Install default Debian release (stable/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 +220,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/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 (stable/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 (stable/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 stable/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 +304,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 +319,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=... @@ -350,11 +358,11 @@ include::releasetable.txt[] ================================================================================ [1] Please notice that lenny is the current old-stable release within Debian. grml-debootstrap can handle the release but you really should not use lenny -anymore unless you really know what you are doing. Choose stable (squeeze) -instead. +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. @@ -367,8 +375,8 @@ the advantage of grub-legacy actually being able to boot from it. .sid release ================================================================================ [2] Please notice that sid is Debian/unstable and due to its nature might not be -always installable. What _might_ work instead is deploying stable (squeeze) or -testing (wheezy) and upgrade it after installation finished. +always installable. What _might_ work instead is deploying a stable or testing +release and upgrade it after installation finished. ================================================================================ Bugs