X-Git-Url: http://git.grml.org/?p=grml-live.git;a=blobdiff_plain;f=docs%2Fgrml-live.txt;h=cd1ab5ef2ec9e232dedfa5692689d301a2c3411b;hp=dcfb14b2a56958b68de29cb798affca49e73817e;hb=bebbbad9c317c10b8536e8bf5993819c6c745fdf;hpb=956db16430d4c373008e9b1a3b0a33e020e117ab diff --git a/docs/grml-live.txt b/docs/grml-live.txt index dcfb14b..cd1ab5e 100644 --- a/docs/grml-live.txt +++ b/docs/grml-live.txt @@ -168,8 +168,8 @@ Specify name of the release. -s **SUITE**:: Specify the Debian suite you want to use for your live-system. Defaults to -"lenny" (being current Debian/stable). Supported values are: etch, lenny, sid. -Debian "squeeze" (current Debian/testing) requires base.tgz +"squeeze" (being current Debian/stable). Supported values are: etch, lenny, +squeeze, sid. Debian "squeeze" requires a recent base.tgz (/etc/grml/fai/config/basefiles/$CLASSNAME.tar.gz) or a recent version of debootstrap. @@ -193,7 +193,7 @@ Increase verbosity in the build process. -z:: -Use ZLIB instead of LZMA compression in mksquashfs part of the build process. +Use ZLIB instead of LZMA/XZ compression in mksquashfs part of the build process. [[usage-examples]] Usage examples @@ -475,9 +475,9 @@ For further information see next section. Current state of grml-live with squashfs-tools and kernel --------------------------------------------------------- -Use squashfs-tools >=4.1-1 (available from Grml repositories as well as from -Debian/experimental) to build Grml (based) ISOs featuring kernel version -2.6.36-grml[64]. +Use squashfs-tools >=4.2-1 (available from Grml repositories as well as from +Debian/unstable) to build Grml (based) ISOs featuring kernel version +2.6.38-grml[64]. //////////////////////////////////////////////////////////////////////////////// Difference between squashfs-lzma-tools, squashfs-lzma-tools4 and squashfs-tools @@ -868,7 +868,7 @@ to get the ratio between the different options): * 1 minute and 40 seconds with ZLIB [[install-local-files]] -How to I install further files into the chroot/ISO? +How do I install further files into the chroot/ISO? ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Just point the configuration variable CHROOT_INSTALL to the directory which @@ -947,7 +947,7 @@ How do I create a base.tgz for use as NFSROOT? First of all build the chroot system: mkdir /tmp/nfsroot && cd /tmp/nfsroot - debootstrap lenny /tmp/nfsroot/ http://cdn.debian.net/debian + debootstrap squeeze /tmp/nfsroot/ http://cdn.debian.net/debian tar zcf base.tgz ./ Then check out where your NFSROOT is located: @@ -996,10 +996,10 @@ FAI_DEBOOTSTRAP: GRML_LIVE_SOURCES=" deb http://localhost:3142/deb.grml.org grml-stable main deb http://localhost:3142/deb.grml.org grml-testing main - deb http://localhost:3142/cdn.debian.net/debian lenny main contrib non-free + deb http://localhost:3142/cdn.debian.net/debian squeeze main contrib non-free " [...] - FAI_DEBOOTSTRAP="lenny http://localhost:3142/cdn.debian.net/debian lenny main contrib non-free" + FAI_DEBOOTSTRAP="squeeze http://localhost:3142/cdn.debian.net/debian squeeze main contrib non-free" Make sure apt-cacher / apt-cacher-ng is running ('/etc/init.d/apt-cacher restart' or '/etc/init.d/apt-cacher-ng restart'). That's it. All downloaded @@ -1017,9 +1017,9 @@ FAI_DEBOOTSTRAP: GRML_LIVE_SOURCES=" deb http://localhost:9999/grml grml-stable main deb http://localhost:9999/grml grml-testing main - deb http://localhost:9999/debian lenny main contrib non-free + deb http://localhost:9999/debian squeeze main contrib non-free " - FAI_DEBOOTSTRAP="lenny http://localhost:9999/debian" + FAI_DEBOOTSTRAP="squeeze http://localhost:9999/debian" Configure approx: @@ -1035,7 +1035,7 @@ All downloaded files will be cached in /var/cache/approx now. How do I revert the manifold feature from an ISO? ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -The so called manifold feature Grml ISOs use by default allows to use the same +The so called manifold feature Grml ISOs use by default allows one to use the same ISO for CD boot and USB boot. If you notice any problems when booting just revert the manifold feature running: @@ -1047,7 +1047,7 @@ syslinux) then just execute: % isohybrid grml.iso [[basetgz]] -How to I create a base tar.gz (I386.tar.gz or AMD64.tar.gz) +How do I create a base tar.gz (I386.tar.gz or AMD64.tar.gz) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Execute the following commands (requires root): @@ -1063,6 +1063,49 @@ 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 + [[question]] I've a question which isn't answered by this document ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~