[release-notes] Adding info about Anaconda/Kickstart changes
pbokoc
pbokoc at fedoraproject.org
Mon Apr 20 16:01:31 UTC 2015
commit 7bc2c75f3033b6a286e5a4688aa22c7d6ff46c1e
Author: Petr Bokoc <pbokoc at redhat.com>
Date: Mon Apr 20 17:58:58 2015 +0200
Adding info about Anaconda/Kickstart changes
en-US/Installation.xml | 151 +++++++++++++++++++++++++++++++++++++++++++++++-
1 files changed, 150 insertions(+), 1 deletions(-)
---
diff --git a/en-US/Installation.xml b/en-US/Installation.xml
index c99b828..303f4cf 100644
--- a/en-US/Installation.xml
+++ b/en-US/Installation.xml
@@ -6,5 +6,154 @@
<section id="sect-installation">
<title>Installation</title>
- <para />
+
+ <section id="sect-installer-general">
+ <title>General Anaconda Changes</title>
+ <itemizedlist>
+ <listitem>
+ <para>
+ Development of the <application>Anaconda</application> installer and related components such as <package>pykickstart</package>, <package>pyparted</package> and <package>initial-setup</package> has been moved from Fedorahostedg to Github (<ulink url="https://github.com/rhinstaller" />).
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ Full documentation of Kickstart commands and options is now in the rhinstaller/pykickstart Github repository as well: <ulink url="https://github.com/rhinstaller/pykickstart/blob/master/docs/kickstart-docs.rst" />. The version on the Fedora Wiki has been removed. Keeping the documentation in the Git repository will allow the development team to maintain multiple, more accurate versions of documentation matching with various releases of <systemitem>pykickstart</systemitem>.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ The localization effort for <application>Anaconda</application> has migrated from Transifex to <ulink url="https://fedora.zanata.org/project/view/anaconda">Zanata</ulink>.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ The new <application>DNF</application> package manager is now used to install packages. You can use the <option>inst.nodnf</option> option to revert back to <application>Yum</application> if needed. See <xref linkend="dnf" /> for more information about <application>DNF</application>.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </section>
+
+ <section id="sect-installer-gui">
+ <title>Changes in Anaconda's Graphical Interface</title>
+ <itemizedlist>
+ <listitem>
+ <para>
+ The advanced storage section of the <guilabel>Manual Partitioning</guilabel> screen now allows adding zFCP storage devices. The screen also now has a <guilabel>Refresh</guilabel> button, allowing you to refresh the list of network (iSCSI, FCoE, etc.) storage devices without having to leave the screen.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ The graphical interface now has animated transitions when moving back and forth between screens. This improvement aims to improve user experience by emphasizing the relationship between the main menu (<guilabel>Installation Summary</guilabel>) and other screens.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <application>Anaconda</application> is now maximized, instead of full-screen, when running on top of a desktop (e.g. when installing from a Live DVD).
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ When changing the settings on an existing connection in the <guilabel>Network & Hostname</guilabel> screen, you no longer have to turn the connection on and off for the changes to take effect.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </section>
+
+ <section id="sect-installer-options">
+ <title>Changes in Anaconda Boot Options</title>
+ <itemizedlist>
+ <listitem>
+ <para>
+ The <option>inst.dnf</option> boot option, which was added in Fedora 21, has been replaced by the <option>inst.nodnf</option> option, which behaves in an opposite way. Use <option>inst.nodnf</option> to force the installer to use the older <application>Yum</application> package manager to install packages instead of <application>DNF</application>, which is now default.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </section>
+
+ <section id="sect-installer-kickstart">
+ <title>Changes in Kickstart Syntax</title>
+ <itemizedlist>
+ <listitem>
+ <para>
+ The <option>--nobase</option> option for the <command>%packages</command> section has been removed.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ New command: <command>sshkey</command>. Use this command to install a SSH key to the <filename>authorized_keys</filename> file for a specified user using the following syntax:
+ </para>
+ <programlisting>
+<command>sshkey --username=<replaceable>user</replaceable> "<replaceable>ssh_key</replaceable>"</command>
+ </programlisting>
+ <para>
+ Replace <replaceable>user</replaceable> with the user name, and <replaceable>ssh_key</replaceable> with the SSH key. The key must be enclosed in quotes because it may contain spaces. Also note that the user must either be <systemitem>root</systemitem>, or it must exist (must be created by the <command>user</command> command in the Kickstart file, or by a package specified in the <command>%packages</command> section).
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ New section: <command>%anaconda</command>. This section can now be used in a Kickstart file to control the behavior of the installer, but not the installed system. Currently, the only command supported in this section is <command>pwpolicy</command>, described below. This section must end with an <command>%end</command> statement.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ New command: <command>pwpolicy</command>. This command sets password requirements such as minimum length for a named password entry.
+ </para>
+ <programlisting>
+<command>pwpolicy <replaceable>name</replaceable> [--minlen=<replaceable>LENGTH</replaceable>] [--minquality=<replaceable>QUALITY</replaceable>] [--strict|notstrict] [--emptyok|notempty] [--changesok|nochanges]</command>
+ </programlisting>
+ <para>
+ Replace <replaceable>name</replaceable> with one of the following: <literal>root</literal>, <literal>user</literal>, or <literal>luks</literal>, to set a policy for the root password, user passwords, or LUKS (disk encryption) password.
+ </para>
+ <para>
+ Available options are:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <option>--minlen=</option> - The minimum allowed password length. This parameter will be passed to the <systemitem>libpwquality</systemitem> library. The default minimum length is <literal>8</literal>.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <option>--minquality=</option> - Minimum allowed quality of the password, as calculated by <systemitem>libpwquality</systemitem>. If the <option>--strict</option> option is used, passwords with lower quality will not be allowed. If <option>--notstrict</option> is used, using a password of lower than specified quality will display a warning require the user to click <guilabel>Done</guilabel> twice in the graphical user interface to confirm. The default quality value is <literal>50</literal>.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <option>--strict</option> - Passwords with lower quality than specified in <option>--minquality</option> will be rejected completely. This is the default.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <option>--notstrict</option> - Passwords with lower quality than specified in <option>--minquality</option> will be accepted, but <application>Anaconda</application> will display a warning and require the user to click <guilabel>Done</guilabel> twice before accepting the password.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <option>--emptyok</option> - Allow empty passwords. This is the default.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <option>--notempty</option> - Do not allow empty passwords.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <option>--changesok</option> - Allow changing a password pre-configured in the Kickstart file to be changed interactively in the graphical user interface.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <option>--nochanges</option> - Passwords set in the Kickstart file can not be changed in the GUI. This is the default.
+ </para>
+ </listitem>
+ </itemizedlist>
+ <para>
+ The defaults are set in the <filename>/usr/share/anaconda/interactive-defaults.ks</filename> file provided by <application>Anaconda</application> on installation media. To override the default Kickstart file (and therefore change the installer's password policy), a <filename>product.img</filename> file with a separate <command>%anaconda</command> section must be created and passed to <application>Anaconda</application>.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </section>
+
</section>
More information about the docs-commits
mailing list