root / man / ganeti-confd.rst @ 4fe04580
History | View | Annotate | Download (2.3 kB)
1 | a6243496 | Iustin Pop | ganeti-confd(8) Ganeti | Version @GANETI_VERSION@ |
---|---|---|---|
2 | a6243496 | Iustin Pop | ================================================= |
3 | a6243496 | Iustin Pop | |
4 | a6243496 | Iustin Pop | Name |
5 | a6243496 | Iustin Pop | ---- |
6 | a6243496 | Iustin Pop | |
7 | a6243496 | Iustin Pop | ganeti-confd - Ganeti conf daemon |
8 | a6243496 | Iustin Pop | |
9 | a6243496 | Iustin Pop | Synopsis |
10 | a6243496 | Iustin Pop | -------- |
11 | a6243496 | Iustin Pop | |
12 | a6243496 | Iustin Pop | **ganeti-confd** [-f] [-d] |
13 | a6243496 | Iustin Pop | |
14 | a6243496 | Iustin Pop | DESCRIPTION |
15 | a6243496 | Iustin Pop | ----------- |
16 | a6243496 | Iustin Pop | |
17 | a6243496 | Iustin Pop | **ganeti-confd** is a daemon used to answer queries related to the |
18 | a6243496 | Iustin Pop | configuration of a Ganeti cluster. |
19 | a6243496 | Iustin Pop | |
20 | a6243496 | Iustin Pop | For testing purposes, you can give the ``-f`` option and the |
21 | a6243496 | Iustin Pop | program won't detach from the running terminal. |
22 | a6243496 | Iustin Pop | |
23 | a6243496 | Iustin Pop | Debug-level message can be activated by giving the ``-d`` option. |
24 | a6243496 | Iustin Pop | |
25 | 416eba57 | Iustin Pop | Logging to syslog, rather than its own log file, can be enabled by |
26 | 416eba57 | Iustin Pop | passing in the ``--syslog`` option. |
27 | 416eba57 | Iustin Pop | |
28 | 416eba57 | Iustin Pop | The **ganeti-confd** daemon listens to port 1814 UDP, on all interfaces, |
29 | 416eba57 | Iustin Pop | by default. The port can be overridden by an entry the services database |
30 | 416eba57 | Iustin Pop | (usually ``/etc/services``) or by passing the ``-p`` option. The ``-b`` |
31 | 416eba57 | Iustin Pop | option can be used to specify the address to bind to (defaults to |
32 | 416eba57 | Iustin Pop | ``0.0.0.0``). The daemon also listens on a Unix socket |
33 | 416eba57 | Iustin Pop | (``@LOCALSTATEDIR@/run/ganeti/socket/ganeti-query``) on which it exports |
34 | 416eba57 | Iustin Pop | a ``Luxi`` endpoint, serving query operations only. Commands and tools |
35 | 416eba57 | Iustin Pop | use this socket if the build-time option for split queries has been |
36 | 416eba57 | Iustin Pop | enabled. |
37 | 416eba57 | Iustin Pop | |
38 | 416eba57 | Iustin Pop | The daemon will refuse to start if the user and group do not match the |
39 | 416eba57 | Iustin Pop | one defined at build time; this behaviour can be overridden by the |
40 | 416eba57 | Iustin Pop | ``--no-user-checks`` option. |
41 | 416eba57 | Iustin Pop | |
42 | a6243496 | Iustin Pop | ROLE |
43 | a6243496 | Iustin Pop | ~~~~ |
44 | a6243496 | Iustin Pop | |
45 | a6243496 | Iustin Pop | The role of the conf daemon is to make sure we have a highly available |
46 | a6243496 | Iustin Pop | and very fast way to query cluster configuration values. This daemon |
47 | a6243496 | Iustin Pop | is automatically active on all master candidates, and so has no single |
48 | a6243496 | Iustin Pop | point of failure. It communicates via UDP so each query can easily be |
49 | a6243496 | Iustin Pop | sent to multiple servers, and it answers queries from a cached copy of |
50 | a6243496 | Iustin Pop | the config it keeps in memory, so no disk access is required to get an |
51 | a6243496 | Iustin Pop | answer. |
52 | a6243496 | Iustin Pop | |
53 | a6243496 | Iustin Pop | The config is reloaded from disk automatically when it changes, with a |
54 | a6243496 | Iustin Pop | rate limit of once per second. |
55 | a6243496 | Iustin Pop | |
56 | a6243496 | Iustin Pop | If the conf daemon is stopped on all nodes, its clients won't be able |
57 | a6243496 | Iustin Pop | to get query answers. |
58 | a6243496 | Iustin Pop | |
59 | a6243496 | Iustin Pop | COMMUNICATION PROTOCOL |
60 | a6243496 | Iustin Pop | ~~~~~~~~~~~~~~~~~~~~~~ |
61 | a6243496 | Iustin Pop | |
62 | a6243496 | Iustin Pop | The confd protocol is an HMAC authenticated json-encoded custom |
63 | a6243496 | Iustin Pop | format, over UDP. A client library is provided to make it easy to |
64 | a6243496 | Iustin Pop | write software to query confd. More information can be found in the |
65 | a6243496 | Iustin Pop | Ganeti 2.1 design doc, and an example usage can be seen in the |
66 | a6243496 | Iustin Pop | (external) NBMA daemon for Ganeti. |
67 | 9ff4f2c0 | Michael Hanselmann | |
68 | 9ff4f2c0 | Michael Hanselmann | .. vim: set textwidth=72 : |
69 | 9ff4f2c0 | Michael Hanselmann | .. Local Variables: |
70 | 9ff4f2c0 | Michael Hanselmann | .. mode: rst |
71 | 9ff4f2c0 | Michael Hanselmann | .. fill-column: 72 |
72 | 9ff4f2c0 | Michael Hanselmann | .. End: |