[install-guide] Restructuring XML for Create RAID section
Jack Reed
jjr at fedoraproject.org
Wed Jan 2 02:20:11 UTC 2013
commit 3f940af76dfac9a3d46ec63e58180fd52cf77ecb
Author: Jack Reed <jreed at redhat.com>
Date: Wed Jan 2 12:19:42 2013 +1000
Restructuring XML for Create RAID section
en-US/Create_Software_RAID-common-para-3.xml | 9 ++
en-US/Create_Software_RAID-common-para-4.xml | 9 ++
en-US/Create_Software_RAID-common-procedure.xml | 50 ++++++++
.../Create_Software_RAID-common-variablelist-1.xml | 47 ++------
.../Create_Software_RAID-common-varlistentry-1.xml | 17 +++
.../Create_Software_RAID-common-varlistentry-2.xml | 16 +++
.../Create_Software_RAID-common-varlistentry-3.xml | 15 +++
.../Create_Software_RAID-common-varlistentry-4.xml | 16 +++
.../Create_Software_RAID-common-varlistentry-5.xml | 17 +++
.../Create_Software_RAID-common-varlistentry-6.xml | 17 +++
en-US/Create_Software_RAID-x86.xml | 132 +-------------------
11 files changed, 178 insertions(+), 167 deletions(-)
---
diff --git a/en-US/Create_Software_RAID-common-para-3.xml b/en-US/Create_Software_RAID-common-para-3.xml
new file mode 100644
index 0000000..9b5feb5
--- /dev/null
+++ b/en-US/Create_Software_RAID-common-para-3.xml
@@ -0,0 +1,9 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE para PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Installation_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<para>
+ RAID configuration options will only be visible if you have selected two or more disks in <xref linkend="s1-diskpartsetup-x86" />. At least two disks are required to create a RAID device.
+</para>
+
diff --git a/en-US/Create_Software_RAID-common-para-4.xml b/en-US/Create_Software_RAID-common-para-4.xml
new file mode 100644
index 0000000..6f99084
--- /dev/null
+++ b/en-US/Create_Software_RAID-common-para-4.xml
@@ -0,0 +1,9 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE para PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Installation_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<para>
+ To create a RAID device:
+</para>
+
diff --git a/en-US/Create_Software_RAID-common-procedure.xml b/en-US/Create_Software_RAID-common-procedure.xml
new file mode 100644
index 0000000..acbd18f
--- /dev/null
+++ b/en-US/Create_Software_RAID-common-procedure.xml
@@ -0,0 +1,50 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE para PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Installation_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<procedure>
+ <step>
+ <para>
+ Create a partition as described in <xref linkend="Adding_Partitions-x86" />. Configuring this partition will configure the RAID device.
+ </para>
+ </step>
+
+ <step>
+ <para>
+ Click the <guilabel>Device Type</guilabel> dropdown menu and select <guilabel>RAID</guilabel>.
+ </para>
+ </step>
+
+ <step>
+ <para>
+ A group of checkboxes will appear beneath the <guilabel>File System</guilabel> dropdown menu, which is grayed out for RAID. Choose the RAID level of the device by checking the required boxes. The level will be displayed at the right when these boxes have been checked.
+ </para>
+ <para>
+ Next to each checkbox, any disk space that will be gained or lost by selecting that option will be displayed in red. Certain boxes may be grayed out and labeled <guilabel>not enough disks</guilabel> if that RAID level cannot be achieved with the available disks.
+ </para>
+ <para>
+ The checkboxes required for each RAID level are:
+ </para>
+
+ <xi:include href="Create_Software_RAID-common-variablelist-1.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <!-- Optimized performance (stripe) -->
+
+ </step>
+ <step>
+ <para>
+ Keeping the partition selected in the left-hand pane, select the configuration button below the pane to open the <guilabel>Configure Mount Point</guilabel> dialog. Select which disks will be included in the RAID device and click <guibutton>Select</guibutton>.
+ </para>
+ <para>
+ If fewer disks are included than the specified RAID level needs, a yellow notification bar at the bottom of the screen will inform you that <guilabel>Device reconfiguration failed</guilabel>. Clicking this warning prompts a dialog informing you how many disks are required.
+ </para>
+ </step>
+
+ <step>
+ <para>
+ Click <guibutton>Apply Changes</guibutton> to save your changes, and either continue with another partition or click <guibutton>Finish Partitioning</guibutton> to return to the Installation Summary Menu.
+ </para>
+ </step>
+
+ </procedure>
+
diff --git a/en-US/Create_Software_RAID-common-variablelist-1.xml b/en-US/Create_Software_RAID-common-variablelist-1.xml
index cfcdfe7..a69e23f 100644
--- a/en-US/Create_Software_RAID-common-variablelist-1.xml
+++ b/en-US/Create_Software_RAID-common-variablelist-1.xml
@@ -4,45 +4,14 @@
%BOOK_ENTITIES;
]>
<variablelist>
- <varlistentry>
- <term><guilabel>RAID Device</guilabel></term>
- <listitem>
- <para>
- Choose this option to construct a RAID device from two or more existing software RAID partitions. This option is available if two or more software RAID partitions have been configured.
- </para>
- <figure float="0">
- <title>Create a RAID device</title>
- <mediaobject>
- <imageobject>
- <imagedata fileref="images/diskpartitioning/raid-device.png" format="PNG" />
- </imageobject>
- <textobject>
- <para>
- The create a RAID device dialog.
- </para>
-
- </textobject>
-
- </mediaobject>
-
- </figure>
- <para>
- Select the file system type as for a standard partition.
- </para>
- <para>
- <application>Anaconda</application> automatically suggests a name for the RAID device, but you can manually select names from <literal>md0</literal> to <literal>md15</literal>.
- </para>
- <para>
- Click the checkboxes beside individual storage devices to include or remove them from this RAID.
- </para>
- <para>
- The <guilabel>RAID Level</guilabel> corresponds to a particular type of RAID. Choose from the following options:
- </para>
- <xi:include href="Create_Software_RAID-common-itemizedlist-1.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
- <!-- RAID 0 — distributes data across multiple storage devices. -->
- </listitem>
-
- </varlistentry>
+
+<xi:include href="Create_Software_RAID-common-varlistentry-1.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+<!-- Optimized performance (stripe) --> <xi:include href="Create_Software_RAID-common-varlistentry-2.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+<!-- Redundancy (mirror) --> <xi:include href="Create_Software_RAID-common-varlistentry-3.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+<!-- Error detection (parity) --> <xi:include href="Create_Software_RAID-common-varlistentry-4.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+<!-- Optimized performance (stripe) and Distributed --> <xi:include href="Create_Software_RAID-common-varlistentry-5.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+<!-- Redundant --> <xi:include href="Create_Software_RAID-common-varlistentry-6.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+<!-- Redundancy (mirror) and Optimized performance (stripe) -->
</variablelist>
diff --git a/en-US/Create_Software_RAID-common-varlistentry-1.xml b/en-US/Create_Software_RAID-common-varlistentry-1.xml
new file mode 100644
index 0000000..79732e8
--- /dev/null
+++ b/en-US/Create_Software_RAID-common-varlistentry-1.xml
@@ -0,0 +1,17 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE para PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Installation_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<varlistentry>
+ <term>
+ <guilabel>Optimized performance (stripe)</guilabel> = RAID0
+ </term>
+ <listitem>
+ <para>
+ Distributes data across multiple storage devices. Level 0 RAIDs offer increased performance over standard partitions, and can be used to pool the storage of multiple devices into one large virtual device. Note that Level 0 RAIDS offer no redundancy and that the failure of one device in the array destroys the entire array. RAID 0 requires at least two RAID partitions.
+
+ </para>
+ </listitem>
+</varlistentry>
+
diff --git a/en-US/Create_Software_RAID-common-varlistentry-2.xml b/en-US/Create_Software_RAID-common-varlistentry-2.xml
new file mode 100644
index 0000000..b20d4d4
--- /dev/null
+++ b/en-US/Create_Software_RAID-common-varlistentry-2.xml
@@ -0,0 +1,16 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE para PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Installation_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<varlistentry>
+
+ <term>
+ <guilabel>Redundancy (mirror)</guilabel> = RAID1
+ </term>
+ <listitem>
+ <para>
+ Mirrors the data on one storage device onto one or more other storage devices. Additional devices in the array provide increasing levels of redundancy. RAID 1 requires at least two RAID partitions.
+ </para>
+ </listitem>
+</varlistentry>
diff --git a/en-US/Create_Software_RAID-common-varlistentry-3.xml b/en-US/Create_Software_RAID-common-varlistentry-3.xml
new file mode 100644
index 0000000..522328c
--- /dev/null
+++ b/en-US/Create_Software_RAID-common-varlistentry-3.xml
@@ -0,0 +1,15 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE para PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Installation_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<varlistentry>
+ <term>
+ <guilabel>Error detection (parity)</guilabel> = RAID4
+ </term>
+ <listitem>
+ <para>
+ Distributes data across multiple storage devices, but uses one device in the array to store parity information that safeguards the array in case any device within the array fails. Because all parity information is stored on the one device, access to this device creates a bottleneck in the performance of the array. RAID 4 requires at least three RAID partitions.
+ </para>
+ </listitem>
+</varlistentry>
diff --git a/en-US/Create_Software_RAID-common-varlistentry-4.xml b/en-US/Create_Software_RAID-common-varlistentry-4.xml
new file mode 100644
index 0000000..36fdcd9
--- /dev/null
+++ b/en-US/Create_Software_RAID-common-varlistentry-4.xml
@@ -0,0 +1,16 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE para PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Installation_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<varlistentry>
+ <term>
+ <guilabel>Optimized performance (stripe)</guilabel> and <guilabel>Distributed</guilabel> = RAID5
+ </term>
+ <listitem>
+ <para>
+ Distributes data and parity information across multiple storage devices. Level 5 RAIDs therefore offer the performance advantages of distributing data across multiple devices, but do not share the performance bottleneck of level 4 RAIDs because the parity information is also distributed through the array. RAID 5 requires at least three RAID partitions.
+ </para>
+ </listitem>
+</varlistentry>
+
diff --git a/en-US/Create_Software_RAID-common-varlistentry-5.xml b/en-US/Create_Software_RAID-common-varlistentry-5.xml
new file mode 100644
index 0000000..31b19e2
--- /dev/null
+++ b/en-US/Create_Software_RAID-common-varlistentry-5.xml
@@ -0,0 +1,17 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE para PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Installation_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<varlistentry>
+
+ <term>
+ <guilabel>Redundant</guilabel> = RAID6
+ </term>
+ <listitem>
+ <para>
+ Level 6 RAIDs are similar to level 5 RAIDs, but instead of storing only one set of parity data, they store two sets. RAID 6 requires at least four RAID partitions.
+ </para>
+ </listitem>
+</varlistentry>
+
diff --git a/en-US/Create_Software_RAID-common-varlistentry-6.xml b/en-US/Create_Software_RAID-common-varlistentry-6.xml
new file mode 100644
index 0000000..434dfef
--- /dev/null
+++ b/en-US/Create_Software_RAID-common-varlistentry-6.xml
@@ -0,0 +1,17 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE para PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Installation_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<varlistentry>
+
+ <term>
+ <guilabel>Redundancy (mirror)</guilabel> and <guilabel>Optimized performance (stripe)</guilabel> = RAID10
+ </term>
+ <listitem>
+ <para>
+ Level 10 RAIDs are <firstterm>nested RAIDs</firstterm> or <firstterm>hybrid RAIDs</firstterm>. Level 10 RAIDs are constructed by distributing data over mirrored sets of storage devices. For example, a level 10 RAID constructed from four RAID partitions consists of two pairs of partitions in which one partition mirrors the other. Data is then distributed across both pairs of storage devices, as in a level 0 RAID. RAID 10 requires at least four RAID partitions.
+ </para>
+ </listitem>
+</varlistentry>
+
diff --git a/en-US/Create_Software_RAID-x86.xml b/en-US/Create_Software_RAID-x86.xml
index 53551c1..8d9454a 100644
--- a/en-US/Create_Software_RAID-x86.xml
+++ b/en-US/Create_Software_RAID-x86.xml
@@ -26,135 +26,11 @@
</figure>
- <para>
- RAID configuration options will only be visible if you have selected two or more disks in <xref linkend="s1-diskpartsetup-x86" />. At least two disks are required to create a RAID device.
- </para>
-
- <para>
- To create a RAID device:
- </para>
-
- <procedure>
- <step>
- <para>
- Create a partition as described in <xref linkend="Adding_Partitions-x86" />. Configuring this partition will configure the RAID device.
- </para>
- </step>
-
- <step>
- <para>
- Click the <guilabel>Device Type</guilabel> dropdown menu and select <guilabel>RAID</guilabel>.
- </para>
- </step>
-
- <step>
- <para>
- A group of checkboxes will appear beneath the <guilabel>File System</guilabel> dropdown menu, which is grayed out for RAID. Choose the RAID level of the device by checking the required boxes. The level will be displayed at the right when these boxes have been checked.
- </para>
- <para>
- Next to each checkbox, any disk space that will be gained or lost by selecting that option will be displayed in red. Certain boxes may be grayed out and labeled <guilabel>not enough disks</guilabel> if that RAID level cannot be achieved with the available disks.
- </para>
- <para>
- The checkboxes required for each RAID level are:
- </para>
- <variablelist>
+ <xi:include href="Create_Software_RAID-common-para-3.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <!-- RAID configuration options will only be visible if you have selected two or more disks --> <xi:include href="Create_Software_RAID-common-para-4.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <!-- To create a RAID device --> <xi:include href="Create_Software_RAID-common-procedure.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+ <!-- Create a partition as described in -->
- <varlistentry>
- <term>
- <guilabel>Optimized performance (stripe)</guilabel> = RAID0
- </term>
- <listitem>
- <para>
- Distributes data across multiple storage devices. Level 0 RAIDs offer increased performance over standard partitions, and can be used to pool the storage of multiple devices into one large virtual device. Note that Level 0 RAIDS offer no redundancy and that the failure of one device in the array destroys the entire array. RAID 0 requires at least two RAID partitions.
-
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
-
- <term>
- <guilabel>Redundancy (mirror)</guilabel> = RAID1
- </term>
- <listitem>
- <para>
- Mirrors the data on one storage device onto one or more other storage devices. Additional devices in the array provide increasing levels of redundancy. RAID 1 requires at least two RAID partitions.
-
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
-
- <term>
- <guilabel>Error detection (parity)</guilabel> = RAID4
- </term>
- <listitem>
- <para>
- Distributes data across multiple storage devices, but uses one device in the array to store parity information that safeguards the array in case any device within the array fails. Because all parity information is stored on the one device, access to this device creates a bottleneck in the performance of the array. RAID 4 requires at least three RAID partitions.
-
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
-
- <term>
- <guilabel>Optimized performance (stripe)</guilabel> and <guilabel>Distributed</guilabel> = RAID5
- </term>
- <listitem>
- <para>
- Distributes data and parity information across multiple storage devices. Level 5 RAIDs therefore offer the performance advantages of distributing data across multiple devices, but do not share the performance bottleneck of level 4 RAIDs because the parity information is also distributed through the array. RAID 5 requires at least three RAID partitions.
-
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
-
- <term>
- <guilabel>Redundant</guilabel> = RAID6
- </term>
- <listitem>
- <para>
- Level 6 RAIDs are similar to level 5 RAIDs, but instead of storing only one set of parity data, they store two sets. RAID 6 requires at least four RAID partitions.
-
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
-
- <term>
- <guilabel>Redundancy (mirror)</guilabel> and <guilabel>Optimized performance (stripe)</guilabel> = RAID10
- </term>
- <listitem>
- <para>
- Level 10 RAIDs are <firstterm>nested RAIDs</firstterm> or <firstterm>hybrid RAIDs</firstterm>. Level 10 RAIDs are constructed by distributing data over mirrored sets of storage devices. For example, a level 10 RAID constructed from four RAID partitions consists of two pairs of partitions in which one partition mirrors the other. Data is then distributed across both pairs of storage devices, as in a level 0 RAID. RAID 10 requires at least four RAID partitions.
-
- </para>
- </listitem>
- </varlistentry>
-
- </variablelist>
- </step>
- <step>
- <para>
- Keeping the partition selected in the left-hand pane, select the configuration button below the pane to open the <guilabel>Configure Mount Point</guilabel> dialog. Select which disks will be included in the RAID device and click <guibutton>Select</guibutton>.
- </para>
- <para>
- If fewer disks are included than the specified RAID level needs, a yellow notification bar at the bottom of the screen will inform you that <guilabel>Device reconfiguration failed</guilabel>. Clicking this warning prompts a dialog informing you how many disks are required.
- </para>
- </step>
-
- <step>
- <para>
- Click <guibutton>Apply Changes</guibutton> to save your changes, and either continue with another partition or click <guibutton>Finish Partitioning</guibutton> to return to the Installation Summary Menu.
- </para>
- </step>
-
- </procedure>
-
<!-- <section id="RAID_Levels-x86">
<title>RAID Levels</title>
More information about the docs-commits
mailing list