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 versions, 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
--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 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@googlegroups.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.