ganeti-luxid.rst 1.84 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
Klaus Aehlig's avatar
Klaus Aehlig committed
19 20 21
configuration and the current live state of a Ganeti cluster. Additionally,
it is the autorative daemon for the Ganeti job queue. Jobs can be
submitted via this daemon and it schedules and starts them.
Thomas Thrainer's avatar
Thomas Thrainer committed
22 23 24 25 26 27 28 29 30

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
31
The **ganeti-luxid** daemon listens on a Unix socket
Thomas Thrainer's avatar
Thomas Thrainer committed
32
(``@LOCALSTATEDIR@/run/ganeti/socket/ganeti-query``) on which it exports
Klaus Aehlig's avatar
Klaus Aehlig committed
33
a ``Luxi`` endpoint supporting the full set of commands.
Thomas Thrainer's avatar
Thomas Thrainer committed
34 35 36 37 38

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.


Klaus Aehlig's avatar
Klaus Aehlig committed
46 47
Only queries which don't require locks can be handled by the luxi daemon,
which might lead to slightly outdated results in some cases.
Thomas Thrainer's avatar
Thomas Thrainer committed
48 49 50 51 52 53 54 55 56 57 58 59 60 61

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: