.TH gnt-os 8 "" "Ganeti" "Version 2.5.2"
.SH Name
.PP
gnt-os - Instance operating system administration
.SH Synopsis
.PP
\f[B]gnt-os\f[] {command} [arguments...]
.SH DESCRIPTION
.PP
The \f[B]gnt-os\f[] is used for managing the list of available
operating system flavours for the instances in the Ganeti cluster.
.SH COMMANDS
.PP
\f[B]list\f[]
.PP
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.
.PP
Note that hidden or blacklisted OSes are not displayed by this
command, use \f[B]diagnose\f[] for showing those.
.PP
\f[B]diagnose\f[]
.PP
This command will help you see why an installed OS is not available
in the cluster. The \f[B]list\f[] 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.
.PP
\f[B]info\f[]
.PP
This command will list detailed information about each OS available
in the cluster, including its validity status, the supported API
versions, the supported parameters (if any) and their
documentations, etc.
.PP
\f[B]modify\f[] [-H
\f[I]HYPERVISOR\f[]:option=\f[I]value\f[][,...]]
.PD 0
.P
.PD
[--hidden=\f[I]yes|no\f[]]
[--blacklisted=\f[I]yes|no\f[]]
.PD 0
.P
.PD
{\f[I]OS\f[]}
.PP
This command will allow you to modify OS parameters.
.PP
To modify the per-OS hypervisor parameters (which override the
global hypervisor parameters), you can run modify \f[B]-H\f[] with
the same syntax as in \f[B]gnt-cluster init\f[] to override default
hypervisor parameters of the cluster for specified \f[I]OS\f[]
argument.
.PP
To modify the hidden and blacklisted states of an OS, pass the
options \f[B]--hidden\f[]\f[I]yes|no\f[], or respectively
\f[B]--blacklisted\ ...\f[].
The \[aq]hidden\[aq] state means that an OS won\[aq]t be listed by
default in the OS list, but is available for installation. The
\[aq]blacklisted\[aq] 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).
.PP
Note: The given operating system doesn\[aq]t have to exists. This
allows preseeding the settings for operating systems not yet known
to \f[B]gnt-os\f[].
.SH REPORTING BUGS
.PP
Report bugs to project website (http://code.google.com/p/ganeti/)
or contact the developers using the
Ganeti mailing list (ganeti@googlegroups.com).
.SH SEE ALSO
.PP
Ganeti overview and specifications: \f[B]ganeti\f[](7) (general
overview), \f[B]ganeti-os-interface\f[](7) (guest OS definitions).
.PP
Ganeti commands: \f[B]gnt-cluster\f[](8) (cluster-wide commands),
\f[B]gnt-job\f[](8) (job-related commands), \f[B]gnt-node\f[](8)
(node-related commands), \f[B]gnt-instance\f[](8) (instance
commands), \f[B]gnt-os\f[](8) (guest OS commands),
\f[B]gnt-group\f[](8) (node group commands), \f[B]gnt-backup\f[](8)
(instance import/export commands), \f[B]gnt-debug\f[](8) (debug
commands).
.PP
Ganeti daemons: \f[B]ganeti-watcher\f[](8) (automatic instance
restarter), \f[B]ganeti-cleaner\f[](8) (job queue cleaner),
\f[B]ganeti-noded\f[](8) (node daemon), \f[B]ganeti-masterd\f[](8)
(master daemon), \f[B]ganeti-rapi\f[](8) (remote API daemon).
.PP
Ganeti htools: \f[B]htools\f[](1) (generic binary),
\f[B]hbal\f[](1) (cluster balancer), \f[B]hspace\f[](1) (capacity
calculation), \f[B]hail\f[](1) (IAllocator plugin),
\f[B]hscan\f[](1) (data gatherer from remote clusters).
.SH COPYRIGHT
.PP
Copyright (C) 2006, 2007, 2008, 2009, 2010, 2011 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.
.PP
On Debian systems, the complete text of the GNU General Public
License can be found in /usr/share/common-licenses/GPL.