root / man / ganeti-master.sgml @ c05bcecf
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 | --> |