X-Git-Url: https://git.grml.org/?a=blobdiff_plain;f=docs%2Fgrml-live.txt;h=41046d3f51b5fab0ab43e21b6bc132ec9f20115c;hb=53adee4dd5e3ed3ef87bac3390cbcbce31be9dec;hp=45c5278fb2cf52cc2a823f69430d109b2b1eddbb;hpb=de6d7ed3e096db257ca1434c895ff69e3b0ef481;p=grml-live.git diff --git a/docs/grml-live.txt b/docs/grml-live.txt index 45c5278..41046d3 100644 --- a/docs/grml-live.txt +++ b/docs/grml-live.txt @@ -26,15 +26,22 @@ FAI uses a class based system. This gives you the flexibility to choose the packages you would like to include on your very own live-cd without having to deal with all the details in the core of the system. +Please notice that you should have a fast network connection as all the Debian +packages will be installed via network. If you want to use a local mirror +checkout +link:http://www.informatik.uni-koeln.de/fai/download/mkdebmirror[mkdebmirror] +and debmirror. + How to get your own live-cd - the easy, fast and simple way ----------------------------------------------------------- To get a small, Debian-stable and grml based live-cd: - # TARGET="/grml/chroot/grml_uncompressed" ; mkdir -p $TARGET - # fai -v -C /etc/grml/fai -cGRML dirinstall $TARGET - # mksquashfs $TARGET/* /grml/chroot/grml_cd/live/grml.squashfs -noappend - # cd /grml/chroot/grml_cd/ + # TARGET="/grml/chroot/grml_uncompressed" + # CDDIR="/grml/chroot/grml_cd" + # grml-live -c GRML -t $TARGET + # mksquashfs $TARGET/* $CDDIR/live/grml.squashfs -noappend + # cd $CDDIR # mkisofs -V "my personal grml" -l -r -J -no-emul-boot -boot-load-size 4 \ -boot-info-table -c boot/isolinux/boot.cat \ -b boot/isolinux/isolinux.bin -o /grml/grml.iso . @@ -54,6 +61,11 @@ like check out /usr/share/doc/fai-doc/examples/simple/ (provided by Debian packa fai-doc). /usr/share/doc/fai-doc/fai-guide.html/ch-config.html also provides documentation regarding configuration possibilities. + /usr/sbin/grml-live + +Script for the main build process (being a wrapper around FAI currently). +Requires root permissions for execution. + /etc/grml/fai/fai.conf Main configuration file which specifies where all the configuration files and @@ -61,6 +73,20 @@ scripts for FAI/grml-live can be found. By default it is FAI_CONFIGDIR=/etc/grml/fai/config, a directory shipped by grml-live out-of-the-box so you shouldn't have to configure anything in this file. + /etc/grml/fai/make-fai-nfsroot.conf + +TODO + + /etc/grml/fai/NFSROOT + +TODO + + /etc/grml/fai/apt/sources.list + +This file specifies which mirrors should be used for retreiving the Debian +packages used for creating the ISO. If you want to use a local mirror you have +to adjust this file. + /etc/grml/fai/config/ The main directory for configuration of FAI/grml-live. More details below. @@ -72,7 +98,7 @@ FAI classes. /etc/grml/fai/config/debconf/ -This directory provides the files for presseding/configuration of debconf +This directory provides the files for preseeding/configuration of debconf through files. /etc/grml/fai/config/hooks/ @@ -84,21 +110,42 @@ installation process. /etc/grml/fai/config/package_config/ File with lists of software packages to be installed or removed. The different -classes describe what should find its way to your ISO. When running 'fai -v --cGRML dirinstall ...' only the files from the directory GRML/ will be taken, if -you use 'fai -v -cGRML,FOOBAR dirinstall ...' then the files of GRML/ **plus** -the files from FOOBAR/ will be taken. So just create a new class to adjust it to -your needs. Please notice that the directory GRML contains a package list -defining a minimum but still reasonable package configuration. +classes describe what should find its way to your ISO. When running 'fai -v -C +/etc/grml/fai -cGRML dirinstall ...' only the files from the directory GRML/ +will be taken, if you use 'fai -v -C /etc/grml/fai -cGRML,FOOBAR dirinstall ...' +then the files of GRML/ **plus** the files from FOOBAR/ will be taken. So just +create a new class to adjust it to your needs. Please notice that the directory +GRML contains a package list defining a minimum but still reasonable package +configuration. /etc/grml/fai/config/scripts/ Scripts for customising the ISO within build process. + /etc/grml/fai/live-initramfs/ + +This directory provides the files used for building the initramfs/initrd via +live-initramfs(8). + +TODO +---- + +* provide a wrapper script which runs all the necessary command in a single run +(/usr/sbin/grml-live and /etc/grml/grml-live.conf are work in progress) + +* support signed apt repositories + +* provide buildprocess for boot/isolinux stuff + +* explain and provide configuration for use of NFSROOT + Bugs ---- -Please report feedback, link:http://grml.org/bugs/[bugreports] and wishes link:http://grml.org/contact/[to us]! + +Please report feedback, link:http://grml.org/bugs/[bugreports] and wishes +link:http://grml.org/contact/[to the grml-team]! Authors ------- Michael Prokop . +