Whamcloud - gitweb
LUDOC-173 trademarks: Completed first pass of Intel trademark compliance review.
[doc/manual.git] / ManagingFailover.xml
index a64f234..653f7cb 100644 (file)
@@ -1,5 +1,4 @@
-<?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">
+<?xml version='1.0' encoding='UTF-8'?><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>
@@ -8,7 +7,20 @@
     </listitem>
   </itemizedlist>
   <note>
-    <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>
+    <para>For information about high availability(HA) management software, see the documentation for:<itemizedlist>
+        <listitem>
+          <para>Red Hat Cluster Manager at <link
+              xlink:href="http://www.redhat.com/software/rha/cluster/manager/"
+              xmlns:xlink="http://www.w3.org/1999/xlink"
+              >http://www.redhat.com/software/rha/cluster/manager/</link></para>
+        </listitem>
+        <listitem>
+          <para>Pacemaker at <link
+              xlink:href="http://clusterlabs.org/doc/en-US/Pacemaker/1.0/html/Pacemaker_Explained/index.html"
+              xmlns:xlink="http://www.w3.org/1999/xlink"
+              >http://clusterlabs.org/doc/en-US/Pacemaker/1.0/html/Pacemaker_Explained/index.html</link></para>
+        </listitem>
+      </itemizedlist></para>
   </note>
   <section xml:id="dbdoclet.50438213_13563">
       <title>
     </itemizedlist>
     <para>With MMP enabled, mounting a clean file system takes at least 10 seconds. If the file system was not cleanly unmounted, then the file system mount may require additional time.</para>
     <note>
-      <para>The MMP feature is only supported on Linux kernel versions &gt;= 2.6.9.</para>
+      <para>The MMP feature is only supported on Linux kernel versions newer than 2.6.9.</para>
     </note>
     <section remap="h3">
       <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>
-      <screen>dumpe2fs -h &lt;device&gt;|grep mmp</screen>
+      <screen>dumpe2fs -h <replaceable>/dev/block_device</replaceable> | grep mmp</screen>
       <para>Here is a sample command:</para>
       <screen>dumpe2fs -h /dev/sdc | grep mmp 
 Filesystem features: has_journal ext_attr resize_inode dir_index 
 filetype extent mmp sparse_super large_file uninit_bg</screen>
       <para>To manually disable MMP, run:</para>
-      <screen>tune2fs -O ^mmp &lt;device&gt; </screen>
+      <screen>tune2fs -O ^mmp <replaceable>/dev/block_device</replaceable></screen>
       <para>To manually enable MMP, run:</para>
-      <screen>tune2fs -O mmp &lt;device&gt;</screen>
+      <screen>tune2fs -O mmp <replaceable>/dev/block_device</replaceable></screen>
       <para>When MMP is enabled, if <literal>ldiskfs</literal> detects multiple mount attempts after the file system is mounted, it blocks these later mount attempts and reports the time when the MMP block was last updated, the node name, and the device name of the node where the file system is currently mounted.</para>
     </section>
   </section>