ganeti-rapi¶
Name¶
ganeti-rapi - Ganeti remote API daemon
Synopsis¶
DESCRIPTION¶
ganeti-rapi is the daemon providing a remote API for Ganeti clusters.
It is automatically started on the master node, and by default it
uses SSL encryption. This can be disabled by passing the
--no-ssl option, or alternatively the certificate used can be
changed via the -C option and the key via the -K option.
The daemon will listen to the “ganeti-rapi” TCP port, as listed in the
system services database, or if not defined, to port 5080 by default.
The port can be overridden by passing the -p option. The -b
option can be used to specify the address to bind to (defaults to
0.0.0.0). Note that if you specify the address, the watcher
needs to be informed about it using its option --rapi-ip, otherwise
it will not be able to reach the RAPI interface and will attempt to
restart it all the time. Alternatively to setting the IP with --b,
the -i option can be used to specify the interface to bind do.
The maximum number of simultaneous client connections may be configured
with the --max-clients option. This defaults to 20. Connections
above this count are accepted, but no responses are sent until enough
connections are closed.
See the Ganeti remote API documentation for further information.
Requests are logged to /usr/local/var/log/ganeti/rapi-daemon.log,
in the same format as for the node and master daemon.
ACCESS CONTROLS¶
Most query operations are allowed without authentication. Only the
modification operations require authentication, in the form of basic
authentication. Specify the --require-authentication command line
flag to always require authentication.
The users and their rights are defined in the
/usr/local/var/lib/ganeti/rapi/users file. The format of this file
is described in the Ganeti documentation (rapi.html).