commit e9012635f7c875a242f6a97e0a3d6428a9a2c743
Author: Petr Bokoc <pbokoc(a)redhat.com>
Date: Mon Sep 15 23:09:22 2014 +0200
Adding Kickstart Installations
en-US/Kickstart_Installations.xml | 216 ++++++++++++++++++++++++++-----------
1 files changed, 153 insertions(+), 63 deletions(-)
---
diff --git a/en-US/Kickstart_Installations.xml b/en-US/Kickstart_Installations.xml
index ece14fe..2fc9c5f 100644
--- a/en-US/Kickstart_Installations.xml
+++ b/en-US/Kickstart_Installations.xml
@@ -4,74 +4,164 @@
%BOOK_ENTITIES;
]>
<chapter id="chap-kickstart-installations">
- <title>Automating the Installation with Kickstart</title>
- <para>
- intro text
- </para>
+ <title>Automating the Installation with Kickstart</title>
+ <para>
+ Kickstart installations offer a means to automate the installation process,
either partially or fully. Kickstart files contain answers to all questions normally asked
by the installation program, such as what time zone do you want the system to use, how
should the drives be partitioned or which packages should be installed. Providing a
prepared Kickstart file when the installation begins therefore allows the you to perform
the installation automatically, without need for any intervention from the user. This is
especially useful when deploying &PRODUCT; on a large number of systems at once.
+ </para>
+ <para>
+ All Kickstart scripts and the log files of their execution are stored in the
<filename>/tmp</filename> directory to assist with debugging installation
issues.
+ </para>
- <section id="sect-kickstart-introduction">
- <title>Introduction to Kickstart Installations</title>
- <para>
- text
- </para>
- </section>
+ <section id="sect-kickstart-howto">
+ <title>How to Perform a Kickstart Installation</title>
+ <para>
+ Kickstart installations can be performed using a local DVD, a local hard
drive, or via NFS, FTP, HTTP, or HTTPS.
+ </para>
+ <para>
+ To use Kickstart, you must:
+ </para>
+ <orderedlist>
+ <listitem>
+ <para>
+ Create a Kickstart file.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Create boot media or configure a network boot (PXE) server which will
be used to begin the installation.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Make the Kickstart file available on removable media, a hard drive,
or a network location.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Start the Kickstart installation by booting the installer and using a
boot option to tell the installer where to find the Kickstart file.
+ </para>
+ </listitem>
+ </orderedlist>
+ <para>
+ This chapter explains these steps in detail.
+ </para>
- <section id="sect-kickstart-howto">
- <title>How to Perform a Kickstart Installation</title>
- <para>
- text
- </para>
+ <section id="sect-kickstart-file-create">
+ <title>Creating a Kickstart File</title>
+ <para>
+ The Kickstart file itself is a plain text file, containing keywords
listed in <xref linkend="appe-kickstart-syntax-reference" />, which serve
as directions for the installation. Any text editor able to save files as ASCII text (such
as <application>Gedit</application> or
<application>vim</application> on Linux systems or
<application>Notepad</application> on Windows systems) can be used to create
and edit Kickstart files.
+ </para>
+ <para>
+ The recommended approach to creating Kickstart files is to perform a
manual installation on one system first. After the installation completes, all choices
made during the installation are saved into a file named
<filename>anaconda-ks.cfg</filename>, located in the <filename
class="directory">/root/</filename> directory on the installed system.
You can then copy this file, make any changes you need, and use the resulting
configuration file in further installations.
+ </para>
+ <para>
+ When creating a Kickstart file, keep in mind the following:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ Lines starting with a pound sign
(<literal>#</literal>) are treated as comments and are ignored.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Sections must be specified <emphasis>in
order</emphasis>. Items within the sections do not have to be in a specific order
unless otherwise specified. The correct section order is:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ The command section which contains actual Kickstart
commands and options as listed in <xref
linkend="appe-kickstart-syntax-reference" />. Note that some commands, such
as <command>install</command>, are mandatory, but most commands are optional.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ The <command>%packages</command> section
which contains a list of packages and package groups to be installed. See <xref
linkend="sect-kickstart-packages" /> for details.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ The <command>%pre</command> and
<command>%post</command> sections, containing a pre-installation and
post-installation scripts. These two sections can be in any order and are not mandatory.
See <xref linkend="sect-kickstart-preinstall" /> and <xref
linkend="sect-kickstart-postinstall" /> for details.
+ </para>
+ </listitem>
+ </itemizedlist>
+ <important>
+ <para>
+ The <command>%packages</command>,
<command>%pre</command> and <command>%post</command> sections must
end with <command>%end</command>, otherwise the installation program will
refuse the Kickstart file. The main command section has no special ending statement.
+ </para>
+ </important>
+ </listitem>
+ <listitem>
+ <para>
+ Omitting any required item results in the installation program
prompting the user for an answer to the related item, just as the user would be prompted
during a typical installation. Once the answer is given, the installation will continue.
Note that if the system you are installing has no display, you will not be able to see the
prompt, and the installation will appear to have failed.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </section>
- <section id="sect-kickstart-file-create">
- <title>Creating a Kickstart File</title>
- <para>
- text
- </para>
- </section>
+ <section id="sect-kickstart-verify">
+ <title>Verifying the Kickstart File</title>
+ <para>
+ When creating or customizing your kickstart file, it is useful to verify
that it is valid before attempting to use it in an installation. &PRODUCT; includes
the <application>ksvalidator</application> command line utility which can be
used to do this. This tool is a part of the <package>pykickstart</package>
package. To install this package, execute the following command:
+ </para>
+ <screen>
+<prompt>#</prompt> <command>yum install pykickstart</command>
+ </screen>
+ <para>
+ After installing the package, you can validate a Kickstart file using the
following command:
+ </para>
+ <screen>
+<prompt>$</prompt> <command>ksvalidator
<replaceable>/path/to/kickstart.ks</replaceable></command>
+ </screen>
+ <para>
+ Replace <replaceable>/path/to/kickstart.ks</replaceable> with
the path to the Kickstart file you want to verify.
+ </para>
+ <para>
+ For more information about this tool, see the
<systemitem>ksvalidator(1)</systemitem> man page.
+ </para>
+ <important>
+ <para>
+ Keep in mind that the validation tool has its limitations. The
Kickstart file can be very complicated; <application>ksvalidator</application>
can make sure the syntax is correct and that the file does not include removed options,
but it cannot guarantee the installation will be successful. It also does not attempt to
validate the <command>%pre</command>, <command>%post</command> and
<command>%packages</command> sections of the Kickstart file.
+ </para>
+ </important>
+ </section>
- <section id="sect-kickstart-verify">
- <title>Verifying the Kickstart File</title>
- <para>
- text
- </para>
- </section>
+ <section id="sect-kickstart-making-available">
+ <title>Making the Kickstart File Available</title>
+ <para>
+ Once you create a Kickstart file, you can place it in one of the
following locations:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ On <emphasis>removable media</emphasis>, such as a
DVD or USB flash drive connected to the installation system
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ On a <emphasis>hard drive</emphasis> connected to the
installation system
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ On a <emphasis>network share</emphasis> reachable
from the installation system
+ </para>
+ </listitem>
+ </itemizedlist>
+ <para>
+ Normally, a Kickstart file is copied to removable media or a hard drive,
or made available on the network. Placing the file in a network location complements the
usual approach to Kickstart installations, which is also network-based: the system is
booted using a PXE server, the Kickstart file is downloaded from a network share, and
software packages specified in the file are downloaded from remote repositories.
+ </para>
+ <para>
+ <remark>TODO: link this with the PXE chapter, and maybe provide a
procedure about how to create a new partition on a bootable USB with a netinst iso and put
a Kickstart on it</remark>
+ </para>
+ </section>
- <section id="sect-kickstart-making-available">
- <title>Making the Kickstart File Available</title>
- <para>
- text
- </para>
- </section>
+ <section id="sect-kickstart-installation-starting">
+ <title>Starting the Kickstart Installation</title>
+ <para>
+ Once you have everything ready - you have created a valid Kickstart file
and you have either local boot media or a PXE server available, you can start the
Kickstart installation. You need to use the <option>inst.ks=</option> boot
option either in the boot menu (when booting from local media), or add this option to your
PXE server configuration. For information about boot options used in Kickstart
installations, see <xref linkend="sect-boot-options-kickstart" />.
+ </para>
+ </section>
- <section id="sect-kickstart-installation-source">
- <title>Making the Installation Source Available</title>
- <para>
- text
- </para>
- </section>
-
- <section id="sect-kickstart-installation-starting">
- <title>Starting the Kickstart Installation</title>
- <para>
- text
- </para>
-
- <section id="sect-kickstart-installation-starting-manual">
- <title>Starting the Kickstart Installation Manually </title>
- <para>
- text
- </para>
- </section>
-
- <section id="sect-kickstart-installation-starting-automatic">
- <title>Starting the Kickstart Installation Automatically</title>
- <para>
- text
- </para>
- </section>
-
- </section>
-
- </section>
+ </section>
</chapter>