Provided by: ganeti-2.16_2.16.0~rc2-1build1_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 {OS}

       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.  If an OS name is given, then only the
       specified OS details will be shown.

       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=*yesno*]
       {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.