Statistics
| Branch: | Tag: | Revision:

root / man / gnt-os.rst @ 93e09cb7

History | View | Annotate | Download (2.4 kB)

1
gnt-os(8) Ganeti | Version @GANETI_VERSION@
2
===========================================
3

    
4
Name
5
----
6

    
7
gnt-os - Instance operating system administration
8

    
9
Synopsis
10
--------
11

    
12
**gnt-os** {command} [arguments...]
13

    
14
DESCRIPTION
15
-----------
16

    
17
The **gnt-os** is used for managing the list of available operating
18
system flavours for the instances in the Ganeti cluster.
19

    
20
COMMANDS
21
--------
22

    
23
LIST
24
~~~~
25

    
26
**list** [\--no-headers]
27

    
28
Gives the list of available/supported OS to use in the instances.
29
When creating the instance you can give the OS-name as an option.
30

    
31
Note that hidden or blacklisted OSes are not displayed by this
32
command, use **diagnose** for showing those.
33

    
34
DIAGNOSE
35
~~~~~~~~
36

    
37
**diagnose**
38

    
39
This command will help you see why an installed OS is not available
40
in the cluster. The **list** command shows only the OS-es that the
41
cluster sees available on all nodes. It could be that some OS is
42
missing from a node, or is only partially installed, and this
43
command will show the details of all the OSes and the reasons they
44
are or are not valid.
45

    
46
INFO
47
~~~~
48

    
49
**info**
50

    
51
This command will list detailed information about each OS available
52
in the cluster, including its validity status, the supported API
53
versions, the supported parameters (if any) and their
54
documentations, etc.
55

    
56
MODIFY
57
~~~~~~
58

    
59
| **modify** [\--submit] [-H *HYPERVISOR*:option=*value*[,...]]
60
| [\--hidden=*yes|no*] [\--blacklisted=*yes|no*]
61
| {*OS*}
62

    
63
This command will allow you to modify OS parameters.
64

    
65
To modify the per-OS hypervisor parameters (which override the
66
global hypervisor parameters), you can run modify ``-H`` with the
67
same syntax as in **gnt-cluster init** to override default
68
hypervisor parameters of the cluster for specified *OS* argument.
69

    
70
To modify the hidden and blacklisted states of an OS, pass the options
71
``--hidden ``*yes|no*, or respectively ``--blacklisted ...``. The
72
'hidden' state means that an OS won't be listed by default in the OS
73
list, but is available for installation. The 'blacklisted' state means
74
that the OS is not listed and is also not allowed for new instance
75
creations (but can be used for reinstalling old instances).
76

    
77
Note: The given operating system doesn't have to exist. This allows
78
preseeding the settings for operating systems not yet known to
79
**gnt-os**.
80

    
81
See **ganeti(7)** for a description of ``--submit`` and other common
82
options.
83

    
84
.. vim: set textwidth=72 :
85
.. Local Variables:
86
.. mode: rst
87
.. fill-column: 72
88
.. End: