commit 199fe2083b51334eefdd76e6417bbbdb90a53f8e
Author: Petr Bokoc <pbokoc(a)redhat.com>
Date: Fri Nov 14 19:19:33 2014 +0100
Adding text to StorageSpoke
en-US/StorageSpoke.xml | 185 +++++++++++++++++++++++++++++++++++++++++++++++-
1 files changed, 184 insertions(+), 1 deletions(-)
---
diff --git a/en-US/StorageSpoke.xml b/en-US/StorageSpoke.xml
index 4c9b241..f9eae9a 100644
--- a/en-US/StorageSpoke.xml
+++ b/en-US/StorageSpoke.xml
@@ -6,6 +6,189 @@
<section id="sect-installation-gui-storage-partitioning">
<title>Installation Destination</title>
<para>
- text
+ The <guilabel>Installation Destination</guilabel> screen allows you to
configure storage options - namely, which disks will be used as the installation target
for your &PRODUCT; installation. At least one disk must always be selected for the
installation to proceed.
</para>
+ <para>
+ For information about the theory and concepts behind disk partitioning in Linux, see
<remark>TODO: xref to the disk partitioning appendix</remark>.
+ </para>
+ <warning>
+ <para>
+ If you plan to use a disk which already contains some data - for example, if you want
to shrink an existing Microsoft Windows partition and install &PRODUCT; as a second
system or if you are upgrading a previous release of &PRODUCT;, make sure to back up
any important data first. Manipulating partitions always carries a risk - if the process
is interrupted or fails for any reason (installer error, hardware failure, power outage,
etc.), any data already on the disk may become impossible to recover.
+ </para>
+ </warning>
+ <para>
+ <remark>TODO: screen</remark>
+ </para>
+ <para>
+ In the top part of the screen, all locally available storage devices (SATA, IDE and
SCSI hard drives, USB flash drives, etc.) are displayed in the <guilabel>Local
Standard Disks</guilabel> section. Local disks are detected when the installer
starts - any storage devices connected after the installation has started will not be
shown. If you need to additional local storage devices, you must restart the installation.
+ </para>
+ <para>
+ The <guilabel>Specialized & Network Disks</guilabel> section below
shows advanced network storage (such as iSCSI and FCoE disks) currently configured. When
you first open this screen, no such devices will be displayed because they can not be
automatically detected; to search for network storage devices <guilabel>Add a
disk</guilabel> button and proceed with <xref
linkend="sect-installation-gui-installation-destination" />. Any network
storage you configure will then show up in the <guilabel>Specialized &
Network Disks</guilabel> the same way local disks are shown above.
+ </para>
+ <para>
+ All storage devices which will be used to install &PRODUCT; have a black circle
icon with a white check mark on them. Disks not marked by this icon will not be used
during the installation - they will be ignored if you choose automatic partitioning, and
they will not be available in manual partitioning.
+ </para>
+ <important>
+ <para>
+ USB storage devices such as flash drives and external disks will be shown in the
<guilabel>Local Standard Disks</guilabel> as well, and they will be available
for selection the same way internal hard drives are. Make sure to
<emphasis>not</emphasis> select any removable storage as installation targets
unless you really want to do so. If you accidentally use a removable drive to install
&PRODUCT; and then unplug it, your system will likely become unusable.
+ </para>
+ </important>
+ <para>
+ <remark>TODO: screen with a selected and an unselected disk</remark>
+ </para>
+ <para>
+ After you select all disks you want to install &PRODUCT;, select one of the two
options in the <guilabel>Other Storage Options</guilabel> section:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <guilabel>Automatically configure partitioning</guilabel> - If this
option is selected, then after you press <guilabel>Done</guilabel> in the top
left corner of the screen, the installer will determine the total amount of space on all
selected disks, and it will create a <firstterm>Logical Volume
Management</firstterm> (LVM) layout suitable for your system. The specifics of this
layout depend on whether your system uses BIOS or UEFI firmware, the total amount of free
space on your disks, and the amount of RAM on your system (which determines the size of
your swap space).
+ </para>
+ <para>
+ With automatic partitioning, you can also select the <guilabel>I would like to
make additional space available</guilabel> option below. Use this option if you want
to reclaim space from an existing partitioning layout - for example, if a disk you want to
use already contains a different operating system, and you want to make this system's
partitions smaller to allow more room for &PRODUCT;. The <guilabel>Reclaim
space</guilabel> dialog which opens if this option is selected is described later in
this section.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <guilabel>I will configure partitioning</guilabel> - Select this option
and press <guilabel>Done</guilabel> in the top left corner of the screen to
configure your system's partitioning layout manually. This requires some knowledge of
the theory behind disk partitions and related concepts, but gives you full control over
the way the system will be installed. For instructions for manual partitioning, see
<xref linkend="sect-installation-gui-manual-partitioning" />.
+ </para>
+ </listitem>
+ </itemizedlist>
+ <para>
+ Additionally, you can select <guilabel>Encrypt my data</guilabel>; this
will encrypt all partitions except the ones needed to boot the system (such as
<filename class="directory">/boot</filename>) using
<firstterm>Linux Unified Key Setup</firstterm> (LUKS). Encrypting your hard
drive is recommended. For detailed information about LUKS encryption, see the
<citetitle>&PRODUCT; Security Guide</citetitle>, available at
<ulink
url="http://docs.fedoraproject.org/">&PRODUCT;
Documentation</ulink>.
+ </para>
+ <warning>
+ <para>
+ If you lose the LUKS passphrase, any encrypted partitions and the data on them will
become completely inaccessible. There is no way to recover a lost passphrase. However, if
you perform a Kickstart installation, you can save encryption passphrases and create
backup encryption passphrases during the installation. See <xref
linkend="chap-kickstart-installations" /> for information about Kickstart
installations.
+ </para>
+ </warning>
+ <para>
+ To control which one of your selected storage devices will contain the
<firstterm>boot loader</firstterm>, click the <guilabel>Full disk
summary and bootloader</guilabel> link in the bottom left corner of the screen, and
follow the instructions below. Note that while in most cases it is sufficient to leave the
boot loader in the default location, some configurations (for example, systems which
require <firstterm>chain loading</firstterm> from another boot loader) will
require the boot drive to be specified manually.
+ </para>
+ <para>
+ After you select storage devices, choose between automatic and manual partitioning,
configure encryption and boot loader location, press <guilabel>Done</guilabel>
in the top left corner of the screen. Then, depending on your settings, the following will
happen:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ If you chose to encrypt your hard drive, the <guilabel>Disk Encryption
Passphrase</guilabel> dialog will appear. Enter your chosen passphrase into the
<guilabel>Passphrase</guilabel> and <guilabel>Confirm</guilabel>
fields. When you do so, the passphrase will be automatically evaluated and its strength
will be displayed, along with suggestions on how to make it stronger if the installer has
determined it to be weak. For information about creating strong passwords, see
<citetitle>&PRODUCT; Security Guide</citetitle>.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ If you selected automatic partitioning and the <guilabel>I would like to make
additional space available</guilabel>, or if there is not enough free space on your
selected hard drives to install &PRODUCT;, the <guilabel>Reclaim
Space</guilabel> dialog will appear. This dialog lists all disk devices you have
configured and all partitions on those devices. The bottom right corner of the dialog
displays information about how much space the system needs for at least a minimal
installation and how much space you have reclaimed.
+ </para>
+ <warning>
+ <para>
+ If you use the <guilabel>Reclaim Space</guilabel> dialog to
<emphasis>delete</emphasis> a partition, all data on that partition will be
lost. If you want to preserve your data, use the <guilabel>Shrink</guilabel>
option, not the <guilabel>Delete</guilabel> option.
+ </para>
+ </warning>
+ <para>
+ First, review the displayed list of available storage devices. The
<guilabel>Reclaimable Space</guilabel> column shows how much space can be
reclaimed from each entry. To reclaim space, select a disk or partition, and press either
the <guilabel>Delete</guilabel> button to delete that partition (or all
partitions on a selected disk), or <guilabel>Shrink</guilabel> to use free
space on a partition while preserving existing data. Alternatively, you can press
<guilabel>Delete all</guilabel> in the bottom right corner; this will delete
all existing partitions on all disks and make this space available to &PRODUCT;, but
all existing data on all disks will be lost.
+ </para>
+ <para>
+ After you free enough space for your &PRODUCT; installation, press
<guilabel>Reclaim space</guilabel> to finish.
+ </para>
+ <note>
+ <para>
+ No changes to any disks will be made until you press <guilabel>Begin
Installation</guilabel> in <xref
linkend="sect-installation-gui-installation-summary" />. The
<guilabel>Reclaim Space</guilabel> dialog only
<emphasis>marks</emphasis> partitions for resizing or deletion, but no such
action is performed immediately.
+ </para>
+ </note>
+ </listitem>
+ <listitem>
+ <para>
+ If you selected the <guilabel>I will configure partitioning</guilabel>
option, pressing <guilabel>Done</guilabel> will open the
<guilabel>Manual Partitioning</guilabel> screen. See <xref
linkend="sect-installation-gui-manual-partitioning" /> for further
instructions.
+ </para>
+ </listitem>
+ </itemizedlist>
+
+ <section id="sect-installation-gui-storage-partitioning-bootloader">
+ <title>Boot Loader Installation</title>
+ <para>
+ &PRODUCT; uses <application>GRUB2</application> (GRand Unified
Bootloader version 2) as its boot loader. The boot loader is the first program that runs
when the computer starts and is responsible for loading and transferring control to an
operating system. <application>GRUB2</application> can boot any compatible
operating system (including Microsoft Windows) and can also use chain loading to transfer
control to other boot loaders for unsupported operating systems.
+ </para>
+ <warning>
+ <para>
+ Installing <application>GRUB2</application> may overwrite your existing
boot loader.
+ </para>
+ </warning>
+ <para>
+ If you have other operating systems already installed, the &PRODUCT; installer
will attempt to automatically detect and configure the boot loader to start them. You can
manually configure any additional operating systems after you finish the installation, if
they are not detected properly. For instructions on editing
<application>GRUB2</application> configuration, see the
<citetitle>&PRODUCT;
System Administrator's Guide</citetitle>, available at
<ulink
url="http://docs.fedoraproject.org/">&PRODUCT;
Documentation</ulink>
+ </para>
+ <para>
+ To specify which device the boot loader should be installed on, click the
<guilabel>Full disk summary and bootloader</guilabel> link at the bottom of
the <guilabel>Installation Destination</guilabel> screen. The
<guilabel>Selected Disks</guilabel> dialog will appear. If you are configuring
your partitioning layout manually, the same dialog can be accessed from <xref
linkend="sect-installation-gui-manual-partitioning" /> using the
<guilabel><replaceable>X</replaceable> storage devices
selected</guilabel> link in the bottom left corner of the screen.
+ </para>
+ <para>
+ <remark>TODO: screen</remark>
+ </para>
+ <para>
+ In the <guilabel>Boot</guilabel> column, a "tick" icon marks one
of the devices as the intended boot device. To change the boot device, select a device
from the list and click the <guilabel>Set as Boot Device</guilabel> button to
install the boot loader there instead. Only one device can be set as the boot device.
+ </para>
+ <para>
+ To decline installation of a new boot loader, select the device currently marked for
boot and click the <guilabel>Do not install bootloader</guilabel> button. This
will remove the tick and ensure <application>GRUB2</application> is not
installed on any device.
+ </para>
+ <warning>
+ <para>
+ If you choose not to install a boot loader for any reason, you will not be able to
boot the system directly, and you must use another boot method, such as a stand-alone
commercial boot loader application. Use this option only if you are sure you have another
way to boot your system.
+ </para>
+ </warning>
+
+ <section id="sect-installation-gui-storage-partitioning-mbr-gpt">
+ <title>MBR and GPT Considerations</title>
+ <para>
+ <application>GRUB2</application> can be installed either in the
<firstterm>Master Boot Record</firstterm> (MBR) or the <firstterm>GUID
Partition Table</firstterm> (GPT) of the boot device. In order to determine which of
these methods to use, the installation program considers the following variations:
+ </para>
+ <variablelist>
+ <varlistentry>
+ <term>Systems with BIOS firmware and UEFI systems in BIOS compatibility
mode</term>
+ <listitem>
+ <para>
+ If the disk is already formatted, the partitioning scheme is retained.
+ </para>
+ <para>
+ If the disk is not formatted, or you have erased all existing partitions from the
disk, the installer choose the following:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ MBR if the size of the disk is less than 2 TB (terabytes)
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ GPT if the size of the disk is more than 2 TB
+ </para>
+ </listitem>
+ </itemizedlist>
+ <note>
+ <para>
+ You can force the installer to use GPT on disks smaller than 2 TB by using the
<option>inst.gpt</option> boot option as described in <xref
linkend="chap-anaconda-boot-options" />. However, the opposite is not
possible - you can not use MBR on disks larger than 2 TB.
+ </para>
+ </note>
+ <para>
+ You need to create a <firstterm>BIOS Boot</firstterm> partition with a
size of 1 MB to install on a system with BIOS firmware if the disk containing the boot
loader uses GPT. If the disk uses a MBR, no special partition is necessary on a BIOS
system.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Systems with UEFI firmware</term>
+ <listitem>
+ <para>
+ Only GPT is allowed on UEFI systems. In order to install on a formatted disk with
a MBR, it must be reformated and relabeled. All data currently on the disk will be lost.
+ </para>
+ <para>
+ UEFI-based systems require an <firstterm>EFI System
Partition</firstterm> at least 50 MB in size (recommended size is 200 MB),
regardless of the partitioning scheme.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <important>
+ <para>
+ If your system requires either a BIOS Boot partition or an EFI System Partition
based on the requirements detailed above, this partition must be created as a standard
physical partition. It can not reside on a LVM volume or a Btrfs subvolume.
+ </para>
+ </important>
+ </section>
+
+ </section>
+
</section>