Changes between Version 35 and Version 36 of Doc/BasicConfig/AII

Timestamp:

Feb 27, 2011, 1:39:20 PM (13 years ago)

Author:

/O=GRID-FR/C=FR/O=CNRS/OU=LAL/CN=Michel Jouvin

Comment:

--

Doc/BasicConfig/AII

@@ -12 +12 @@
 == AII Site Configuration ==
 
+The typical place to customize AII configuration is the site-specific template pointed by variable `AII_CONFIG_SITE` or [source:templates/trunk/sites/example/site/aii-config.tpl site/aii-config.tpl] if the variable is not defined. This template is executed quite late in the configuration, after completion of all the base OS configuration. Thus it is possible to make reference to most of the variables built during the configuration, in particular those reflecting OS flavour (version and arch) used, file systems configured...
+
 All AII options may be customized through variables. For the complete list, look at the man pages ''aii-pxelinux(8)'' and ''aii-ks(8)''  or the source code [source:templates/trunk/standard/quattor/aii/ks/config.tpl standard/quattor/aii/ks/config.tpl] and [source:templates/trunk/standard/quattor/aii/pxelinux/config.tpl standard/quattor/aii/pxelinux/config.tpl].
+
 
 A typical AII configuration is :
@@ -22 +25 @@
 }}}
 
-The typical place to customize AII configuration is template [source:templates/trunk/sites/example/site/aii-config.tpl site/aii-config.tpl]. This template is executed quite late in the configuration, after completion of all the base OS configuration. Thus it is possible to make reference to most of the variables built during the configuration, in particular those reflecting OS flavour (version and arch) used.
+=== Controlling disks used by Kickstart ===
+
+Among all the AII-related variables available, a few ones control disk where the GRUB boot loader is written to, which disks can be used by Kickstart during installation and what are the disks whose existing partition table must be cleared. In particular:
+ * `AII_OSINSTALL_BOOTDISK_ORDER`: list of disk name (without `/dev`) where to write GRUB boot loader.
+ * `AII_OSINSTALL_OPTION_CLEARPART`: list of disks (without `/dev`) whose existing partition table must be cleared by Kickstart.
+ * `AII_OSINSTALL_IGNOREDISKS`: list of disks (without `/dev`) whose existing partition table must be cleared by Kickstart.
+ * `AII_OSINSTALL_CLEARPART_BOOT_ONLY`: if false and nothing is explicitly specified, all disks managed by Quattor (present in `/system/blockdevices/physical_devs`) have their existing partition table cleared. If true, only disk having property `boot` defined to `true` in the hardware configuration (`/hardware/harddisks`) are cleared. Default is `false`.
+
+Default value for these variables should be appropriate as long as the hardware description for the machine is correct. In particular, all the disks present in the hardware configuration are added either to the list of disks whose existing partitions must be cleared or to the list of disks to ignore. When a machine has several disks, it is possible to define the property `boot` to `true` for the disk entry in `/hardware/harddisks` corresponding to the system disk (if there is only one disk, it is assume to be the system disk).
 
 == Kickstart Site-Specific Installation Actions ==
 
-AII allows to define in a flexible way site-specific actions that must be done at various points in Kickstart. This is done through several `hooks`.
+AII allows to define in a flexible way site-specific actions that must be done at various points in Kickstart/Anaconda. This is done through `AII hooks`. Writing and configuring hooks is not yet documented...
 
 == Configuration of Filesystems: The Recommended Way ==