Synnefo » snf-ganeti

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

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

  <!ENTITY dhdate      "<date>June 08, 2010</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-noded</refentrytitle>">

  <!ENTITY dhpackage   "ganeti-noded">

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

      <year>2008</year>

      <year>2009</year>

      <year>2010</year>

      <holder>Google Inc.</holder>

    </copyright>

    &dhdate;

  </refentryinfo>

  <refmeta>

    &dhucpackage;

    &dhsection;

    <refmiscinfo>Ganeti 2.2</refmiscinfo>

  </refmeta>

  <refnamediv>

    <refname>&dhpackage;</refname>

    <refpurpose>Ganeti node daemon</refpurpose>

  </refnamediv>

  <refsynopsisdiv>

    <cmdsynopsis>

      <command>&dhpackage; </command>

      <arg>-f</arg>

      <arg>-d</arg>

    </cmdsynopsis>

  </refsynopsisdiv>

  <refsect1>

    <title>DESCRIPTION</title>

    <para>

      The <command>&dhpackage;</command> is the daemon which is

      responsible for the node functions in the Ganeti system.

    </para>

    <para>

      By default, in order to be able to support features such as node

      powercycling even on systems with a very damaged root disk,

      <command>ganeti-noded</command> locks itself in RAM using

      <citerefentry>

        <refentrytitle>mlockall</refentrytitle>

        <manvolnum>2</manvolnum>

      </citerefentry>. You can disable this feature by passing in the

      <option>--no-mlock</option> to the daemon.

    </para>

    <para>

      For testing purposes, you can give the <option>-f</option>

      option and the program won't detach from the running terminal.

    </para>

    <para>

      Debug-level message can be activated by giving the

      <option>-d</option> option.

    </para>

    <para>

      Logging to syslog, rather than its own log file, can be enabled by

      passing in the <option>--syslog</option> option.

    </para>

    <para>

      The <command>ganeti-noded</command> daemon listens to port 1811 TCP, on

      all interfaces, by default. This can be overridden by an entry the

      services database (<filename>/etc/services</filename>) or by passing the

      <option>-p</option> option. The <option>-b</option> option can be used to

      specify the address to bind to (defaults to 0.0.0.0).

    </para>

    <para>

      Ganeti noded communication is protected via SSL, with a key generated at

      cluster init time. This can be disabled with the

      <option>--no-ssl</option> option, or a different SSL key and certificate

      can be specified using the <option>-K</option> and <option>-C</option>

      options.

    </para>

    <refsect2>

      <title>ROLE</title>

      <para>

        The role of the node daemon is to do almost all the actions

        that change the state of the node. Things like creating disks

        for instances, activating disks, starting/stopping instance

        and so on are done via the node daemon.

      </para>

      <para>

        Also, in some cases the startup/shutdown of the master daemon

        are done via the node daemon, and the cluster IP address is

        also added/removed to the master node via it.

      </para>

      <para>

        If the node daemon is stopped, the instances are not affected,

        but the master won't be able to talk to that node.

      </para>

    </refsect2>

    <refsect2>

      <title>COMMUNICATION PROTOCOL</title>

      <para>

        Currently the master-node RPC is done using a simple RPC protocol built

        using JSON over HTTP(S).

      </para>

    </refsect2>

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

-->