<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">\r
<head>\r
<meta http-equiv="Content-Type" content="application/xhtml+xml; charset=UTF-8" />\r
-<meta name="generator" content="AsciiDoc 8.6.7" />\r
+<meta name="generator" content="AsciiDoc 8.6.9" />\r
<title>grml-live(8)</title>\r
<style type="text/css">\r
/* Shared CSS for AsciiDoc xhtml11 and html5 backends */\r
ul > li { color: #aaa; }\r
ul > li > * { color: black; }\r
\r
-pre {\r
+.monospaced, code, pre {\r
+ font-family: "Courier New", Courier, monospace;\r
+ font-size: inherit;\r
+ color: navy;\r
padding: 0;\r
margin: 0;\r
}\r
+pre {\r
+ white-space: pre-wrap;\r
+}\r
\r
#author {\r
color: #527bbd;\r
}\r
\r
div.imageblock div.content { padding-left: 0; }\r
-span.image img { border-style: none; }\r
+span.image img { border-style: none; vertical-align: text-bottom; }\r
a.image:visited { color: white; }\r
\r
dl {\r
*\r
* */\r
\r
-tt {\r
- font-family: "Courier New", Courier, monospace;\r
- font-size: inherit;\r
- color: navy;\r
-}\r
-\r
div.tableblock {\r
margin-top: 1.0em;\r
margin-bottom: 1.5em;\r
*\r
* */\r
\r
-.monospaced {\r
- font-family: "Courier New", Courier, monospace;\r
- font-size: inherit;\r
- color: navy;\r
-}\r
-\r
table.tableblock {\r
margin-top: 1.0em;\r
margin-bottom: 1.5em;\r
@media print {\r
body.manpage div#toc { display: none; }\r
}\r
+\r
+\r
</style>\r
<script type="text/javascript">\r
/*<![CDATA[*/\r
</dt>\r
<dd>\r
<p>\r
-Specify the Debian suite you want to use for your live-system. Defaults to\r
-"squeeze" (being current Debian/stable). Supported values are: etch, lenny,\r
-squeeze, wheezy, sid. Please be aware that recent Debian suites might require a\r
-recent version of debootstrap.\r
+Specify the Debian suite you want to use for your live-system. If unset defaults\r
+to "testing". Supported values are: stable, testing, unstable (or their\r
+corresponding release names like "wheezy"). Please be aware that recent Debian\r
+suites might require a recent base.tgz\r
+debootstrap.\r
</p>\r
</dd>\r
<dt class="hdlist1">\r
as build and output directory just run:</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt># grml-live</tt></pre>\r
+<pre><code># grml-live</code></pre>\r
</div></div>\r
<div class="paragraph"><p>To get a 64bit Debian-testing and grml-small based Live-CD using /srv/grml-live\r
as build and output directory use the following command line on your amd64\r
system:</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt># grml-live -s testing -c GRMLBASE,GRML_SMALL,AMD64 -o /srv/grml-live</tt></pre>\r
+<pre><code># grml-live -s testing -c GRMLBASE,GRML_SMALL,AMD64 -o /srv/grml-live</code></pre>\r
</div></div>\r
<div class="admonitionblock">\r
<table><tr>\r
relevant for class GRMLBASE by default:</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt>${GRML_FAI_CONFIG}/config/scripts/GRMLBASE/\r
+<pre><code>${GRML_FAI_CONFIG}/config/scripts/GRMLBASE/\r
${GRML_FAI_CONFIG}/config/debconf/GRMLBASE\r
${GRML_FAI_CONFIG}/config/class/GRMLBASE.var\r
${GRML_FAI_CONFIG}/config/hooks/instsoft.GRMLBASE\r
-${GRML_FAI_CONFIG}/config/package_config/GRMLBASE</tt></pre>\r
+${GRML_FAI_CONFIG}/config/package_config/GRMLBASE</code></pre>\r
</div></div>\r
<div class="paragraph"><p>Take a look at the next section for information about the concept of those\r
files/directories.</p></div>\r
</li>\r
<li>\r
<p>\r
+FRESHCLAM: execute freshclam (if it’s present) to update clamav definitions\r
+(increases resulting ISO size ~70MB). By default it’s skipped to avoid bigger\r
+ISO size.\r
+</p>\r
+</li>\r
+<li>\r
+<p>\r
GRMLBASE: the main class responsible for getting a minimal subset of what’s\r
defining a Grml system. Important parts of the buildprocess are specified in\r
this class as well, so unless you have a really good reason you should always\r
provides documentation regarding configuration possibilities.</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt>/usr/sbin/grml-live</tt></pre>\r
+<pre><code>/usr/sbin/grml-live</code></pre>\r
</div></div>\r
<div class="paragraph"><p>Script for the main build process. Requires root permissions for execution.</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt>/etc/grml/grml-live.conf</tt></pre>\r
+<pre><code>/etc/grml/grml-live.conf</code></pre>\r
</div></div>\r
<div class="paragraph"><p>Main configuration file for grml-live which should be considered as a reference\r
configuration file only. Please use /etc/grml/grml-live.local for local\r
configuration instead.</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt>/etc/grml/grml-live.local</tt></pre>\r
+<pre><code>/etc/grml/grml-live.local</code></pre>\r
</div></div>\r
<div class="paragraph"><p>All the local configuration should go to this file. This file overrides any\r
defaults of grml-live. Configurations via /etc/grml/grml-live.local are preferred\r
commandline.</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt>${GRML_FAI_CONFIG}/fai.conf</tt></pre>\r
+<pre><code>${GRML_FAI_CONFIG}/fai.conf</code></pre>\r
</div></div>\r
<div class="paragraph"><p>Main configuration file for FAI which specifies where all the configuration\r
files and scripts for FAI/grml-live can be found. By default the configuration\r
file.</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt>${GRML_FAI_CONFIG}/config/</tt></pre>\r
+<pre><code>${GRML_FAI_CONFIG}/config/</code></pre>\r
</div></div>\r
<div class="paragraph"><p>The main directory for configuration of FAI/grml-live. More details below.</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt>${GRML_FAI_CONFIG}/config/class/</tt></pre>\r
+<pre><code>${GRML_FAI_CONFIG}/config/class/</code></pre>\r
</div></div>\r
<div class="paragraph"><p>This directory contains files which specify main configuration variables for the\r
FAI classes.</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt>${GRML_FAI_CONFIG}/config/debconf/</tt></pre>\r
+<pre><code>${GRML_FAI_CONFIG}/config/debconf/</code></pre>\r
</div></div>\r
<div class="paragraph"><p>This directory provides the files for preseeding/configuration of debconf\r
through files.</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt>${GRML_FAI_CONFIG}/config/hooks/</tt></pre>\r
+<pre><code>${GRML_FAI_CONFIG}/config/hooks/</code></pre>\r
</div></div>\r
<div class="paragraph"><p>This directory provides files for customising the build process through hooks.\r
Hooks are user defined programs or scripts, which are called during the\r
installation process.</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt>${GRML_FAI_CONFIG}/config/package_config/</tt></pre>\r
+<pre><code>${GRML_FAI_CONFIG}/config/package_config/</code></pre>\r
</div></div>\r
<div class="paragraph"><p>Directory with lists of software packages to be installed or removed. The\r
different classes describe what should find its way to your ISO. When running\r
reasonable package configuration.</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt>${GRML_FAI_CONFIG}/config/scripts/</tt></pre>\r
+<pre><code>${GRML_FAI_CONFIG}/config/scripts/</code></pre>\r
</div></div>\r
<div class="paragraph"><p>Scripts for customising the ISO within the build process.</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt>${GRML_FAI_CONFIG}/live-initramfs/</tt></pre>\r
+<pre><code>${GRML_FAI_CONFIG}/live-initramfs/</code></pre>\r
</div></div>\r
<div class="paragraph"><p>This directory provides the files used for building the initramfs/initrd via\r
live-initramfs(8).</p></div>\r
<h2 id="current_state">12. Current state of grml-live with squashfs-tools and kernel</h2>\r
<div class="sectionbody">\r
<div class="paragraph"><p>Use squashfs-tools >=4.2-1 (available from Grml repositories as well as from\r
-Debian/testing and Debian/unstable) to build Grml (based) ISOs featuring kernel\r
-version 2.6.38-grml[64] or newer.</p></div>\r
+Debian) to build Grml (based) ISOs featuring kernel version 2.6.38-grml[64] or\r
+newer.</p></div>\r
</div>\r
</div>\r
<div class="sect1">\r
<div class="paragraph"><p>The easiest way to get a running grml-live setup is to just use Grml.\r
Of course using grml-live on a plain, original Debian installation is supported\r
as well. So there we go.</p></div>\r
-<div class="paragraph"><p>What we have: plain, original Debian squeeze (6.0) with debian-backports\r
-enabled. (This is important for squashfs-tools.)</p></div>\r
+<div class="paragraph"><p>What we have: plain, original Debian wheezy (7.x).</p></div>\r
<div class="paragraph"><p>What we want: build a Grml ISO based on Debian/wheezy for the amd64 architecture\r
using grml-live.</p></div>\r
<div class="sect3">\r
<h4 id="_instructions">13.1.1. Instructions</h4>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt># adjust sources.list:\r
-cat >> /etc/apt/sources.list << EOF</tt></pre>\r
+<pre><code># adjust sources.list:\r
+cat >> /etc/apt/sources.list << EOF</code></pre>\r
</div></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt># grml stable repository:\r
+<pre><code># grml stable repository:\r
deb http://deb.grml.org/ grml-stable main\r
-# deb-src http://deb.grml.org/ grml-stable main</tt></pre>\r
+# deb-src http://deb.grml.org/ grml-stable main</code></pre>\r
</div></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt># grml testing/development repository:\r
+<pre><code># grml testing/development repository:\r
deb http://deb.grml.org/ grml-testing main\r
# deb-src http://deb.grml.org/ grml-testing main\r
-EOF</tt></pre>\r
+EOF</code></pre>\r
</div></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt># get keyring for apt:\r
+<pre><code># get keyring for apt:\r
apt-get update\r
-apt-get --allow-unauthenticated install grml-debian-keyring</tt></pre>\r
+apt-get --allow-unauthenticated install grml-debian-keyring</code></pre>\r
</div></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt># optionally(!) install basefile so we don't have to build basic\r
+<pre><code># optionally(!) install basefile so we don't have to build basic\r
# chroot from scratch, grab from http://daily.grml.org/\r
# mkdir -p /etc/grml/fai/config/basefiles/\r
# mv I386.tar.gz /etc/grml/fai/config/basefiles/\r
-# mv AMD64.tar.gz /etc/grml/fai/config/basefiles/</tt></pre>\r
+# mv AMD64.tar.gz /etc/grml/fai/config/basefiles/</code></pre>\r
</div></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt># install relevant tools\r
-apt-get install -t squeeze-backports squashfs-tools\r
-apt-get --no-install-recommends install grml-live</tt></pre>\r
+<pre><code># install relevant tools\r
+apt-get --no-install-recommends install grml-live</code></pre>\r
</div></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt># adjust grml-live configuration for our needs:\r
+<pre><code># adjust grml-live configuration for our needs:\r
cat > /etc/grml/grml-live.local << EOF\r
## want a faster build process and don't need smaller ISOs?\r
## if so use zlib compression\r
# CHROOT_INSTALL="/etc/grml/fai/chroot_install"\r
## adjust if necessary (defaults to /grml/grml-live):\r
## OUTPUT="/srv/grml-live"\r
-FAI_DEBOOTSTRAP="wheezy http://cdn.debian.net/debian/"\r
+FAI_DEBOOTSTRAP="wheezy http://http.debian.net/debian/"\r
# ARCH="amd64"\r
CLASSES="GRMLBASE,GRML_FULL,AMD64"\r
-EOF</tt></pre>\r
+EOF</code></pre>\r
</div></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt># just optional(!) - upgrade FAI to latest available version:\r
-cat >> /etc/apt/sources.list << EOF\r
-# fai:\r
- deb http://fai-project.org/download squeeze koeln\r
-EOF</tt></pre>\r
+<pre><code># just optional(!) - upgrade FAI to latest available version:\r
+cat >> /etc/apt/sources.list.d/fai.list << EOF\r
+deb http://jenkins.grml.org/debian fai main\r
+deb-src http://jenkins.grml.org/debian fai main\r
+EOF</code></pre>\r
</div></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt># get gpg key of FAI repos and install current FAI version:\r
-gpg -a --recv-keys AB9B66FD; gpg -a --export AB9B66FD | apt-key add -\r
+<pre><code># get gpg key of FAI repos and install current FAI version:\r
+wget -O - http://jenkins.grml.org/debian/C525F56752D4A654.asc | sudo apt-key add -\r
apt-get update\r
-apt-get install fai-client fai-server fai-doc</tt></pre>\r
+apt-get install fai-client fai-server fai-doc</code></pre>\r
</div></div>\r
<div class="paragraph"><p>That’s it. Now invoking <em>grml-live -V</em> should build the ISO. If everything\r
worked as expected the last line of the shell output should look like:</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt>[*] Successfully finished execution of grml-live [running 687 seconds]</tt></pre>\r
+<pre><code>[*] Successfully finished execution of grml-live [running 687 seconds]</code></pre>\r
</div></div>\r
<div class="paragraph"><p>and the ISO can be found inside /grml-live/grml-live/grml_isos/ then.</p></div>\r
</div>\r
own. Usage example:</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt>echo "CHROOT_INSTALL=\$GRML_FAI_CONFIG/chroot_install" >> /etc/grml/grml-live.local\r
+<pre><code>echo "CHROOT_INSTALL=\$GRML_FAI_CONFIG/chroot_install" >> /etc/grml/grml-live.local\r
mkdir -p /etc/grml/fai/chroot_install/usr/src/\r
wget example.org/foo.tar.gz\r
mv foo.tar.gz /etc/grml/fai/chroot_install/usr/src/\r
-grml-live ...</tt></pre>\r
+grml-live ...</code></pre>\r
</div></div>\r
</div>\r
<div class="sect2">\r
<div class="paragraph"><p>If you want to use a HTTP Proxy (like apt-cacher-ng), set APT_PROXY. Example:</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt>APT_PROXY="http://localhost:3142/"</tt></pre>\r
+<pre><code>APT_PROXY="http://localhost:3142/"</code></pre>\r
</div></div>\r
</div>\r
<div class="sect2">\r
<div class="paragraph"><p>Just create a new class (using the package_config directory):</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt># cat > /etc/grml/fai/config/package_config/MIKA << EOF\r
-PACKAGES aptitude</tt></pre>\r
+<pre><code># cat > /etc/grml/fai/config/package_config/MIKA << EOF\r
+PACKAGES aptitude</code></pre>\r
</div></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt>vim\r
+<pre><code>vim\r
another_name_of_a_debian_package\r
and_another_one\r
-EOF</tt></pre>\r
+EOF</code></pre>\r
</div></div>\r
<div class="paragraph"><p>and specify it when invoking grml-live then:</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt># grml-live -c GRMLBASE,GRML_SMALL,AMD64,MIKA</tt></pre>\r
+<pre><code># grml-live -c GRMLBASE,GRML_SMALL,AMD64,MIKA</code></pre>\r
</div></div>\r
</div>\r
<div class="sect2">\r
what you are searching for just run:</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt>rm -rf /etc/grml/fai /etc/grml/grml-live.conf\r
-dpkg -i --force-confnew --force-confmiss /path/to/grml-live_..._all.deb</tt></pre>\r
+<pre><code>rm -rf /etc/grml/fai /etc/grml/grml-live.conf\r
+dpkg -i --force-confnew --force-confmiss /path/to/grml-live_..._all.deb</code></pre>\r
</div></div>\r
</div>\r
<div class="sect2">\r
<div class="paragraph"><p>First of all create the chroot using debootstrap:</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt>BASECHROOT='/tmp/basefile'\r
-debootstrap squeeze "$BASECHROOT" http://cdn.debian.net/debian\r
-tar -C "$BASECHROOT" --exclude='var/cache/apt/archives/*.deb' -zcf base.tar.gz ./</tt></pre>\r
+<pre><code>BASECHROOT='/tmp/basefile'\r
+debootstrap wheezy "$BASECHROOT" http://http.debian.net/debian\r
+tar -C "$BASECHROOT" --exclude='var/cache/apt/archives/*.deb' -zcf base.tar.gz ./</code></pre>\r
</div></div>\r
<div class="admonitionblock">\r
<table><tr>\r
debootstrap. Check out the output for something like:</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt>[...]\r
+<pre><code>[...]\r
ftar: extracting //etc/grml/fai/config/basefiles///AMD64.tar.gz to /srv/grml64_testing/grml_chroot//\r
-[...]</tt></pre>\r
+[...]</code></pre>\r
</div></div>\r
<div class="admonitionblock">\r
<table><tr>\r
FAI_DEBOOTSTRAP:</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt># cat /etc/grml/grml-live.local\r
+<pre><code># cat /etc/grml/grml-live.local\r
[...]\r
APT_PROXY="http://localhost:3142/"\r
[...]\r
-FAI_DEBOOTSTRAP="squeeze http://localhost:3142/cdn.debian.net/debian squeeze main contrib non-free"</tt></pre>\r
+FAI_DEBOOTSTRAP="wheezy http://localhost:3142/http.debian.net/debian wheezy main contrib non-free"</code></pre>\r
</div></div>\r
<div class="paragraph"><p>Make sure apt-cacher-ng is running (<em>/etc/init.d/apt-cacher-ng restart</em>).\r
That’s it. All downloaded files will be cached in /var/cache/apt-cacher-ng then.</p></div>\r
revert the manifold feature running:</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt>% dd if=/dev/zero of=grml.iso bs=512 count=1 conv=notrunc</tt></pre>\r
+<pre><code>% dd if=/dev/zero of=grml.iso bs=512 count=1 conv=notrunc</code></pre>\r
</div></div>\r
<div class="paragraph"><p>To switch from manifold to isohybrid mode (an alternative approach provided by\r
syslinux) then just execute:</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt>% isohybrid grml.iso</tt></pre>\r
+<pre><code>% isohybrid grml.iso</code></pre>\r
</div></div>\r
</div>\r
<div class="sect2">\r
<div class="paragraph"><p>Execute the following commands (requires root):</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt>ARCH='amd64' # replace with i386 if necessary\r
-SUITE='squeeze' # using the current stable release should always work\r
+<pre><code>ARCH='amd64' # replace with i386 if necessary\r
+SUITE='wheezy' # using the current stable release should always work\r
debootstrap --arch "$ARCH" --exclude=info,tasksel,tasksel-data "$SUITE" "$ARCH" http://debian.netcologne.de/debian\r
cd "$ARCH"\r
rm var/cache/apt/archives/*.deb\r
-tar zcf ../"${ARCH}".tar.gz *</tt></pre>\r
+tar zcf ../"${ARCH}".tar.gz *</code></pre>\r
</div></div>\r
<div class="paragraph"><p>And finally place the generated tarball in /etc/grml/fai/config/basefiles/ (note\r
that it needs to be uppercase letters matching the class names, so: AMD64.tar.gz\r
current development tree), just execute:</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt>git clone git://git.grml.org/grml-live\r
+<pre><code>git clone git://git.grml.org/grml-live\r
cd grml-live\r
-debuild -us -uc</tt></pre>\r
+debuild -us -uc</code></pre>\r
</div></div>\r
</div>\r
</div>\r
<div id="footnotes"><hr /></div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 2012-09-26 19:37:35 CEST\r
+Last updated 2013-12-11 11:53:34 CET\r
</div>\r
</div>\r
</body>\r
projects / grml.org.git / commitdiff