--- pandoc_docs.rst 2015-03-27 12:45:34.954752535 +0100 +++ docs/kickstart_docs.rst 2015-03-27 12:36:53.698906036 +0100 @@ -1,6 +1,12 @@ -.. raw:: mediawiki +Kickstart Documentation +************************ - {{autolang|base=yes}} +:Authors: + Chris Lumens + and other members of the *Anaconda installer team* + +.. contents:: + :depth: 3 Chapter 1. Introduction ======================= @@ -25,6 +31,7 @@ http://docs.fedoraproject.org/en-US/index.html has a detailed section on kickstart. + How Do You Perform a Kickstart Installation? -------------------------------------------- @@ -41,6 +48,7 @@ This chapter explains these steps in detail. + Creating the Kickstart File --------------------------- @@ -84,6 +92,7 @@ sure you haven't used any of them. When using ksvalidator, deprecated items will cause an error. + Special Notes for Referring to Disks ------------------------------------ @@ -126,6 +135,7 @@ part /data --ondisk=LABEL=data part /misc --ondisk=UUID=819ff6de-0bd6-4bf4-8b72-dbe41033a85b + Chapter 2. Kickstart Options ============================ @@ -133,17 +143,20 @@ to use a graphical interface for creating your kickstart file, you can use the Kickstart Configurator application. -.. raw:: mediawiki +**If the option is followed by an equals mark (``==``), a value must be specified after it. - {{Admon/caution | If the option is followed by an equals mark (=), a value must be specified after it. +In the example commands, options in '''[square brackets]''' are optional arguments for the command.** - In the example commands, options in '''[square brackets]''' are optional arguments for the command.}} +**pykickstart processes arguments to commands just like the shell does:** -.. raw:: mediawiki +:: - {{Admon/caution | pykickstart processes arguments to commands just like the shell does. + If a list of arguments can be passed in, the arguments must be separated by + commas and not include any extra spaces. If extra spaces are required in the + list of arguments, the entire argument must be surrounded by double quotes. If + quotes, spaces, or other special characters need to be added to the argumens + list, they must be escaped. - If a list of arguments can be passed in, the arguments must be separated by commas and not include any extra spaces. If extra spaces are required in the list of arguments, the entire argument must be surrounded by double quotes. If quotes, spaces, or other special characters need to be added to the argument list, they must be escaped.}} auth or authconfig ------------------ @@ -155,6 +168,7 @@ By default, passwords are normally encrypted and are not shadowed. + autopart -------- @@ -162,9 +176,7 @@ partition, and an appropriate boot partition for the architecture. On large enough drives, this will also create a /home partition. -.. raw:: mediawiki - - {{Admon/caution | The autopart command can't be used together with the part/partition, raid, volgroup or logvol commands in the same kickstart file.}} +**The ``autopart`` command can't be used together with the ``part``/``partition``, ``raid``, ``volgroup`` or ``logvol`` commands in the same kickstart file.** ``--type=`` @@ -215,6 +227,7 @@ scheme and a filesystem. eg. --fstype=ext4. Added in anaconda-21.46-1 + autostep -------- @@ -229,14 +242,13 @@ images over to /root/anaconda-screenshots after installation is complete. This is most useful for documentation. + bootloader ---------- This required command specifies how the boot loader should be installed. -.. raw:: mediawiki - - {{admon/important|BIOS Boot partition|As of Fedora 16 there must be a biosboot partition for the bootloader to be installed successfully onto a disk that contains a GPT/GUID partition table, which includes disks initialized by anaconda. This partition may be created with the kickstart option part biosboot --fstype{{=}}biosboot --size{{=}}1. However, in the case that a disk has an existing biosboot partition, adding a "part biosboot" option is unnecessary. }} +**As of Fedora 16 there must be a biosboot partition for the bootloader to be installed successfully onto a disk that contains a GPT/GUID partition table, which includes disks initialized by anaconda. This partition may be created with the kickstart option ``part biosboot --fstype=biosboot --size=1``. However, in the case that a disk has an existing biosboot partition, adding a "part biosboot" option is unnecessary.** ``--append=`` @@ -311,11 +323,10 @@ Use the extlinux bootloader instead of GRUB. This option only works on machines that are supported by extlinux. + btrfs ----- -(Added in anaconda-17.3) - Defines a BTRFS volume or subvolume. This command is of the form: ``btrfs --data= --metadata= --label=