Statistics
| Branch: | Tag: | Revision:

root / man / ganeti-master.sgml @ 48c4dfa8

History | View | Annotate | Download (3.7 kB)

1
<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
2

    
3
  <!-- Please adjust the date whenever revising the manpage. -->
4
  <!ENTITY dhdate      "<date>November 22, 2007</date>">
5
  <!-- SECTION should be 1-8, maybe w/ subsection other parameters are
6
       allowed: see man(7), man(1). -->
7
  <!ENTITY dhsection   "<manvolnum>8</manvolnum>">
8
  <!ENTITY dhucpackage "<refentrytitle>ganeti-master</refentrytitle>">
9
  <!ENTITY dhpackage   "ganeti-master">
10

    
11
  <!ENTITY debian      "<productname>Debian</productname>">
12
  <!ENTITY gnu         "<acronym>GNU</acronym>">
13
  <!ENTITY gpl         "&gnu; <acronym>GPL</acronym>">
14
  <!ENTITY footer SYSTEM "footer.sgml">
15
]>
16

    
17
<refentry>
18
  <refentryinfo>
19
    <copyright>
20
      <year>2006</year>
21
      <year>2007</year>
22
      <holder>Google Inc.</holder>
23
    </copyright>
24
    &dhdate;
25
  </refentryinfo>
26
  <refmeta>
27
    &dhucpackage;
28

    
29
    &dhsection;
30
    <refmiscinfo>ganeti 1.2</refmiscinfo>
31
  </refmeta>
32
  <refnamediv>
33
    <refname>&dhpackage;</refname>
34

    
35
    <refpurpose>ganeti master startup script</refpurpose>
36
  </refnamediv>
37
  <refsynopsisdiv>
38
    <cmdsynopsis>
39
      <command>&dhpackage; </command>
40
      <arg>-d</arg>
41
      <group choice="req">
42
        <arg>start</arg>
43
        <arg>stop</arg>
44
      </group>
45

    
46
    </cmdsynopsis>
47
  </refsynopsisdiv>
48
  <refsect1>
49
    <title>DESCRIPTION</title>
50

    
51
    <para>
52
      The <command>&dhpackage;</command> is the program that activates
53
      the cluster IP on the master node.
54
    </para>
55

    
56
    <para>
57
      The script will first check to see if the IP is not already
58
      alive on the cluster (on another node). If so, it wil abort the
59
      startup.
60
    </para>
61

    
62
    <para>
63
      If the master IP is unreachable, the script will add the IP to
64
      the <literal>master_netdev</literal> interface (as configured at
65
      cluster init time) with the label the name of the interface plus
66
      <quote>:0</quote>, so that the new IP shows up as a
67
      subinterface. After that, it will send three gratuitous ARP
68
      updates so that the switch updates its tables immediatly
69
      (instead of after expiry).
70
    </para>
71

    
72
  </refsect1>
73

    
74
  <refsect1>
75
    <title>Exit codes</title>
76
    <variablelist>
77
      <varlistentry>
78
        <term>0</term>
79
        <listitem>
80
          <simpara>successfull exit, IP activated</simpara>
81
        </listitem>
82
      </varlistentry>
83
      <varlistentry>
84
        <term>1</term>
85
        <listitem>
86
          <simpara>failed to add the IP to the interface</simpara>
87
        </listitem>
88
      </varlistentry>
89
      <varlistentry>
90
        <term>11</term>
91
        <listitem>
92
          <simpara>this node doesn't have the master role, no action
93
            taken</simpara>
94
        </listitem>
95
      </varlistentry>
96
      <varlistentry>
97
        <term>12</term>
98
        <listitem>
99
          <simpara>the configuration of the node is not complete; most
100
          probably, this node is not part of a cluster</simpara>
101
        </listitem>
102
      </varlistentry>
103
      <varlistentry>
104
        <term>13</term>
105
        <listitem>
106
          <simpara>the IP is reachable on the network, activation
107
            aborted</simpara>
108
        </listitem>
109
      </varlistentry>
110
      <varlistentry>
111
        <term>14</term>
112
        <listitem>
113
          <simpara>argument error - the script should be called with
114
          either the <option>start</option> or <option>stop</option>
115
          arguments</simpara>
116
        </listitem>
117
      </varlistentry>
118
    </variablelist>
119
  </refsect1>
120

    
121
  &footer;
122

    
123
</refentry>
124

    
125
<!-- Keep this comment at the end of the file
126
Local variables:
127
mode: sgml
128
sgml-omittag:t
129
sgml-shorttag:t
130
sgml-minimize-attributes:nil
131
sgml-always-quote-attributes:t
132
sgml-indent-step:2
133
sgml-indent-data:t
134
sgml-parent-document:nil
135
sgml-default-dtd-file:nil
136
sgml-exposed-tags:nil
137
sgml-local-catalogs:nil
138
sgml-local-ecat-files:nil
139
End:
140
-->