X-Git-Url: http://git.grml.org/?p=grml-live.git;a=blobdiff_plain;f=docs%2Fgrml-live.txt;h=a525e6efe97c803959106294a7026d7f8b308644;hp=eee2d2faf09df34740d817cf7cecb20176097f66;hb=220ee724598d82ded6a43144f0c10e7cb927abeb;hpb=c9141f43791a61b6bce79fa3963791f96dd78f04 diff --git a/docs/grml-live.txt b/docs/grml-live.txt index eee2d2f..a525e6e 100644 --- a/docs/grml-live.txt +++ b/docs/grml-live.txt @@ -86,12 +86,13 @@ really know that you do not want to update the chroot. -c **CLASSES**:: Specify the CLASSES to be used for building the ISO via FAI. By default only -the classes GRMLBASE, GRML_MEDIUM and I386 are assumed, resulting in a small base -system (being about ~180MB 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 -<> for details about available classes). -So instead of GRML_MEDIUM you can also use GRML_SMALL and GRML_FULL. +the classes GRMLBASE, GRML_FULL and I386/AMD64 (depending on system +architecture) are assumed, resulting in a small base system (being about ~180MB +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 <> for +details about available classes). So instead of GRML_FULL you can also use +GRML_SMALL and GRML_FULL. [IMPORTANT] All class names should be written in uppercase letters. Do not use a dash, use @@ -240,18 +241,18 @@ 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 -s sid -c GRMLBASE,GRML_SMALL,I386 -o /home/mika/grml-live + # grml-live -s sid -c GRMLBASE,GRML_SMALL,AMD64 -o /home/mika/grml-live -To get a medium sized, Debian-unstable and grml-based Live-CD for i386 +To get a medium sized, Debian-unstable and grml-based Live-CD for amd64 architecture using /grml/grml-live as build and output directory just run: - # grml-live -s sid -a i386 -c GRMLBASE,GRML_MEDIUM,I386 + # grml-live -s sid -a amd64 -c GRMLBASE,GRML_FULL,AMD64 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 /tmp/grml_isos) just invoke: - # grml-live -o /tmp -c GRMLBASE,GRML_SMALL,I386 -s sid -i grml_0.0-3.iso + # grml-live -o /tmp -c GRMLBASE,GRML_SMALL,AMD64 -s sid -i grml_0.0-3.iso [NOTE] @@ -306,9 +307,9 @@ files/directories. If you want to use your own configuration, extend an existing configuration and/or add additional packages to your ISO just invent a new class (or extend an existing one). For example if you want to use your own class named "FOOBAR" just -set CLASSES="GRMLBASE,GRML_SMALL,I386,FOOBAR" inside /etc/grml/grml-live.local +set CLASSES="GRMLBASE,GRML_SMALL,AMD64,FOOBAR" inside /etc/grml/grml-live.local or invoke grml-live using the classes option: "grml-live -c -GRMLBASE,GRML_SMALL,I386,FOOBAR ...". +GRMLBASE,GRML_SMALL,AMD64,FOOBAR ...". More details regarding the class concept can be found in the documentation of FAI itself (being available at /usr/share/doc/fai-doc/). @@ -326,18 +327,21 @@ selected. The following classes are predefined: * DEBORPHAN: get rid of all packages listed in output of 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 +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_FULL: full featured grml, also known as the "normal", full grml. +* GRML_FULL: full featured grml, also known as the "normal", full grml as +introduced in november 2011 (~350MB ISO size). -* GRML_MEDIUM: medium sized grml version, known as grml-medium +* GRML_MEDIUM: medium sized grml version, used to be known as grml-medium +until november 2011 (~220MB ISO size). -* GRML_POWERPC: grml for PowerPC architecture, not supported yet (still work in -progress) +* GRML_SMALL: minimum sized grml version, known as grml-small (~110MB ISO +size). -* GRML_SMALL: minimum sized grml version, known as grml-small +* GRML_XL: large size Grml version, used to be known as "full grml" until +november 2011 (~700MB ISO size). * LATEX: LaTeX(-related) packages like auctex, texlive,... (which used to be shipped by grml before the LaTeX removal) @@ -448,10 +452,10 @@ installation process. Directory with lists of software packages to be installed or removed. The different classes describe what should find its way to your ISO. When running -"grml-live -c GRMLBASE,GRML_SMALL,I386 ..." only the configuration of GRMLBASE, -GRML_SMALL and and I386 will be taken. If you use 'grml-live -c -GRMLBASE,GRML_SMALL,I386,FOOBAR ...' then the files of GRMLBASE, GRML_SMALL, -I386 **plus** the files from FOOBAR will be taken. So just create a new class to +"grml-live -c GRMLBASE,GRML_SMALL,AMD64 ..." only the configuration of GRMLBASE, +GRML_SMALL and and AMD64 will be taken. If you use 'grml-live -c +GRMLBASE,GRML_SMALL,AMD64,FOOBAR ...' then the files of GRMLBASE, GRML_SMALL, +AMD64 **plus** the files from FOOBAR will be taken. So just create a new class to adjust the package selection according to your needs. Please notice that the directory GRMLBASE contains a package list defining a minimum but still reasonable package configuration. @@ -746,7 +750,7 @@ plain, original Debian installation is supported as well. So there we go. What we have: plain, original Debian Lenny (5.0). -What we want: build a grml-medium ISO based on Debian/squeeze for the i386 +What we want: build a grml-medium ISO based on Debian/squeeze for the amd64 architecture using grml-live. [IMPORTANT] @@ -808,7 +812,7 @@ Instructions ## OUTPUT="/srv/grml-live" FAI_DEBOOTSTRAP="squeeze http://cdn.debian.net/debian/" ARCH="i386" - CLASSES="GRMLBASE,GRML_MEDIUM,I386" + CLASSES="GRMLBASE,GRML_FULL,AMD64" # PRESERVE_LOGFILE='1' # ZERO_FAI_LOGFILE='1' GRML_LIVE_SOURCES=" @@ -951,7 +955,7 @@ Just create a new class (using the package_config directory): and specify it when invoking grml-live then: - # grml-live -c GRMLBASE,GRML_SMALL,I386,MIKA + # grml-live -c GRMLBASE,GRML_SMALL,AMD64,MIKA [[reset-grml-live-configuration]] I fscked up my grml-live configuration. How do I reset it to the defaults?