<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.3" />\r
+<meta name="generator" content="AsciiDoc 8.6.6" />\r
<title>grml-live(8)</title>\r
<style type="text/css">\r
-/* Sans-serif font. */\r
+/* Shared CSS for AsciiDoc xhtml11 and html5 backends */\r
+\r
+/* Default font. */\r
+body {\r
+ font-family: Georgia,serif;\r
+}\r
+\r
+/* Title font. */\r
h1, h2, h3, h4, h5, h6,\r
div.title, caption.title,\r
thead, p.table.header,\r
-div#toctitle,\r
-span#author, span#revnumber, span#revdate, span#revremark,\r
-div#footer {\r
+#toctitle,\r
+#author, #revnumber, #revdate, #revremark,\r
+#footer {\r
font-family: Arial,Helvetica,sans-serif;\r
}\r
\r
-/* Serif font. */\r
-div.sectionbody {\r
- font-family: Georgia,"Times New Roman",Times,serif;\r
-}\r
-\r
-/* Monospace font. */\r
-tt {\r
- font-size: inherit;\r
-}\r
-\r
body {\r
margin: 1em 5% 1em 5%;\r
}\r
color: #083194;\r
}\r
\r
-tt {\r
- font-size: inherit;\r
- color: navy;\r
-}\r
-\r
h1, h2, h3, h4, h5, h6 {\r
color: #527bbd;\r
margin-top: 1.2em;\r
h3 + * {\r
clear: left;\r
}\r
+h5 {\r
+ font-size: 1.0em;\r
+}\r
\r
div.sectionbody {\r
margin-left: 0;\r
margin: 0;\r
}\r
\r
-span#author {\r
+#author {\r
color: #527bbd;\r
font-weight: bold;\r
font-size: 1.1em;\r
}\r
-span#email {\r
+#email {\r
}\r
-span#revnumber, span#revdate, span#revremark {\r
+#revnumber, #revdate, #revremark {\r
}\r
\r
-div#footer {\r
+#footer {\r
font-size: small;\r
border-top: 2px solid silver;\r
padding-top: 0.5em;\r
margin-top: 4.0em;\r
}\r
-div#footer-text {\r
+#footer-text {\r
float: left;\r
padding-bottom: 0.5em;\r
}\r
-div#footer-badges {\r
+#footer-badges {\r
float: right;\r
padding-bottom: 0.5em;\r
}\r
\r
-div#preamble {\r
+#preamble {\r
margin-top: 1.5em;\r
margin-bottom: 1.5em;\r
}\r
-div.tableblock, div.imageblock, div.exampleblock, div.verseblock,\r
+div.imageblock, div.exampleblock, div.verseblock,\r
div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,\r
div.admonitionblock {\r
margin-top: 1.0em;\r
margin-left: 1.0em;\r
margin-right: 10%;\r
border-left: 5px solid #f0f0f0;\r
- color: #777777;\r
+ color: #888;\r
}\r
\r
div.quoteblock > div.attribution {\r
margin-bottom: 0.1em;\r
}\r
\r
-div.tableblock > table {\r
- border: 3px solid #527bbd;\r
-}\r
-thead, p.table.header {\r
- font-weight: bold;\r
- color: #527bbd;\r
-}\r
tfoot {\r
font-weight: bold;\r
}\r
td > div.verse {\r
white-space: pre;\r
}\r
-p.table {\r
- margin-top: 0;\r
-}\r
-/* Because the table frame attribute is overriden by CSS in most browsers. */\r
-div.tableblock > table[frame="void"] {\r
- border-style: none;\r
-}\r
-div.tableblock > table[frame="hsides"] {\r
- border-left-style: none;\r
- border-right-style: none;\r
-}\r
-div.tableblock > table[frame="vsides"] {\r
- border-top-style: none;\r
- border-bottom-style: none;\r
-}\r
-\r
\r
div.hdlist {\r
margin-top: 0.8em;\r
}\r
\r
@media print {\r
- div#footer-badges { display: none; }\r
+ #footer-badges { display: none; }\r
}\r
\r
-div#toc {\r
+#toc {\r
margin-bottom: 2.5em;\r
}\r
\r
-div#toctitle {\r
+#toctitle {\r
color: #527bbd;\r
font-size: 1.1em;\r
font-weight: bold;\r
font-size: 0.9em;\r
}\r
\r
+span.aqua { color: aqua; }\r
+span.black { color: black; }\r
+span.blue { color: blue; }\r
+span.fuchsia { color: fuchsia; }\r
+span.gray { color: gray; }\r
+span.green { color: green; }\r
+span.lime { color: lime; }\r
+span.maroon { color: maroon; }\r
+span.navy { color: navy; }\r
+span.olive { color: olive; }\r
+span.purple { color: purple; }\r
+span.red { color: red; }\r
+span.silver { color: silver; }\r
+span.teal { color: teal; }\r
+span.white { color: white; }\r
+span.yellow { color: yellow; }\r
+\r
+span.aqua-background { background: aqua; }\r
+span.black-background { background: black; }\r
+span.blue-background { background: blue; }\r
+span.fuchsia-background { background: fuchsia; }\r
+span.gray-background { background: gray; }\r
+span.green-background { background: green; }\r
+span.lime-background { background: lime; }\r
+span.maroon-background { background: maroon; }\r
+span.navy-background { background: navy; }\r
+span.olive-background { background: olive; }\r
+span.purple-background { background: purple; }\r
+span.red-background { background: red; }\r
+span.silver-background { background: silver; }\r
+span.teal-background { background: teal; }\r
+span.white-background { background: white; }\r
+span.yellow-background { background: yellow; }\r
+\r
+span.big { font-size: 2em; }\r
+span.small { font-size: 0.6em; }\r
+\r
+span.underline { text-decoration: underline; }\r
+span.overline { text-decoration: overline; }\r
+span.line-through { text-decoration: line-through; }\r
+\r
+\r
+/*\r
+ * xhtml11 specific\r
+ *\r
+ * */\r
+\r
+tt {\r
+ font-family: 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
+div.tableblock > table {\r
+ border: 3px solid #527bbd;\r
+}\r
+thead, p.table.header {\r
+ font-weight: bold;\r
+ color: #527bbd;\r
+}\r
+p.table {\r
+ margin-top: 0;\r
+}\r
+/* Because the table frame attribute is overriden by CSS in most browsers. */\r
+div.tableblock > table[frame="void"] {\r
+ border-style: none;\r
+}\r
+div.tableblock > table[frame="hsides"] {\r
+ border-left-style: none;\r
+ border-right-style: none;\r
+}\r
+div.tableblock > table[frame="vsides"] {\r
+ border-top-style: none;\r
+ border-bottom-style: none;\r
+}\r
+\r
+\r
+/*\r
+ * html5 specific\r
+ *\r
+ * */\r
+\r
+.monospaced {\r
+ font-family: monospace;\r
+ font-size: inherit;\r
+ color: navy;\r
+}\r
+\r
+table.tableblock {\r
+ margin-top: 1.0em;\r
+ margin-bottom: 1.5em;\r
+}\r
+thead, p.tableblock.header {\r
+ font-weight: bold;\r
+ color: #527bbd;\r
+}\r
+p.tableblock {\r
+ margin-top: 0;\r
+}\r
+table.tableblock {\r
+ border-width: 3px;\r
+ border-spacing: 0px;\r
+ border-style: solid;\r
+ border-color: #527bbd;\r
+ border-collapse: collapse;\r
+}\r
+th.tableblock, td.tableblock {\r
+ border-width: 1px;\r
+ padding: 4px;\r
+ border-style: solid;\r
+ border-color: #527bbd;\r
+}\r
+\r
+table.tableblock.frame-topbot {\r
+ border-left-style: hidden;\r
+ border-right-style: hidden;\r
+}\r
+table.tableblock.frame-sides {\r
+ border-top-style: hidden;\r
+ border-bottom-style: hidden;\r
+}\r
+table.tableblock.frame-none {\r
+ border-style: hidden;\r
+}\r
+\r
+th.tableblock.halign-left, td.tableblock.halign-left {\r
+ text-align: left;\r
+}\r
+th.tableblock.halign-center, td.tableblock.halign-center {\r
+ text-align: center;\r
+}\r
+th.tableblock.halign-right, td.tableblock.halign-right {\r
+ text-align: right;\r
+}\r
+\r
+th.tableblock.valign-top, td.tableblock.valign-top {\r
+ vertical-align: top;\r
+}\r
+th.tableblock.valign-middle, td.tableblock.valign-middle {\r
+ vertical-align: middle;\r
+}\r
+th.tableblock.valign-bottom, td.tableblock.valign-bottom {\r
+ vertical-align: bottom;\r
+}\r
+\r
+\r
+/*\r
+ * manpage specific\r
+ *\r
+ * */\r
+\r
+body.manpage h1 {\r
+ padding-top: 0.5em;\r
+ padding-bottom: 0.5em;\r
+ border-top: 2px solid silver;\r
+ border-bottom: 2px solid silver;\r
+}\r
+body.manpage h2 {\r
+ border-style: none;\r
+}\r
+body.manpage div.sectionbody {\r
+ margin-left: 3em;\r
+}\r
+\r
+@media print {\r
+ body.manpage div#toc { display: none; }\r
+}\r
</style>\r
<script type="text/javascript">\r
/*<![CDATA[*/\r
-window.onload = function(){asciidoc.footnotes(); asciidoc.toc(2);}\r
var asciidoc = { // Namespace.\r
\r
/////////////////////////////////////////////////////////////////////\r
}\r
\r
var toc = document.getElementById("toc");\r
+ if (!toc) {\r
+ return;\r
+ }\r
+\r
+ // Delete existing TOC entries in case we're reloading the TOC.\r
+ var tocEntriesToRemove = [];\r
+ var i;\r
+ for (i = 0; i < toc.childNodes.length; i++) {\r
+ var entry = toc.childNodes[i];\r
+ if (entry.nodeName == 'div'\r
+ && entry.getAttribute("class")\r
+ && entry.getAttribute("class").match(/^toclevel/))\r
+ tocEntriesToRemove.push(entry);\r
+ }\r
+ for (i = 0; i < tocEntriesToRemove.length; i++) {\r
+ toc.removeChild(tocEntriesToRemove[i]);\r
+ }\r
+\r
+ // Rebuild TOC entries.\r
var entries = tocEntries(document.getElementById("content"), toclevels);\r
for (var i = 0; i < entries.length; ++i) {\r
var entry = entries[i];\r
*/\r
\r
footnotes: function () {\r
- var cont = document.getElementById("content");\r
+ // Delete existing footnote entries in case we're reloading the footnodes.\r
+ var i;\r
var noteholder = document.getElementById("footnotes");\r
+ if (!noteholder) {\r
+ return;\r
+ }\r
+ var entriesToRemove = [];\r
+ for (i = 0; i < noteholder.childNodes.length; i++) {\r
+ var entry = noteholder.childNodes[i];\r
+ if (entry.nodeName == 'div' && entry.getAttribute("class") == "footnote")\r
+ entriesToRemove.push(entry);\r
+ }\r
+ for (i = 0; i < entriesToRemove.length; i++) {\r
+ noteholder.removeChild(entriesToRemove[i]);\r
+ }\r
+\r
+ // Rebuild footnote entries.\r
+ var cont = document.getElementById("content");\r
var spans = cont.getElementsByTagName("span");\r
var refs = {};\r
var n = 0;\r
for (i=0; i<spans.length; i++) {\r
if (spans[i].className == "footnote") {\r
n++;\r
- // Use [\s\S] in place of . so multi-line matches work.\r
- // Because JavaScript has no s (dotall) regex flag.\r
- note = spans[i].innerHTML.match(/\s*\[([\s\S]*)]\s*/)[1];\r
+ var note = spans[i].getAttribute("data-note");\r
+ if (!note) {\r
+ // Use [\s\S] in place of . so multi-line matches work.\r
+ // Because JavaScript has no s (dotall) regex flag.\r
+ note = spans[i].innerHTML.match(/\s*\[([\s\S]*)]\s*/)[1];\r
+ spans[i].innerHTML =\r
+ "[<a id='_footnoteref_" + n + "' href='#_footnote_" + n +\r
+ "' title='View footnote' class='footnote'>" + n + "</a>]";\r
+ spans[i].setAttribute("data-note", note);\r
+ }\r
noteholder.innerHTML +=\r
"<div class='footnote' id='_footnote_" + n + "'>" +\r
"<a href='#_footnoteref_" + n + "' title='Return to text'>" +\r
n + "</a>. " + note + "</div>";\r
- spans[i].innerHTML =\r
- "[<a id='_footnoteref_" + n + "' href='#_footnote_" + n +\r
- "' title='View footnote' class='footnote'>" + n + "</a>]";\r
var id =spans[i].getAttribute("id");\r
if (id != null) refs["#"+id] = n;\r
}\r
}\r
}\r
}\r
+},\r
+\r
+install: function(toclevels) {\r
+ var timerId;\r
+\r
+ function reinstall() {\r
+ asciidoc.footnotes();\r
+ if (toclevels) {\r
+ asciidoc.toc(toclevels);\r
+ }\r
+ }\r
+\r
+ function reinstallAndRemoveTimer() {\r
+ clearInterval(timerId);\r
+ reinstall();\r
+ }\r
+\r
+ timerId = setInterval(reinstall, 500);\r
+ if (document.addEventListener)\r
+ document.addEventListener("DOMContentLoaded", reinstallAndRemoveTimer, false);\r
+ else\r
+ window.onload = reinstallAndRemoveTimer;\r
}\r
\r
}\r
+asciidoc.install(2);\r
/*]]>*/\r
</script>\r
</head>\r
<div class="sectionbody">\r
<div class="paragraph"><p>grml-live [-a <architecture>] [-c <classe[s]>] [-C <configfile>] [-g\r
<grml_name>] [-i <iso_name> ] [-o <output_directory>] [-r <release_name>] [-s\r
-<suite>] [-t <template_directory>] [-v <version_number>] [-bBFhquVz]</p></div>\r
+<suite>] [-t <template_directory>] [-v <version_number>] [-U <username>] [\r
+-AbBFnNquVz]</p></div>\r
<div class="admonitionblock">\r
<table><tr>\r
<td class="icon">\r
<img src="./images/icons/caution.png" alt="Caution" />\r
</td>\r
<td class="content">grml-live does <strong>not</strong> use /etc/fai for configuration but instead\r
-provides and uses /etc/grml/fai. This ensures that it does not clash with\r
-default FAI configuration and packages, so you can use grml-live and FAI\r
+(unless overriden using the <em>'-D</em>' option). This ensures that it does not clash\r
+with default FAI configuration and packages, so you can use grml-live and FAI\r
completely independent at the same time!</td>\r
</tr></table>\r
</div>\r
<div class="sectionbody">\r
<div class="dlist"><dl>\r
<dt class="hdlist1">\r
+-A\r
+</dt>\r
+<dd>\r
+<p>\r
+Clean up output directories before attempting the build. Packs the chroot\r
+into a tar archive, and removes chroot and iso build directories before exiting.\r
+</p>\r
+</dd>\r
+<dt class="hdlist1">\r
-a <strong>ARCHITECTURE</strong>\r
</dt>\r
<dd>\r
<dd>\r
<p>\r
Specify the CLASSES to be used for building the ISO via FAI. By default only\r
-the classes GRMLBASE, GRML_MEDIUM and I386 are assumed, resulting in a small base\r
-system (being about ~180MB total ISO size). If using a non-I386 system (like\r
-AMD64) you should specify the appropriate architecture as well. Additionally you\r
-can specify a class providing a grml-kernel (see\r
-<a href="#classes">the <em>CLASSES</em> section in this document</a> for details about available classes).\r
-So instead of GRML_MEDIUM you can also use GRML_SMALL and GRML_FULL.\r
+the classes GRMLBASE, GRML_FULL and I386/AMD64 (depending on system\r
+architecture) are assumed, resulting in a small base system (being about ~180MB\r
+total ISO size). If using a non-I386 system (like AMD64) you should specify the\r
+appropriate architecture as well. Additionally you can specify a class providing\r
+a grml-kernel (see <a href="#classes">the <em>CLASSES</em> section in this document</a> for\r
+details about available classes). So instead of GRML_FULL you can also use\r
+GRML_SMALL and GRML_FULL.\r
</p>\r
</dd>\r
</dl></div>\r
of grml-live, so please make sure you use /etc/grml/grml-live.conf as a base for\r
your own configuration file (usually /etc/grml/grml-live.local). Please also\r
notice that the configuration file specified via this option is <strong>not</strong> (yet)\r
-supported inside the scripts/hooks/classes at /etc/grml/fai/config. Instead use\r
/etc/grml/grml-live.local for configuration stuff used inside\r
-/etc/grml/fai/config.\r
</p>\r
</dd>\r
<dt class="hdlist1">\r
</p>\r
</dd>\r
<dt class="hdlist1">\r
+-D <strong>CONFIGURATION_DIRECTORY</strong>\r
+</dt>\r
+<dd>\r
+<p>\r
+The specified directory is used as configuration directory for grml-live and its\r
+FAI. By default /etc/grml/fai is used as default configuration directory. If\r
+you want to have different configuration scripts, package definitions, etc. with\r
+without messing with the global configuration under /etc/grml/fai provided by\r
+grml-live this option provides you the option to use your own configuration\r
+throughout this documentation.\r
+</p>\r
+</dd>\r
+<dt class="hdlist1">\r
-F\r
</dt>\r
<dd>\r
</p>\r
</dd>\r
<dt class="hdlist1">\r
+-N\r
+</dt>\r
+<dd>\r
+<p>\r
+Bootstrap the chroot without building bootloader, squashfs, or finalizing the\r
+ISO. Use this option if installation of some packages fails, you want to run\r
+custom commands or similar.\r
+The main use of this option is to save time by skipping stages which aren’t\r
+necessary for bootstrapping the chroot and which would get executed more than\r
+once when iterating through the initial bootstrapping.\r
+Alternatively, use this option as a test run of grml-live. Once you are\r
+satisfied with the state of your grml_chroot, use grml-live <strong>-u</strong> to build the\r
+remaining stages and finalize the ISO.\r
+</p>\r
+</dd>\r
+<dt class="hdlist1">\r
-o <strong>OUTPUT_DIRECTORY</strong>\r
</dt>\r
<dd>\r
</p>\r
</dd>\r
<dt class="hdlist1">\r
+-Q\r
+</dt>\r
+<dd>\r
+<p>\r
+Build the ISO without generating a netboot package.\r
+</p>\r
+</dd>\r
+<dt class="hdlist1">\r
-r <strong>RELEASENAME</strong>\r
</dt>\r
<dd>\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, sid. Debian "squeeze" requires a recent base.tgz\r
-(/etc/grml/fai/config/basefiles/$CLASSNAME.tar.gz) or a recent version of\r
debootstrap.\r
</p>\r
</dd>\r
</p>\r
</dd>\r
<dt class="hdlist1">\r
+-T <strong>CHROOT_ARCHIVE</strong>\r
+</dt>\r
+<dd>\r
+<p>\r
+Unpack chroot tar archive before starting. Most useful in combination with\r
+-A and -b or -u.\r
+</p>\r
+</dd>\r
+<dt class="hdlist1">\r
-u\r
</dt>\r
<dd>\r
</p>\r
</dd>\r
<dt class="hdlist1">\r
+-U <strong>USERNAME</strong>\r
+</dt>\r
+<dd>\r
+<p>\r
+Sets ownership of all build output files to specified username before exiting.\r
+</p>\r
+</dd>\r
+<dt class="hdlist1">\r
-v <strong>VERSION_NUMBER</strong>\r
</dt>\r
<dd>\r
/home/mika/grml-live as build and output directory just use:</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt># grml-live -s sid -c GRMLBASE,GRML_SMALL,I386 -o /home/mika/grml-live</tt></pre>\r
+<pre><tt># grml-live -s sid -c GRMLBASE,GRML_SMALL,AMD64 -o /home/mika/grml-live</tt></pre>\r
</div></div>\r
-<div class="paragraph"><p>To get a medium sized, Debian-unstable and grml-based Live-CD for i386\r
+<div class="paragraph"><p>To get a medium sized, Debian-unstable and grml-based Live-CD for amd64\r
architecture using /grml/grml-live as build and output directory just run:</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt># grml-live -s sid -a i386 -c GRMLBASE,GRML_MEDIUM,I386</tt></pre>\r
+<pre><tt># grml-live -s sid -a amd64 -c GRMLBASE,GRML_FULL,AMD64</tt></pre>\r
</div></div>\r
<div class="paragraph"><p>To get a small, Debian-unstable and grml-based Live-CD using /tmp as build and\r
output directory and use grml_0.0-3.iso as ISO name (placed inside\r
/tmp/grml_isos) just invoke:</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt># grml-live -o /tmp -c GRMLBASE,GRML_SMALL,I386 -s sid -i grml_0.0-3.iso</tt></pre>\r
+<pre><tt># grml-live -o /tmp -c GRMLBASE,GRML_SMALL,AMD64 -s sid -i grml_0.0-3.iso</tt></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>/etc/grml/fai/config/scripts/GRMLBASE/\r
-/etc/grml/fai/config/debconf/GRMLBASE\r
-/etc/grml/fai/config/class/GRMLBASE.var\r
-/etc/grml/fai/config/hooks/instsoft.GRMLBASE\r
-/etc/grml/fai/config/package_config/GRMLBASE</tt></pre>\r
+<pre><tt>${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
</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
<div class="paragraph"><p>If you want to use your own configuration, extend an existing configuration\r
and/or add additional packages to your ISO just invent a new class (or extend an\r
existing one). For example if you want to use your own class named "FOOBAR" just\r
-set CLASSES="GRMLBASE,GRML_SMALL,I386,FOOBAR" inside /etc/grml/grml-live.local\r
+set CLASSES="GRMLBASE,GRML_SMALL,AMD64,FOOBAR" inside /etc/grml/grml-live.local\r
or invoke grml-live using the classes option: "grml-live -c\r
-GRMLBASE,GRML_SMALL,I386,FOOBAR …".</p></div>\r
+GRMLBASE,GRML_SMALL,AMD64,FOOBAR …".</p></div>\r
<div class="paragraph"><p>More details regarding the class concept can be found in the documentation of\r
FAI itself (being available at /usr/share/doc/fai-doc/).</p></div>\r
</div>\r
<h2 id="classes">8. Available classes</h2>\r
<div class="sectionbody">\r
<div class="paragraph"><p>The package selection part of the classes can be found in\r
-/etc/grml/fai/config/package_config whereas some further classes are defined for\r
-example in /etc/grml/fai/config/scripts/ so specific feature sets can be\r
selected. The following classes are predefined:</p></div>\r
<div class="ulist"><ul>\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
+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
use this class.\r
</p>\r
</li>\r
<li>\r
<p>\r
-GRML_FULL: full featured grml, also known as the "normal", full grml.\r
+GRML_FULL: full featured grml, also known as the "normal", full grml as\r
+introduced in november 2011 (~350MB ISO size).\r
</p>\r
</li>\r
<li>\r
<p>\r
-GRML_MEDIUM: medium sized grml version, known as grml-medium\r
+GRML_MEDIUM: medium sized grml version, used to be known as grml-medium\r
+until november 2011 (~220MB ISO size).\r
</p>\r
</li>\r
<li>\r
<p>\r
-GRML_POWERPC: grml for PowerPC architecture, not supported yet (still work in\r
-progress)\r
+GRML_SMALL: minimum sized grml version, known as grml-small (~110MB ISO\r
+size).\r
</p>\r
</li>\r
<li>\r
<p>\r
-GRML_SMALL: minimum sized grml version, known as grml-small\r
+GRML_XL: large size Grml version, used to be known as "full grml" until\r
+november 2011 (~700MB ISO size).\r
</p>\r
</li>\r
<li>\r
</li>\r
<li>\r
<p>\r
+SOURCES: retrieve Debian source packages after installation. Files will be\r
+placed in the output directory under grml_sources.\r
+</p>\r
+</li>\r
+<li>\r
+<p>\r
XORG: providing important packages for use with a base grml-featured X.org\r
setup\r
</p>\r
<div class="paragraph"><p>Notice that grml-live ships FAI configuration files that do not use the same\r
namespace as the FAI packages itself. This ensures that grml-live does not clash\r
with your usual FAI configuration, so instead of /etc/fai/fai.conf (package\r
-fai-client) grml uses /etc/grml/fai/fai.conf instead. For more details see\r
below. To get an idea how another configuration or example files could look like\r
check out /usr/share/doc/fai-doc/examples/simple/ (provided by Debian package\r
fai-doc). Furthermore /usr/share/doc/fai-doc/fai-guide.html/ch-config.html\r
commandline.</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt>/etc/grml/fai/fai.conf</tt></pre>\r
+<pre><tt>${GRML_FAI_CONFIG}/fai.conf</tt></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
variables are FAI_CONFIG_SRC=file:///etc/grml/fai/config and\r
-FAI_CONFIGDIR=/etc/grml/fai/config - both pointing to a directory shipped by\r
+GRML_FAI_CONFIG=/etc/grml/fai/config - both pointing to a directory shipped by\r
grml-live out-of-the-box so you shouldn’t have to configure anything in this\r
file.</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt>/etc/grml/fai/make-fai-nfsroot.conf</tt></pre>\r
+<pre><tt>${GRML_FAI_CONFIG}/make-fai-nfsroot.conf</tt></pre>\r
</div></div>\r
<div class="paragraph"><p>This file is used by make-fai-nfsroot(8) only. Usually you don’t have to change\r
anything inside this file. If you want to modify NFSROOT though you can adjust\r
it there.</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt>/etc/grml/fai/NFSROOT</tt></pre>\r
+<pre><tt>${GRML_FAI_CONFIG}/NFSROOT</tt></pre>\r
</div></div>\r
<div class="paragraph"><p>This file specifies the package list for creating the NFSROOT.</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt>/etc/grml/fai/apt/sources.list</tt></pre>\r
+<pre><tt>${GRML_FAI_CONFIG}/apt/sources.list</tt></pre>\r
</div></div>\r
<div class="paragraph"><p>This file specifies which mirrors should be considered for retrieving the Debian\r
packages when creating the main chroot (including all the software you would\r
like to see included). Important: this file should <strong>not</strong> be adjusted manually!\r
Instead use the GRML_LIVE_SOURCES variable inside /etc/grml/grml-live.conf or\r
-/etc/grml/grml-live.local which modifies /etc/grml/fai/apt/sources.list\r
-on-the-fly via grml-live then. If you want to generally adjust apt configuration\r
-use FAI’s fcopy command with /etc/grml/fai/config/files instead.</p></div>\r
+on-the-fly via grml-live then. If you want to generally adjust apt configuration</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt>/etc/grml/fai/config/</tt></pre>\r
+<pre><tt>${GRML_FAI_CONFIG}/config/</tt></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>/etc/grml/fai/config/class/</tt></pre>\r
+<pre><tt>${GRML_FAI_CONFIG}/config/class/</tt></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>/etc/grml/fai/config/debconf/</tt></pre>\r
+<pre><tt>${GRML_FAI_CONFIG}/config/debconf/</tt></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>/etc/grml/fai/config/hooks/</tt></pre>\r
+<pre><tt>${GRML_FAI_CONFIG}/config/hooks/</tt></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>/etc/grml/fai/config/package_config/</tt></pre>\r
+<pre><tt>${GRML_FAI_CONFIG}/config/package_config/</tt></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
-"grml-live -c GRMLBASE,GRML_SMALL,I386 …" only the configuration of GRMLBASE,\r
-GRML_SMALL and and I386 will be taken. If you use <em>grml-live -c\r
-GRMLBASE,GRML_SMALL,I386,FOOBAR …</em> then the files of GRMLBASE, GRML_SMALL,\r
-I386 <strong>plus</strong> the files from FOOBAR will be taken. So just create a new class to\r
+"grml-live -c GRMLBASE,GRML_SMALL,AMD64 …" only the configuration of GRMLBASE,\r
+GRML_SMALL and and AMD64 will be taken. If you use <em>grml-live -c\r
+GRMLBASE,GRML_SMALL,AMD64,FOOBAR …</em> then the files of GRMLBASE, GRML_SMALL,\r
+AMD64 <strong>plus</strong> the files from FOOBAR will be taken. So just create a new class to\r
adjust the package selection according to your needs. Please notice that the\r
directory GRMLBASE contains a package list defining a minimum but still\r
reasonable package configuration.</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt>/etc/grml/fai/config/scripts/</tt></pre>\r
+<pre><tt>${GRML_FAI_CONFIG}/config/scripts/</tt></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>/etc/grml/fai/live-initramfs/</tt></pre>\r
+<pre><tt>${GRML_FAI_CONFIG}/live-initramfs/</tt></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
<div class="paragraph"><p>The FAI part of grml-live logs to /var/log/fai/$HOSTNAME/ - so the\r
default being /var/log/fai/grml/.</p></div>\r
<div class="paragraph"><p>If you are using the grml-live buildd you will find the logs of the grml-live\r
-run at /var/log/grml-buildd.stdout and /var/log/grml-buildd.stderr.</p></div>\r
+run at /var/log/grml-buildd.log.</p></div>\r
<div class="paragraph"><p>If you want to store build information in a database just install the\r
grml-live-db Debian package. Further details available in the grml-live-db\r
manpage.</p></div>\r
don’t want to run it on a physical system). Of course using grml-live on a\r
plain, original Debian installation is supported as well. So there we go.</p></div>\r
<div class="paragraph"><p>What we have: plain, original Debian Lenny (5.0).</p></div>\r
-<div class="paragraph"><p>What we want: build a grml-medium ISO based on Debian/squeeze for the i386\r
+<div class="paragraph"><p>What we want: build a grml-medium ISO based on Debian/squeeze for the amd64\r
architecture using grml-live.</p></div>\r
<div class="admonitionblock">\r
<table><tr>\r
## OUTPUT="/srv/grml-live"\r
FAI_DEBOOTSTRAP="squeeze http://cdn.debian.net/debian/"\r
ARCH="i386"\r
-CLASSES="GRMLBASE,GRML_MEDIUM,I386"\r
+CLASSES="GRMLBASE,GRML_FULL,AMD64"\r
# PRESERVE_LOGFILE='1'\r
# ZERO_FAI_LOGFILE='1'\r
GRML_LIVE_SOURCES="\r
</div>\r
</div>\r
<div class="sect2">\r
-<h3 id="fai-on-etch">13.2. Help, I’m using Debian etch and I don’t have FAI version >3.2</h3>\r
-<div class="literalblock">\r
-<div class="content">\r
-<pre><tt>wget http://fai-project.org/download/etch/fai-client_3.2.8_all.deb \\r
- http://fai-project.org/download/etch/fai-server_3.2.8_all.deb \\r
- http://fai-project.org/download/etch/fai-doc_3.2.8_all.deb\r
-dpkg -i fai-client_3.2.8_all.deb fai-server_3.2.8_all.deb fai-doc_3.2.8_all.deb</tt></pre>\r
-</div></div>\r
-<div class="paragraph"><p>or check out the <a href="http://fai-project.org/">FAI-homepage</a> for\r
-further details.</p></div>\r
+<h3 id="grml_fai_config_variable">13.2. What is $GRML_FAI_CONFIG?</h3>\r
+<div class="paragraph"><p>The variable <em>$GRML_FAI_CONFIG</em> is pointing to the directory /etc/grml/fai by\r
+default. To provide you a maximum of flexibility you can set up your own\r
+configuration directory (e.g. based on /etc/grml/fai) and use this directory\r
+running grml-live with the <em>-D <config_dir></em> option. Now <em>$GRML_FAI_CONFIG</em>\r
+points to the specified directory instead of using /etc/grml/fai and all the\r
+configuration files, scripts and hooks will be taken from your\r
+<em>$GRML_FAI_CONFIG</em> directory.</p></div>\r
</div>\r
<div class="sect2">\r
<h3 id="how-to-debug">13.3. I’ve problems with the build process. How to start debugging?</h3>\r
</div>\r
<div class="sect2">\r
<h3 id="local-debian-mirror">13.6. Can I use my own (local) Debian mirror?</h3>\r
-<div class="paragraph"><p>Sure. Just adjust the variables GRML_LIVE_SOURCES and FAI_DEBOOTSTRAP (if not\r
-already using NFSROOT’s base.tgz) inside /etc/grml/grml-live.conf according to\r
-your needs. Please don’t forget that you should use the grml servers as well\r
-(see default configuration) so all the grml packages can be downloaded as well.</p></div>\r
-<div class="paragraph"><p>If you want to use a local (for example NFS mount) mirror additionally, just\r
-adjust MIRROR_DIRECTORY and MIRROR_SOURCES inside /etc/grml/grml-live.conf as\r
-well.</p></div>\r
-<div class="paragraph"><p>Unless you specify GRML_LIVE_SOURCES and/or FAI_DEBOOTSTRAP the default from\r
-/etc/grml/fai/apt/sources.list and /etc/grml/fai/make-fai-nfsroot.conf will be\r
-taken. If you customise the variables in /etc/grml/grml-live.conf then the two\r
-files will be adjusted during runtime automatically.</p></div>\r
-<div class="paragraph"><p>If MIRROR_DIRECTORY and MIRROR_SOURCES are specified the local mirror will be\r
-taken as first entry in the generated sources.list so it’s preferred over\r
-non-local mirrors. Using a fallback mirror (via providing several mirrors in\r
-GRML_LIVE_SOURCES as used by default) is a recommended setting.</p></div>\r
+<div class="paragraph"><p>Yes. Set up an according sources.list configuration as class file in\r
+FAI_DEBOOTSTRAP (if not already using NFSROOT’s base.tgz) inside\r
+/etc/grml/grml-live.conf[.local]. If you’re setting up your own class file don’t\r
+forget to include the class name in the class list (grml-live -c …).</p></div>\r
+<div class="paragraph"><p>If you want to use a local (for example NFS mount) mirror additionally then\r
+adjust MIRROR_DIRECTORY in /etc/grml/grml-live.conf[.local] as well.</p></div>\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
+</div></div>\r
</div>\r
<div class="sect2">\r
<h3 id="add-additional-debian-packages">13.7. How do I add additional Debian package(s) to my CD/ISO?</h3>\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,I386,MIKA</tt></pre>\r
+<pre><tt># grml-live -c GRMLBASE,GRML_SMALL,AMD64,MIKA</tt></pre>\r
</div></div>\r
</div>\r
<div class="sect2">\r
<td class="content">Existing base.tgz can be found at <a href="http://daily.grml.org/">http://daily.grml.org/</a></td>\r
</tr></table>\r
</div>\r
-</div>\r
-<div class="sect2">\r
-<h3 id="apt-cacher">13.10. Set up apt-cacher / apt-cacher-ng for use with grml-live</h3>\r
-<div class="paragraph"><p>Make sure /etc/grml/grml-live.conf provides according GRML_LIVE_SOURCES and\r
-FAI_DEBOOTSTRAP:</p></div>\r
-<div class="literalblock">\r
+<div class="paragraph" id="apt-cacher"><p>Set up apt-cacher-ng for use with grml-live</p></div>\r
+<div class="listingblock">\r
<div class="content">\r
-<pre><tt># cat /etc/grml/grml-live.conf\r
-[...]\r
-GRML_LIVE_SOURCES="\r
-deb http://localhost:3142/deb.grml.org grml-stable main\r
-deb http://localhost:3142/deb.grml.org grml-testing main\r
-deb http://localhost:3142/cdn.debian.net/debian squeeze main contrib non-free\r
-"\r
-[...]\r
-FAI_DEBOOTSTRAP="squeeze http://localhost:3142/cdn.debian.net/debian squeeze main contrib non-free"</tt></pre>\r
+<pre><tt>Make sure /etc/grml/grml-live.local provides according APT_PROXY and\r
+FAI_DEBOOTSTRAP:\r
+\r
+ # 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"\r
+\r
+Make sure apt-cacher-ng is running ('/etc/init.d/apt-cacher-ng restart').\r
+That's it. All downloaded files will be cached in /var/cache/apt-cacher-ng then.\r
+\r
+[[approx]]\r
+Set up approx for use with grml-live</tt></pre>\r
</div></div>\r
-<div class="paragraph"><p>Make sure apt-cacher / apt-cacher-ng is running (<em>/etc/init.d/apt-cacher\r
-restart</em> or <em>/etc/init.d/apt-cacher-ng restart</em>). That’s it. All downloaded\r
-files will be cached in /var/cache/apt-cacher/ or /var/cache/apt-cacher-ng then.</p></div>\r
-</div>\r
-<div class="sect2">\r
-<h3 id="approx">13.11. Set up approx for use with grml-live</h3>\r
<div class="paragraph"><p>Make sure /etc/grml/grml-live.conf provides according GRML_LIVE_SOURCES and\r
FAI_DEBOOTSTRAP:</p></div>\r
<div class="literalblock">\r
All downloaded files will be cached in /var/cache/approx now.</p></div>\r
</div>\r
<div class="sect2">\r
-<h3 id="revert_manifold">13.12. How do I revert the manifold feature from an ISO?</h3>\r
-<div class="paragraph"><p>The so called manifold feature Grml ISOs use by default allows to use the same\r
+<h3 id="revert_manifold">13.10. How do I revert the manifold feature from an ISO?</h3>\r
+<div class="paragraph"><p>The so called manifold feature Grml ISOs use by default allows one to use the same\r
ISO for CD boot and USB boot. If you notice any problems when booting just\r
revert the manifold feature running:</p></div>\r
<div class="literalblock">\r
</div></div>\r
</div>\r
<div class="sect2">\r
-<h3 id="basetgz">13.13. How do I create a base tar.gz (I386.tar.gz or AMD64.tar.gz)</h3>\r
+<h3 id="basetgz">13.11. How do I create a base tar.gz (I386.tar.gz or AMD64.tar.gz)</h3>\r
<div class="paragraph"><p>Execute the following commands (requires root):</p></div>\r
<div class="literalblock">\r
<div class="content">\r
for amd64 and I386.tar.gz for i386).</p></div>\r
</div>\r
<div class="sect2">\r
-<h3 id="autobuild">13.14. How do I set up an autobuild environment?</h3>\r
+<h3 id="autobuild">13.12. How do I set up an autobuild environment?</h3>\r
<div class="paragraph"><p>If you want to set up a system like <a href="http://daily.grml.org/">daily.grml.org</a>\r
the Debian package grml-live-buildd provides all you need to start. Start with\r
figuring out the cron job script /usr/share/grml-live/buildd/cronjob.sh.</p></div>\r
</div></div>\r
</div>\r
<div class="sect2">\r
-<h3 id="question">13.15. I’ve a question which isn’t answered by this document</h3>\r
+<h3 id="question">13.13. I’ve a question which isn’t answered by this document</h3>\r
<div class="paragraph"><p>Don’t hesitate to contact the author: <<a href="mailto:mika@grml.org">mika@grml.org</a>></p></div>\r
</div>\r
</div>\r
<div id="footnotes"><hr /></div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 2011-03-18 13:51:07 CET\r
+Last updated 2011-12-10 01:16:51 CET\r
</div>\r
</div>\r
</body>\r
projects / grml.org.git / commitdiff