Name

       ganeti-rapi - Ganeti remote API daemon

Synopsis

       ganeti-rapi  [-d]  [-f]  [-p PORT] [-bADDRESS] [-iINTERFACE] | [--no-ssl] [-KSSL_KEY_FILE]
       [-CSSL_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); alternatively, the -i option can be used to specify the interface
       to bind do.

       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).

REPORTING BUGS

       Report  bugs  to  project  website  (http://code.google.com/p/ganeti/)  or   contact   the
       developers using the Ganeti mailing list (ganeti@googlegroups.com).

SEE ALSO

       Ganeti  overview  and specifications: ganeti(7) (general overview), ganeti-os-interface(7)
       (guest OS definitions), ganeti-extstorage-interface(7) (external storage providers).

       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-storage(8) (storage  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),
       hinfo(1) (cluster information printer), mon-collector(7) (data collectors interface).

COPYRIGHT

       Copyright  (C) 2006, 2007, 2008, 2009, 2010, 2011, 2012 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.