X-Git-Url: https://git.grml.org/?a=blobdiff_plain;f=grml-live%2Findex.html;h=f01c64b072447523d889dc91274e2453aae9516b;hb=854800cb8b84070565a73ac422c10683c381de19;hp=d59b6f62c0748c9b479cb19a40ebdb88c4b7f6f9;hpb=a44a72ca7ef9d9b03702fb60c077b3e0f935bc42;p=grml.org.git

diff --git a/grml-live/index.html b/grml-live/index.html
index d59b6f6..f01c64b 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.7" />
+<meta name="generator" content="AsciiDoc 8.6.9" />
 <title>grml-live(8)</title>
 <style type="text/css">
 /* Shared CSS for AsciiDoc xhtml11 and html5 backends */
@@ -87,10 +87,16 @@ ul, ol, li > p {
 ul > li     { color: #aaa; }
 ul > li > * { color: black; }
 
-pre {
+.monospaced, code, pre {
+  font-family: "Courier New", Courier, monospace;
+  font-size: inherit;
+  color: navy;
   padding: 0;
   margin: 0;
 }
+pre {
+  white-space: pre-wrap;
+}
 
 #author {
   color: #527bbd;
@@ -219,7 +225,7 @@ div.exampleblock > div.content {
 }
 
 div.imageblock div.content { padding-left: 0; }
-span.image img { border-style: none; }
+span.image img { border-style: none; vertical-align: text-bottom; }
 a.image:visited { color: white; }
 
 dl {
@@ -415,12 +421,6 @@ div.unbreakable { page-break-inside: avoid; }
  *
  * */
 
-tt {
-  font-family: "Courier New", Courier, monospace;
-  font-size: inherit;
-  color: navy;
-}
-
 div.tableblock {
   margin-top: 1.0em;
   margin-bottom: 1.5em;
@@ -454,12 +454,6 @@ div.tableblock > table[frame="vsides"] {
  *
  * */
 
-.monospaced {
-  font-family: "Courier New", Courier, monospace;
-  font-size: inherit;
-  color: navy;
-}
-
 table.tableblock {
   margin-top: 1.0em;
   margin-bottom: 1.5em;
@@ -539,6 +533,8 @@ body.manpage div.sectionbody {
 @media print {
   body.manpage div#toc { display: none; }
 }
+
+
 </style>
 <script type="text/javascript">
 /*<![CDATA[*/
@@ -758,7 +754,7 @@ Linux Live system (CD/ISO)</p></div>
 -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>
+-w &lt;date&gt;] [-AbBFnNqQuVz]</p></div>
 </div>
 </div>
 <div class="sect1">
@@ -1043,10 +1039,11 @@ Specify name of the release.
 </dt>
 <dd>
 <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, wheezy, sid. Please be aware that recent Debian suites might require a
-recent version of debootstrap.
+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
+suites might require a recent base.tgz
+debootstrap.
 </p>
 </dd>
 <dt class="hdlist1">
@@ -1092,6 +1089,26 @@ Increase verbosity in the build process.
 </p>
 </dd>
 <dt class="hdlist1">
+-w <strong>DATE</strong>
+</dt>
+<dd>
+<p>
+The wayback machine. Build the system using Debian archives from the specified
+date.  Valid date formats are yyyymmddThhmmssZ or simply yyyymmdd.  To learn
+which snapshots exist, i.e. which date strings are valid, simply browse the
+lists on <a href="http://snapshot.debian.org/">http://snapshot.debian.org/</a>.  If there is no import at the exact time
+you specified you will get the latest available timestamp which is before the
+time you specified.
+This option is useful especially for release and debugging builds - for example
+if you know that the Debian archive was in a good state on a specific date but
+you want to build it on another day in the future, where the archive might not
+be as needed anymore. Please be aware that this is restricted to the plain
+Debian repositories only, as referred to in /etc/apt/sources.list.d/debian.list
+(so neither the Grml repositories nor any further custom ones are affected by
+the wayback machine).
+</p>
+</dd>
+<dt class="hdlist1">
 -z
 </dt>
 <dd>
@@ -1109,14 +1126,14 @@ Use ZLIB instead of LZMA/XZ compression in mksquashfs part of the build process.
 as build and output directory just run:</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt># grml-live</tt></pre>
+<pre><code># grml-live</code></pre>
 </div></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 -s testing -c GRMLBASE,GRML_SMALL,AMD64 -o /srv/grml-live</tt></pre>
+<pre><code># grml-live -s testing -c GRMLBASE,GRML_SMALL,AMD64 -o /srv/grml-live</code></pre>
 </div></div>
 <div class="admonitionblock">
 <table><tr>
@@ -1174,15 +1191,15 @@ losing the simplicity in the build process.</p></div>
 recommended to <strong>always</strong> use the class GRMLBASE when building an ISO using
 grml-live, as well as the architecture dependent class which provides the kernel
 (being <em>I386</em> for x86_32 and <em>AMD64</em> for x86_64) and a GRML_* class (like
-GRML_SMALL, GRML_MEDIUM or GRML_FULL). The following files and directories are
+GRML_SMALL or GRML_FULL). The following files and directories are
 relevant for class GRMLBASE by default:</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt>${GRML_FAI_CONFIG}/config/scripts/GRMLBASE/
+<pre><code>${GRML_FAI_CONFIG}/config/scripts/GRMLBASE/
 ${GRML_FAI_CONFIG}/config/debconf/GRMLBASE
 ${GRML_FAI_CONFIG}/config/class/GRMLBASE.var
 ${GRML_FAI_CONFIG}/config/hooks/instsoft.GRMLBASE
-${GRML_FAI_CONFIG}/config/package_config/GRMLBASE</tt></pre>
+${GRML_FAI_CONFIG}/config/package_config/GRMLBASE</code></pre>
 </div></div>
 <div class="paragraph"><p>Take a look at the next section for information about the concept of those
 files/directories.</p></div>
@@ -1209,6 +1226,13 @@ DEBORPHAN: get rid of all packages listed in output of deborphan
 </li>
 <li>
 <p>
+FRESHCLAM: execute freshclam (if it&#8217;s present) to update clamav definitions
+(increases resulting ISO size ~70MB). By default it&#8217;s skipped to avoid bigger
+ISO size.
+</p>
+</li>
+<li>
+<p>
 GRMLBASE: the main class responsible for getting a minimal subset of what&#8217;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
@@ -1218,29 +1242,17 @@ use this class.
 <li>
 <p>
 GRML_FULL: full featured Grml, also known as the "normal", full grml as
-introduced in December 2011 (~350MB ISO size).
+introduced in December 2011 (~460MB ISO size).
 </p>
 </li>
 <li>
 <p>
-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 (~230MB ISO
 size).
 </p>
 </li>
 <li>
 <p>
-GRML_XL: large size Grml version, used to be known as "full grml" until
-December 2011 (~700MB ISO size).
-</p>
-</li>
-<li>
-<p>
 LATEX: LaTeX(-related) packages like auctex, texlive,&#8230;
 (which used to be shipped by grml before the LaTeX removal)
 </p>
@@ -1303,19 +1315,19 @@ fai-doc). Furthermore /usr/share/doc/fai-doc/fai-guide.html/ch-config.html
 provides documentation regarding configuration possibilities.</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt>/usr/sbin/grml-live</tt></pre>
+<pre><code>/usr/sbin/grml-live</code></pre>
 </div></div>
 <div class="paragraph"><p>Script for the main build process. Requires root permissions for execution.</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt>/etc/grml/grml-live.conf</tt></pre>
+<pre><code>/etc/grml/grml-live.conf</code></pre>
 </div></div>
 <div class="paragraph"><p>Main configuration file for grml-live which should be considered as a reference
 configuration file only. Please use /etc/grml/grml-live.local for local
 configuration instead.</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt>/etc/grml/grml-live.local</tt></pre>
+<pre><code>/etc/grml/grml-live.local</code></pre>
 </div></div>
 <div class="paragraph"><p>All the local configuration should go to this file. This file overrides any
 defaults of grml-live. Configurations via /etc/grml/grml-live.local are preferred
@@ -1324,7 +1336,7 @@ from /etc/grml/grml-live.local as well you have to specify them on the grml-live
 commandline.</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt>${GRML_FAI_CONFIG}/fai.conf</tt></pre>
+<pre><code>${GRML_FAI_CONFIG}/fai.conf</code></pre>
 </div></div>
 <div class="paragraph"><p>Main configuration file for FAI which specifies where all the configuration
 files and scripts for FAI/grml-live can be found. By default the configuration
@@ -1334,31 +1346,31 @@ 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}/config/</tt></pre>
+<pre><code>${GRML_FAI_CONFIG}/config/</code></pre>
 </div></div>
 <div class="paragraph"><p>The main directory for configuration of FAI/grml-live. More details below.</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt>${GRML_FAI_CONFIG}/config/class/</tt></pre>
+<pre><code>${GRML_FAI_CONFIG}/config/class/</code></pre>
 </div></div>
 <div class="paragraph"><p>This directory contains files which specify main configuration variables for the
 FAI classes.</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt>${GRML_FAI_CONFIG}/config/debconf/</tt></pre>
+<pre><code>${GRML_FAI_CONFIG}/config/debconf/</code></pre>
 </div></div>
 <div class="paragraph"><p>This directory provides the files for preseeding/configuration of debconf
 through files.</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt>${GRML_FAI_CONFIG}/config/hooks/</tt></pre>
+<pre><code>${GRML_FAI_CONFIG}/config/hooks/</code></pre>
 </div></div>
 <div class="paragraph"><p>This directory provides files for customising the build process through hooks.
 Hooks are user defined programs or scripts, which are called during the
 installation process.</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt>${GRML_FAI_CONFIG}/config/package_config/</tt></pre>
+<pre><code>${GRML_FAI_CONFIG}/config/package_config/</code></pre>
 </div></div>
 <div class="paragraph"><p>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
@@ -1371,12 +1383,12 @@ directory GRMLBASE contains a package list defining a minimum but still
 reasonable package configuration.</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt>${GRML_FAI_CONFIG}/config/scripts/</tt></pre>
+<pre><code>${GRML_FAI_CONFIG}/config/scripts/</code></pre>
 </div></div>
 <div class="paragraph"><p>Scripts for customising the ISO within the build process.</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt>${GRML_FAI_CONFIG}/live-initramfs/</tt></pre>
+<pre><code>${GRML_FAI_CONFIG}/live-initramfs/</code></pre>
 </div></div>
 <div class="paragraph"><p>This directory provides the files used for building the initramfs/initrd via
 live-initramfs(8).</p></div>
@@ -1424,9 +1436,8 @@ chroot (check out "local mirror" to workaround this problem as far as possible)
 <div class="sect1">
 <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/testing and Debian/unstable) to build Grml (based) ISOs featuring kernel
-version 2.6.38-grml[64] or newer.</p></div>
+<div class="paragraph"><p>Use squashfs-tools &gt;=4.2-1 to build Grml (based) ISOs featuring kernel version
+2.6.38-grml[64] or newer.</p></div>
 </div>
 </div>
 <div class="sect1">
@@ -1437,53 +1448,51 @@ version 2.6.38-grml[64] or newer.</p></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
+<div class="paragraph"><p>What we have: plain, original Debian jessie (8.x).</p></div>
+<div class="paragraph"><p>What we want: build a Grml ISO based on Debian/jessie for the amd64 architecture
 using grml-live.</p></div>
 <div class="sect3">
 <h4 id="_instructions">13.1.1. Instructions</h4>
 <div class="literalblock">
 <div class="content">
-<pre><tt># adjust sources.list:
-cat &gt;&gt; /etc/apt/sources.list &lt;&lt; EOF</tt></pre>
+<pre><code># adjust sources.list:
+cat &gt;&gt; /etc/apt/sources.list &lt;&lt; EOF</code></pre>
 </div></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt># grml stable repository:
+<pre><code># grml stable repository:
   deb     http://deb.grml.org/ grml-stable  main
-# deb-src http://deb.grml.org/ grml-stable  main</tt></pre>
+# deb-src http://deb.grml.org/ grml-stable  main</code></pre>
 </div></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt># grml testing/development repository:
+<pre><code># grml testing/development repository:
   deb     http://deb.grml.org/ grml-testing main
 # deb-src http://deb.grml.org/ grml-testing main
-EOF</tt></pre>
+EOF</code></pre>
 </div></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt># get keyring for apt:
+<pre><code># get keyring for apt:
 apt-get update
-apt-get --allow-unauthenticated install grml-debian-keyring</tt></pre>
+apt-get --allow-unauthenticated install grml-debian-keyring</code></pre>
 </div></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt># optionally(!) install basefile so we don't have to build basic
+<pre><code># 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 I386.tar.gz /etc/grml/fai/config/basefiles/
-# mv AMD64.tar.gz /etc/grml/fai/config/basefiles/</tt></pre>
+# mv AMD64.tar.gz /etc/grml/fai/config/basefiles/</code></pre>
 </div></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt># install relevant tools
-apt-get install -t squeeze-backports squashfs-tools
-apt-get --no-install-recommends install grml-live</tt></pre>
+<pre><code># install relevant tools
+apt-get --no-install-recommends install grml-live</code></pre>
 </div></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt># adjust grml-live configuration for our needs:
+<pre><code># adjust grml-live configuration for our needs:
 cat &gt; /etc/grml/grml-live.local &lt;&lt; EOF
 ## want a faster build process and don't need smaller ISOs?
 ## if so use zlib compression
@@ -1494,31 +1503,31 @@ cat &gt; /etc/grml/grml-live.local &lt;&lt; EOF
 # CHROOT_INSTALL="/etc/grml/fai/chroot_install"
 ## adjust if necessary (defaults to /grml/grml-live):
 ## OUTPUT="/srv/grml-live"
-FAI_DEBOOTSTRAP="wheezy http://cdn.debian.net/debian/"
+FAI_DEBOOTSTRAP="jessie http://ftp.debian.org/debian/"
 # ARCH="amd64"
 CLASSES="GRMLBASE,GRML_FULL,AMD64"
-EOF</tt></pre>
+EOF</code></pre>
 </div></div>
 <div class="literalblock">
 <div class="content">
-<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 squeeze koeln
-EOF</tt></pre>
+<pre><code># just optional(!) - upgrade FAI to latest available version:
+cat &gt;&gt; /etc/apt/sources.list.d/fai.list &lt;&lt; EOF
+deb     http://jenkins.grml.org/debian fai main
+deb-src http://jenkins.grml.org/debian fai main
+EOF</code></pre>
 </div></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt># get gpg key of FAI repos and install current FAI version:
-gpg -a --recv-keys AB9B66FD; gpg -a --export AB9B66FD | apt-key add -
+<pre><code># get gpg key of FAI repos and install current FAI version:
+wget -O - http://jenkins.grml.org/debian/C525F56752D4A654.asc | sudo apt-key add -
 apt-get update
-apt-get install fai-client fai-server fai-doc</tt></pre>
+apt-get install fai-client fai-server fai-doc</code></pre>
 </div></div>
 <div class="paragraph"><p>That&#8217;s it. Now invoking <em>grml-live -V</em> should build the ISO.  If everything
 worked as expected the last line of the shell output should look like:</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt>[*] Successfully finished execution of grml-live [running 687 seconds]</tt></pre>
+<pre><code>[*] Successfully finished execution of grml-live [running 687 seconds]</code></pre>
 </div></div>
 <div class="paragraph"><p>and the ISO can be found inside /grml-live/grml-live/grml_isos/ then.</p></div>
 </div>
@@ -1549,11 +1558,11 @@ under <em>/</em> in the chroot - so you have to create the rootfs structure on y
 own. Usage example:</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt>echo "CHROOT_INSTALL=\$GRML_FAI_CONFIG/chroot_install" &gt;&gt; /etc/grml/grml-live.local
+<pre><code>echo "CHROOT_INSTALL=\$GRML_FAI_CONFIG/chroot_install" &gt;&gt; /etc/grml/grml-live.local
 mkdir -p /etc/grml/fai/chroot_install/usr/src/
 wget example.org/foo.tar.gz
 mv foo.tar.gz /etc/grml/fai/chroot_install/usr/src/
-grml-live ...</tt></pre>
+grml-live ...</code></pre>
 </div></div>
 </div>
 <div class="sect2">
@@ -1567,7 +1576,7 @@ adjust MIRROR_DIRECTORY in /etc/grml/grml-live.conf[.local] as well.</p></div>
 <div class="paragraph"><p>If you want to use a HTTP Proxy (like apt-cacher-ng), set APT_PROXY. Example:</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt>APT_PROXY="http://localhost:3142/"</tt></pre>
+<pre><code>APT_PROXY="http://localhost:3142/"</code></pre>
 </div></div>
 </div>
 <div class="sect2">
@@ -1575,20 +1584,20 @@ adjust MIRROR_DIRECTORY in /etc/grml/grml-live.conf[.local] as well.</p></div>
 <div class="paragraph"><p>Just create a new class (using the package_config directory):</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt># cat &gt; /etc/grml/fai/config/package_config/MIKA &lt;&lt; EOF
-PACKAGES aptitude</tt></pre>
+<pre><code># cat &gt; /etc/grml/fai/config/package_config/MIKA &lt;&lt; EOF
+PACKAGES aptitude</code></pre>
 </div></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt>vim
+<pre><code>vim
 another_name_of_a_debian_package
 and_another_one
-EOF</tt></pre>
+EOF</code></pre>
 </div></div>
 <div class="paragraph"><p>and specify it when invoking grml-live then:</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt># grml-live -c GRMLBASE,GRML_SMALL,AMD64,MIKA</tt></pre>
+<pre><code># grml-live -c GRMLBASE,GRML_SMALL,AMD64,MIKA</code></pre>
 </div></div>
 </div>
 <div class="sect2">
@@ -1597,18 +1606,50 @@ EOF</tt></pre>
 what you are searching for just run:</p></div>
 <div class="literalblock">
 <div class="content">
-<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>
+<pre><code>rm -rf /etc/grml/fai /etc/grml/grml-live.conf
+dpkg -i --force-confnew --force-confmiss /path/to/grml-live_..._all.deb</code></pre>
+</div></div>
+</div>
+<div class="sect2">
+<h3 id="apt-cacher">13.8. 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><code># cat /etc/grml/grml-live.local
+[...]
+APT_PROXY="http://localhost:3142/"
+[...]
+FAI_DEBOOTSTRAP="jessie http://localhost:3142/ftp.debian.org/debian jessie main contrib non-free"</code></pre>
 </div></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="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>
+<h3 id="revert_manifold">13.9. How do I revert the manifold feature from an ISO?</h3>
+<div class="paragraph"><p>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:</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>
+<pre><code>% dd if=/dev/zero of=grml.iso bs=512 count=1 conv=notrunc</code></pre>
+</div></div>
+<div class="paragraph"><p>To switch from manifold to isohybrid mode (an alternative approach provided by
+syslinux) then just execute:</p></div>
+<div class="literalblock">
+<div class="content">
+<pre><code>% isohybrid grml.iso</code></pre>
+</div></div>
+</div>
+<div class="sect2">
+<h3 id="create-a-base-tgz">13.10. How do I create a base tar.gz (I386.tar.gz or AMD64.tar.gz)</h3>
+<div class="paragraph" id="basetgz"><p>First of all create the chroot using debootstrap (requires root):</p></div>
+<div class="literalblock">
+<div class="content">
+<pre><code>BASECHROOT='/tmp/basefile'  # path where the chroot gets generated
+SUITE='jessie'              # 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 ./</code></pre>
 </div></div>
 <div class="admonitionblock">
 <table><tr>
@@ -1621,105 +1662,133 @@ then invoke debootstrap using the <em>--arch i386</em> option. Disclaimer: build
 AMD64 base.tgz won&#8217;t work if you are using a 32bit kernel system of course.</td>
 </tr></table>
 </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
+<div class="paragraph"><p>Finally place the generated tarball in /etc/grml/fai/config/basefiles/ (note
+that it needs to be uppercase letters matching the class names, so: e.g.
+AMD64.tar.gz for amd64 and I386.tar.gz for i386).</p></div>
+<div class="paragraph"><p>Then 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>[...]
+<pre><code>[...]
 ftar: extracting //etc/grml/fai/config/basefiles///AMD64.tar.gz to /srv/grml64_testing/grml_chroot//
-[...]</tt></pre>
+[...]</code></pre>
 </div></div>
-<div class="admonitionblock">
-<table><tr>
-<td class="icon">
-<img src="./images/icons/tip.png" alt="Tip" />
-</td>
-<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>
 <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>
+<h3 id="localrepos">13.11. How to use your own local repository</h3>
+<div class="paragraph"><p>Let&#8217;s assume you have Debian package(s) in your filesystem inside
+<code>/home/foobar/local-packages</code> and want to provide them to your grml-live build.
+This can be achieved either 1) through a bind mount (using the MIRROR_DIRECTORY
+configuration) or 2) by serving a repository via HTTP.</p></div>
+<div class="sect3">
+<h4 id="_serving_via_bind_mount_mirror_directory">13.11.1. Serving via bind mount / MIRROR_DIRECTORY</h4>
+<div class="paragraph"><p>Make sure to create an according sources.list configuration file, e.g. using
+your own class name <code>CUSTOM</code>:</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt># 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"</tt></pre>
+<pre><code># cat &gt; /etc/grml/fai/config/files/etc/apt/sources.list.d/local-packages.list/CUSTOM &lt;&lt; EOF
+deb file:///home/foobar/local-packages ./
+EOF</code></pre>
 </div></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>
-<div class="paragraph"><p>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:</p></div>
+<div class="paragraph"><p>Add the according MIRROR_DIRECTORY configuration to your grml-live configuration:</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt>% dd if=/dev/zero of=grml.iso bs=512 count=1 conv=notrunc</tt></pre>
+<pre><code># echo "MIRROR_DIRECTORY='/home/foobar/packages'" &gt;&gt; /etc/grml/grml-live.local</code></pre>
 </div></div>
-<div class="paragraph"><p>To switch from manifold to isohybrid mode (an alternative approach provided by
-syslinux) then just execute:</p></div>
+<div class="paragraph"><p>Make sure the local directory looks like a mirror:</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt>% isohybrid grml.iso</tt></pre>
+<pre><code>% cd /home/foobar/packages
+% dpkg-scanpackages . /dev/null | gzip &gt; Packages.gz</code></pre>
 </div></div>
+<div class="paragraph"><p>Finally invoke grml-live with your class name (<code>CUSTOM</code> in this example) added
+to the list of classes on the command line (see grml-live option <code>-c</code>).</p></div>
 </div>
-<div class="sect2">
-<h3 id="basetgz">13.11. How do I create a base tar.gz (I386.tar.gz or AMD64.tar.gz)</h3>
-<div class="paragraph"><p>Execute the following commands (requires root):</p></div>
+<div class="sect3">
+<h4 id="_serving_a_repository_via_http">13.11.2. Serving a repository via HTTP</h4>
+<div class="paragraph"><p>Make sure to create an according sources.list configuration file, e.g. using
+your own class name <code>CUSTOM</code>:</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt>ARCH='amd64' # replace with i386 if necessary
-SUITE='squeeze' # using the current stable release should always work
-debootstrap --arch "$ARCH" --exclude=info,tasksel,tasksel-data "$SUITE" "$ARCH" http://debian.netcologne.de/debian
-cd "$ARCH"
-rm var/cache/apt/archives/*.deb
-tar zcf ../"${ARCH}".tar.gz *</tt></pre>
+<pre><code># cat &gt; /etc/grml/fai/config/files/etc/apt/sources.list.d/local-packages.list/CUSTOM &lt;&lt; EOF
+deb http://127.0.0.1:8000/ ./
+EOF</code></pre>
 </div></div>
-<div class="paragraph"><p>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).</p></div>
+<div class="paragraph"><p>Make sure the local directory is served via HTTP on the according IP address and
+port. For the <code>http://127.0.0.1:8000/</code> example from above it should be enough to
+just invoke:</p></div>
+<div class="literalblock">
+<div class="content">
+<pre><code>% cd /home/foobar/packages
+% dpkg-scanpackages . /dev/null | gzip &gt; Packages.gz
+% python -m SimpleHTTPServer 8000</code></pre>
+</div></div>
+<div class="admonitionblock">
+<table><tr>
+<td class="icon">
+<img src="./images/icons/tip.png" alt="Tip" />
+</td>
+<td class="content">Of course you can also use a real Debian repository setup using tools like
+reprepro(1) and/or using a real web server, though for quick debugging sessions
+python&#8217;s SimpleHTTPServer in combination with dpkg-scanpackages from package
+dpkg-dev is a simple and easy approach.</td>
+</tr></table>
+</div>
+<div class="paragraph"><p>Finally invoke grml-live with your class name (<code>CUSTOM</code> in this example) added
+to the list of classes on the command line (see grml-live option <code>-c</code>).</p></div>
+</div>
 </div>
 </div>
 </div>
 <div class="sect1">
 <h2 id="download">14. Download / install grml-live as a Debian package</h2>
 <div class="sectionbody">
-<div class="paragraph"><p>Debian packages are available through the grml-repository at
-<a href="http://deb.grml.org/pool/main/g/grml-live/">deb.grml.org</a>.  If you want to
-build a Debian package on your own (using for example a specific version or the
-current development tree), just execute:</p></div>
+<div class="paragraph"><p>Stable Debian packages are available through the grml-repository at
+<a href="http://deb.grml.org/pool/main/g/grml-live/">deb.grml.org</a> and the latest
+Git commits are available as Debian packages from
+<a href="http://jenkins.grml.org/job/grml-live-binaries/">jenkins.grml.org</a>.
+If you want to build a Debian package on your own (using for example a specific
+version or the current development tree), just execute:</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt>git clone git://git.grml.org/grml-live
+<pre><code>git clone git://git.grml.org/grml-live
 cd grml-live
-debuild -us -uc</tt></pre>
+debuild -us -uc</code></pre>
+</div></div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="run-from-git">15. Run grml-live directly from git</h2>
+<div class="sectionbody">
+<div class="paragraph"><p>In case you want to run grml-live directly from the git repository checkout
+(after making sure all dependencies are installed), you should set
+<code>GRML_FAI_CONFIG</code> so that a) it finds the according FAI configuration files and
+b) does not use the config files of an possibly installed <code>grml-live</code> package.
+Usage example:</p></div>
+<div class="literalblock">
+<div class="content">
+<pre><code># export GRML_FAI_CONFIG=$(pwd)/etc/grml/fai
+# export SCRIPTS_DIRECTORY=$(pwd)/scripts
+# ./grml-live -s sid -a amd64 -c GRMLBASE,GRML_FULL,AMD64</code></pre>
 </div></div>
 </div>
 </div>
 <div class="sect1">
-<h2 id="source">15. Source</h2>
+<h2 id="source">16. Source</h2>
 <div class="sectionbody">
 <div class="paragraph"><p>The source of grml-live is available at
 <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">16. Bugs</h2>
+<h2 id="bugs">17. 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>
 </div>
 </div>
 <div class="sect1">
-<h2 id="documentation">17. Documentation</h2>
+<h2 id="documentation">18. 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
@@ -1739,7 +1808,7 @@ in different formats:</p></div>
 </div>
 </div>
 <div class="sect1">
-<h2 id="authors">18. Authors</h2>
+<h2 id="authors">19. 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>
@@ -1748,7 +1817,8 @@ in different formats:</p></div>
 <div id="footnotes"><hr /></div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2012-09-26 19:37:35 CEST
+Last updated
+ 2016-02-15 22:15:22 CET
 </div>
 </div>
 </body>
