Statistics
| Branch: | Tag: | Revision:

root / man / ganeti-noded.rst @ e715a6d6

History | View | Annotate | Download (2.3 kB)

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