root / man / ganeti-confd.rst @ 6e7f0cd9
History | View | Annotate | Download (1.4 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 | a6243496 | Iustin Pop | ROLE |
26 | a6243496 | Iustin Pop | ~~~~ |
27 | a6243496 | Iustin Pop | |
28 | a6243496 | Iustin Pop | The role of the conf daemon is to make sure we have a highly available |
29 | a6243496 | Iustin Pop | and very fast way to query cluster configuration values. This daemon |
30 | a6243496 | Iustin Pop | is automatically active on all master candidates, and so has no single |
31 | a6243496 | Iustin Pop | point of failure. It communicates via UDP so each query can easily be |
32 | a6243496 | Iustin Pop | sent to multiple servers, and it answers queries from a cached copy of |
33 | a6243496 | Iustin Pop | the config it keeps in memory, so no disk access is required to get an |
34 | a6243496 | Iustin Pop | answer. |
35 | a6243496 | Iustin Pop | |
36 | a6243496 | Iustin Pop | The config is reloaded from disk automatically when it changes, with a |
37 | a6243496 | Iustin Pop | rate limit of once per second. |
38 | a6243496 | Iustin Pop | |
39 | a6243496 | Iustin Pop | If the conf daemon is stopped on all nodes, its clients won't be able |
40 | a6243496 | Iustin Pop | to get query answers. |
41 | a6243496 | Iustin Pop | |
42 | a6243496 | Iustin Pop | COMMUNICATION PROTOCOL |
43 | a6243496 | Iustin Pop | ~~~~~~~~~~~~~~~~~~~~~~ |
44 | a6243496 | Iustin Pop | |
45 | a6243496 | Iustin Pop | The confd protocol is an HMAC authenticated json-encoded custom |
46 | a6243496 | Iustin Pop | format, over UDP. A client library is provided to make it easy to |
47 | a6243496 | Iustin Pop | write software to query confd. More information can be found in the |
48 | a6243496 | Iustin Pop | Ganeti 2.1 design doc, and an example usage can be seen in the |
49 | a6243496 | Iustin Pop | (external) NBMA daemon for Ganeti. |