← Back to branch summary

~ampelbein/ubuntu/oneiric/heartbeat/lp-770743

« back to all changes in this revision

Viewing changes to doc/hb_takeover.xml.in

  • Committer: Bazaar Package Importer
  • Author(s): Ante Karamatic
  • Date: 2010-02-17 21:59:18 UTC
  • mfrom: (1.1.11 upstream)
  • Revision ID: james.westby@ubuntu.com-20100217215918-06paxph5do4saw8v
Tags: 3.0.2-0ubuntu1
* New upstream release
* Drop hard dep on pacemaker for heartbet; moved to Recommends
* debian/heartbeat.install:
  - follow upstream changes
* debian/control:
  - added docbook-xsl and xsltproc to build depends

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/hb_takeover.xml.in
 
1
<?xml version="1.0"?>
 
2
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
 
3
<refentry id="re-hbtakeover">
 
4
  <refentryinfo>
 
5
    <date>November 26, 2009</date>
 
6
    <productname>Heartbeat</productname>
 
7
    <productnumber>@VERSION@</productnumber>
 
8
    <authorgroup>
 
9
      <author>
 
10
        <firstname>Alan</firstname>
 
11
        <surname>Robertson</surname>
 
12
        <contrib>hb_takeover</contrib>
 
13
        <email>alanr@unix.sh</email>
 
14
      </author>
 
15
      <author>
 
16
        <surname>Shi</surname>
 
17
        <firstname>Guochun</firstname>
 
18
        <contrib>man page</contrib>
 
19
        <email>gshi@ncsa.uiuc.edu</email>
 
20
      </author>
 
21
      <author>
 
22
        <firstname>Florian</firstname>
 
23
        <surname>Haas</surname>
 
24
        <contrib>man page</contrib>
 
25
        <email>florian.haas@linbit.com</email>
 
26
      </author>
 
27
    </authorgroup>
 
28
  </refentryinfo>
 
29
  <refmeta>
 
30
    <refentrytitle>hb_takeover</refentrytitle>
 
31
    <manvolnum>1</manvolnum>
 
32
    <refmiscinfo class="manual">General commands</refmiscinfo>
 
33
  </refmeta>
 
34
  <refnamediv>
 
35
    <refname>hb_takeover</refname>
 
36
    <refpurpose>issues a failover request to the cluster manager</refpurpose>
 
37
  </refnamediv>
 
38
  <refsynopsisdiv>
 
39
    <para><command>hb_takeover</command> [<token>all</token>|<token>foreign</token>|<token>local</token>|<token>failback</token>]</para>
 
40
  </refsynopsisdiv>
 
41
  <refsection id="rs-hbtakeover-description">
 
42
    <title>Description</title>
 
43
    <warning>
 
44
      <para>This command is deprecated. It is only suitable for legacy
 
45
      Heartbeat clusters without Pacemaker enabled. In
 
46
      Pacemaker-enabled clusters, the
 
47
      <citerefentry><refentrytitle>crm</refentrytitle><manvolnum>8</manvolnum></citerefentry>
 
48
      shell supports switching individual nodes into standby mode, and
 
49
      replaces <command>hb_takeover</command>.</para>
 
50
    </warning>
 
51
    <para>
 
52
      <command>@HA_NOARCHDATAHBDIR@/hb_takeover</command> issues a
 
53
      request to the cluster to move resources to the node where it is
 
54
      invoked, from the other node. Issuing
 
55
      <command>hb_takeover</command> on the current node is equivalent
 
56
      to performing <command>hb_standby</command> on the other
 
57
      node.</para>
 
58
  </refsection>
 
59
  <refsection id="rs-hbtakeover-caveats">
 
60
    <title>Caveats</title>
 
61
    <para><command>hb_takeover</command> is only usable in R1-style
 
62
    configurations (i.e., those configured using the
 
63
    <filename>haresources</filename> file).</para>
 
64
  </refsection>
 
65
  <refsection id="rs-hbtakeover-seealso">
 
66
    <title>See also</title>
 
67
    <para>
 
68
      <citerefentry><refentrytitle>hb_standby</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
 
69
      <citerefentry><refentrytitle>heartbeat</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
 
70
      <citerefentry><refentrytitle>cl_status</refentrytitle><manvolnum>1</manvolnum></citerefentry>
 
71
    </para>
 
72
  </refsection>
 
73
</refentry>