Statistics
| Branch: | Tag: | Revision:

root / man / ganeti-queryd.rst @ e9ba0663

History | View | Annotate | Download (1.6 kB)

1
ganeti-queryd(8) Ganeti | Version @GANETI_VERSION@
2
==================================================
3

    
4
Name
5
----
6

    
7
ganeti-queryd - Ganeti query daemon
8

    
9
Synopsis
10
--------
11

    
12
**ganeti-queryd** [-f] [-d]
13

    
14
DESCRIPTION
15
-----------
16

    
17
**ganeti-queryd** is a daemon used to answer queries related to the
18
configuration and the current live state of a Ganeti cluster.
19

    
20
For testing purposes, you can give the ``-f`` option and the
21
program won't detach from the running terminal.
22

    
23
Debug-level message can be activated by giving the ``-d`` option.
24

    
25
Logging to syslog, rather than its own log file, can be enabled by
26
passing in the ``--syslog`` option.
27

    
28
The **ganeti-queryd** daemon listens on a Unix socket
29
(``@LOCALSTATEDIR@/run/ganeti/socket/ganeti-query``) on which it exports
30
a ``Luxi`` endpoint, serving query operations only. Commands and tools
31
use this socket if the build-time option for split queries has been
32
enabled.
33

    
34
The daemon will refuse to start if the user and group do not match the
35
one defined at build time; this behaviour can be overridden by the
36
``--no-user-checks`` option.
37

    
38
ROLE
39
~~~~
40

    
41
The role of the query daemon is to answer queries about the (live)
42
cluster state without going through the master daemon. Only queries
43
which don't require locks can be handles by the query daemon, which
44
might lead to slightly outdated results in some cases.
45

    
46
The config is reloaded from disk automatically when it changes, with a
47
rate limit of once per second.
48

    
49
COMMUNICATION PROTOCOL
50
~~~~~~~~~~~~~~~~~~~~~~
51

    
52
See **gnt-master**\(8).
53

    
54
.. vim: set textwidth=72 :
55
.. Local Variables:
56
.. mode: rst
57
.. fill-column: 72
58
.. End: