grml-debootstrap - wrapper around debootstrap for installing plain Debian via grml
grml-debootstrap - wrapper around debootstrap for installing plain Debian
grml-debootstrap [ options ]
grml-debootstrap is a wrapper suite around debootstrap (and cdebootstrap if you -want) for installing a plain Debian system 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 commandline) and invoke -grml-debootstrap without any further options then.
A plain and base Debian system will be installed on the given device (or -directory) then. Customization of this process is possible as well.
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, directory +or virtual image file then. Customization of this process is possible as well.
|
-The grml team does not take responsibility for loss of any data! | +The Grml team does not take responsibility for loss of any data! |
- Architecture you want to bootstrap. Currently only i386 is supported. - Defaults to the architecture that is currently running on your system. If - you’re running an amd64 system and want to deploy a i386 system use this option. - Note: deploying amd64 from a i386 system won’t work. + Set target architecture you want to install. Defaults to the architecture + you are currently running. If you’re running an amd64 kernel and want to + deploy an i386 system use this option. Note: deploying amd64 from an i386 + kernel does not work. Example: "--arch i386"
@@ -607,7 +802,7 @@ directory) then. Customization of this process is possible as well.
@@ -615,7 +810,7 @@ directory) then. Customization of this process is possible as well.
@@ -626,7 +821,7 @@ directory) then. Customization of this process is possible as well.
@@ -634,7 +829,7 @@ directory) then. Customization of this process is possible as well.
@@ -643,7 +838,7 @@ directory) then. Customization of this process is possible as well.
@@ -651,7 +846,35 @@ directory) then. Customization of this process is possible as well.
+ 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.filesystem. +
++ Skip user acknowledgement and do not prompt for user input. +
++ Enable Grml.org’s Debian repository (http://deb.grml.org/) via the + /etc/apt/sources.list.d/grml.list configuration file. This provides the + option to install Debian packages from Grml’s repository. +
+@@ -672,7 +895,7 @@ directory) then. Customization of this process is possible as well.
@@ -680,14 +903,14 @@ directory) then. Customization of this process is possible as well.
- Specify mountpoint where you have a Debian ISO mounted loopback. + Specify mount point where you have a Debian ISO mounted loopback. Using this option instead of the mirror option gives you the possibility to install the base-system without network access. Make sure you - mounted the according Debian-ISO to the given <_/mntpoint_>. See section + mounted the according Debian-ISO to the given /mntpoint. See section Usage examples for a demonstration.
@@ -725,26 +948,28 @@ directory) then. Customization of this process is possible as well.
- Do not download and check signatures for retrieved Release files. + 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.
- Specify mountpoint that should be used for mounting the target system. + Specify mount point that should be used for mounting the target system. Corresponding with configuration variable MNTPOINT. Note: this option has no effect if option -t is given and represents a directory.
@@ -753,27 +978,27 @@ directory) then. Customization of this process is possible as well.
Use specified password as password for user root. Use with caution, as your - commandline might be visible in the process list and the shell history. + command line might be visible in the process list and the shell history. It’s meant for automatic installation only.
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.
@@ -785,7 +1010,7 @@ directory) then. Customization of this process is possible as well.
@@ -796,7 +1021,7 @@ directory) then. Customization of this process is possible as well.
@@ -815,6 +1040,28 @@ directory) then. Customization of this process is possible as well.
+ 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 +
++ 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 +
+
grml-debootstrap --target /dev/sda1 --grub /dev/sda
Install default Debian release (stable/lenny) 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.
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 (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/lenny) on /dev/sda3 and install bootmanager +
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 (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/lenny 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 ISO.
/etc/debootstrap/extrapackages+
/etc/debootstrap/extrapackages/
Debian Packages dropped here will be installed into the new Debian system by -default (Controlvariable: EXTRAPACKAGES)
Debian Packages dropped in this directory will be installed into the new Debian +system by default (Control variable: EXTRAPACKAGES)
/etc/debootstrap/stages/@@ -918,28 +1176,32 @@ directory on your own if you want to re-execute grml-debootstrap after running i successfully once. This should avoid recurrent execution by error of grml-debootstrap (which might delete present data).
You can control execution of grml-debootstrap via adjusting /etc/debootstrap/config for some main stuff or via setting some selected -variables via commandline. The packages which should be installed in the new +variables via command line. The packages which should be installed in the new Debian system can be defined via the file /etc/debootstrap/packages. If you want to put existing files to the new Debian system you can place them into the (by default non-existing) directories boot, etc, share, usr and var in /etc/debootstrap/. Every existing directory will be copied to the new Debian system then. If you want to install additional packages that are not available -via the grml or debian mirror drop them into /etc/debootstrap/extrapackages and +via the Grml or Debian mirror drop them into /etc/debootstrap/extrapackages and make sure that EXTRAPACKAGES is set to "yes".
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 commandline instead) it is meant for use via bootoption -debian2hd. The bootoption debian2hd (more precise: the kernelname on bootprompt) -supports the following bootoptions (they correspond with the commandline options -mentioned above):
target=...@@ -955,14 +1217,14 @@ target=/dev/sda1
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 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
Set password of user root without prompting for it but set it to the given argument. Usage example: password=AiTh5ahn
debian2hd target=/dev/sda1 grub=/dev/sda mirror=ftp://ftp.tugraz.at/mirror/debian password=foobar
You have to enter this commandline at the bootprompt of grml. Please make sure -that /dev/sda1 is the partition where you really want to install your new Debian -system.
You have to enter this command line at the bootprompt of the Grml live system. +Please make sure that /dev/sda1 is the partition where you really want to +install your new Debian system.
| @@ -986,10 +1249,13 @@ system. | Automatic installation within booting process is done in grml-autoconfig via setting environment variable AUTOINSTALL and creation of /usr/bin/grml-debootstrap_noninteractive with the available and relevant -bootoptions for grml-debootstrap. | +boot options for grml-debootstrap.
[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.
[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 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://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.
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.
|
+
+ |
+
+ 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 a stable or testing +release and upgrade it after installation finished. |
+
Probably. Please send bugreports to Michael Prokop <mika@grml.org>.
debootstrap (8), cdebootstrap (1).
Michael Prokop <mika@grml.org>