X-Git-Url: https://git.grml.org/?p=grml-debootstrap.git;a=blobdiff_plain;f=grml-debootstrap.8.txt;h=1d181a8fe3d137b3526992e79ef80960820a1b13;hp=e04624e7c5fee64271c195ac2d0679ab104d1fb2;hb=b4bbe9397b5ca4ff0ee130c0333128081cae91ff;hpb=854ae66b8bcf6287ed4cb3112423aa5dd73d7268 diff --git a/grml-debootstrap.8.txt b/grml-debootstrap.8.txt index e04624e..1d181a8 100644 --- a/grml-debootstrap.8.txt +++ b/grml-debootstrap.8.txt @@ -7,7 +7,7 @@ grml-debootstrap - wrapper around debootstrap for installing plain Debian via gr Synopsis -------- -grml-debootstrap [ options ] +grml-debootstrap [ _options_ ] image:images/screenshot.png[Screenshot] @@ -31,51 +31,53 @@ CAUTION: The grml team does not take responsibility for loss of any data! 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 +*--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 - -Specify root device for usage in grub (corresponds with $TARGET). -Again, use grub syntax for specifying. -Corresponding with configuration variable GROOT. - - -m, --mirror - -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 +*-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 +*-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 +*-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 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 @@ -103,7 +105,16 @@ any bootloader). 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 ----- @@ -127,6 +138,11 @@ Defines the default locales used for generating locales via locale-gen. 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 @@ -134,7 +150,7 @@ single function of grml-debootstrap will write 'done' to the stages directory 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). @@ -148,7 +164,9 @@ 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. +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 ---------------------- @@ -189,7 +207,7 @@ Usage example: mirror=ftp://ftp.tugraz.at/mirror/debian 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: