code.grnet.gr Git - ganeti-local/blob - man/ganeti-noded.rst

   1 ganeti-noded(8) Ganeti | Version @GANETI_VERSION@
   2 =================================================
   3
   4 Name
   5 ----
   6
   7 ganeti-noded - Ganeti node daemon
   8
   9 Synopsis
  10 --------
  11
  12 **ganeti-noded** [-f] [-d] [-p *PORT*] [-b *ADDRESS*] [-i *INTERFACE*]
  13 [--no-mlock] [--syslog] [--no-ssl] [-K *SSL_KEY_FILE*] [-C *SSL_CERT_FILE*]
  14
  15 DESCRIPTION
  16 -----------
  17
  18 The **ganeti-noded** is the daemon which is responsible for the
  19 node functions in the Ganeti system.
  20
  21 By default, in order to be able to support features such as node
  22 powercycling even on systems with a very damaged root disk,
  23 **ganeti-noded** locks itself in RAM using **mlockall**\(2). You can
  24 disable this feature by passing in the ``--no-mlock`` to the daemon.
  25
  26 For testing purposes, you can give the ``-f`` option and the
  27 program won't detach from the running terminal.
  28
  29 Debug-level message can be activated by giving the ``-d`` option.
  30
  31 Logging to syslog, rather than its own log file, can be enabled by
  32 passing in the ``--syslog`` option.
  33
  34 The **ganeti-noded** daemon listens to port 1811 TCP, on all
  35 interfaces, by default. The port can be overridden by an entry in the
  36 services database (usually ``/etc/services``) or by passing the ``-p``
  37 option.  The ``-b`` option can be used to specify the address to bind
  38 to (defaults to ``0.0.0.0``); alternatively, the ``-i`` option can be
  39 used to specify the interface to bind do.
  40
  41 Ganeti noded communication is protected via SSL, with a key
  42 generated at cluster init time. This can be disabled with the
  43 ``--no-ssl`` option, or a different SSL key and certificate can be
  44 specified using the ``-K`` and ``-C`` options.
  45
  46 ROLE
  47 ~~~~
  48
  49 The role of the node daemon is to do almost all the actions that
  50 change the state of the node. Things like creating disks for
  51 instances, activating disks, starting/stopping instance and so on
  52 are done via the node daemon.
  53
  54 Also, in some cases the startup/shutdown of the master daemon are
  55 done via the node daemon, and the cluster IP address is also
  56 added/removed to the master node via it.
  57
  58 If the node daemon is stopped, the instances are not affected, but
  59 the master won't be able to talk to that node.
  60
  61 COMMUNICATION PROTOCOL
  62 ~~~~~~~~~~~~~~~~~~~~~~
  63
  64 Currently the master-node RPC is done using a simple RPC protocol
  65 built using JSON over HTTP(S).
  66
  67 .. vim: set textwidth=72 :
  68 .. Local Variables:
  69 .. mode: rst
  70 .. fill-column: 72
  71 .. End: