Revision e9ba0663

b/INSTALL
177 177 
~~~~~~~~~~~~~~~~~~~~~~~~~
178 178 

  		





  179
  179
  
    
Optionally, more functionality can be enabled if your build machine has


  		





  180
  
  
    
a few more Haskell libraries enabled: the ``ganeti-confd`` daemon


  		





  181
  
  
    
(``--enable-confd``) and the monitoring daemon


  		





  
  180
  
    
a few more Haskell libraries enabled: the ``ganeti-confd`` and


  		





  
  181
  
    
``ganeti-queryd`` daemon (``--enable-confd``) and the monitoring daemon


  		





  182
  182
  
    
(``--enable-mond``). The list of extra dependencies for these is:


  		





  183
  183
  
    

  		





  184
  184
  
    
- `hslogger <http://software.complete.org/hslogger>`_, version 1.1 and


  		












  

    
      b/Makefile.am
    
  






  986
  986
  
    
man_MANS = \


  		





  987
  987
  
    
	man/ganeti-cleaner.8 \


  		





  988
  988
  
    
	man/ganeti-confd.8 \


  		





  
  989
  
    
	man/ganeti-queryd.8 \


  		





  989
  990
  
    
	man/ganeti-listrunner.8 \


  		





  990
  991
  
    
	man/ganeti-masterd.8 \


  		





  991
  992
  
    
	man/ganeti-mond.8 \


  		












  

    
      b/man/ganeti-confd.rst
    
  






  29
  29
  
    
by default. The port can be overridden by an entry the services database


  		





  30
  30
  
    
(usually ``/etc/services``) or by passing the ``-p`` option.  The ``-b``


  		





  31
  31
  
    
option can be used to specify the address to bind to (defaults to


  		





  32
  
  
    
``0.0.0.0``). The daemon also listens on a Unix socket


  		





  33
  
  
    
(``@LOCALSTATEDIR@/run/ganeti/socket/ganeti-query``) on which it exports


  		





  34
  
  
    
a ``Luxi`` endpoint, serving query operations only. Commands and tools


  		





  35
  
  
    
use this socket if the build-time option for split queries has been


  		





  36
  
  
    
enabled.


  		





  
  32
  
    
``0.0.0.0``).


  		





  37
  33
  
    

  		





  38
  34
  
    
The daemon will refuse to start if the user and group do not match the


  		





  39
  35
  
    
one defined at build time; this behaviour can be overridden by the


  		












  

    
      b/man/ganeti-queryd.rst
    
  






  
  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:


  		












Also available in:
  Unified diff