Synnefo » snf-ganeti » ganeti-local

<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [

  <!-- Fill in your name for FIRSTNAME and SURNAME. -->

  <!-- Please adjust the date whenever revising the manpage. -->

  <!ENTITY dhdate      "<date>February 11, 2009</date>">

  <!-- SECTION should be 1-8, maybe w/ subsection other parameters are

       allowed: see man(7), man(1). -->

  <!ENTITY dhsection   "<manvolnum>8</manvolnum>">

  <!ENTITY dhucpackage "<refentrytitle>ganeti-watcher</refentrytitle>">

  <!ENTITY dhpackage   "ganeti-watcher">

  <!ENTITY debian      "<productname>Debian</productname>">

  <!ENTITY gnu         "<acronym>GNU</acronym>">

  <!ENTITY gpl         "&gnu; <acronym>GPL</acronym>">

  <!ENTITY footer SYSTEM "footer.sgml">

]>

<refentry>

  <refentryinfo>

    <copyright>

      <year>2007</year>

      <year>2008</year>

      <year>2009</year>

      <holder>Google Inc.</holder>

    </copyright>

    &dhdate;

  </refentryinfo>

  <refmeta>

    &dhucpackage;

    &dhsection;

    <refmiscinfo>ganeti 2.0</refmiscinfo>

  </refmeta>

  <refnamediv>

    <refname>&dhpackage;</refname>

    <refpurpose>ganeti cluster watcher</refpurpose>

  </refnamediv>

  <refsynopsisdiv>

    <cmdsynopsis>

      <command>&dhpackage; </command>

    </cmdsynopsis>

  </refsynopsisdiv>

  <refsect1>

    <title>DESCRIPTION</title>

    <para>

      The <command>&dhpackage;</command> is a periodically run script

      which is responsible for keeping the instances in the correct

      status.

    </para>

    <para>

      Its primary function is to try to keep running all instances

      which are marked as <emphasis>up</emphasis> in the configuration

      file, by trying to start them a limited number of times.

    </para>

    <para>

      Its other function is to <quote>repair</quote> DRBD links by

      reactivating the block devices of instances which have

      secondaries on nodes that have been rebooted.

    </para>

    <para>

      The watcher does synchronous queries but will submit jobs for

      executing the changes. Due to locking, it could be that the jobs

      execute much later than the watcher executes them.

    </para>

    <para>

      The command has a state file located at

      <filename>@LOCALSTATEDIR@/lib/ganeti/watcher.data</filename> and a log

      file at

      <filename>@LOCALSTATEDIR@/log/ganeti/watcher.log</filename>. Removal of

      either file will not affect correct operation; the removal of

      the state file will just cause the restart counters for the

      instances to reset to zero.

    </para>

  </refsect1>

  &footer;

</refentry>

<!-- Keep this comment at the end of the file

Local variables:

mode: sgml

sgml-omittag:t

sgml-shorttag:t

sgml-minimize-attributes:nil

sgml-always-quote-attributes:t

sgml-indent-step:2

sgml-indent-data:t

sgml-parent-document:nil

sgml-default-dtd-file:nil

sgml-exposed-tags:nil

sgml-local-catalogs:nil

sgml-local-ecat-files:nil

End:

-->