Merge "LUDOC-18 added entry for errno EDQUOT."

[doc/manual.git] / ManagingFailover.xml

diff --git a/ManagingFailover.xml b/ManagingFailover.xml
index efaeeb2..a64f234 100644 (file)
--- a/ManagingFailover.xml
+++ b/ManagingFailover.xml
@@ -1,9 +1,6 @@
 <?xml version='1.0' encoding='UTF-8'?>
-<!-- This document was created with Syntext Serna Free. -->
-<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en-US" xml:id="managingfailover">
-  <info>
-    <title xml:id="managingfailover.title">Managing Failover</title>
-  </info>
+<!-- This document was created with Syntext Serna Free. --><chapter xmlns="http://docbook.org/ns/docbook" xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en-US" xml:id="managingfailover">
+  <title xml:id="managingfailover.title">Managing Failover</title>
   <para>This chapter describes failover in a Lustre system and includes the following sections:</para>
   <itemizedlist>
     <listitem>
@@ -11,10 +8,13 @@
     </listitem>
   </itemizedlist>
   <note>
-    <para>For information about high availability(HA) management software, see the Lustre wiki topic <ulink xl:href="http://wiki.lustre.org/index.php/Using_Red_Hat_Cluster_Manager_with_Lustre">Using Red Hat Cluster Manager with Lustre</ulink> or the Lustre wiki topic <ulink xl:href="http://wiki.lustre.org/index.php/Using_Pacemaker_with_Lustre">LuUsing Pacemaker with stre</ulink>.</para>
+    <para>For information about high availability(HA) management software, see the Lustre wiki topic <link xl:href="http://wiki.lustre.org/index.php/Using_Red_Hat_Cluster_Manager_with_Lustre">Using Red Hat Cluster Manager with Lustre</link> or the Lustre wiki topic <link xl:href="http://wiki.lustre.org/index.php/Using_Pacemaker_with_Lustre">LuUsing Pacemaker with stre</link>.</para>
   </note>
   <section xml:id="dbdoclet.50438213_13563">
-    <title>20.1 Lustre Failover and <anchor xml:id="dbdoclet.50438213_marker-1301522" xreflabel=""/>Multiple-Mount Protection</title>
+      <title>
+          <indexterm><primary>multiple-mount protection</primary><see>failover</see></indexterm>
+          <indexterm><primary>failover</primary></indexterm>
+          Lustre Failover and Multiple-Mount Protection</title>
     <para>The failover functionality in Lustre is implemented with the multiple-mount protection (MMP) feature, which protects the file system from being mounted simultaneously to more than one node. This feature is important in a shared storage environment (for example, when a failover pair of OSTs share a partition).</para>
     <para>Lustre&apos;s backend file system, <literal>ldiskfs</literal>, supports the MMP mechanism. A block in the file system is updated by a <literal>kmmpd</literal> daemon at one second intervals, and a sequence number is written in this block. If the file system is cleanly unmounted, then a special &quot;clean&quot; sequence is written to this block. When mounting the file system, <literal>ldiskfs</literal> checks if the MMP block has a clean sequence or not.</para>
     <para>Even if the MMP block has a clean sequence, <literal>ldiskfs</literal> waits for some interval to guard against the following situations:</para>
@@ -31,7 +31,7 @@
       <para>The MMP feature is only supported on Linux kernel versions &gt;= 2.6.9.</para>
     </note>
     <section remap="h3">
-      <title>20.1.1 Working with Multiple-Mount Protection</title>
+      <title><indexterm><primary>failover</primary><secondary>multiple-mount protection</secondary></indexterm>Working with Multiple-Mount Protection</title>
       <para>On a new Lustre file system, MMP is automatically enabled by mkfs.lustre at format time if failover is being used and the kernel and <literal>e2fsprogs</literal> version support it. On an existing file system, a Lustre administrator can manually enable MMP when the file system is unmounted.</para>
       <para>Use the following commands to determine whether MMP is running in Lustre and to enable or disable the MMP feature.</para>
       <para>To determine if MMP is enabled, run:</para>