Statistics
| Branch: | Tag: | Revision:

root / man / ganeti-queryd.rst @ e9ba0663

History | View | Annotate | Download (1.6 kB)

1 e9ba0663 Thomas Thrainer
ganeti-queryd(8) Ganeti | Version @GANETI_VERSION@
2 e9ba0663 Thomas Thrainer
==================================================
3 e9ba0663 Thomas Thrainer
4 e9ba0663 Thomas Thrainer
Name
5 e9ba0663 Thomas Thrainer
----
6 e9ba0663 Thomas Thrainer
7 e9ba0663 Thomas Thrainer
ganeti-queryd - Ganeti query daemon
8 e9ba0663 Thomas Thrainer
9 e9ba0663 Thomas Thrainer
Synopsis
10 e9ba0663 Thomas Thrainer
--------
11 e9ba0663 Thomas Thrainer
12 e9ba0663 Thomas Thrainer
**ganeti-queryd** [-f] [-d]
13 e9ba0663 Thomas Thrainer
14 e9ba0663 Thomas Thrainer
DESCRIPTION
15 e9ba0663 Thomas Thrainer
-----------
16 e9ba0663 Thomas Thrainer
17 e9ba0663 Thomas Thrainer
**ganeti-queryd** is a daemon used to answer queries related to the
18 e9ba0663 Thomas Thrainer
configuration and the current live state of a Ganeti cluster.
19 e9ba0663 Thomas Thrainer
20 e9ba0663 Thomas Thrainer
For testing purposes, you can give the ``-f`` option and the
21 e9ba0663 Thomas Thrainer
program won't detach from the running terminal.
22 e9ba0663 Thomas Thrainer
23 e9ba0663 Thomas Thrainer
Debug-level message can be activated by giving the ``-d`` option.
24 e9ba0663 Thomas Thrainer
25 e9ba0663 Thomas Thrainer
Logging to syslog, rather than its own log file, can be enabled by
26 e9ba0663 Thomas Thrainer
passing in the ``--syslog`` option.
27 e9ba0663 Thomas Thrainer
28 e9ba0663 Thomas Thrainer
The **ganeti-queryd** daemon listens on a Unix socket
29 e9ba0663 Thomas Thrainer
(``@LOCALSTATEDIR@/run/ganeti/socket/ganeti-query``) on which it exports
30 e9ba0663 Thomas Thrainer
a ``Luxi`` endpoint, serving query operations only. Commands and tools
31 e9ba0663 Thomas Thrainer
use this socket if the build-time option for split queries has been
32 e9ba0663 Thomas Thrainer
enabled.
33 e9ba0663 Thomas Thrainer
34 e9ba0663 Thomas Thrainer
The daemon will refuse to start if the user and group do not match the
35 e9ba0663 Thomas Thrainer
one defined at build time; this behaviour can be overridden by the
36 e9ba0663 Thomas Thrainer
``--no-user-checks`` option.
37 e9ba0663 Thomas Thrainer
38 e9ba0663 Thomas Thrainer
ROLE
39 e9ba0663 Thomas Thrainer
~~~~
40 e9ba0663 Thomas Thrainer
41 e9ba0663 Thomas Thrainer
The role of the query daemon is to answer queries about the (live)
42 e9ba0663 Thomas Thrainer
cluster state without going through the master daemon. Only queries
43 e9ba0663 Thomas Thrainer
which don't require locks can be handles by the query daemon, which
44 e9ba0663 Thomas Thrainer
might lead to slightly outdated results in some cases.
45 e9ba0663 Thomas Thrainer
46 e9ba0663 Thomas Thrainer
The config is reloaded from disk automatically when it changes, with a
47 e9ba0663 Thomas Thrainer
rate limit of once per second.
48 e9ba0663 Thomas Thrainer
49 e9ba0663 Thomas Thrainer
COMMUNICATION PROTOCOL
50 e9ba0663 Thomas Thrainer
~~~~~~~~~~~~~~~~~~~~~~
51 e9ba0663 Thomas Thrainer
52 e9ba0663 Thomas Thrainer
See **gnt-master**\(8).
53 e9ba0663 Thomas Thrainer
54 e9ba0663 Thomas Thrainer
.. vim: set textwidth=72 :
55 e9ba0663 Thomas Thrainer
.. Local Variables:
56 e9ba0663 Thomas Thrainer
.. mode: rst
57 e9ba0663 Thomas Thrainer
.. fill-column: 72
58 e9ba0663 Thomas Thrainer
.. End: