X-Git-Url: https://git.grml.org/?p=grml-live.git;a=blobdiff_plain;f=docs%2Fgrml-live.txt;h=c4436e2d5924babde9e86a183fa0366c0579f77b;hp=ad6b8fb8b56b952ddfae7e4464b371e701d58caf;hb=0fbd7ed21b5e8accc0fe9afcef5828303d906448;hpb=121b3484e6301de73a1c5f3cc89ba4997de9ba08 diff --git a/docs/grml-live.txt b/docs/grml-live.txt index ad6b8fb..c4436e2 100644 --- a/docs/grml-live.txt +++ b/docs/grml-live.txt @@ -43,8 +43,7 @@ completely independent at the same time! Please notice that you should have a fast network connection as all the Debian packages will be downloaded and installed via network. If you want to use a local mirror (strongly recommended if you plan to use grml-live more than once) -checkout mkdebmirror (see /usr/share/doc/grml-live/examples/mkdebmirror), -debmirror(1), reprepro(1) (see /usr/share/doc/grml-live/examples/reprepro/ for a +checkout debmirror(1), reprepro(1) (see /usr/share/doc/grml-live/examples/reprepro/ for a sample configuration), apt-cacher(1) and approx(8). To avoid downloading the base system again and again check out <>. @@ -84,12 +83,10 @@ really know that you do not want to update the chroot. Specify the CLASSES to be used for building the ISO via FAI. By default only the classes GRMLBASE, GRML_FULL and I386/AMD64 (depending on system -architecture) are assumed, resulting in a base system of about 350MB -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. +architecture) are assumed. 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 e.g. +GRML_SMALL. [IMPORTANT] All class names should be written in uppercase letters. Do not use a dash, use @@ -256,7 +253,7 @@ Use ZLIB instead of LZMA/XZ compression in mksquashfs part of the build process. Usage examples -------------- -To get a Debian-stable and Grml-based Live-CD using /grml/grml-live +To get a Debian-stable and Grml-based Live-CD using ./grml as build and output directory just run: # grml-live @@ -335,6 +332,14 @@ selected. The following classes are predefined: * DEBORPHAN: get rid of all packages listed in output of deborphan +* FILE_RC: instead of using systemd as init system use file-rc instead. file-rc +was the init system used by Grml until and including stable release 2014.11, +starting with beginning of 2016 Grml switched to systemd instead. If you want to +build a live system in the old style using file-rc instead of systemd then enable +this class. Please notice that support for file-rc is no longer being actively +maintained (the Grml team happily accepts patches though) and file-rc (upstream +wise) might disappear too. + * FRESHCLAM: execute freshclam (if it's present) to update clamav definitions (increases resulting ISO size ~70MB). By default it's skipped to avoid bigger ISO size. @@ -342,12 +347,18 @@ ISO size. * 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. +use this class. Please be aware that using *just* the GRMLBASE class won't be +enough, because the kernel packages (e.g. linux-image-i386-grml + +linux-image-amd64-grml) are chosen in further GRML_* classes (to provide maximum +flexibility with kernel selection). If you don't want to use the existing +GRML_FULL or GRML_SMALL classes, define your own CLASS file choosing the kernel +package you want to use (and don't forget to include your CLASS in the arguments +of grml-live's -c... command line option). * GRML_FULL: full featured Grml, also known as the "normal", full grml as -introduced in December 2011 (~460MB ISO size). +introduced in December 2011 (~600MB ISO size). -* GRML_SMALL: minimum sized Grml version, known as grml-small (~230MB ISO +* GRML_SMALL: minimum sized Grml version, known as grml-small (~300MB ISO size). * LATEX: LaTeX(-related) packages like auctex, texlive,... @@ -475,11 +486,11 @@ please send us a bug report then). Check out <> for details how to set up grml-live on a plain, original Debian system. -* enough free disk space; at least 800MB are required for a minimal grml-live -run (\~400MB for the chroot [$CHROOT_OUTPUT], \~150MB for the build target -[$BUILD_OUTPUT] and \~150MB for the resulting ISO [$ISO_OUTPUT] plus some -temporary files), if you plan to use GRML_FULL you should have at least 4GB of -total free disk space +* enough free disk space; at least 1.5GB are required for a minimal grml-live +run (\~850MB for the chroot [$CHROOT_OUTPUT], \~300MB for the build target +[$BUILD_OUTPUT], \~30MB for the netboot files and \~300MB for the resulting ISO +[$ISO_OUTPUT] plus some temporary files), if you plan to use GRML_FULL you +should have at least 4GB of total free disk space * fast network access for retrieving the Debian packages used for creating the chroot (check out "local mirror" to workaround this problem as far as possible) @@ -548,7 +559,7 @@ Instructions # SQUASHFS_BINARY='/usr/bin/mksquashfs' ## install local files into the chroot # CHROOT_INSTALL="/etc/grml/fai/chroot_install" - ## adjust if necessary (defaults to /grml/grml-live): + ## adjust if necessary (defaults to ./grml/): ## OUTPUT="/srv/grml-live" FAI_DEBOOTSTRAP="jessie http://ftp.debian.org/debian/" # ARCH="amd64"