X-Git-Url: https://git.grml.org/?p=grml-live.git;a=blobdiff_plain;f=docs%2Fgrml-live.txt;h=2c79417836199dff9baae961acb45f8a3277490a;hp=94a22d474105a5f0cd9ed2039dc11ea99205f3ee;hb=eaf2b9631232f9d4c1d593f922e2c4c8cf125302;hpb=c6f2a325e4cd41d6b21f6b7b0f60e34b9bbab82d diff --git a/docs/grml-live.txt b/docs/grml-live.txt index 94a22d4..2c79417 100644 --- a/docs/grml-live.txt +++ b/docs/grml-live.txt @@ -15,9 +15,16 @@ grml-live [-a ] [-c ] [-g ] [-i ] ] [-v ] [-bFVhuz] ******************************************************************************* -Important! This document is growing as requested. If you have questions which +Important: squashfs-tools in Debian (version 1:3.3-6 for example) currently +don't work as expected for grml-live. Please install grml's version 1:3.2r2-9exp1 from +http://grml.org/squashfs/squashfs-tools_3.2r2-9exp1_i386.deb (for x86) or +http://grml.org/squashfs/squashfs-tools_3.2r2-9exp1_amd64.deb (for amd64) +on your build-system instead. +******************************************************************************* + +******************************************************************************* +Notice! This document is growing as requested. If you have questions which aren't answered by this document yet please let me know: ! -This document currently applies to grml-live version 0.0.13. ******************************************************************************* Description @@ -58,17 +65,18 @@ Options -a **ARCHITECTURE**:: Use the specified architecture instead of the currently running one. This -allows building a 32bit system on a 64bit host. Please notice that real +allows building a 32bit system on a 64bit host (though you can't build a 64bit +system on a 32bit system/kernel of course). Please notice that real crosscompiling (like building a ppc system on x86) isn't possible due to the -nature and the need of working in a chroot. +nature and the need of working in a chroot. Currently supported values: i386 +and amd64. -b:: Build the ISO without updating the chroot via FAI. This option is useful for example when working on stable releases: if you have a working base system/chroot and do not want to execute any further updates (via "-u" option) -but intend to only build the ISO. (Notice: This option requires a feature within -FAI which is not yet part of the official FAI release yet.) +but intend to only build the ISO. -c **CLASSES**:: @@ -77,8 +85,8 @@ the classes GRMLBASE, GRML_SMALL and I386 are assumed, resulting in a small base system (being about ~150MB total ISO size). If using a non-I386 system (like amd64) you should specify the appropriate architecture as well. Additionally you can specify a class providing a grml-kernel (see -/etc/grml/fai/config/package_config/ for a full list). So instead of GRML_SMALL -you can also use GRML_MEDIUM and GRML_FULL instead. +<> for details about available classes). +So instead of GRML_SMALL you can also use GRML_MEDIUM and GRML_FULL. -C **CONFIGURATION_FILE**:: @@ -103,6 +111,8 @@ Force execution and do not prompt for acknowledgment of configuration. -g **GRML_NAME**:: Set the grml flavour name. Common usage examples: grml, grml-small, grml64. +Please do NOT use blanks and any special characters like '/', ';' inside +GRML_NAME, otherwise you might notice problems with booting. -h:: @@ -162,7 +172,12 @@ as build and output directory just run: To get a small Debian-unstable and grml-small based Live-CD using /home/mika/grml-live as build and output directory just use: - # grml-live -c GRMLBASE,GRML_SMALL,I386 -o /home/mika/grml-live + # grml-live -s sid -c GRMLBASE,GRML_SMALL,I386 -o /home/mika/grml-live + +To get a medium sized, Debian-unstable and grml-based Live-CD for i386 +architecture using /grml/grml-live as build and output directory just run: + + # grml-live -s sid -a i386 -c GRMLBASE,GRML_MEDIUM,I386 To get a small, Debian-unstable and grml-based Live-CD using /tmp as build and output directory and use grml_0.0-3.iso as ISO name (placed inside @@ -176,7 +191,7 @@ If you have about 700MB of free space inside /dev/shm (being a tmpfs, usually you should 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_OUTPUT, +in an empty /dev/shm, so please use another directory for $CHROOT_OUTPUT, $BUILD_OUTPUT and $ISO_OUTPUT if you plan to create more persistent output. :) Main features of grml-live @@ -228,10 +243,32 @@ option: "grml-live -c GRMLBASE,GRML_SMALL,I386,FOOBAR ...". More details regarding the class concept can be found in the documentation of FAI itself (being available at /usr/share/doc/fai-doc/). +[[X7]] Available classes ----------------- -Documentation to be done... +The package selection part of the classes can be found in +/etc/grml/fai/config/package_config whereas some further classes are defined for +example in /etc/grml/fai/config/scripts/ so specific feature sets can be +selected. The following classes are predefined: + +* DEBORPHAN: +* GRMLBASE: the main class responsible for getting a minimal subset of what's +defining a grml system. Important parts of the buildprocess are specified in +this class as well, so unless you have a really good reason you should always +use this class. +* GRML_FORENSIC: tools for forensic investigations which has been created +by people from link:http://www.forensic-geeks.org/[forensic-geeks.org]. +* GRML_FULL: full featured grml, also know as the "normal", full grml. +* GRML_MEDIUM: +* GRML_POWERPC: +* GRML_SMALL: +* LATEX_CLEANUP: +* LOCALES: +* NO_ONLINE: +* RELEASE: +* REMOVE_DOCS: +* XORG: Files ----- @@ -364,10 +401,10 @@ FAQ Help, I'm using Debian etch and I don't have FAI version >3.2 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - wget http://www.informatik.uni-koeln.de/fai/download/etch/fai-client_3.2.3_all.deb \ - http://www.informatik.uni-koeln.de/fai/download/etch/fai-server_3.2.3_all.deb \ - http://www.informatik.uni-koeln.de/fai/download/etch/fai-doc_3.2.3_all.deb - dpkg -i fai-client_3.2.3_all.deb fai-server_3.2.3_all.deb fai-doc_3.2.3_all.deb + wget http://www.informatik.uni-koeln.de/fai/download/etch/fai-client_3.2.6_all.deb \ + http://www.informatik.uni-koeln.de/fai/download/etch/fai-server_3.2.6_all.deb \ + http://www.informatik.uni-koeln.de/fai/download/etch/fai-doc_3.2.6_all.deb + dpkg -i fai-client_3.2.6_all.deb fai-server_3.2.6_all.deb fai-doc_3.2.6_all.deb or check out the link:http://www.informatik.uni-koeln.de/fai/[FAI-homepage] for further details.