[[current-versions]]
include::grml-autoconfig.current.txt[]
-Permanently adjust boot parameters
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-As you probably know you can adjust boot parameters on the bootprompt. You want
-to set some boot parameters permanently? That's possible via adding a directory
-named 'bootparams' to the Grml ISO which has to be located at the root-directory
-/bootparams/ (note: the directory is known as /lib/live/mount/medium/bootparams/ on a
-_running_ Grml system then). Place a textfile inside the directory containing
-the boot parameters which should be appended to default ones (this corresponds
-to booting without any special parameters).
-
- mkdir bootparams
- echo lang=de > bootparams/my_bootparams
-
-Then burn a multisession CD where directory bootparams is located in the root
-directory of the CD.
-
-[NOTE]
-Not all boot parameters can be used via /bootparams/. This is a limitation of
-the way the kernel and userspace retrieve boot parameters. Boot parameter
-regarding the kernel definitely do *NOT* work. Boot parameter related to
-grml-autoconfig (the main part of the boot process in Grml running in userspace,
-being all the stuff after startup of udev) are expected to work. Boot parameter
-related to initrd/initramfs (the part between 'Searching for GRML file' and
-startup of udev) are *NOT* covered by /bootparams/ as well yet.
-
-TIP: the application k3b (not available on the live-CD but available through the
-Debian repositories) provides an easy to use interface for doing the
-multisession task.
-
[[X7]]
Usage scenarios
---------------
You are a fan of the editor vim? Great. You probably have your own ~/.vimrc and
want to use it on the Grml system. You also don't like the default zsh
-configuration and want to use your own ~/.zshrc? How to procede? Copy your
+configuration and want to use your own ~/.zshrc? How to proceed? Copy your
.vimrc and .zshrc to $HOME of user 'grml'. Place additional files in
$HOME/config. Now create a configuration for your files running:
Run your own commands on startup
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-You know that booting with 'grml services=foobar' executes /etc/init.d/foobar
-when booting Grml. But you want to setup a more complex network configuration,
-adjust some other stuff and so on on your own? Just write a script named grml.sh
-which does the job and use own of the mentioned bootparams. Let's say you have
-placed grml.sh on your usb device (usb stick) then use the following commandline
-on bootprompt:
+You know that booting with 'grml services=foobar' executes
+/etc/init.d/foobar when booting Grml. But you want to setup a more
+complex network configuration, adjust some other stuff and so on, on
+your own? Just write a script named grml.sh which does the job and use
+one of the mentioned boot parameters. Let's say you have placed grml.sh
+on your usb device (usb stick) then use the following commandline on
+bootprompt:
grml myconfig=/dev/sda1
Or even better: create a device with label GRMLCFG running (adjust /dev/sdX1
according to your needs):
- mkfs.ext3 -L GRMLCFG /dev/sdX1 # warning: this destroys all data from /dev/sdX1
+ mkfs.ext3 -L GRMLCFG /dev/sdX1 # warning: this destroys all data on /dev/sdX1
TIP: several filesystems provide the possibility to provide a label. For
example FAT provides this through: 'mkfs.vfat -n GRMLCFG /dev/sda1' (attention:
this will destroy data on /dev/sda1 of course!). Take a look at the
documentation/manpage of the filesystem you want to use.
-Now place your configuration archive (see save-config and the other usage
-scenarios) and the script grml.sh on the device. Now you can boot your system
-without specifying any bootparameters on bootprompt because devices labeled with
-GRMLCFG are mounted readonly and used by default. If you did not label your
-device you can use the device anyway using 'grml myconfig=/dev/sdX' (adjust
-/dev/sdX) on the bootprompt.
+Now place your configuration archive (see save-config and the other
+usage scenarios) and the script grml.sh on the device. Now you can boot
+your system without specifying any boot parameters on bootprompt because
+devices labeled with GRMLCFG are mounted readonly and used by default.
+If you did not label your device you can use the device anyway using
+'grml myconfig=/dev/sdX' (adjust /dev/sdX) on the bootprompt.
Debug remote systems
~~~~~~~~~~~~~~~~~~~~
Or you put a grml.iso file on your hard disk (maybe in /boot/grml) or on an USB
stick, use grub to boot from there and place debs, configuration scripts or Grml
-configuraton archives alongside the .iso.
+configuration archives alongside the .iso.
Bugs
----