Statistics
| Branch: | Tag: | Revision:

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

History | View | Annotate | Download (2.8 kB)

1 a8083063 Iustin Pop
<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
2 a8083063 Iustin Pop
3 a8083063 Iustin Pop
  <!-- Fill in your name for FIRSTNAME and SURNAME. -->
4 a8083063 Iustin Pop
  <!-- Please adjust the date whenever revising the manpage. -->
5 a8083063 Iustin Pop
  <!ENTITY dhdate      "<date>June 20, 2007</date>">
6 a8083063 Iustin Pop
  <!-- SECTION should be 1-8, maybe w/ subsection other parameters are
7 a8083063 Iustin Pop
       allowed: see man(7), man(1). -->
8 a8083063 Iustin Pop
  <!ENTITY dhsection   "<manvolnum>8</manvolnum>">
9 a8083063 Iustin Pop
  <!ENTITY dhucpackage "<refentrytitle>ganeti-watcher</refentrytitle>">
10 a8083063 Iustin Pop
  <!ENTITY dhpackage   "ganeti-watcher">
11 a8083063 Iustin Pop
12 a8083063 Iustin Pop
  <!ENTITY debian      "<productname>Debian</productname>">
13 a8083063 Iustin Pop
  <!ENTITY gnu         "<acronym>GNU</acronym>">
14 a8083063 Iustin Pop
  <!ENTITY gpl         "&gnu; <acronym>GPL</acronym>">
15 a8083063 Iustin Pop
  <!ENTITY footer SYSTEM "footer.sgml">
16 a8083063 Iustin Pop
]>
17 a8083063 Iustin Pop
18 a8083063 Iustin Pop
<refentry>
19 a8083063 Iustin Pop
  <refentryinfo>
20 a8083063 Iustin Pop
    <copyright>
21 a8083063 Iustin Pop
      <year>2007</year>
22 a8083063 Iustin Pop
      <holder>Google Inc.</holder>
23 a8083063 Iustin Pop
    </copyright>
24 a8083063 Iustin Pop
    &dhdate;
25 a8083063 Iustin Pop
  </refentryinfo>
26 a8083063 Iustin Pop
  <refmeta>
27 a8083063 Iustin Pop
    &dhucpackage;
28 a8083063 Iustin Pop
29 a8083063 Iustin Pop
    &dhsection;
30 a8083063 Iustin Pop
    <refmiscinfo>ganeti 1.2</refmiscinfo>
31 a8083063 Iustin Pop
  </refmeta>
32 a8083063 Iustin Pop
  <refnamediv>
33 a8083063 Iustin Pop
    <refname>&dhpackage;</refname>
34 a8083063 Iustin Pop
35 a8083063 Iustin Pop
    <refpurpose>ganeti cluster watcher</refpurpose>
36 a8083063 Iustin Pop
  </refnamediv>
37 a8083063 Iustin Pop
  <refsynopsisdiv>
38 a8083063 Iustin Pop
    <cmdsynopsis>
39 a8083063 Iustin Pop
      <command>&dhpackage; </command>
40 a8083063 Iustin Pop
41 a8083063 Iustin Pop
    </cmdsynopsis>
42 a8083063 Iustin Pop
  </refsynopsisdiv>
43 a8083063 Iustin Pop
  <refsect1>
44 a8083063 Iustin Pop
    <title>DESCRIPTION</title>
45 a8083063 Iustin Pop
46 a8083063 Iustin Pop
    <para>
47 a8083063 Iustin Pop
      The <command>&dhpackage;</command> is a periodically run script
48 a8083063 Iustin Pop
      which is responsible for keeping the instances in the correct
49 a8083063 Iustin Pop
      status.
50 a8083063 Iustin Pop
    </para>
51 a8083063 Iustin Pop
52 a8083063 Iustin Pop
    <para>
53 f69dab6d Iustin Pop
      Its primary function is to try to keep running all instances
54 f69dab6d Iustin Pop
      which are marked as <emphasis>up</emphasis> in the configuration
55 f69dab6d Iustin Pop
      file, by trying to start them a limited number of times.
56 f69dab6d Iustin Pop
    </para>
57 f69dab6d Iustin Pop
58 f69dab6d Iustin Pop
    <para>
59 f69dab6d Iustin Pop
      Its other function is to <quote>repair</quote> DRBD links by
60 f69dab6d Iustin Pop
      reactivating the block devices of instances which have
61 f69dab6d Iustin Pop
      secondaries on nodes that have been rebooted.
62 a8083063 Iustin Pop
    </para>
63 a8083063 Iustin Pop
64 a8083063 Iustin Pop
    <para>In order to prevent piling up commands, all the
65 a8083063 Iustin Pop
    <emphasis>gnt-*</emphasis> commands executed by ganeti-watcher are
66 a8083063 Iustin Pop
    run with a timeout of 15 seconds.
67 a8083063 Iustin Pop
    </para>
68 a8083063 Iustin Pop
69 a8083063 Iustin Pop
    <para>
70 a8083063 Iustin Pop
      The command has a state file located at
71 26c7e094 Michael Hanselmann
      <filename>@LOCALSTATEDIR@/lib/ganeti/restart_state</filename> and a log
72 a8083063 Iustin Pop
      file at
73 26c7e094 Michael Hanselmann
      <filename>@LOCALSTATEDIR@/log/ganeti/watcher.log</filename>. Removal of
74 a8083063 Iustin Pop
      either file will not affect correct operation; the removal of
75 a8083063 Iustin Pop
      the state file will just cause the restart counters for the
76 a8083063 Iustin Pop
      instances to reset to zero.
77 a8083063 Iustin Pop
    </para>
78 a8083063 Iustin Pop
79 a8083063 Iustin Pop
  </refsect1>
80 a8083063 Iustin Pop
81 a8083063 Iustin Pop
  &footer;
82 a8083063 Iustin Pop
83 a8083063 Iustin Pop
</refentry>
84 a8083063 Iustin Pop
85 a8083063 Iustin Pop
<!-- Keep this comment at the end of the file
86 a8083063 Iustin Pop
Local variables:
87 a8083063 Iustin Pop
mode: sgml
88 a8083063 Iustin Pop
sgml-omittag:t
89 a8083063 Iustin Pop
sgml-shorttag:t
90 a8083063 Iustin Pop
sgml-minimize-attributes:nil
91 a8083063 Iustin Pop
sgml-always-quote-attributes:t
92 a8083063 Iustin Pop
sgml-indent-step:2
93 a8083063 Iustin Pop
sgml-indent-data:t
94 a8083063 Iustin Pop
sgml-parent-document:nil
95 a8083063 Iustin Pop
sgml-default-dtd-file:nil
96 a8083063 Iustin Pop
sgml-exposed-tags:nil
97 a8083063 Iustin Pop
sgml-local-catalogs:nil
98 a8083063 Iustin Pop
sgml-local-ecat-files:nil
99 a8083063 Iustin Pop
End:
100 a8083063 Iustin Pop
-->