Provided by: ganeti2_2.1.2.1-2_all bug

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 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 a file named rapi_users,
       located in the /var/ganeti directory. 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   tespw

       The first user (rclient)  will  have  read-write  rights,  whereas  the
       second  user  does  only  have  read  (query) rights, and as such is no
       different than not using authentication at all.

REPORTING BUGS

       Report bugs to  <URL: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 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-
       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).

COPYRIGHT

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