ganeti-rapi(8) Version 2.5.2 ganeti-rapi(8)
Name
ganeti-rapi - Ganeti remote API daemon
Synopsis
ganeti-rapi [-d] [-f] [--no-ssl] [-K SSL_KEY_FILE] [-C SSL_CERT_FILE]
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.
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
All query operations are allowed without authentication. Only the modification operations require authentication, in the form of basic
authentication.
The users and their rights are defined in the /var/lib/ganeti/rapi/users file. The users should be listed one per line, in the following
format:
username password options
Currently the options field should equal the string write in order to actually give write permission for the given users. Example:
rclient secret write
guest testpw
The first user (rclient) has read-write rights, whereas the second user (guest) only has read (query) rights, and as such is no different
than not using authentication at all.
More details (including on how to use hashed passwords) can be found in the Ganeti documentation.
REPORTING BUGS
Report bugs to project website (http://code.google.com/p/ganeti/) or contact the developers using the Ganeti mailing list (ganeti@google-
groups.com).
SEE ALSO
Ganeti overview and specifications: ganeti(7) (general overview), ganeti-os-interface(7) (guest OS definitions).
Ganeti commands: gnt-cluster(8) (cluster-wide commands), gnt-job(8) (job-related commands), gnt-node(8) (node-related commands), gnt-
instance(8) (instance commands), gnt-os(8) (guest OS commands), gnt-group(8) (node group commands), gnt-backup(8) (instance import/export
commands), gnt-debug(8) (debug commands).
Ganeti daemons: ganeti-watcher(8) (automatic instance restarter), ganeti-cleaner(8) (job queue cleaner), ganeti-noded(8) (node daemon),
ganeti-masterd(8) (master daemon), ganeti-rapi(8) (remote API daemon).
Ganeti htools: htools(1) (generic binary), hbal(1) (cluster balancer), hspace(1) (capacity calculation), hail(1) (IAllocator plugin),
hscan(1) (data gatherer from remote clusters).
COPYRIGHT
Copyright (C) 2006, 2007, 2008, 2009, 2010, 2011 Google Inc. Permission is granted to copy, distribute and/or modify under the terms of
the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later
version.
On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL.
Ganeti ganeti-rapi(8)