Ubuntu Manpage: gnt-os - Instance operating system administration

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

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
modify [--submit] [--print-job-id]
[-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 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).

       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-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),
       hinfo(1) (cluster information printer), mon-collector(7) (data collectors interface).

COPYRIGHT