Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Browse files

grml-live: refresh docs from grml-live.git

  • Loading branch information...
commit 5f85692ed8abdbee4abf13724c11c92174e9306e 1 parent a302ea6
@mika mika authored
BIN  grml-live/grml-live.epub
Binary file not shown
BIN  grml-live/grml-live.pdf
Binary file not shown
169 grml-live/index.html
@@ -752,9 +752,10 @@ <h2 id="_name">1. Name</h2>
<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;] [
+<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;] [
@@ -808,8 +809,8 @@ <h2 id="_options">4. Options</h2>
-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.
<dt class="hdlist1">
@@ -920,6 +921,15 @@ <h2 id="_options">4. Options</h2>
<dt class="hdlist1">
+-e <strong>EXTRACT_ISO_NAME</strong>
+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.
+<dt class="hdlist1">
@@ -1047,15 +1057,6 @@ <h2 id="_options">4. Options</h2>
<dt class="hdlist1">
--T <strong>CHROOT_ARCHIVE</strong>
-Unpack chroot tar archive before starting. Most useful in combination with
--A and -b or -u.
-<dt class="hdlist1">
@@ -1120,12 +1121,10 @@ <h2 id="usage-examples">5. Usage examples</h2>
<td class="icon">
<img src="./images/icons/note.png" alt="Note" />
-<td class="content">If you have enough 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
@@ -1449,7 +1448,8 @@ <h3 id="deploy-on-debian">13.1. How do I deploy grml-live on a plain Debian inst
<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).</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">
@@ -1474,21 +1474,6 @@ <h4 id="_instructions">13.1.1. Instructions</h4>
<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
-Pin-Priority: 1</tt></pre>
-<div class="literalblock">
-<div class="content">
-<pre><tt>Package: squashfs-tools
-Pin: origin
-Pin-Priority: 996
-<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>
@@ -1498,14 +1483,14 @@ <h4 id="_instructions">13.1.1. Instructions</h4>
<pre><tt># optionally(!) install basefile so we don't have to build basic
# chroot from scratch, grab from
# 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 class="literalblock">
<div class="content">
<pre><tt># install relevant tools
-# please check out 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 class="literalblock">
<div class="content">
@@ -1628,46 +1613,33 @@ <h3 id="reset-grml-live-configuration">13.7. I fscked up my grml-live configurat
<div class="sect2">
-<h3 id="create-a-base-tgz">13.8. 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/
-tar zcf base.tgz ./</tt></pre>
-<div class="paragraph"><p>Then check out where your NFSROOT is located:</p></div>
+<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># grep '^NFSROOT' /etc/grml/fai/make-fai-nfsroot.conf
+debootstrap squeeze "$BASECHROOT"
+tar -C "$BASECHROOT" --exclude='var/cache/apt/archives/*.deb' -zcf base.tar.gz ./</tt></pre>
-<div class="paragraph"><p>So as /grml/fai/nfsroot is your NFSROOT place the file under
-<div class="literalblock">
-<div class="content">
-<pre><tt>mv base.tgz /grml/fai/nfsroot/live/filesystem.dir/var/tmp/base.tgz</tt></pre>
-<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
-<div class="literalblock">
-<div class="content">
-Calling task_extrbase
-Unpacking Debian base archive
-Extracting /grml/fai/nfsroot/live/filesystem.dir/var/tmp/base.tgz
-Calling task_mirror
-<div class="paragraph"><p>or if using /etc/grml/fai/config/basefiles/$CLASSNAME.tar.gz for:</p></div>
+<div class="admonitionblock">
+<td class="icon">
+<img src="./images/icons/tip.png" alt="Tip" />
+<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>
+<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">
-ftar: extracting /etc/grml/fai/config/basefiles///AMD64.tar.gz to
+ftar: extracting //etc/grml/fai/config/basefiles///AMD64.tar.gz to /srv/grml64_testing/grml_chroot//
<div class="admonitionblock">
@@ -1726,53 +1698,6 @@ <h3 id="basetgz">13.11. How do I create a base tar.gz (I386.tar.gz or AMD64.tar.
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="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=""></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/</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 the
-provided 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/ ./" &gt;&gt; /etc/apt/sources.list.d/grml-live.list
-adduser --disabled-login --disabled-password grml-live-git</tt></pre>
-<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 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
-git clone git://
-git config --global "Grml-Live Git Autobuild"
-git config --global "grml-live-git@$(hostname)"</tt></pre>
-<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/ &gt;/home/grml-live-git/grml-live-build.log</tt></pre>
-<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 class="paragraph"><p>and run "date -ud @$STRING" where $STRING is the number behind the "autobuild",
-<div class="literalblock">
-<div class="content">
-<pre><tt>% date -ud @1300450081
-Fri Mar 18 12:08:01 UTC 2011</tt></pre>
<div class="sect1">
@@ -1834,7 +1759,7 @@ <h2 id="authors">18. Authors</h2>
<div id="footnotes"><hr /></div>
<div id="footer">
<div id="footer-text">
-Last updated 2011-12-12 16:10:01 CET
+Last updated 2012-01-19 13:18:45 CET
Please sign in to comment.
Something went wrong with that request. Please try again.