ganeti-rapi

Name

ganeti-rapi - Ganeti remote API daemon

Synopsis

ganeti-rapi [-d] [-f] [-p PORT] [-b ADDRESS] [-i INTERFACE]
[–max-clients CLIENTS] [–no-ssl] [-K SSL_KEY_FILE]
[-C SSL_CERT_FILE] | [–require-authentication]

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 overridded 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 /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 /var/lib/ganeti/rapi/users file. The format of this file is described in the Ganeti documentation (rapi.html).