Statistics
| Branch: | Tag: | Revision:

root / man / gnt-os.rst @ 23fe06c2

History | View | Annotate | Download (2.2 kB)

1 6165efb9 Iustin Pop
gnt-os(8) Ganeti | Version @GANETI_VERSION@
2 6165efb9 Iustin Pop
===========================================
3 6165efb9 Iustin Pop
4 6165efb9 Iustin Pop
Name
5 6165efb9 Iustin Pop
----
6 6165efb9 Iustin Pop
7 6165efb9 Iustin Pop
gnt-os - Instance operating system administration
8 6165efb9 Iustin Pop
9 6165efb9 Iustin Pop
Synopsis
10 6165efb9 Iustin Pop
--------
11 6165efb9 Iustin Pop
12 6165efb9 Iustin Pop
**gnt-os** {command} [arguments...]
13 6165efb9 Iustin Pop
14 6165efb9 Iustin Pop
DESCRIPTION
15 6165efb9 Iustin Pop
-----------
16 6165efb9 Iustin Pop
17 6165efb9 Iustin Pop
The **gnt-os** is used for managing the list of available operating
18 6165efb9 Iustin Pop
system flavours for the instances in the Ganeti cluster.
19 6165efb9 Iustin Pop
20 6165efb9 Iustin Pop
COMMANDS
21 6165efb9 Iustin Pop
--------
22 6165efb9 Iustin Pop
23 6165efb9 Iustin Pop
**list**
24 6165efb9 Iustin Pop
25 6165efb9 Iustin Pop
Gives the list of available/supported OS to use in the instances.
26 6165efb9 Iustin Pop
When creating the instance you can give the OS-name as an option.
27 6165efb9 Iustin Pop
28 6165efb9 Iustin Pop
Note that hidden or blacklisted OSes are not displayed by this
29 6165efb9 Iustin Pop
command, use **diagnose** for showing those.
30 6165efb9 Iustin Pop
31 6165efb9 Iustin Pop
**diagnose**
32 6165efb9 Iustin Pop
33 6165efb9 Iustin Pop
This command will help you see why an installed OS is not available
34 6165efb9 Iustin Pop
in the cluster. The **list** command shows only the OS-es that the
35 6165efb9 Iustin Pop
cluster sees available on all nodes. It could be that some OS is
36 6165efb9 Iustin Pop
missing from a node, or is only partially installed, and this
37 6165efb9 Iustin Pop
command will show the details of all the OSes and the reasons they
38 6165efb9 Iustin Pop
are or are not valid.
39 6165efb9 Iustin Pop
40 6165efb9 Iustin Pop
**info**
41 6165efb9 Iustin Pop
42 6165efb9 Iustin Pop
This command will list detailed information about each OS available
43 6165efb9 Iustin Pop
in the cluster, including its validity status, the supported API
44 6165efb9 Iustin Pop
versions, the supported parameters (if any) and their
45 6165efb9 Iustin Pop
documentations, etc.
46 6165efb9 Iustin Pop
47 6165efb9 Iustin Pop
| **modify** [-H *HYPERVISOR*:option=*value*[,...]]
48 6165efb9 Iustin Pop
| [--hidden=*yes|no*] [--blacklisted=*yes|no*]
49 6165efb9 Iustin Pop
| {*OS*}
50 6165efb9 Iustin Pop
51 6165efb9 Iustin Pop
This command will allow you to modify OS parameters.
52 6165efb9 Iustin Pop
53 6165efb9 Iustin Pop
To modify the per-OS hypervisor parameters (which override the
54 6165efb9 Iustin Pop
global hypervisor parameters), you can run modify ``-H`` with the
55 6165efb9 Iustin Pop
same syntax as in **gnt-cluster init** to override default
56 6165efb9 Iustin Pop
hypervisor parameters of the cluster for specified *OS* argument.
57 6165efb9 Iustin Pop
58 6165efb9 Iustin Pop
To modify the hidden and blacklisted states of an OS, pass the options
59 6165efb9 Iustin Pop
``--hidden ``*yes|no*, or respectively ``--blacklisted ...``. The
60 6165efb9 Iustin Pop
'hidden' state means that an OS won't be listed by default in the OS
61 6165efb9 Iustin Pop
list, but is available for installation. The 'blacklisted' state means
62 6165efb9 Iustin Pop
that the OS is not listed and is also not allowed for new instance
63 6165efb9 Iustin Pop
creations (but can be used for reinstalling old instances).
64 6165efb9 Iustin Pop
65 6165efb9 Iustin Pop
Note: The given operating system doesn't have to exists. This allows
66 6165efb9 Iustin Pop
preseeding the settings for operating systems not yet known to
67 6165efb9 Iustin Pop
**gnt-os**.
68 9ff4f2c0 Michael Hanselmann
69 9ff4f2c0 Michael Hanselmann
.. vim: set textwidth=72 :
70 9ff4f2c0 Michael Hanselmann
.. Local Variables:
71 9ff4f2c0 Michael Hanselmann
.. mode: rst
72 9ff4f2c0 Michael Hanselmann
.. fill-column: 72
73 9ff4f2c0 Michael Hanselmann
.. End: