From 8322083fcb0aac14729bcb35f79b046b984cf48a Mon Sep 17 00:00:00 2001 From: Michael Prokop Date: Tue, 10 Apr 2012 12:23:13 +0200 Subject: [PATCH] Update /grml-debootstrap/ --- grml-debootstrap/index.html | 615 +++++++++++++++++++++++++++++++++----------- 1 file changed, 460 insertions(+), 155 deletions(-) diff --git a/grml-debootstrap/index.html b/grml-debootstrap/index.html index 2d7a7dc..1bc4afe 100644 --- a/grml-debootstrap/index.html +++ b/grml-debootstrap/index.html @@ -2,15 +2,25 @@ "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd"> - - + + grml-debootstrap(8) - +
+

Name

-

grml-debootstrap - wrapper around debootstrap for installing plain Debian via grml

+

grml-debootstrap - wrapper around debootstrap for installing plain Debian

+
+

Synopsis

grml-debootstrap [ options ]

@@ -565,12 +752,14 @@ footnotes: function () { Screenshot

+
+

Introduction

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.

+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 commandline) and invoke +/etc/debootstrap/config (or specify some variables via command line) 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.

@@ -579,26 +768,28 @@ directory) then. Customization of this process is possible as well.

Caution -The grml team does not take responsibility for loss of any data! +The Grml team does not take responsibility for loss of any data! + +

Options and environment variables

---arch <_architecture_> +--arch architecture

- 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"

---bootappend <_appendline for the kernel_> +--bootappend appendline-for-the-kernel

@@ -607,7 +798,7 @@ directory) then. Customization of this process is possible as well.

--c, --config <_file_> +-c, --config file

@@ -615,7 +806,7 @@ directory) then. Customization of this process is possible as well.

---chroot-scripts <_directory_> +--chroot-scripts directory

@@ -626,7 +817,7 @@ directory) then. Customization of this process is possible as well.

--d, --confdir <_path_> +-d, --confdir path

@@ -634,7 +825,7 @@ directory) then. Customization of this process is possible as well.

---debconf <_file_> +--debconf file

@@ -643,7 +834,7 @@ directory) then. Customization of this process is possible as well.

---debopt <_params_> +--debopt params

@@ -651,7 +842,35 @@ directory) then. Customization of this process is possible as well.

---grub <_device_> +--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.filesystem. +

+
+
+--force +
+
+

+ Skip user acknowledgement and do not prompt for user input. +

+
+
+--grmlrepos +
+
+

+ 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. +

+
+
+--grub device

@@ -672,7 +891,7 @@ directory) then. Customization of this process is possible as well.

---hostname <_hostname_> +--hostname hostname

@@ -680,18 +899,26 @@ directory) then. Customization of this process is possible as well.

--i, --iso <_/mntpoint_> +-i, --iso /mntpoint

- 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.

+--insecure +
+
+

+ Do not download and check signatures for retrieved Release files. +

+
+
--keep_src_list
@@ -700,7 +927,7 @@ directory) then. Customization of this process is possible as well.

--m, --mirror <_URL_> +-m, --mirror URL

@@ -725,26 +952,28 @@ directory) then. Customization of this process is possible as well.

---insecure +--nopassword

- 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.

--p, --mntpoint <_/mntpoint_> +-p, --mntpoint /mntpoint

- 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.

---packages <_file_> +--packages file

@@ -753,27 +982,27 @@ directory) then. Customization of this process is possible as well.

---password <_password_> +--password password

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.

--r, --release <_releasename_> +-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_> +--pre-scripts directory

@@ -785,7 +1014,7 @@ directory) then. Customization of this process is possible as well.

---scripts <_directory_> +--scripts directory

@@ -796,7 +1025,7 @@ directory) then. Customization of this process is possible as well.

--t, --target <_target_> +-t, --target target

@@ -815,6 +1044,28 @@ directory) then. Customization of this process is possible as well.

+--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
@@ -828,19 +1079,21 @@ directory) then. Customization of this process is possible as well.

Warning -the commandline parsing of grml-debootstrap does not validate the provided -arguments for the commandline options. Please be careful and check docs and +the command line parsing of grml-debootstrap does not validate the provided +arguments for the command line options. Please be careful and check docs and /etc/debootstrap/config for further information. + +

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.

@@ -853,13 +1106,20 @@ Grub in MBR (master boot record) of /dev/sda and use /dev/sda1 as system partiti 
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.

@@ -867,12 +1127,14 @@ Use specified mirror instead of the default (

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 ISO.

+
+

Files

@@ -901,10 +1163,10 @@ has been installed via [c]debootstrap.

Debian system by default.

-
/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,27 +1180,31 @@ 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).

+
+

Customization

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".

+
+

Automatic installation

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 +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):

@@ -955,8 +1221,8 @@ 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 squeeze. Supported +relases: lenny, squeeze, wheezy and sid. Usage example: release=sid

mirror=...
@@ -970,14 +1236,15 @@ 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

-

Usage example for automatic installation:

+
+

Usage example for automatic installation:

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.

+boot options for grml-debootstrap.
@@ -986,10 +1253,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.
+
+
+

Supported Releases

@@ -1019,10 +1289,10 @@ cellspacing="0" cellpadding="4"> Lenny - works + works [1] - works + works [1] @@ -1038,7 +1308,7 @@ cellspacing="0" cellpadding="4"> - Sid + Wheezy works @@ -1047,6 +1317,17 @@ cellspacing="0" cellpadding="4"> works + + + Sid + + + works [2] + + + works [2] + +
@@ -1056,31 +1337,55 @@ cellspacing="0" cellpadding="4"> Note -
Etch-Release
-

[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.

+
lenny release
+

[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.

+

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.

+
+ + + +
+Note + +
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.

+
+
+
+

Bugs

Probably. Please send bugreports to Michael Prokop <mika@grml.org>.

+
+

See also

debootstrap (8), cdebootstrap (1).

+
+

Author

Michael Prokop <mika@grml.org>

+
-- 2.1.4