Whamcloud - gitweb
FIX: proofed against origional
[doc/manual.git] / ConfiguringFailover.xml
1 <?xml version='1.0' encoding='UTF-8'?>
2 <!-- This document was created with Syntext Serna Free. -->
3 <chapter xmlns="http://docbook.org/ns/docbook" xmlns:xl="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en-US" xml:id="configuringfailover">
4   <info>
5     <title xml:id="configuringfailover.title">Configuring Lustre Failover</title>
6   </info>
7   <para>This chapter describes how to configure Lustre failover using the Heartbeat cluster infrastructure daemon. It includes:</para>
8   <itemizedlist>
9     <listitem>
10       <para><xref linkend="dbdoclet.50438188_82389"/></para>
11     </listitem>
12     <listitem>
13       <para><xref linkend="dbdoclet.50438188_92688"/></para>
14     </listitem>
15   </itemizedlist>
16   <note>
17     <para>
18           Using Lustre Failover is optional
19       </para>
20   </note>
21   <section xml:id="dbdoclet.50438188_82389">
22     <title>11.1 Creating a Failover Environment</title>
23     <para>Lustre provides failover mechanisms only at the file system level. No failover functionality is provided for system-level components, such as node failure detection or power control, as would typically be provided in a complete failover solution. Additional tools are also needed to provide resource fencing, control and monitoring.</para>
24     <section remap="h3">
25       <title>11.1.1 Power Management Software</title>
26       <para>Lustre failover requires power control and management capability to verify that a failed node is shut down before I/O is directed to the failover node. This avoids double-mounting the two nodes, and the risk of unrecoverable data corruption. A variety of power management tools will work, but two packages that are commonly used with Lustre are STONITH and PowerMan.</para>
27       <para>Shoot The Other Node In The HEAD (STONITH), is a set of power management tools provided with the Linux-HA package. STONITH has native support for many power control devices and is extensible. It uses expect scripts to automate control.</para>
28       <para>PowerMan, available from the Lawrence Livermore National Laboratory (LLNL), is used to control remote power control (RPC) devices from a central location. PowerMan provides native support for several RPC varieties and expect-like configuration simplifies the addition of new devices.</para>
29       <para>The latest versions of PowerMan are available at:</para>
30       <para><ulink xl:href="http://sourceforge.net/projects/powerman">http://sourceforge.net/projects/powerman</ulink></para>
31       <para>For more information about PowerMan, go to:</para>
32       <para><ulink xl:href="https://computing.llnl.gov/linux/powerman.html">https://computing.llnl.gov/linux/powerman.html</ulink></para>
33     </section>
34     <section remap="h3">
35       <title>11.1.2 Power Equipment</title>
36       <para>Lustre failover also requires the use of RPC devices, which come in different configurations. Lustre server nodes may be equipped with some kind of service processor that allows remote power control. If a Lustre server node is not equipped with a service processor, then a multi-port, Ethernet-addressable RPC may be used as an alternative. For recommended products, refer to the list of supported RPC devices on the PowerMan website.</para>
37       <para><ulink xl:href="https://computing.llnl.gov/linux/powerman.html">https://computing.llnl.gov/linux/powerman.html</ulink></para>
38     </section>
39   </section>
40   <section xml:id="dbdoclet.50438188_92688">
41     <title>11.2 Setting up High-Availability (HA) Software with Lustre</title>
42     <para>Lustre must be combined with high-availability (HA) software to enable a complete Lustre failover solution. Lustre can be used with several HA packages including:</para>
43     <itemizedlist>
44       <listitem>
45         <para><emphasis>Red Hat Cluster Manager</emphasis>  - For more information about setting up Lustre failover with Red Hat Cluster Manager, 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>.</para>
46       </listitem>
47       <listitem>
48         <para><emphasis>Pacemaker</emphasis>  - For more information about setting up Lustre failover with Pacemaker, see the Lustre wiki topic <ulink xl:href="http://wiki.lustre.org/index.php/Using_Pacemaker_with_Lustre">Using Pacemaker with Lustre</ulink>.<anchor xml:id="dbdoclet.50438188_61775" xreflabel=""/></para>
49       </listitem>
50     </itemizedlist>
51   </section>
52 </chapter>