Provided by: ganeti-2.15_2.15.2-3_all bug

Name

       gnt-os - Instance operating system administration

Synopsis

       gnt-os {command} [arguments...]

DESCRIPTION

       The  gnt-os is used for managing the list of available operating system
       flavours for the instances in the Ganeti cluster.

COMMANDS

   LIST
       list [--no-headers]

       Gives the list of available/supported OS to use in the instances.  When
       creating the instance you can give the OS-name as an option.

       Note that hidden or blacklisted OSes are not displayed by this command,
       use diagnose for showing those.

   DIAGNOSE
       diagnose

       This command will help you see why an installed OS is not available  in
       the  cluster.   The  list command shows only the OS-es that the cluster
       sees available on all nodes.  It could be that some OS is missing  from
       a  node, or is only partially installed, and this command will show the
       details of all the OSes and the reasons they are or are not valid.

   INFO
       info

       This command will list detailed information about each OS available  in
       the cluster, including its validity status, the supported API versions,
       the  supported  parameters   and   variants   (if   any),   and   their
       documentation, etc.

       Note  that this command besides the information about the given OS(es),
       shows detailed  information  about  the  given  available/supported  OS
       variant(s),  in  terms of the modified per-OS hypervisor parameters and
       the modified per-OS parameters passed to the OS install scripts.

       For the list of the available OSes use list.  Also, see  modify  for  a
       description  of  how  to modify the parameters for a specific operating
       system.

   MODIFY
       modify [--submit] [--print-jobid]
       [ [ -O | --os-parameters ] =*option*=*value*]
       [ --os-parameters-private=*option*=*value*]
       [-H HYPERVISOR:option=*value*[,...]]
       [--hidden=*yes|no*] [--blacklisted=*yes|no*]
       {OS}

       This command will allow you to modify OS parameters.

       To modify the per-OS hypervisor parameters (which override  the  global
       hypervisor  parameters),  you can run modify -H with the same syntax as
       in gnt-cluster init to override default hypervisor  parameters  of  the
       cluster for specified OS argument.

       To  modify  the  parameters  passed  to the OS install scripts, use the
       --os-parameters option.  If the value of the parameter  should  not  be
       saved to logs, use --os-parameters-private and make sure that no Ganeti
       daemon or program is running in debug mode.  ganeti-luxid in particular
       will issue a warning at startup time if ran in debug mode.

       To  modify the hidden and blacklisted states of an OS, pass the options
       --hidden yes|no, or respectively --blacklisted ....  The 'hidden' state
       means  that  an  OS  won't  be listed by default in the OS list, but is
       available for installation.  The 'blacklisted' state means that the  OS
       is  not  listed and is also not allowed for new instance creations (but
       can be used for reinstalling old instances).

       Note: The given operating system doesn't have to  exist.   This  allows
       preseeding the settings for operating systems not yet known to gnt-os.

       See ganeti(7) for a description of --submit and other common options.

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-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-2015 Google Inc.  All rights reserved.

       Redistribution  and  use  in  source  and binary forms, with or without
       modification, are permitted provided that the following conditions  are
       met:

       1.   Redistributions  of  source  code  must retain the above copyright
       notice, this list of conditions and the following disclaimer.

       2.  Redistributions in binary form must reproduce the  above  copyright
       notice,  this  list  of  conditions and the following disclaimer in the
       documentation and/or other materials provided with the distribution.

       THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
       IS"  AND  ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
       TO, THE  IMPLIED  WARRANTIES  OF  MERCHANTABILITY  AND  FITNESS  FOR  A
       PARTICULAR  PURPOSE  ARE  DISCLAIMED.   IN NO EVENT SHALL THE COPYRIGHT
       HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,  INCIDENTAL,
       SPECIAL,  EXEMPLARY,  OR  CONSEQUENTIAL  DAMAGES  (INCLUDING,  BUT  NOT
       LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS  OF  USE,
       DATA,  OR  PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
       THEORY OF LIABILITY, WHETHER IN CONTRACT,  STRICT  LIABILITY,  OR  TORT
       (INCLUDING  NEGLIGENCE  OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
       OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.