[Fai-commit] r4356 - people/lazyboy/bugfixes/dirinstall-doc/doc

[lazyboy-guest at alioth.debian.org]

Author: lazyboy-guest
Date: 2007-06-22 20:31:50 +0000 (Fri, 22 Jun 2007)
New Revision: 4356

Modified:
   people/lazyboy/bugfixes/dirinstall-doc/doc/fai-guide.sgml
Log:
add dirinstall docs, and move quickstart into an extra chapter - sorry for double checkin...

Modified: people/lazyboy/bugfixes/dirinstall-doc/doc/fai-guide.sgml
===================================================================
--- people/lazyboy/bugfixes/dirinstall-doc/doc/fai-guide.sgml	2007-06-22 17:38:45 UTC (rev 4355)
+++ people/lazyboy/bugfixes/dirinstall-doc/doc/fai-guide.sgml	2007-06-22 20:31:50 UTC (rev 4356)
@@ -235,7 +235,7 @@
 	    <item> <p>Automatic hardware detection</p> </item>
 </list>
 
-<sect id=impatient>Quickstart - For the impatient user<p>
+<chapt id=impatient>Quickstart - For the impatient user<p>
 
 So, you do not like to read the whole manual? You like to try an
 installation without reading the manual? OK. Here's how to succeed in
@@ -2569,8 +2569,42 @@
 The file format of the configuration files in <file>disk_config</file> and
 <file>package_config</file> are different than those for Linux.
 
-<chapt id=advanced>Advanced FAI
+<chapt id=advanced>Advanced FAI<p>
 
+<sect id="dirinstall">Installing into a mounted directory for chroot and virtualization<p>
+If you have some chroot environments to install, or a virtualization environment where 
+you neither can nor want to run a normal Debian Installer in to
+get to a working system (for example, Xen guest domains), there is the 
+FAI action <tt>dirinstall</tt>.
+
+By calling 
+
+<example>fai &lt;options&gt; dirinstall &lt;target-directory&gt;</example>
+and using either the option 
+<example>-c &lt;classes&gt;</example> or <example>-u &lt;hostname&gt;</example>
+you get a FAI installation, without the partitioning action, right into the 
+target directory.
+
+This, for example, can be used to combine FAI with the tool <tt>xen-tools</tt>, which 
+helps you to build Xen guest domains. <tt>xen-tools</tt> are very nice for 
+generating config files and block devices for new guests based on simple
+commands and/or config files,  but they can only assign one role per installation
+for customization.
+FAI-users need and want more, as they are used to have the class system.
+They get them even in xen-tools installations, by using the following code as
+a xen-tools role script:
+
+<example>
+#!/bin/sh
+TARGET=$1
+CMD="fai -N  -v -u ${hostname} dirinstall $TARGET"
+echo running $CMD
+$CMD
+</example>
+
+Then, you will want to set the variable <example>install=0</example> in the xen-tools config for
+that host(in previous versions of xen-tools, this was <tt>no-install=1</tt>).
+
 <sect id=generalscm>Using revision control for FAI configuration<p>
 If there is a team of administrators involved, a revision control/sourcecode
 management system like CVS can make coordination easier: many people can 
@@ -2907,3 +2941,14 @@
 sgml-local-ecat-files:nil
 End:
 -->
+
+
+
+
+
+
+
+
+
+
+