[deployment-guide/comm-rel: 169/727] Wrote an outline of the kdump configuration chapter.

[Jaromir Hradilek]

commit f3db456b299b895604cc2aede4d61e379945f76d
Author: Jaromir Hradilek <jhradile at redhat.com>
Date:   Tue Jul 27 17:42:37 2010 +0200

    Wrote an outline of the kdump configuration chapter.
    
    Note that this commit also fixes bug 606414.

 en-US/The_kdump_Crash_Recovery_Service.xml |   92 ++++++++++++++++++++++++++++
 1 files changed, 92 insertions(+), 0 deletions(-)
---
diff --git a/en-US/The_kdump_Crash_Recovery_Service.xml b/en-US/The_kdump_Crash_Recovery_Service.xml
index fe9c2bc..c4c61a0 100644
--- a/en-US/The_kdump_Crash_Recovery_Service.xml
+++ b/en-US/The_kdump_Crash_Recovery_Service.xml
@@ -9,4 +9,96 @@
       To use the <systemitem class="service">kdump</systemitem> service, you must have the <package>kexec-tools</package> package installed. Refer to <xref linkend="sec-Installing" /> for more information on how to install new packages in &MAJOROS;.
     </para>
   </note>
+  <section id="s1-kdump-configuration">
+    <title>Configuring the <systemitem class="service">kdump</systemitem> Service</title>
+    <section id="s2-kdump-configuration-gui">
+      <title>Using the <application>Kernel Dump Configuration</application> Utility</title>
+      <para>
+        To start the <application>Kernel Dump Configuration</application> utility, select <menuchoice><guimenu>System</guimenu><guisubmenu>Administration</guisubmenu><guimenuitem>Kernel crash dumps</guimenuitem></menuchoice> from the panel, or type <command>system-config-kdump</command> at a shell prompt (for example, <emphasis>xterm</emphasis> or <emphasis>GNOME Terminal</emphasis>). You will be presented with a window as shown in <xref linkend="fig-kdump-kernel_dump_configuration" />.
+      </para>
+      <important>
+        <title>Important: Make Sure Your System Has Enough Memory</title>
+        <para>
+          Unless the system has enough memory, the utility will not start, and you will be presented with the following error message:
+        </para>
+        <mediaobject>
+          <imageobject>
+            <imagedata fileref="images/kdump-kernel_dump_configuration-not_enough_memory.png" align="center" format="PNG" scalefit="1" />
+          </imageobject>
+          <textobject>
+            <para>
+              The <quote>not enough memory</quote> error
+            </para>
+          </textobject>
+        </mediaobject>
+        <para>
+          For the information on minimum memory requirements, refer to the <citetitle pubwork="section">Required minimums</citetitle> section of the <ulink url="http://www.redhat.com/rhel/compare/"><citetitle pubwork="webpage">Red Hat Enterprise Linux</citetitle> comparison chart</ulink>. Note that when the <systemitem class="service">kdump</systemitem> crash recovery is enabled, the minimum memory requirements increase by the amount of memory reserved for it. This value is determined by a user, and defaults to 128 MB.
+        </para>
+      </important>
+      <section id="s2-kdump-configuration-gui-basic">
+        <title>The <guilabel>Basic Settings</guilabel> Tab</title>
+        <figure id="fig-kdump-kernel_dump_configuration">
+          <title><guilabel>Basic Settings</guilabel></title>
+          <mediaobject>
+            <imageobject>
+              <imagedata fileref="images/kdump-kernel_dump_configuration.png" format="PNG" scalefit="1" />
+            </imageobject>
+            <textobject>
+              <para>
+                <guilabel>Basic Settings</guilabel>
+              </para>
+            </textobject>
+          </mediaobject>
+        </figure>
+      </section>
+      <section id="s2-kdump-configuration-gui-target">
+        <title>The <guilabel>Target Settings</guilabel> Tab</title>
+        <figure id="fig-kdump-kernel_dump_configuration-target_settings">
+          <title><guilabel>Target Settings</guilabel></title>
+          <mediaobject>
+            <imageobject>
+              <imagedata fileref="images/kdump-kernel_dump_configuration-target_settings.png" format="PNG" scalefit="1" />
+            </imageobject>
+            <textobject>
+              <para>
+                <guilabel>Target Settings</guilabel>
+              </para>
+            </textobject>
+          </mediaobject>
+        </figure>
+      </section>
+      <section id="s2-kdump-configuration-gui-filtering">
+        <title>The <guilabel>Filtering Settings</guilabel> Tab</title>
+        <figure id="fig-kdump-kernel_dump_configuration-filtering_settings">
+          <title><guilabel>Filtering Settings</guilabel></title>
+          <mediaobject>
+            <imageobject>
+              <imagedata fileref="images/kdump-kernel_dump_configuration-filtering_settings.png" format="PNG" scalefit="1" />
+            </imageobject>
+            <textobject>
+              <para>
+                <guilabel>Filtering Settings</guilabel>
+              </para>
+            </textobject>
+          </mediaobject>
+        </figure>
+      </section>
+      <section id="s2-kdump-configuration-gui-expert">
+        <title>The <guilabel>Expert Settings</guilabel> Tab</title>
+        <figure id="fig-kdump-kernel_dump_configuration-expert_settings">
+          <title><guilabel>Expert Settings</guilabel></title>
+          <mediaobject>
+            <imageobject>
+              <imagedata fileref="images/kdump-kernel_dump_configuration-expert_settings.png" format="PNG" scalefit="1" />
+            </imageobject>
+            <textobject>
+              <para>
+                <guilabel>Expert Settings</guilabel>
+              </para>
+            </textobject>
+          </mediaobject>
+        </figure>
+      </section>
+    </section>
+  </section>
 </chapter>