Statistics
| Branch: | Tag: | Revision:

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

History | View | Annotate | Download (3.7 kB)

1 4de0fa98 Iustin Pop
<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
2 4de0fa98 Iustin Pop
3 4de0fa98 Iustin Pop
  <!-- Please adjust the date whenever revising the manpage. -->
4 4de0fa98 Iustin Pop
  <!ENTITY dhdate      "<date>November 22, 2007</date>">
5 4de0fa98 Iustin Pop
  <!-- SECTION should be 1-8, maybe w/ subsection other parameters are
6 4de0fa98 Iustin Pop
       allowed: see man(7), man(1). -->
7 4de0fa98 Iustin Pop
  <!ENTITY dhsection   "<manvolnum>8</manvolnum>">
8 4de0fa98 Iustin Pop
  <!ENTITY dhucpackage "<refentrytitle>ganeti-master</refentrytitle>">
9 4de0fa98 Iustin Pop
  <!ENTITY dhpackage   "ganeti-master">
10 4de0fa98 Iustin Pop
11 4de0fa98 Iustin Pop
  <!ENTITY debian      "<productname>Debian</productname>">
12 4de0fa98 Iustin Pop
  <!ENTITY gnu         "<acronym>GNU</acronym>">
13 4de0fa98 Iustin Pop
  <!ENTITY gpl         "&gnu; <acronym>GPL</acronym>">
14 4de0fa98 Iustin Pop
  <!ENTITY footer SYSTEM "footer.sgml">
15 4de0fa98 Iustin Pop
]>
16 4de0fa98 Iustin Pop
17 4de0fa98 Iustin Pop
<refentry>
18 4de0fa98 Iustin Pop
  <refentryinfo>
19 4de0fa98 Iustin Pop
    <copyright>
20 4de0fa98 Iustin Pop
      <year>2006</year>
21 4de0fa98 Iustin Pop
      <year>2007</year>
22 4de0fa98 Iustin Pop
      <holder>Google Inc.</holder>
23 4de0fa98 Iustin Pop
    </copyright>
24 4de0fa98 Iustin Pop
    &dhdate;
25 4de0fa98 Iustin Pop
  </refentryinfo>
26 4de0fa98 Iustin Pop
  <refmeta>
27 4de0fa98 Iustin Pop
    &dhucpackage;
28 4de0fa98 Iustin Pop
29 4de0fa98 Iustin Pop
    &dhsection;
30 4de0fa98 Iustin Pop
    <refmiscinfo>ganeti 1.2</refmiscinfo>
31 4de0fa98 Iustin Pop
  </refmeta>
32 4de0fa98 Iustin Pop
  <refnamediv>
33 4de0fa98 Iustin Pop
    <refname>&dhpackage;</refname>
34 4de0fa98 Iustin Pop
35 4de0fa98 Iustin Pop
    <refpurpose>ganeti master startup script</refpurpose>
36 4de0fa98 Iustin Pop
  </refnamediv>
37 4de0fa98 Iustin Pop
  <refsynopsisdiv>
38 4de0fa98 Iustin Pop
    <cmdsynopsis>
39 4de0fa98 Iustin Pop
      <command>&dhpackage; </command>
40 4de0fa98 Iustin Pop
      <arg>-d</arg>
41 4de0fa98 Iustin Pop
      <group choice="req">
42 4de0fa98 Iustin Pop
        <arg>start</arg>
43 4de0fa98 Iustin Pop
        <arg>stop</arg>
44 4de0fa98 Iustin Pop
      </group>
45 4de0fa98 Iustin Pop
46 4de0fa98 Iustin Pop
    </cmdsynopsis>
47 4de0fa98 Iustin Pop
  </refsynopsisdiv>
48 4de0fa98 Iustin Pop
  <refsect1>
49 4de0fa98 Iustin Pop
    <title>DESCRIPTION</title>
50 4de0fa98 Iustin Pop
51 4de0fa98 Iustin Pop
    <para>
52 4de0fa98 Iustin Pop
      The <command>&dhpackage;</command> is the program that activates
53 4de0fa98 Iustin Pop
      the cluster IP on the master node.
54 4de0fa98 Iustin Pop
    </para>
55 4de0fa98 Iustin Pop
56 4de0fa98 Iustin Pop
    <para>
57 4de0fa98 Iustin Pop
      The script will first check to see if the IP is not already
58 4de0fa98 Iustin Pop
      alive on the cluster (on another node). If so, it wil abort the
59 4de0fa98 Iustin Pop
      startup.
60 4de0fa98 Iustin Pop
    </para>
61 4de0fa98 Iustin Pop
62 4de0fa98 Iustin Pop
    <para>
63 4de0fa98 Iustin Pop
      If the master IP is unreachable, the script will add the IP to
64 4de0fa98 Iustin Pop
      the <literal>master_netdev</literal> interface (as configured at
65 4de0fa98 Iustin Pop
      cluster init time) with the label the name of the interface plus
66 4de0fa98 Iustin Pop
      <quote>:0</quote>, so that the new IP shows up as a
67 4de0fa98 Iustin Pop
      subinterface. After that, it will send three gratuitous ARP
68 4de0fa98 Iustin Pop
      updates so that the switch updates its tables immediatly
69 4de0fa98 Iustin Pop
      (instead of after expiry).
70 4de0fa98 Iustin Pop
    </para>
71 4de0fa98 Iustin Pop
72 4de0fa98 Iustin Pop
  </refsect1>
73 4de0fa98 Iustin Pop
74 4de0fa98 Iustin Pop
  <refsect1>
75 4de0fa98 Iustin Pop
    <title>Exit codes</title>
76 4de0fa98 Iustin Pop
    <variablelist>
77 4de0fa98 Iustin Pop
      <varlistentry>
78 4de0fa98 Iustin Pop
        <term>0</term>
79 4de0fa98 Iustin Pop
        <listitem>
80 4de0fa98 Iustin Pop
          <simpara>successfull exit, IP activated</simpara>
81 4de0fa98 Iustin Pop
        </listitem>
82 4de0fa98 Iustin Pop
      </varlistentry>
83 4de0fa98 Iustin Pop
      <varlistentry>
84 4de0fa98 Iustin Pop
        <term>1</term>
85 4de0fa98 Iustin Pop
        <listitem>
86 4de0fa98 Iustin Pop
          <simpara>failed to add the IP to the interface</simpara>
87 4de0fa98 Iustin Pop
        </listitem>
88 4de0fa98 Iustin Pop
      </varlistentry>
89 4de0fa98 Iustin Pop
      <varlistentry>
90 4de0fa98 Iustin Pop
        <term>11</term>
91 4de0fa98 Iustin Pop
        <listitem>
92 4de0fa98 Iustin Pop
          <simpara>this node doesn't have the master role, no action
93 4de0fa98 Iustin Pop
            taken</simpara>
94 4de0fa98 Iustin Pop
        </listitem>
95 4de0fa98 Iustin Pop
      </varlistentry>
96 4de0fa98 Iustin Pop
      <varlistentry>
97 4de0fa98 Iustin Pop
        <term>12</term>
98 4de0fa98 Iustin Pop
        <listitem>
99 4de0fa98 Iustin Pop
          <simpara>the configuration of the node is not complete; most
100 4de0fa98 Iustin Pop
          probably, this node is not part of a cluster</simpara>
101 4de0fa98 Iustin Pop
        </listitem>
102 4de0fa98 Iustin Pop
      </varlistentry>
103 4de0fa98 Iustin Pop
      <varlistentry>
104 4de0fa98 Iustin Pop
        <term>13</term>
105 4de0fa98 Iustin Pop
        <listitem>
106 4de0fa98 Iustin Pop
          <simpara>the IP is reachable on the network, activation
107 4de0fa98 Iustin Pop
            aborted</simpara>
108 4de0fa98 Iustin Pop
        </listitem>
109 4de0fa98 Iustin Pop
      </varlistentry>
110 4de0fa98 Iustin Pop
      <varlistentry>
111 4de0fa98 Iustin Pop
        <term>14</term>
112 4de0fa98 Iustin Pop
        <listitem>
113 4de0fa98 Iustin Pop
          <simpara>argument error - the script should be called with
114 4de0fa98 Iustin Pop
          either the <option>start</option> or <option>stop</option>
115 4de0fa98 Iustin Pop
          arguments</simpara>
116 4de0fa98 Iustin Pop
        </listitem>
117 4de0fa98 Iustin Pop
      </varlistentry>
118 4de0fa98 Iustin Pop
    </variablelist>
119 4de0fa98 Iustin Pop
  </refsect1>
120 4de0fa98 Iustin Pop
121 4de0fa98 Iustin Pop
  &footer;
122 4de0fa98 Iustin Pop
123 4de0fa98 Iustin Pop
</refentry>
124 4de0fa98 Iustin Pop
125 4de0fa98 Iustin Pop
<!-- Keep this comment at the end of the file
126 4de0fa98 Iustin Pop
Local variables:
127 4de0fa98 Iustin Pop
mode: sgml
128 4de0fa98 Iustin Pop
sgml-omittag:t
129 4de0fa98 Iustin Pop
sgml-shorttag:t
130 4de0fa98 Iustin Pop
sgml-minimize-attributes:nil
131 4de0fa98 Iustin Pop
sgml-always-quote-attributes:t
132 4de0fa98 Iustin Pop
sgml-indent-step:2
133 4de0fa98 Iustin Pop
sgml-indent-data:t
134 4de0fa98 Iustin Pop
sgml-parent-document:nil
135 4de0fa98 Iustin Pop
sgml-default-dtd-file:nil
136 4de0fa98 Iustin Pop
sgml-exposed-tags:nil
137 4de0fa98 Iustin Pop
sgml-local-catalogs:nil
138 4de0fa98 Iustin Pop
sgml-local-ecat-files:nil
139 4de0fa98 Iustin Pop
End:
140 4de0fa98 Iustin Pop
-->