Synopsis
--------
-grml-debootstrap [ options ]
+grml-debootstrap [ _options_ ]
image:images/screenshot.png[Screenshot]
Options and environment variables
---------------------------------
- -h, --help
+*-h*, *--help*::
+ Show summary of options and exit.
-Show summary of options and exit.
+*-v*, *--version*::
+ Show version of program and exit.
- -v, --version
+*--grub* <_device_>::
+ Where do you want to install grub to? Use grub syntax for specifying.
+ Do not forget to set groot as well. Leave empty to avoid installation of grub.
-Show version of program and exit.
+*--groot* <_device_>::
+ Specify root device for usage in grub (corresponds with $TARGET).
+ Again, use grub syntax for specifying.
+ Corresponding with configuration variable GROOT.
- --grub <device>
+*--boot_append* <_appendline for the kernel_>::
+ Specify appendline for the kernel.
+ E.g. "_pci=nomsi_"
-Where do you want to install grub to? Use grub syntax for specifying.
-Do not forget to set groot as well. Leave empty to avoid installation of grub.
-
- --groot <device>
-
-Specify root device for usage in grub (corresponds with $TARGET).
-Again, use grub syntax for specifying.
-Corresponding with configuration variable GROOT.
-
- -m, --mirror <URL>
-
-Specify mirror which should be used for apt-get/aptitude. Notice that
-specifying the mirror also sets the chrootmirror to the given value.
-Corresponding with configuration variables MIRROR and CHROOTMIRROR.
-
- -p, --mntpoint </mntpoint>
+*-m*, *--mirror* <_URL_>::
+ Specify mirror which should be used for apt-get/aptitude. Notice that
+ specifying the mirror also sets the chrootmirror to the given value.
+ Corresponding with configuration variables MIRROR and CHROOTMIRROR.
-Specify mountpoint that should be used for mounting the target system.
-Corresponding with configuration variable MNTPOINT.
+*-i*, *--iso* <_/mntpoint_>::
+ Specify mountpoint 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
+ 'Usage examples' for a demonstration.
- --password <password>
+*-p*, *--mntpoint* <_/mntpoint_>::
+ Specify mountpoint that should be used for mounting the target system.
+ Corresponding with configuration variable MNTPOINT.
-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.
-It's meant for automatic installation only.
+*--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.
+ It's meant for automatic installation only.
- -r, --release <releasename>
+*-r*, *--release* <_releasename_>::
+ Specify release of new Debian system. Supported releases: sarge, etch, lenny and sid.
+ Corresponding with configuration variable RELEASE.
-Specify release of new Debian system. Supported relases: sarge, etch, lenny and sid.
-Corresponding with configuration variable RELEASE.
-
- -t, --target <target>
-
-Target partition (/dev/...) or directory (anything else without /dev at the
-beginning).
+*-t*, *--target* <_target_>::
+ Target partition (/dev/...) or directory (anything else without /dev at the
+ beginning).
WARNING: the commandline parsing of grml-debootstrap does not validate the provided
arguments for the commandline options. Please be careful and check docs and
Install default Debian release (stable/etch) on /dev/sda3 and install bootmanager
Grub in MBR (master boot record) of /dev/sda and use /dev/sda3 as system partition.
-Use specifed mirror instead of the default (ftp://ftp.debian.de/debian) one.
+Use specified mirror instead of the default (ftp://ftp.debian.de/debian) one.
+
+ mount -o loop /mnt/hda6/debian-40r0-i386-CD-1.iso /mnt/iso
+ grml-debootstrap --target /dev/hda1 --grub hd0 --groot hd0,0 --iso file:/mnt/iso/debian/
+
+Install Debian stable/etch on /dev/hda1 using the loopback mounted Debian-ISO
+for the base-system and install bootmanager Grub in MBR (master boot record) of
+/dev/hda and use /dev/hda1 as system partition. Please notice, that the chroot
+system requires network access for all packages which are not part of the
+ISO.
Files
-----
Defines the software packages which should be installed in the new
Debian system by default.
+ /etc/debootstrap/extrapackages
+
+Debian Packages dropped here will be installed into the new Debian system by
+default (Controlvariable: EXTRAPACKAGES)
+
/etc/debootstrap/stages/
The default directory for storing information about executed stages. Every
into a file named as the function itself if it has been executed successfully.
You can adjust the location of the directory via configuration variable STAGES
via /etc/debootstrap/config. Please notice that you have to remove the stages
-directory on your own if you want to re-execute grml-deboostrap after running it
+directory on your own if you want to re-execute grml-debootstrap after running it
successfully once. This should avoid recurrent execution by error of
grml-debootstrap (which might delete present data).
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.
+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
+take sure that EXTRAPACKAGES is set to "yes".
Automatic installation
----------------------
password=...
-Set passwort of user root without prompting for it but set it to the given
+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: