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. It has two separate functions, one for the master node

      and another one that runs on every node.

    </para>

    <refsect2>

      <title>Master operations</title>

      <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>

    </refsect2>

    <refsect2>

      <title>Node operations</title>

      <para>

        The watcher will restart any down daemons that are appropriate

        for the current node.

      </para>

      <para>

        In addition, it will execute any scripts which exist under the

        <quote>watcher</quote> directory in the ganeti hooks directory

        (@SYSCONFDIR@/ganeti/hooks). This should be used for

        lightweight actions, like starting any extra daemons.

      </para>

      <para>

        If the cluster

        parameter <literal>maintain_node_health</literal> is enabled,

        then the watcher will also shutdown instances and DRBD devices

        if the node is declared as offline by known master candidates.

      </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>

    </refsect2>

  </refsect1>

  <refsect1>

    <title>FILES</title>

    <para>

      The command has a state file located at

      <filename>@LOCALSTATEDIR@/lib/ganeti/watcher.data</filename>

      (only used on the master) 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:

-->