code.grnet.gr Git - ganeti-local/blob - man/ganeti-watcher.sgml

   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>February 11, 2009</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       <year>2008</year>
  23       <year>2009</year>
  24       <holder>Google Inc.</holder>
  25     </copyright>
  26     &dhdate;
  27   </refentryinfo>
  28   <refmeta>
  29     &dhucpackage;
  30
  31     &dhsection;
  32     <refmiscinfo>ganeti 2.0</refmiscinfo>
  33   </refmeta>
  34   <refnamediv>
  35     <refname>&dhpackage;</refname>
  36
  37     <refpurpose>ganeti cluster watcher</refpurpose>
  38   </refnamediv>
  39   <refsynopsisdiv>
  40     <cmdsynopsis>
  41       <command>&dhpackage; </command>
  42
  43     </cmdsynopsis>
  44   </refsynopsisdiv>
  45   <refsect1>
  46     <title>DESCRIPTION</title>
  47
  48     <para>
  49       The <command>&dhpackage;</command> is a periodically run script
  50       which is responsible for keeping the instances in the correct
  51       status.
  52     </para>
  53
  54     <para>
  55       Its primary function is to try to keep running all instances
  56       which are marked as <emphasis>up</emphasis> in the configuration
  57       file, by trying to start them a limited number of times.
  58     </para>
  59
  60     <para>
  61       Its other function is to <quote>repair</quote> DRBD links by
  62       reactivating the block devices of instances which have
  63       secondaries on nodes that have been rebooted.
  64     </para>
  65
  66     <para>
  67       The watcher does synchronous queries but will submit jobs for
  68       executing the changes. Due to locking, it could be that the jobs
  69       execute much later than the watcher executes them.
  70     </para>
  71
  72     <para>
  73       The command has a state file located at
  74       <filename>@LOCALSTATEDIR@/lib/ganeti/watcher.data</filename> and a log
  75       file at
  76       <filename>@LOCALSTATEDIR@/log/ganeti/watcher.log</filename>. Removal of
  77       either file will not affect correct operation; the removal of
  78       the state file will just cause the restart counters for the
  79       instances to reset to zero.
  80     </para>
  81
  82   </refsect1>
  83
  84   &footer;
  85
  86 </refentry>
  87
  88 <!-- Keep this comment at the end of the file
  89 Local variables:
  90 mode: sgml
  91 sgml-omittag:t
  92 sgml-shorttag:t
  93 sgml-minimize-attributes:nil
  94 sgml-always-quote-attributes:t
  95 sgml-indent-step:2
  96 sgml-indent-data:t
  97 sgml-parent-document:nil
  98 sgml-default-dtd-file:nil
  99 sgml-exposed-tags:nil
 100 sgml-local-catalogs:nil
 101 sgml-local-ecat-files:nil
 102 End:
 103 -->