gnt-os(8) Version 2.5.2 gnt-os(8)
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
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
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
This command will list detailed information about each OS available in the cluster, including its validity status, the supported API ver-
sions, the supported parameters (if any) and their documentations, etc.
modify [-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 hidden and blacklisted states of an OS, pass the options --hiddenyes|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 exists. This allows preseeding the settings for operating systems not yet known to gnt-os.
REPORTING BUGS
Report bugs to project website (http://code.google.com/p/ganeti/) or contact the developers using the Ganeti mailing list (ganeti@google-
groups.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-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-masterd(8) (master 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).
COPYRIGHT
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.
On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL.
Ganeti gnt-os(8)