X-Git-Url: http://git.grml.org/?a=blobdiff_plain;f=grml-live%2Findex.html;h=d59b6f62c0748c9b479cb19a40ebdb88c4b7f6f9;hb=fc23e0ae143230f2a177b5850face4155ed3fb72;hp=93eb3bd5007deb4979b41babb0c6b638f7a11c7d;hpb=9e415c6c4a54d8a6e55aed2d2f5482a29933fe72;p=grml.org.git

diff --git a/grml-live/index.html b/grml-live/index.html
index 93eb3bd..d59b6f6 100644
--- a/grml-live/index.html
+++ b/grml-live/index.html
@@ -3,7 +3,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
 <head>
 <meta http-equiv="Content-Type" content="application/xhtml+xml; charset=UTF-8" />
-<meta name="generator" content="AsciiDoc 8.6.6" />
+<meta name="generator" content="AsciiDoc 8.6.7" />
 <title>grml-live(8)</title>
 <style type="text/css">
 /* Shared CSS for AsciiDoc xhtml11 and html5 backends */
@@ -349,7 +349,7 @@ div.colist td img {
   margin-bottom: 0.1em;
 }
 
-div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
+div.toclevel0, div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
   margin-top: 0;
   margin-bottom: 0;
 }
@@ -407,6 +407,8 @@ span.underline { text-decoration: underline; }
 span.overline { text-decoration: overline; }
 span.line-through { text-decoration: line-through; }
 
+div.unbreakable { page-break-inside: avoid; }
+
 
 /*
  * xhtml11 specific
@@ -414,7 +416,7 @@ span.line-through { text-decoration: line-through; }
  * */
 
 tt {
-  font-family: monospace;
+  font-family: "Courier New", Courier, monospace;
   font-size: inherit;
   color: navy;
 }
@@ -453,7 +455,7 @@ div.tableblock > table[frame="vsides"] {
  * */
 
 .monospaced {
-  font-family: monospace;
+  font-family: "Courier New", Courier, monospace;
   font-size: inherit;
   color: navy;
 }
@@ -581,7 +583,7 @@ toc: function (toclevels) {
 
   function tocEntries(el, toclevels) {
     var result = new Array;
-    var re = new RegExp('[hH]([2-'+(toclevels+1)+'])');
+    var re = new RegExp('[hH]([1-'+(toclevels+1)+'])');
     // Function that scans the DOM tree for header elements (the DOM2
     // nodeIterator API would be a better technique but not supported by all
     // browsers).
@@ -610,7 +612,7 @@ toc: function (toclevels) {
   var i;
   for (i = 0; i < toc.childNodes.length; i++) {
     var entry = toc.childNodes[i];
-    if (entry.nodeName == 'div'
+    if (entry.nodeName.toLowerCase() == 'div'
      && entry.getAttribute("class")
      && entry.getAttribute("class").match(/^toclevel/))
       tocEntriesToRemove.push(entry);
@@ -656,7 +658,7 @@ footnotes: function () {
   var entriesToRemove = [];
   for (i = 0; i < noteholder.childNodes.length; i++) {
     var entry = noteholder.childNodes[i];
-    if (entry.nodeName == 'div' && entry.getAttribute("class") == "footnote")
+    if (entry.nodeName.toLowerCase() == 'div' && entry.getAttribute("class") == "footnote")
       entriesToRemove.push(entry);
   }
   for (i = 0; i < entriesToRemove.length; i++) {
@@ -745,32 +747,24 @@ asciidoc.install(2);
 <div class="sect1">
 <h2 id="_name">1. Name</h2>
 <div class="sectionbody">
-<div class="paragraph"><p>grml-live - build framework based on FAI for generating a grml and Debian based
+<div class="paragraph"><p>grml-live - build framework based on FAI for generating a Grml and Debian based
 Linux Live system (CD/ISO)</p></div>
 </div>
 </div>
 <div class="sect1">
 <h2 id="_synopsis">2. Synopsis</h2>
 <div class="sectionbody">
-<div class="paragraph"><p>grml-live [-a &lt;architecture&gt;] [-c &lt;classe[s]&gt;] [-C &lt;configfile&gt;] [-g
-&lt;grml_name&gt;] [-i &lt;iso_name&gt; ] [-o &lt;output_directory&gt;] [-r &lt;release_name&gt;] [-s
-&lt;suite&gt;] [-t &lt;template_directory&gt;] [-v &lt;version_number&gt;] [-U &lt;username&gt;] [
--AbBFnNquVz]</p></div>
-<div class="admonitionblock">
-<table><tr>
-<td class="icon">
-<img src="./images/icons/caution.png" alt="Caution" />
-</td>
-<td class="content">Please check out <a href="#current_state">the <em>Current state of grml-live with squashfs-tools and kernel</em> section</a> for details about current state of involved
-tools before starting with grml-live or if you encounter any problems.</td>
-</tr></table>
-</div>
+<div class="paragraph"><p>grml-live [-a &lt;architecture&gt;] [-c &lt;classe[s]&gt;] [-C &lt;configfile&gt;] [
+-e &lt;extract_iso_name&gt;] [-g &lt;grml_name&gt;] [-i &lt;iso_name&gt;] [
+-o &lt;output_directory&gt;] [-r &lt;release_name&gt;] [-s &lt;suite&gt;] [
+-t &lt;template_directory&gt;] [-v &lt;version_number&gt;] [-U &lt;username&gt;] [
+-AbBFnNqQuVz]</p></div>
 </div>
 </div>
 <div class="sect1">
 <h2 id="_description">3. Description</h2>
 <div class="sectionbody">
-<div class="paragraph"><p>grml-live provides the build system for creating a grml and Debian based Linux
+<div class="paragraph"><p>grml-live provides the build system for creating a Grml and Debian based Linux
 Live-CD. The build system is based on
 <a href="http://fai-project.org/">FAI</a> (Fully Automatic
 Installation). grml-live uses the "fai dirinstall" feature to generate a chroot
@@ -787,7 +781,7 @@ details of a build process.</p></div>
 <img src="./images/icons/caution.png" alt="Caution" />
 </td>
 <td class="content">grml-live does <strong>not</strong> use /etc/fai for configuration but instead
-(unless overriden using the <em>'-D</em>' option). This ensures that it does not clash
+(unless overridden using the <em>'-D</em>' option). This ensures that it does not clash
 with default FAI configuration and packages, so you can use grml-live and FAI
 completely independent at the same time!</td>
 </tr></table>
@@ -803,8 +797,7 @@ 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
 sample configuration), apt-cacher(1) and approx(8). To avoid downloading the
-base system again and again check out FAI&#8217;s NFSROOT (see FAQ of this document
-for details).</td>
+base system again and again check out <a href="#create-a-base-tgz">the base tar.gz feature</a>.</td>
 </tr></table>
 </div>
 </div>
@@ -818,8 +811,8 @@ for details).</td>
 </dt>
 <dd>
 <p>
-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.
 </p>
 </dd>
 <dt class="hdlist1">
@@ -852,7 +845,7 @@ but intend to only build the ISO.
 <dd>
 <p>
 Build the ISO without touching the chroot at all. This option is useful if
-you modified anything that FAI or grml-live might adjust via grml&#8217;s FAI
+you modified anything that FAI or grml-live might adjust via Grml&#8217;s FAI
 scripts.  It&#8217;s like the <em>-b</em> option but even more advanced. Use only if you
 really know that you do not want to update the chroot.
 </p>
@@ -864,8 +857,8 @@ really know that you do not want to update the chroot.
 <p>
 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 small base system (being about ~180MB
-total ISO size). If using a non-I386 system (like AMD64) you should specify the
+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 <a href="#classes">the <em>CLASSES</em> section in this document</a> for
 details about available classes).  So instead of GRML_FULL you can also use
@@ -930,6 +923,15 @@ throughout this documentation.
 </p>
 </dd>
 <dt class="hdlist1">
+-e <strong>EXTRACT_ISO_NAME</strong>
+</dt>
+<dd>
+<p>
+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.
+</p>
+</dd>
+<dt class="hdlist1">
 -F
 </dt>
 <dd>
@@ -1043,8 +1045,8 @@ Specify name of the release.
 <p>
 Specify the Debian suite you want to use for your live-system.  Defaults to
 "squeeze" (being current Debian/stable). Supported values are: etch, lenny,
-squeeze, sid. Debian "squeeze" requires a recent base.tgz
-debootstrap.
+squeeze, wheezy, sid. Please be aware that recent Debian suites might require a
+recent version of debootstrap.
 </p>
 </dd>
 <dt class="hdlist1">
@@ -1057,15 +1059,6 @@ Specify place of the templates used for building the ISO. By default
 </p>
 </dd>
 <dt class="hdlist1">
--T <strong>CHROOT_ARCHIVE</strong>
-</dt>
-<dd>
-<p>
-Unpack chroot tar archive before starting. Most useful in combination with
--A and -b or -u.
-</p>
-</dd>
-<dt class="hdlist1">
 -u
 </dt>
 <dd>
@@ -1112,42 +1105,28 @@ Use ZLIB instead of LZMA/XZ compression in mksquashfs part of the build process.
 <div class="sect1">
 <h2 id="usage-examples">5. Usage examples</h2>
 <div class="sectionbody">
-<div class="paragraph"><p>To get a small, Debian-stable and grml-based Live-CD using /grml/grml-live
+<div class="paragraph"><p>To get a Debian-stable and Grml-based Live-CD using /grml/grml-live
 as build and output directory just run:</p></div>
 <div class="literalblock">
 <div class="content">
 <pre><tt># grml-live</tt></pre>
 </div></div>
-<div class="paragraph"><p>To get a small Debian-unstable and grml-small based Live-CD using
-/home/mika/grml-live as build and output directory just use:</p></div>
-<div class="literalblock">
-<div class="content">
-<pre><tt># grml-live -s sid -c GRMLBASE,GRML_SMALL,AMD64 -o /home/mika/grml-live</tt></pre>
-</div></div>
-<div class="paragraph"><p>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:</p></div>
-<div class="literalblock">
-<div class="content">
-<pre><tt># grml-live -s sid -a amd64 -c GRMLBASE,GRML_FULL,AMD64</tt></pre>
-</div></div>
-<div class="paragraph"><p>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:</p></div>
+<div class="paragraph"><p>To get a 64bit Debian-testing and grml-small based Live-CD using /srv/grml-live
+as build and output directory use the following command line on your amd64
+system:</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt># grml-live -o /tmp -c GRMLBASE,GRML_SMALL,AMD64 -s sid -i grml_0.0-3.iso</tt></pre>
+<pre><tt># grml-live -s testing -c GRMLBASE,GRML_SMALL,AMD64 -o /srv/grml-live</tt></pre>
 </div></div>
 <div class="admonitionblock">
 <table><tr>
 <td class="icon">
 <img src="./images/icons/note.png" alt="Note" />
 </td>
-<td class="content">If you have about 700MB of free space inside /dev/shm (being a tmpfs, usually
-you should have &gt;=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. :)</td>
+<td class="content">If you have enough RAM, just run "mount -t tmpfs none /media/ramdisk" to get a
+tmpfs ("RAMDISK"), and use /media/ramdisk as build and output directory - this
+results in a very fast build process. Note that these files will be gone when
+rebooting.</td>
 </tr></table>
 </div>
 </div>
@@ -1158,7 +1137,7 @@ $BUILD_OUTPUT and $ISO_OUTPUT if you plan to create more persistent output. :)</
 <div class="ulist"><ul>
 <li>
 <p>
-create a grml-/Debian-based Linux Live-CD with one single command
+create a Grml-/Debian-based Linux Live-CD with one single command
 </p>
 </li>
 <li>
@@ -1182,11 +1161,6 @@ Debian repositories
 native support of FAI features
 </p>
 </li>
-<li>
-<p>
-multi-arch support (work in progress)
-</p>
-</li>
 </ul></div>
 </div>
 </div>
@@ -1230,7 +1204,7 @@ selected. The following classes are predefined:</p></div>
 <div class="ulist"><ul>
 <li>
 <p>
-DEBORPHAN: get rid of all packages listed in output of Deborphan
+DEBORPHAN: get rid of all packages listed in output of deborphan
 </p>
 </li>
 <li>
@@ -1243,26 +1217,26 @@ use this class.
 </li>
 <li>
 <p>
-GRML_FULL: full featured grml, also known as the "normal", full grml as
-introduced in november 2011 (~350MB ISO size).
+GRML_FULL: full featured Grml, also known as the "normal", full grml as
+introduced in December 2011 (~350MB ISO size).
 </p>
 </li>
 <li>
 <p>
-GRML_MEDIUM: medium sized grml version, used to be known as grml-medium
-until november 2011 (~220MB ISO size).
+GRML_MEDIUM: medium sized Grml version, used to be known as grml-medium
+until December 2011 (~220MB ISO size).
 </p>
 </li>
 <li>
 <p>
-GRML_SMALL: minimum sized grml version, known as grml-small (~110MB ISO
+GRML_SMALL: minimum sized Grml version, known as grml-small (~110MB ISO
 size).
 </p>
 </li>
 <li>
 <p>
 GRML_XL: large size Grml version, used to be known as "full grml" until
-november 2011 (~700MB ISO size).
+December 2011 (~700MB ISO size).
 </p>
 </li>
 <li>
@@ -1360,27 +1334,6 @@ grml-live out-of-the-box so you shouldn&#8217;t have to configure anything in th
 file.</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt>${GRML_FAI_CONFIG}/make-fai-nfsroot.conf</tt></pre>
-</div></div>
-<div class="paragraph"><p>This file is used by make-fai-nfsroot(8) only. Usually you don&#8217;t have to change
-anything inside this file. If you want to modify NFSROOT though you can adjust
-it there.</p></div>
-<div class="literalblock">
-<div class="content">
-<pre><tt>${GRML_FAI_CONFIG}/NFSROOT</tt></pre>
-</div></div>
-<div class="paragraph"><p>This file specifies the package list for creating the NFSROOT.</p></div>
-<div class="literalblock">
-<div class="content">
-<pre><tt>${GRML_FAI_CONFIG}/apt/sources.list</tt></pre>
-</div></div>
-<div class="paragraph"><p>This file specifies which mirrors should be considered for retrieving the Debian
-packages when creating the main chroot (including all the software you would
-like to see included). Important: this file should <strong>not</strong> be adjusted manually!
-Instead use the GRML_LIVE_SOURCES variable inside /etc/grml/grml-live.conf or
-on-the-fly via grml-live then. If you want to generally adjust apt configuration</p></div>
-<div class="literalblock">
-<div class="content">
 <pre><tt>${GRML_FAI_CONFIG}/config/</tt></pre>
 </div></div>
 <div class="paragraph"><p>The main directory for configuration of FAI/grml-live. More details below.</p></div>
@@ -1432,16 +1385,10 @@ live-initramfs(8).</p></div>
 <div class="sect1">
 <h2 id="log-files">10. Available log files</h2>
 <div class="sectionbody">
-<div class="paragraph"><p>grml-live itself logs to /var/log/grml-live.log. Unless you set PRESERVE_LOGFILE
-in your grml-live configuration the file is cleared on each new invocation of
-grml-live.</p></div>
-<div class="paragraph"><p>The FAI part of grml-live logs to /var/log/fai/$HOSTNAME/ - so the
-default being /var/log/fai/grml/.</p></div>
-<div class="paragraph"><p>If you are using the grml-live buildd you will find the logs of the grml-live
-run at /var/log/grml-buildd.log.</p></div>
-<div class="paragraph"><p>If you want to store build information in a database just install the
-grml-live-db Debian package. Further details available in the grml-live-db
-manpage.</p></div>
+<div class="paragraph"><p>Starting with grml-live version 0.17.0 you should find log files in a directory
+named <em>grml_logs</em> in the output directory (next to grml_isos, grml_chroot,&#8230;).</p></div>
+<div class="paragraph"><p>grml-live versions before 0.17.0 used to log into /var/log/grml-live.log
+and /var/log/fai/grml.</p></div>
 </div>
 </div>
 <div class="sect1">
@@ -1451,9 +1398,7 @@ manpage.</p></div>
 <li>
 <p>
 any Debian based system should be sufficient (if it doesn&#8217;t work it&#8217;s a bug,
-please send us a bug report then) [a usual
-<a href="http://grml.org/grml2hd/">grml2hd</a> harddisk installation (using grml or
-grml-medium) ships all you need]. Check out <a href="#deploy-on-debian">How do I deploy grml-live on a plain Debian installation</a> for details how to set up grml-live
+please send us a bug report then). Check out <a href="#deploy-on-debian">How do I deploy grml-live on a plain Debian installation</a> for details how to set up grml-live
 on a plain, original Debian system.
 </p>
 </li>
@@ -1469,8 +1414,7 @@ total free disk space
 <li>
 <p>
 fast network access for retrieving the Debian packages used for creating the
-chroot (check out "local mirror" and "NFSROOT" to workaround this problem as far
-as possible)
+chroot (check out "local mirror" to workaround this problem as far as possible)
 </p>
 </li>
 </ul></div>
@@ -1481,8 +1425,8 @@ as possible)
 <h2 id="current_state">12. Current state of grml-live with squashfs-tools and kernel</h2>
 <div class="sectionbody">
 <div class="paragraph"><p>Use squashfs-tools &gt;=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].</p></div>
+Debian/testing and Debian/unstable) to build Grml (based) ISOs featuring kernel
+version 2.6.38-grml[64] or newer.</p></div>
 </div>
 </div>
 <div class="sect1">
@@ -1490,22 +1434,13 @@ Debian/unstable) to build Grml (based) ISOs featuring kernel version
 <div class="sectionbody">
 <div class="sect2">
 <h3 id="deploy-on-debian">13.1. How do I deploy grml-live on a plain Debian installation?</h3>
-<div class="paragraph"><p>The easiest way to get a running grml-live setup is to install Grml or
-grml-medium using grml2hd (for example inside KVM, Virtualbox, VMware,&#8230; if you
-don&#8217;t want to run it on a physical system). Of course using grml-live on a
-plain, original Debian installation is supported as well. So there we go.</p></div>
-<div class="paragraph"><p>What we have: plain, original Debian Lenny (5.0).</p></div>
-<div class="paragraph"><p>What we want: build a grml-medium ISO based on Debian/squeeze for the amd64
-architecture using grml-live.</p></div>
-<div class="admonitionblock">
-<table><tr>
-<td class="icon">
-<img src="./images/icons/important.png" alt="Important" />
-</td>
-<td class="content">If you encounter any problems while booting the resulting ISO please be aware of
-<a href="#current_state">the <em>current state of grml-live with squashfs-tools and kernel</em> section</a>.</td>
-</tr></table>
-</div>
+<div class="paragraph"><p>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.</p></div>
+<div class="paragraph"><p>What we have: plain, original Debian squeeze (6.0) with debian-backports
+enabled. (This is important for squashfs-tools.)</p></div>
+<div class="paragraph"><p>What we want: build a Grml ISO based on Debian/wheezy for the amd64 architecture
+using grml-live.</p></div>
 <div class="sect3">
 <h4 id="_instructions">13.1.1. Instructions</h4>
 <div class="literalblock">
@@ -1528,21 +1463,6 @@ EOF</tt></pre>
 </div></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt># adjust apt-pinning (only prefer squashfs stuff from grml):
-cat &gt;&gt; /etc/apt/preferences &lt;&lt; EOF
-Package: *
-Pin: origin deb.grml.org
-Pin-Priority: 1</tt></pre>
-</div></div>
-<div class="literalblock">
-<div class="content">
-<pre><tt>Package: squashfs-tools
-Pin: origin deb.grml.org
-Pin-Priority: 996
-EOF</tt></pre>
-</div></div>
-<div class="literalblock">
-<div class="content">
 <pre><tt># get keyring for apt:
 apt-get update
 apt-get --allow-unauthenticated install grml-debian-keyring</tt></pre>
@@ -1552,14 +1472,14 @@ apt-get --allow-unauthenticated install grml-debian-keyring</tt></pre>
 <pre><tt># 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</tt></pre>
+# mv I386.tar.gz /etc/grml/fai/config/basefiles/
+# mv AMD64.tar.gz /etc/grml/fai/config/basefiles/</tt></pre>
 </div></div>
 <div class="literalblock">
 <div class="content">
 <pre><tt># 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</tt></pre>
+apt-get install -t squeeze-backports squashfs-tools
+apt-get --no-install-recommends install grml-live</tt></pre>
 </div></div>
 <div class="literalblock">
 <div class="content">
@@ -1570,20 +1490,13 @@ cat &gt; /etc/grml/grml-live.local &lt;&lt; EOF
 # SQUASHFS_OPTIONS="-comp gzip -b 256k"
 ## want to use a specific squashfs binary?
 # SQUASHFS_BINARY='/usr/bin/mksquashfs'
-# install local files into the chroot
-CHROOT_INSTALL="/etc/grml/fai/chroot_install"
+## install local files into the chroot
+# CHROOT_INSTALL="/etc/grml/fai/chroot_install"
 ## adjust if necessary (defaults to /grml/grml-live):
 ## OUTPUT="/srv/grml-live"
-FAI_DEBOOTSTRAP="squeeze http://cdn.debian.net/debian/"
-ARCH="i386"
+FAI_DEBOOTSTRAP="wheezy http://cdn.debian.net/debian/"
+# ARCH="amd64"
 CLASSES="GRMLBASE,GRML_FULL,AMD64"
-# PRESERVE_LOGFILE='1'
-# ZERO_FAI_LOGFILE='1'
-GRML_LIVE_SOURCES="
-deb http://deb.grml.org/            grml-stable  main
-deb http://deb.grml.org/            grml-testing main
-deb http://cdn.debian.net/debian squeeze main contrib non-free
-"
 EOF</tt></pre>
 </div></div>
 <div class="literalblock">
@@ -1591,7 +1504,7 @@ EOF</tt></pre>
 <pre><tt># just optional(!) - upgrade FAI to latest available version:
 cat &gt;&gt; /etc/apt/sources.list &lt;&lt; EOF
 # fai:
-  deb http://fai-project.org/download lenny koeln
+  deb http://fai-project.org/download squeeze koeln
 EOF</tt></pre>
 </div></div>
 <div class="literalblock">
@@ -1622,158 +1535,14 @@ configuration files, scripts and hooks will be taken from your
 </div>
 <div class="sect2">
 <h3 id="how-to-debug">13.3. I&#8217;ve problems with the build process. How to start debugging?</h3>
-<div class="paragraph"><p>Check out the logs inside /var/log/fai/&#8230; If you think it&#8217;s a bug in grml-live
-send a copy of your config, logs and the commandline with a short problem
-description to &lt;<a href="mailto:mika@grml.org">mika@grml.org</a>&gt;:</p></div>
-<div class="literalblock">
-<div class="content">
-<pre><tt># history | grep grml-live &gt; /etc/grml/grml_live.cmdline
-# tar zcf grml_live_problem.tar.gz /etc/grml/grml-live.conf \
-          /etc/grml/grml_live.cmdline /etc/grml/grml-buildd.conf \
-          /var/log/fai /etc/grml/fai
--&gt; finally mail grml_live_problem.tar.gz to &lt;mika@grml.org&gt;</tt></pre>
-</div></div>
+<div class="paragraph"><p>Check out the logs inside the directory <em>grml_logs</em> next to your grml_chroot,
+grml_isos,&#8230; directories.</p></div>
 <div class="paragraph"><p>If you need help with grml-live or would like to see new features as part of
 grml-live you can get commercial support via
 <a href="http://grml-solutions.com/">Grml Solutions</a>.</p></div>
 </div>
 <div class="sect2">
-<h3 id="lzma-vs-zlib">13.4. How much is the difference between LZMA and ZLIB compression?</h3>
-<div class="paragraph"><p>ISO size (bs = blocksize):</p></div>
-<div class="tableblock">
-<table rules="all"
-width="45%"
-frame="border"
-cellspacing="0" cellpadding="4">
-<col width="42%" />
-<col width="28%" />
-<col width="28%" />
-<tbody>
-<tr>
-<td align="left" valign="top"><p class="table">ISO</p></td>
-<td align="center" valign="top"><p class="table">LZMA (256kB bs)</p></td>
-<td align="center" valign="top"><p class="table">ZLIB</p></td>
-</tr>
-<tr>
-<td align="left" valign="top"><p class="table">grml_sid</p></td>
-<td align="center" valign="top"><p class="table">666M</p></td>
-<td align="center" valign="top"><p class="table">771M</p></td>
-</tr>
-<tr>
-<td align="left" valign="top"><p class="table">grml_squeeze</p></td>
-<td align="center" valign="top"><p class="table">659M</p></td>
-<td align="center" valign="top"><p class="table">761M</p></td>
-</tr>
-<tr>
-<td align="left" valign="top"><p class="table">grml_lenny</p></td>
-<td align="center" valign="top"><p class="table">624M</p></td>
-<td align="center" valign="top"><p class="table">723M</p></td>
-</tr>
-<tr>
-<td align="left" valign="top"><p class="table">grml64_sid</p></td>
-<td align="center" valign="top"><p class="table">677M</p></td>
-<td align="center" valign="top"><p class="table">791M</p></td>
-</tr>
-<tr>
-<td align="left" valign="top"><p class="table">grml64_squeeze</p></td>
-<td align="center" valign="top"><p class="table">671M</p></td>
-<td align="center" valign="top"><p class="table">785M</p></td>
-</tr>
-<tr>
-<td align="left" valign="top"><p class="table">grml64_lenny</p></td>
-<td align="center" valign="top"><p class="table">639M</p></td>
-<td align="center" valign="top"><p class="table">745M</p></td>
-</tr>
-<tr>
-<td align="left" valign="top"><p class="table">grml-medium_sid</p></td>
-<td align="center" valign="top"><p class="table">208M</p></td>
-<td align="center" valign="top"><p class="table">236M</p></td>
-</tr>
-<tr>
-<td align="left" valign="top"><p class="table">grml-medium_squeeze</p></td>
-<td align="center" valign="top"><p class="table">206M</p></td>
-<td align="center" valign="top"><p class="table">234M</p></td>
-</tr>
-<tr>
-<td align="left" valign="top"><p class="table">grml-medium_lenny</p></td>
-<td align="center" valign="top"><p class="table">193M</p></td>
-<td align="center" valign="top"><p class="table">220M</p></td>
-</tr>
-<tr>
-<td align="left" valign="top"><p class="table">grml64-medium_sid</p></td>
-<td align="center" valign="top"><p class="table">213M</p></td>
-<td align="center" valign="top"><p class="table">245M</p></td>
-</tr>
-<tr>
-<td align="left" valign="top"><p class="table">grml64-medium_squeeze</p></td>
-<td align="center" valign="top"><p class="table">213M</p></td>
-<td align="center" valign="top"><p class="table">244M</p></td>
-</tr>
-<tr>
-<td align="left" valign="top"><p class="table">grml64-medium_lenny</p></td>
-<td align="center" valign="top"><p class="table">201M</p></td>
-<td align="center" valign="top"><p class="table">231M</p></td>
-</tr>
-<tr>
-<td align="left" valign="top"><p class="table">grml-small_sid</p></td>
-<td align="center" valign="top"><p class="table">102M</p></td>
-<td align="center" valign="top"><p class="table">118M</p></td>
-</tr>
-<tr>
-<td align="left" valign="top"><p class="table">grml-small_squeeze</p></td>
-<td align="center" valign="top"><p class="table">101M</p></td>
-<td align="center" valign="top"><p class="table">117M</p></td>
-</tr>
-<tr>
-<td align="left" valign="top"><p class="table">grml-small_lenny</p></td>
-<td align="center" valign="top"><p class="table">97M</p></td>
-<td align="center" valign="top"><p class="table">112M</p></td>
-</tr>
-<tr>
-<td align="left" valign="top"><p class="table">grml64-small_sid</p></td>
-<td align="center" valign="top"><p class="table">103M</p></td>
-<td align="center" valign="top"><p class="table">120M</p></td>
-</tr>
-<tr>
-<td align="left" valign="top"><p class="table">grml64-small_squeeze</p></td>
-<td align="center" valign="top"><p class="table">103M</p></td>
-<td align="center" valign="top"><p class="table">120M</p></td>
-</tr>
-<tr>
-<td align="left" valign="top"><p class="table">grml64-small_lenny</p></td>
-<td align="center" valign="top"><p class="table">99M</p></td>
-<td align="center" valign="top"><p class="table">116M</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-<div class="paragraph"><p>Build time of grml-medium&#8217;s squashfs file (depends on your system, though just
-to get the ratio between the different options):</p></div>
-<div class="ulist"><ul>
-<li>
-<p>
-10 minutes and 4 seconds with LZMA default blocksize (128k)
-</p>
-</li>
-<li>
-<p>
-7 minutes 27 seconds with LZMA and blocksize 256k
-</p>
-</li>
-<li>
-<p>
-6 minutes and 8 seconds with LZMA blocksize 512k
-</p>
-</li>
-<li>
-<p>
-1 minute and 40 seconds with ZLIB
-</p>
-</li>
-</ul></div>
-</div>
-<div class="sect2">
-<h3 id="install-local-files">13.5. How do I install further files into the chroot/ISO?</h3>
+<h3 id="install-local-files">13.4. How do I install further files into the chroot/ISO?</h3>
 <div class="paragraph"><p>Just point the configuration variable CHROOT_INSTALL to the directory which
 provides the files you would like to install. Note that the files are installed
 under <em>/</em> in the chroot - so you have to create the rootfs structure on your
@@ -1788,9 +1557,9 @@ grml-live ...</tt></pre>
 </div></div>
 </div>
 <div class="sect2">
-<h3 id="local-debian-mirror">13.6. Can I use my own (local) Debian mirror?</h3>
+<h3 id="local-debian-mirror">13.5. Can I use my own (local) Debian mirror?</h3>
 <div class="paragraph"><p>Yes. Set up an according sources.list configuration as class file in
-FAI_DEBOOTSTRAP (if not already using NFSROOT&#8217;s base.tgz) inside
+FAI_DEBOOTSTRAP (if not already using a base.tgz) inside
 /etc/grml/grml-live.conf[.local]. If you&#8217;re setting up your own class file don&#8217;t
 forget to include the class name in the class list (grml-live -c &#8230;).</p></div>
 <div class="paragraph"><p>If you want to use a local (for example NFS mount) mirror additionally then
@@ -1802,7 +1571,7 @@ adjust MIRROR_DIRECTORY in /etc/grml/grml-live.conf[.local] as well.</p></div>
 </div></div>
 </div>
 <div class="sect2">
-<h3 id="add-additional-debian-packages">13.7. How do I add additional Debian package(s) to my CD/ISO?</h3>
+<h3 id="add-additional-debian-packages">13.6. How do I add additional Debian package(s) to my CD/ISO?</h3>
 <div class="paragraph"><p>Just create a new class (using the package_config directory):</p></div>
 <div class="literalblock">
 <div class="content">
@@ -1823,7 +1592,7 @@ EOF</tt></pre>
 </div></div>
 </div>
 <div class="sect2">
-<h3 id="reset-grml-live-configuration">13.8. I fscked up my grml-live configuration. How do I reset it to the defaults?</h3>
+<h3 id="reset-grml-live-configuration">13.7. I fscked up my grml-live configuration. How do I reset it to the defaults?</h3>
 <div class="paragraph"><p>Notice: this deletes all your grml-live configuration files. If that&#8217;s really
 what you are searching for just run:</p></div>
 <div class="literalblock">
@@ -1831,59 +1600,35 @@ what you are searching for just run:</p></div>
 <pre><tt>rm -rf /etc/grml/fai /etc/grml/grml-live.conf
 dpkg -i --force-confnew --force-confmiss /path/to/grml-live_..._all.deb</tt></pre>
 </div></div>
+</div>
+<div class="sect2">
+<h3 id="create-a-base-tgz">13.8. How do I create a base.tgz?</h3>
+<div class="paragraph"><p>First of all create the chroot using debootstrap:</p></div>
+<div class="literalblock">
+<div class="content">
+<pre><tt>BASECHROOT='/tmp/basefile'
+debootstrap squeeze "$BASECHROOT" http://cdn.debian.net/debian
+tar -C "$BASECHROOT" --exclude='var/cache/apt/archives/*.deb' -zcf base.tar.gz ./</tt></pre>
+</div></div>
 <div class="admonitionblock">
 <table><tr>
 <td class="icon">
-<img src="./images/icons/note.png" alt="Note" />
+<img src="./images/icons/tip.png" alt="Tip" />
 </td>
-<td class="content">If you don&#8217;t control your /etc using a version control system (VCS) yet it&#8217;s a
-good chance to start using it now. Check out
-<a href="http://michael-prokop.at/blog/2007/03/14/maintain-etc-with-mercurial-on-debian/">http://michael-prokop.at/blog/2007/03/14/maintain-etc-with-mercurial-on-debian/</a>
-for more details how to maintain /etc using the mercurial VCS.</td>
+<td class="content">By default debootstrap builds a chroot matching the architecture of the running
+host system. If you&#8217;re using an amd64 system and want to build an i386 base.tgz
+then invoke debootstrap using the <em>--arch i386</em> option. Disclaimer: building an
+AMD64 base.tgz won&#8217;t work if you are using a 32bit kernel system of course.</td>
 </tr></table>
 </div>
-</div>
-<div class="sect2">
-<h3 id="create-a-base-tgz">13.9. How do I create a base.tgz for use as NFSROOT?</h3>
-<div class="paragraph"><p>First of all build the chroot system:</p></div>
-<div class="literalblock">
-<div class="content">
-<pre><tt>mkdir /tmp/nfsroot &amp;&amp; cd /tmp/nfsroot
-debootstrap squeeze /tmp/nfsroot/ http://cdn.debian.net/debian
-tar zcf base.tgz ./</tt></pre>
-</div></div>
-<div class="paragraph"><p>Then check out where your NFSROOT is located:</p></div>
-<div class="literalblock">
-<div class="content">
-<pre><tt># grep '^NFSROOT' /etc/grml/fai/make-fai-nfsroot.conf
-NFSROOT=/grml/fai/nfsroot</tt></pre>
-</div></div>
-<div class="paragraph"><p>So as /grml/fai/nfsroot is your NFSROOT place the file under
-/grml/fai/nfsroot/live/filesystem.dir/var/tmp/:</p></div>
-<div class="literalblock">
-<div class="content">
-<pre><tt>mv base.tgz /grml/fai/nfsroot/live/filesystem.dir/var/tmp/base.tgz</tt></pre>
-</div></div>
-<div class="paragraph"><p>or even better use /etc/grml/fai/config/basefiles/$CLASSNAME.tar.gz instead.
-Use I386 as $CLASSNAME for i386 builds and AMD64 for amd64 builds.</p></div>
-<div class="paragraph"><p>Now running "grml-live &#8230;" will use this file as main system instead of
-executing debootstrap. Check out the output for the following lines if using
-NFSROOT:</p></div>
-<div class="literalblock">
-<div class="content">
-<pre><tt>[...]
-Calling task_extrbase
-Unpacking Debian base archive
-Extracting /grml/fai/nfsroot/live/filesystem.dir/var/tmp/base.tgz
-Calling task_mirror
-[...]</tt></pre>
-</div></div>
-<div class="paragraph"><p>or if using /etc/grml/fai/config/basefiles/$CLASSNAME.tar.gz for:</p></div>
+<div class="paragraph"><p>Then move the base.tar.gz to /etc/grml/fai/config/basefiles/$CLASSNAME.tar.gz.
+Use e.g. I386 as $CLASSNAME for i386 chroots and AMD64 for amd64 chroots.</p></div>
+<div class="paragraph"><p>Now executing grml-live should use this file as base system instead of executing
+debootstrap. Check out the output for something like:</p></div>
 <div class="literalblock">
 <div class="content">
 <pre><tt>[...]
-ftar: extracting /etc/grml/fai/config/basefiles///AMD64.tar.gz to
-/grml-live/grml-live_20071029.22138/grml_chroot//
+ftar: extracting //etc/grml/fai/config/basefiles///AMD64.tar.gz to /srv/grml64_testing/grml_chroot//
 [...]</tt></pre>
 </div></div>
 <div class="admonitionblock">
@@ -1894,47 +1639,21 @@ ftar: extracting /etc/grml/fai/config/basefiles///AMD64.tar.gz to
 <td class="content">Existing base.tgz can be found at <a href="http://daily.grml.org/">http://daily.grml.org/</a></td>
 </tr></table>
 </div>
-<div class="paragraph" id="apt-cacher"><p>Set up apt-cacher-ng for use with grml-live</p></div>
-<div class="listingblock">
-<div class="content">
-<pre><tt>Make sure /etc/grml/grml-live.local provides according APT_PROXY and
-FAI_DEBOOTSTRAP:
-
-  # cat /etc/grml/grml-live.local
-  [...]
-  APT_PROXY="http://localhost:3142/"
-  [...]
-  FAI_DEBOOTSTRAP="squeeze http://localhost:3142/cdn.debian.net/debian squeeze 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.
-
-[[approx]]
-Set up approx for use with grml-live</tt></pre>
-</div></div>
-<div class="paragraph"><p>Make sure /etc/grml/grml-live.conf provides according GRML_LIVE_SOURCES and
+</div>
+<div class="sect2">
+<h3 id="apt-cacher">13.9. Set up apt-cacher-ng for use with grml-live</h3>
+<div class="paragraph"><p>Make sure /etc/grml/grml-live.local provides according APT_PROXY and
 FAI_DEBOOTSTRAP:</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt># cat /etc/grml/grml-live.conf
+<pre><tt># cat /etc/grml/grml-live.local
 [...]
-GRML_LIVE_SOURCES="
-deb http://localhost:9999/grml            grml-stable  main
-deb http://localhost:9999/grml            grml-testing main
-deb http://localhost:9999/debian squeeze  main contrib non-free
-"
-FAI_DEBOOTSTRAP="squeeze http://localhost:9999/debian"</tt></pre>
-</div></div>
-<div class="paragraph"><p>Configure approx:</p></div>
-<div class="literalblock">
-<div class="content">
-<pre><tt># cat /etc/approx/approx.conf
+APT_PROXY="http://localhost:3142/"
 [...]
-debian http://ftp.at.debian.org/debian
-grml   http://deb.grml.org/</tt></pre>
+FAI_DEBOOTSTRAP="squeeze http://localhost:3142/cdn.debian.net/debian squeeze main contrib non-free"</tt></pre>
 </div></div>
-<div class="paragraph"><p>Don&#8217;t forget to restart approx (/etc/init.d/approx restart). That&#8217;s it.
-All downloaded files will be cached in /var/cache/approx now.</p></div>
+<div class="paragraph"><p>Make sure apt-cacher-ng is running (<em>/etc/init.d/apt-cacher-ng restart</em>).
+That&#8217;s it.  All downloaded files will be cached in /var/cache/apt-cacher-ng then.</p></div>
 </div>
 <div class="sect2">
 <h3 id="revert_manifold">13.10. How do I revert the manifold feature from an ISO?</h3>
@@ -1968,57 +1687,6 @@ tar zcf ../"${ARCH}".tar.gz *</tt></pre>
 that it needs to be uppercase letters matching the class names, so: AMD64.tar.gz
 for amd64 and I386.tar.gz for i386).</p></div>
 </div>
-<div class="sect2">
-<h3 id="autobuild">13.12. How do I set up an autobuild environment?</h3>
-<div class="paragraph"><p>If you want to set up a system like <a href="http://daily.grml.org/">daily.grml.org</a>
-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.</p></div>
-<div class="paragraph"><p>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:</p></div>
-<div class="literalblock">
-<div class="content">
-<pre><tt>echo "deb file:/home/grml-live-git/grml-live.build-area/ ./" &gt;&gt; /etc/apt/sources.list.d/grml-live.list
-adduser --disabled-login --disabled-password grml-live-git</tt></pre>
-</div></div>
-<div class="paragraph"><p>Execute <em>visudo</em> to update sudo configuration and add the following line:</p></div>
-<div class="literalblock">
-<div class="content">
-<pre><tt>grml-live-git ALL=NOPASSWD: /usr/bin/apt-get</tt></pre>
-</div></div>
-<div class="paragraph"><p>Switch to user grml-live-git and configure the rest:</p></div>
-<div class="literalblock">
-<div class="content">
-<pre><tt>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)"</tt></pre>
-</div></div>
-<div class="paragraph"><p>Finally install a cron job (as user grml-live-git) like:</p></div>
-<div class="literalblock">
-<div class="content">
-<pre><tt>30 00 * * * cd /home/grml-live-git/grml-live.git/ &amp;&amp; env AUTOBUILD=1 scripts/release_helper.sh &gt;/home/grml-live-git/grml-live-build.log</tt></pre>
-</div></div>
-<div class="paragraph"><p>Tip: To find out the build date of the installed grml-live package just execute:</p></div>
-<div class="literalblock">
-<div class="content">
-<pre><tt>% apt-cache policy grml-live | grep 'Installed.*autobuild'
- Installed: 0.13.1~autobuild1300450381</tt></pre>
-</div></div>
-<div class="paragraph"><p>and run "date -ud @$STRING" where $STRING is the number behind the "autobuild",
-like:</p></div>
-<div class="literalblock">
-<div class="content">
-<pre><tt>% date -ud @1300450081
-Fri Mar 18 12:08:01 UTC 2011</tt></pre>
-</div></div>
-</div>
-<div class="sect2">
-<h3 id="question">13.13. I&#8217;ve a question which isn&#8217;t answered by this document</h3>
-<div class="paragraph"><p>Don&#8217;t hesitate to contact the author: &lt;<a href="mailto:mika@grml.org">mika@grml.org</a>&gt;</p></div>
-</div>
 </div>
 </div>
 <div class="sect1">
@@ -2040,24 +1708,18 @@ debuild -us -uc</tt></pre>
 <h2 id="source">15. Source</h2>
 <div class="sectionbody">
 <div class="paragraph"><p>The source of grml-live is available at
-<a href="http://git.grml.org/?p=grml-live.git">http://git.grml.org/?p=grml-live.git</a></p></div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="todo-list">16. TODO list</h2>
-<div class="sectionbody">
-<div class="paragraph"><p>Check out the <a href="http://git.grml.org/?p=grml-live.git;a=blob;f=TODO;hb=HEAD">TODO file</a>.</p></div>
+<a href="https://github.com/grml/grml-live/">https://github.com/grml/grml-live/</a></p></div>
 </div>
 </div>
 <div class="sect1">
-<h2 id="bugs">17. Bugs</h2>
+<h2 id="bugs">16. Bugs</h2>
 <div class="sectionbody">
 <div class="paragraph"><p>Please report feedback, <a href="http://grml.org/bugs/">bugreports</a> and wishes
-<a href="http://grml.org/contact/">to the grml-team</a>!</p></div>
+<a href="http://grml.org/contact/">to the Grml team</a>!</p></div>
 </div>
 </div>
 <div class="sect1">
-<h2 id="documentation">18. Documentation</h2>
+<h2 id="documentation">17. Documentation</h2>
 <div class="sectionbody">
 <div class="paragraph"><p>The most recent grml-live documentation is available online at
 <a href="http://grml.org/grml-live/">http://grml.org/grml-live/</a> and for offline reading also available
@@ -2077,7 +1739,7 @@ in different formats:</p></div>
 </div>
 </div>
 <div class="sect1">
-<h2 id="authors">19. Authors</h2>
+<h2 id="authors">18. Authors</h2>
 <div class="sectionbody">
 <div class="paragraph"><p>Michael Prokop &lt;<a href="mailto:mika@grml.org">mika@grml.org</a>&gt;</p></div>
 </div>
@@ -2086,7 +1748,7 @@ in different formats:</p></div>
 <div id="footnotes"><hr /></div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2011-12-10 01:16:51 CET
+Last updated 2012-09-26 19:37:35 CEST
 </div>
 </div>
 </body>
