root / man / ganeti-watcher.sgml @ 24a40d57
History | View | Annotate | Download (3 kB)
1 |
<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [ |
---|---|
2 |
|
3 |
<!-- Fill in your name for FIRSTNAME and SURNAME. --> |
4 |
<!-- Please adjust the date whenever revising the manpage. --> |
5 |
<!ENTITY dhdate "<date>June 20, 2007</date>"> |
6 |
<!-- SECTION should be 1-8, maybe w/ subsection other parameters are |
7 |
allowed: see man(7), man(1). --> |
8 |
<!ENTITY dhsection "<manvolnum>8</manvolnum>"> |
9 |
<!ENTITY dhucpackage "<refentrytitle>ganeti-watcher</refentrytitle>"> |
10 |
<!ENTITY dhpackage "ganeti-watcher"> |
11 |
|
12 |
<!ENTITY debian "<productname>Debian</productname>"> |
13 |
<!ENTITY gnu "<acronym>GNU</acronym>"> |
14 |
<!ENTITY gpl "&gnu; <acronym>GPL</acronym>"> |
15 |
<!ENTITY footer SYSTEM "footer.sgml"> |
16 |
]> |
17 |
|
18 |
<refentry> |
19 |
<refentryinfo> |
20 |
<copyright> |
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 cluster watcher</refpurpose> |
36 |
</refnamediv> |
37 |
<refsynopsisdiv> |
38 |
<cmdsynopsis> |
39 |
<command>&dhpackage; </command> |
40 |
|
41 |
</cmdsynopsis> |
42 |
</refsynopsisdiv> |
43 |
<refsect1> |
44 |
<title>DESCRIPTION</title> |
45 |
|
46 |
<para> |
47 |
The <command>&dhpackage;</command> is a periodically run script |
48 |
which is responsible for keeping the instances in the correct |
49 |
status. |
50 |
</para> |
51 |
|
52 |
<para> |
53 |
Its function is to try to keep running all instances which are |
54 |
marked as <emphasis>up</emphasis> in the configuration file, by |
55 |
trying to start them a limited number of times. |
56 |
</para> |
57 |
|
58 |
<para>In order to prevent piling up commands, all the |
59 |
<emphasis>gnt-*</emphasis> commands executed by ganeti-watcher are |
60 |
run with a timeout of 15 seconds. |
61 |
</para> |
62 |
|
63 |
<para> |
64 |
The command has a state file located at |
65 |
<filename>@LOCALSTATEDIR@/lib/ganeti/restart_state</filename> and a log |
66 |
file at |
67 |
<filename>@LOCALSTATEDIR@/log/ganeti/watcher.log</filename>. Removal of |
68 |
either file will not affect correct operation; the removal of |
69 |
the state file will just cause the restart counters for the |
70 |
instances to reset to zero. |
71 |
</para> |
72 |
|
73 |
</refsect1> |
74 |
|
75 |
<refsect1> |
76 |
<title>KNOWN BUGS</title> |
77 |
|
78 |
<para> |
79 |
Due to the way we initialize DRBD peers, restarting a secondary |
80 |
node for an instance will cause the DRBD endpoints on that node |
81 |
to disappear, thus all instances which have that node as a |
82 |
secondary will lose redundancy. The watcher does not detect this |
83 |
situation. The workaround is to manually run |
84 |
<command>gnt-instance activate-disks</command> for all the |
85 |
affected instances. |
86 |
</para> |
87 |
</refsect1> |
88 |
|
89 |
&footer; |
90 |
|
91 |
</refentry> |
92 |
|
93 |
<!-- Keep this comment at the end of the file |
94 |
Local variables: |
95 |
mode: sgml |
96 |
sgml-omittag:t |
97 |
sgml-shorttag:t |
98 |
sgml-minimize-attributes:nil |
99 |
sgml-always-quote-attributes:t |
100 |
sgml-indent-step:2 |
101 |
sgml-indent-data:t |
102 |
sgml-parent-document:nil |
103 |
sgml-default-dtd-file:nil |
104 |
sgml-exposed-tags:nil |
105 |
sgml-local-catalogs:nil |
106 |
sgml-local-ecat-files:nil |
107 |
End: |
108 |
--> |