Synnefo » snf-ganeti

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

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

  <!ENTITY dhdate      "<date>November 22, 2007</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-master</refentrytitle>">

  <!ENTITY dhpackage   "ganeti-master">

  <!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>2006</year>

      <year>2007</year>

      <holder>Google Inc.</holder>

    </copyright>

    &dhdate;

  </refentryinfo>

  <refmeta>

    &dhucpackage;

    &dhsection;

    <refmiscinfo>ganeti 1.2</refmiscinfo>

  </refmeta>

  <refnamediv>

    <refname>&dhpackage;</refname>

    <refpurpose>ganeti master startup script</refpurpose>

  </refnamediv>

  <refsynopsisdiv>

    <cmdsynopsis>

      <command>&dhpackage; </command>

      <arg>-d</arg>

      <group choice="req">

        <arg>start</arg>

        <arg>stop</arg>

      </group>

    </cmdsynopsis>

  </refsynopsisdiv>

  <refsect1>

    <title>DESCRIPTION</title>

    <para>

      The <command>&dhpackage;</command> is the program that activates

      the cluster IP on the master node.

    </para>

    <para>

      The script will first check to see if the IP is not already

      alive on the cluster (on another node). If so, it wil abort the

      startup.

    </para>

    <para>

      If the master IP is unreachable, the script will add the IP to

      the <literal>master_netdev</literal> interface (as configured at

      cluster init time) with the label the name of the interface plus

      <quote>:0</quote>, so that the new IP shows up as a

      subinterface. After that, it will send three gratuitous ARP

      updates so that the switch updates its tables immediatly

      (instead of after expiry).

    </para>

  </refsect1>

  <refsect1>

    <title>Exit codes</title>

    <variablelist>

      <varlistentry>

        <term>0</term>

        <listitem>

          <simpara>successfull exit, IP activated</simpara>

        </listitem>

      </varlistentry>

      <varlistentry>

        <term>1</term>

        <listitem>

          <simpara>failed to add the IP to the interface</simpara>

        </listitem>

      </varlistentry>

      <varlistentry>

        <term>11</term>

        <listitem>

          <simpara>this node doesn't have the master role, no action

            taken</simpara>

        </listitem>

      </varlistentry>

      <varlistentry>

        <term>12</term>

        <listitem>

          <simpara>the configuration of the node is not complete; most

          probably, this node is not part of a cluster</simpara>

        </listitem>

      </varlistentry>

      <varlistentry>

        <term>13</term>

        <listitem>

          <simpara>the IP is reachable on the network, activation

            aborted</simpara>

        </listitem>

      </varlistentry>

      <varlistentry>

        <term>14</term>

        <listitem>

          <simpara>argument error - the script should be called with

          either the <option>start</option> or <option>stop</option>

          arguments</simpara>

        </listitem>

      </varlistentry>

    </variablelist>

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

-->