Provided by: ganeti-2.16_2.16.0~rc2-1build1_all 
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.