ganeti-luxid.rst 1.92 KB
Newer Older
Thomas Thrainer's avatar
Thomas Thrainer committed
1
2
ganeti-luxid(8) Ganeti | Version @GANETI_VERSION@
=================================================
Thomas Thrainer's avatar
Thomas Thrainer committed
3
4
5
6

Name
----

Thomas Thrainer's avatar
Thomas Thrainer committed
7
ganeti-luxid - Ganeti query daemon
Thomas Thrainer's avatar
Thomas Thrainer committed
8
9
10
11

Synopsis
--------

Klaus Aehlig's avatar
Klaus Aehlig committed
12
13
**ganeti-luxid** [-f] [-d] [--syslog] [--no-user-checks]
[--no-voting --yes-do-it]
Thomas Thrainer's avatar
Thomas Thrainer committed
14
15
16
17

DESCRIPTION
-----------

Thomas Thrainer's avatar
Thomas Thrainer committed
18
**ganeti-luxid** is a daemon used to answer queries related to the
Thomas Thrainer's avatar
Thomas Thrainer committed
19
20
21
22
23
24
25
26
27
28
configuration and the current live state of a Ganeti cluster.

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

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

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

Thomas Thrainer's avatar
Thomas Thrainer committed
29
The **ganeti-luxid** daemon listens on a Unix socket
Thomas Thrainer's avatar
Thomas Thrainer committed
30
31
32
33
34
35
36
37
38
(``@LOCALSTATEDIR@/run/ganeti/socket/ganeti-query``) on which it exports
a ``Luxi`` endpoint, serving query operations only. Commands and tools
use this socket if the build-time option for split queries has been
enabled.

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

39
40
41
42
43
44
45
The daemon will refuse to start if it cannot verify that the majority
of cluster nodes believes that it is running on the master node. To
allow failover in a two-node cluster, this can be overridden by the
``--no-voting`` option. As it this is dangerous, the ``--yes-do-it``
option has to be given as well.


Thomas Thrainer's avatar
Thomas Thrainer committed
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
ROLE
~~~~

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

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

COMMUNICATION PROTOCOL
~~~~~~~~~~~~~~~~~~~~~~

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

.. vim: set textwidth=72 :
.. Local Variables:
.. mode: rst
.. fill-column: 72
.. End: