X-Git-Url: https://git.grml.org/?p=grml-live.git;a=blobdiff_plain;f=docs%2Fgrml-live.txt;h=192aa4cf98273b05944b47d84af9b5fcc03d88e7;hp=c9c73716dcf44d755569339315972235666e2e53;hb=05a12f526922e6ce24e6023c72596b49ec1f5480;hpb=5bfdcecb4c2ff08416a8c5262efa9bdc814008c2 diff --git a/docs/grml-live.txt b/docs/grml-live.txt index c9c7371..192aa4c 100644 --- a/docs/grml-live.txt +++ b/docs/grml-live.txt @@ -10,9 +10,10 @@ Linux Live system (CD/ISO) Synopsis -------- -grml-live [-a ] [-c ] [-C ] [-g -] [-i ] [-o ] [-r ] [-s -] [-t ] [-v ] [-U ] [ +grml-live [-a ] [-c ] [-C ] [ +-e ] [-g ] [-i ] [ +-o ] [-r ] [-s ] [ +-t ] [-v ] [-U ] [ -AbBFnNqQuVz] Description @@ -53,8 +54,8 @@ Options -A:: -Clean up output directories before attempting the build. Packs the chroot -into a tar archive, and removes chroot and ISO build directories before exiting. +Clean up all output directories before running the build process. After finishing, +clean up the Chroot target and Build target directories. -a **ARCHITECTURE**:: @@ -132,6 +133,11 @@ grml-live this option provides you the option to use your own configuration directory. This directory is what's being referred to as ${GRML_FAI_CONFIG} throughout this documentation. + -e **EXTRACT_ISO_NAME**:: + +The squashfs inside the specified ISO will be extracted and used as the chroot. +This option is useful for remastering, in combination with -A and -b or -u. + -F:: Force execution and do not prompt for acknowledgment of configuration. @@ -208,11 +214,6 @@ debootstrap. Specify place of the templates used for building the ISO. By default (and if not manually specified) this is /usr/share/grml-live/templates/. - -T **CHROOT_ARCHIVE**:: - -Unpack chroot tar archive before starting. Most useful in combination with --A and -b or -u. - -u:: Update existing chroot instead of rebuilding it from scratch. This option is @@ -251,12 +252,10 @@ system: [NOTE] -If you have enough 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 use another directory for $CHROOT_OUTPUT, -$BUILD_OUTPUT and $ISO_OUTPUT if you plan to create more persistent output. :) +If you have enough RAM, just run "mount -t tmpfs none /mnt/ramdisk" to get a +tmpfs ("RAMDISK"), and use /mnt/ramdisk as build and output directory - this +results in a very fast build process. Note that these files will be gone when +rebooting. [[main-features]] Main features of grml-live @@ -504,7 +503,8 @@ 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 squeeze (6.0). +What we have: plain, original Debian squeeze (6.0) with debian-backports +enabled. (This is important for squashfs-tools.) What we want: build a Grml ISO based on Debian/wheezy for the amd64 architecture using grml-live. @@ -524,17 +524,6 @@ Instructions # deb-src http://deb.grml.org/ grml-testing main EOF - # adjust apt-pinning (only prefer squashfs stuff from grml): - cat >> /etc/apt/preferences << EOF - Package: * - Pin: origin deb.grml.org - Pin-Priority: 1 - - Package: squashfs-tools - Pin: origin deb.grml.org - Pin-Priority: 996 - EOF - # get keyring for apt: apt-get update apt-get --allow-unauthenticated install grml-debian-keyring @@ -542,12 +531,12 @@ Instructions # optionally(!) install basefile so we don't have to build basic # chroot from scratch, grab from http://daily.grml.org/ # mkdir -p /etc/grml/fai/config/basefiles/ - # mv base.tgz /etc/grml/fai/config/basefiles/I386.tar.gz - # mv base64.tgz /etc/grml/fai/config/basefiles/AMD64.tar.gz + # mv I386.tar.gz /etc/grml/fai/config/basefiles/ + # mv AMD64.tar.gz /etc/grml/fai/config/basefiles/ # install relevant tools - # please check out http://grml.org/grml-live/#current_state when encountering problems! - apt-get -o APT::Install-Recommends=false install grml-live squashfs-tools + apt-get install -t squeeze-backports squashfs-tools + apt-get --no-install-recommends install grml-live # adjust grml-live configuration for our needs: cat > /etc/grml/grml-live.local << EOF @@ -758,49 +747,6 @@ And finally place the generated tarball in /etc/grml/fai/config/basefiles/ (note that it needs to be uppercase letters matching the class names, so: AMD64.tar.gz for amd64 and I386.tar.gz for i386). -[[autobuild]] -How do I set up an autobuild environment? -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -If you want to set up a system like link:http://daily.grml.org/[daily.grml.org] -the Debian package grml-live-buildd provides all you need to start. Start with -figuring out the cron job script /usr/share/grml-live/buildd/cronjob.sh. - -If you want to automatically update the grml-live Debian package on your build -system based on the git tree of grml-live (so you get bleeding edge of -development which might is interesting for services like daily.grml.org) the -provided release_helper.sh script provides everything you need. Execute as root: - - echo "deb file:/home/grml-live-git/grml-live.build-area/ ./" >> /etc/apt/sources.list.d/grml-live.list - adduser --disabled-login --disabled-password grml-live-git - -Execute 'visudo' to update sudo configuration and add the following line: - - grml-live-git ALL=NOPASSWD: /usr/bin/apt-get - -Switch to user grml-live-git and configure the rest: - - su - grml-live-git - mkdir grml-live.build-area - git clone git://git.grml.org/grml-live.git - git config --global user.name "Grml-Live Git Autobuild" - git config --global user.email "grml-live-git@$(hostname)" - -Finally install a cron job (as user grml-live-git) like: - - 30 00 * * * cd /home/grml-live-git/grml-live.git/ && env AUTOBUILD=1 scripts/release_helper.sh >/home/grml-live-git/grml-live-build.log - -Tip: To find out the build date of the installed grml-live package just execute: - - % apt-cache policy grml-live | grep 'Installed.*autobuild' - Installed: 0.13.1~autobuild1300450381 - -and run "date -ud @$STRING" where $STRING is the number behind the "autobuild", -like: - - % date -ud @1300450081 - Fri Mar 18 12:08:01 UTC 2011 - [[download]] Download / install grml-live as a Debian package ------------------------------------------------