X-Git-Url: https://git.grml.org/?a=blobdiff_plain;f=docs%2Fgrml-live.txt;h=14b492b3fad7c3e13bad143f7f11083245b3bb87;hb=5984c749460d7fc5840a6ba4d63b997245b32ce8;hp=003589cc654b6b0e74bbe639e3804b651b9daa6d;hpb=02f2d2167c9489eb19d068b8265858515b5416e9;p=grml-live.git diff --git a/docs/grml-live.txt b/docs/grml-live.txt index 003589c..14b492b 100644 --- a/docs/grml-live.txt +++ b/docs/grml-live.txt @@ -46,9 +46,9 @@ Options -c **CLASSES**:: -Specify the CLASSES to be used for building the ISO via fai. -By default only the class GRML is assumed, resulting in a small base system (being -about ~170MB ISO size). +Specify the CLASSES to be used for building the ISO via fai. By default only +the classes GRML and I386 are assumed, resulting in a small base system (being +about ~150MB ISO size). -t **TARGET_DIRECTORY**:: @@ -63,29 +63,22 @@ Force execution and do not display summary of configuration details. Display short usage information and exit. - additional_arguments_for_fai:: - -Any additional argument(s) to grml-live will be given to the FAI commandline -(being basically "fai dirinstall ...). This might become a temporary solution -(due to security reasons), if you need an option please let us know so we can -implement it. - How to get your own live-cd - the easy, fast and simple way ----------------------------------------------------------- -To get a small, Debian-stable and grml based live-cd: +To get a small, Debian-stable and grml based live-cd using /dev/shm/ +as build and output directory: - # TARGET="/grml/grml_uncompressed" - # CDDIR="/grml/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 . + # grml-live + +[NOTE] -(TODO: provide the content of /grml/chroot/grml_cd through the package -grml-live, in the meanwhile get the content from a current grml-ISO) +If you have about 700MB of free space inside /dev/shm (being a tmpfs, usually +you have >=1GB of RAM) just run "mount -o remount,suid,dev,rw /dev/shm" and use +/dev/shm as build and output directory - resulting in very fast build process. +But please be aware of the fact that rebooting your system will result in an +empty /dev/shm, so please another directory for $CHROOT_TARGET, $BUILD_TARGET +and $ISO_TARGET if you plan to create more persistent output. :) The class concept ----------------- @@ -96,8 +89,9 @@ the simplicity in the build process. The main and base class provided by grml-live is named GRML. It's strongly recommended to **always** use the class GRML when building an ISO using -grml-live. The following files and directories are relevant for class GRML by -default: +grml-live as well as the architecture dependend class (being 'I386' for x86_32 +currently only). The following files and directories are relevant for class GRML +by default: /etc/grml/fai/config/scripts/GRML/ /etc/grml/fai/config/debconf/GRML @@ -143,11 +137,11 @@ out-of-the-box so you shouldn't have to configure anything in this file. /etc/grml/fai/make-fai-nfsroot.conf -TODO +TODO: documentation /etc/grml/fai/NFSROOT -TODO +TODO: documentation /etc/grml/fai/apt/sources.list @@ -201,7 +195,10 @@ Requirements for the build system * any Debian based system should be sufficient (if not please send a bug report), for example a grml2hd harddisk installation ships all you need -* enough free disk space, at least 1GB are required for a minimal grml-live run +* enough free disk space; at least 800MB are required for a minimal grml-live +run (\~400MB for the chroot [$CHROOT_TARGET], \~150MB for the build target +[$BUILD_TARGET] and \~150MB for the resulting ISO [$ISO_TARGET] plus some +temporary files) * fast network access for retreiving the Debian packages used for creating the chroot (check out "local mirror" and "NFSROOT" to workaround this problem as far @@ -210,17 +207,42 @@ as possiblbe) Known TODOs ----------- -* extend the grml-live wrapper script so it runs all the necessary command in a -single run (boot/isolinux, mksquashfs and mkisofs stuff is missing currently) +* do not use /dev/shm/ als default target directory (which one do we want to use +instead?) + +* add support for amd64 [gebi?] + ppc [formorer?] (and identify all packages +that are arch specific so we have a clean package list in all classes) + +* support different grml-flavours through classes right out-of-the-box (being: +grml, grml64, grml-small for at least x86, amd64 and ppc) [currently it defaults +to Debian/stable I386] + +* support setting grml-live configuration on the command line to provide +different flavours using the commandline only -* really support signed apt repositories +* really support signed apt repositories (currently it's deactivated via fai's +dirinstall for some packages) * explain (and provide configuration for) the use of NFSROOT -* support setting stuff like ISO name, version,... +* support setting stuff like ISO name, version,... (especially for stuff inside +x86_files/boot/isolinux) + +* support "final builds" (including stuff like md5sums) + +* use hooks of FAI as far as possible in all grml-live scripts + +* the grml-live class(es) should send output as used inside FAI as well (so it's +not as verbose unless you specify it, make it configurable) + +* provide possibility for cleanup of all created build directories + +* support hooks to further allow customisation of the build process + +* support nocolor-option for /etc/grml/fai/grml/grml_cleanup_chroot -* support different flavours and architectures of Debian (currently it defaults -to Debian/stable x86_32) +* copy files from $FAI_CONFIGDIR/... instead of using 'cat > $FILE << EOF ...' +inside all the /etc/grml/fai/config/scripts/GRML/-scripts Bugs ---- @@ -232,3 +254,6 @@ Authors ------- Michael Prokop . +///////////////////////////////////// +// vim:ai tw=80 ft=asciidoc expandtab +/////////////////////////////////////