X-Git-Url: https://git.grml.org/?a=blobdiff_plain;f=docs%2Fgrml-live.txt;h=455889f959117a7054d438f8c62ac2cd499c771b;hb=b47433a3c158d7d761a9c239bbdf8181d1e99092;hp=2c7feb3f92be5540831eaabeef38fed476fbc4ea;hpb=6c2fffeba931ee69cbf8c3c85260bbfb79a36b08;p=grml-live.git diff --git a/docs/grml-live.txt b/docs/grml-live.txt index 2c7feb3..455889f 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 <>. @@ -203,7 +202,7 @@ Specify name of the release. Specify the Debian suite you want to use for your live-system. If unset defaults to "testing". Supported values are: stable, testing, unstable (or their -corresponding release names like "jessie"). Please be aware that recent Debian +corresponding release names like "stretch"). Please be aware that recent Debian suites might require a recent base.tgz (${GRML_FAI_CONFIG}/config/basefiles/$CLASSNAME.tar.gz) or a recent version of debootstrap. @@ -254,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 @@ -349,12 +348,11 @@ ISO size. 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. 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). +enough, because the kernel packages (e.g. linux-image-*) 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 (~600MB ISO size). @@ -452,7 +450,7 @@ 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,AMD64 ..." only the configuration of GRMLBASE, -GRML_SMALL and and AMD64 will be taken. If you use 'grml-live -c +GRML_SMALL 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 @@ -518,9 +516,9 @@ The easiest way to get a running grml-live setup is to just use Grml. Of course using grml-live on a plain, original Debian installation is supported as well. So there we go. -What we have: plain, original Debian jessie (8.x). +What we have: plain, original Debian stretch (9.x). -What we want: build a Grml ISO based on Debian/jessie for the amd64 architecture +What we want: build a Grml ISO based on Debian/stretch for the amd64 architecture using grml-live. Instructions @@ -560,9 +558,9 @@ 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/" + FAI_DEBOOTSTRAP="stretch http://ftp.debian.org/debian/" # ARCH="amd64" CLASSES="GRMLBASE,GRML_FULL,AMD64" EOF @@ -679,7 +677,7 @@ FAI_DEBOOTSTRAP: [...] APT_PROXY="http://localhost:3142/" [...] - FAI_DEBOOTSTRAP="jessie http://localhost:3142/ftp.debian.org/debian jessie main contrib non-free" + FAI_DEBOOTSTRAP="stretch http://localhost:3142/ftp.debian.org/debian stretch main contrib non-free" Make sure apt-cacher-ng is running ('/etc/init.d/apt-cacher-ng restart'). That's it. All downloaded files will be cached in /var/cache/apt-cacher-ng then. @@ -707,7 +705,7 @@ How do I create a base tar.gz (I386.tar.gz or AMD64.tar.gz) First of all create the chroot using debootstrap (requires root): BASECHROOT='/tmp/basefile' # path where the chroot gets generated - SUITE='jessie' # using the current stable release should always work + SUITE='stretch' # using the current stable release should always work debootstrap --exclude=info,tasksel,tasksel-data "$SUITE" "$BASECHROOT" http://ftp.debian.org/debian tar -C "$BASECHROOT" --exclude='var/cache/apt/archives/*.deb' -zcf "${SUITE}".tar.gz ./ @@ -813,6 +811,7 @@ Usage example: # export GRML_FAI_CONFIG=$(pwd)/etc/grml/fai # export SCRIPTS_DIRECTORY=$(pwd)/scripts + # export TEMPLATE_DIRECTORY=$(pwd)/templates # ./grml-live -s sid -a amd64 -c GRMLBASE,GRML_FULL,AMD64 [[source]]