commit d5ed456cd484d7b78099bfccafb09703602cc4ba Author: Petr Bokoc pbokoc@redhat.com Date: Mon Nov 17 20:33:48 2014 +0100
Adding a procedure for creating Btrfs in CustomSpoke
en-US/CustomSpoke_AddBtrfs.xml | 74 +++++++++++++++++++++++++++++++++++++++- 1 files changed, 73 insertions(+), 1 deletions(-) --- diff --git a/en-US/CustomSpoke_AddBtrfs.xml b/en-US/CustomSpoke_AddBtrfs.xml index 613e479..c296f92 100644 --- a/en-US/CustomSpoke_AddBtrfs.xml +++ b/en-US/CustomSpoke_AddBtrfs.xml @@ -6,6 +6,78 @@ <section id="sect-installation-gui-manual-partitioning-btrfs"> <title>Creating a Btrfs Layout</title> <para> - text + <firstterm>Btrfs</firstterm> is a type of file system, but it has several features characteristic of a storage device. It is designed to make the file system tolerant of errors, and to facilitate the detection and repair of errors when they occur. It uses checksums to ensure the validity of data and metadata, and maintains snapshots of the file system that can be used for backup or repair. + </para> + <para> + Creating a Btrfs layout is somewhat similar to LVM (described in <xref linkend="sect-installation-gui-manual-partitioning-lvm" />) with slightly different terminology. A Btrfs <firstterm>volume</firstterm> is the equivalent of a LVM volume group, and a Btrfs <firstterm>subvolume</firstterm> is similar to a LVM logical volume. An important difference to note is how <application>Anaconda</application> reports sizes of separate mount points: For LVM, the exact size of each logical volume is shown next to each mount point in the left pane, while with Btrfs, the total size of the entire volume is shown next to each subvolume. + </para> + <warning> + <para> + Some partition types - notably the <filename class="directory">/boot</filename> and <filename class="directory">/usr</filename> directories and the BIOS Boot and EFI partitions - can not be placed on Btrfs subvolumes. Use standard physical volumes for them (or a LVM logical volume for <filename class="directory">/usr</filename>). See <xref linkend="sect-installation-gui-manual-partitioning-recommended" /> for more information. + </para> + </warning> + <para> + <remark>TODO: screen</remark> + </para> + <para> + Follow the procedure below to create Btrfs volumes and subvolumes: + </para> + <procedure> + <title>Creating Btrfs Subvolumes and Volumes</title> + <step> + <para> + Click the <guilabel>+</guilabel> button at the bottom of the list showing existing mount points. A new dialog window will open. + </para> + </step> + <step> + <para> + In the new dialog window, specify a mount point you want to create a separate logical volume for - for example, <filename class="directory">/</filename>. Optionally, specify a size for the volume using standard units such as MB or GB (for example, <literal>50GB</literal>). Then, click <guilabel>Add mount point</guilabel> to add the volume and return to the main partitioning screen. + </para> + </step> + <step> + <para> + The mount point has now been created using the default settings, which means it has been created as an LVM logical volume. Select the newly created mount point in the left pane to configure it further, and convert it to a Btrfs subvolume by changing the <guilabel>Device Type</guilabel> option to <guilabel>Btrfs</guilabel>. Then, click <guilabel>Update Settings</guilabel> in the bottom right corner of the screen. + </para> + </step> + <step> + <para> + In the <guilabel>Volume</guilabel> menu, you can see that the subvolume has been assigned to an automatically created volume, which is named after the &PRODUCT; variant you are installing (for example, <literal>fedora-server00</literal>. Click the <guilabel>Modify</guilabel> button under the drop-down menu to access the volume settings. + </para> + </step> + <step> + <para> + In the <guilabel>Configure Volume</guilabel> dialog, you can change the volume's name, its <guilabel>RAID level</guilabel> (see <xref linkend="sect-installation-gui-manual-partitioning-swraid" /> for details about software RAID), and you can also specify which physical devices (disks) this volume should reside on. You can select one or more disks which will be used to hold this volume by holding down <keycap>Ctrl</keycap> and clicking each disk in the list. + </para> + <note> + <para> + If you select a redundant RAID type (such as <guilabel>RAID1 (Redundancy)</guilabel>), the volume will take up twice its actual size on your disks. A 5 GB volume with RAID1 will take up 10 GB of space. + </para> + </note> + <para> + You can also make sure that the volume is encrypted by selecting the <guilabel>Encrypt</guilabel> option; this will enable LUKS encryption for the entire volume. See the <citetitle>&PRODUCT; Security Guide</citetitle>, available at the <ulink url="http://docs.fedoraproject.org/">&PRODUCT; Documentation website</ulink>, for information about LUKS disk encryption. + </para> + <para> + Additionally, you can set a fixed size for the volume by selecting the <guilabel>Fixed</guilabel> option from the <guilabel>Size policy</guilabel> menu, and entering a size for the volume group. + </para> + <para> + After you finish configuring the Btrfs volume settings, click <guilabel>Save</guilabel> to return to the main <guilabel>Manual Partitioning</guilabel> screen. + </para> + </step> + <step> + <para> + If you need to create more than one Btrfs volume, open the <guilabel>Volume</guilabel> drop-down menu, and select the <guilabel>Create a new volume group</guilabel> option. A new dialog window will open, identical to the one described in the previous step; again, select a name, storage devices, encryption settings, RAID level and size policy for the new volume, and click <guilabel>Save</guilabel>. The new volume will then become available in the <guilabel>Volume Group</guilabel> drop-down menu; you can then go through your existing mount points and change this setting to assign them to a different volume. + </para> + </step> + <step> + <para> + Configure other settings specific to the subvolume - its <guilabel>Mount Point</guilabel>, <guilabel>Desired Capacity</guilabel>, <guilabel>File System</guilabel>, and <guilabel>Name</guilabel>. Press <guilabel>Update Settings</guilabel> to apply any changes to the configuration. + </para> + </step> + </procedure> + <para> + Repeat this procedure for any additional Btrfs subvolumes you want to create. Note that when creating additional subvolumes, a new volume is not automatically created each time; instead, any additional subvolumes are assigned to an existing volume. + </para> + <para> + For each mount point you create, review its settings and make sure that it is assigned to the correct volume, that it has a sufficient capacity, and that it has a descriptive name so you can identify the volume later if you need to. </para> </section>
docs-commits@lists.fedoraproject.org