root / man / gnt-os.rst @ 6165efb9
History | View | Annotate | Download (2.1 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 |
Gives the list of available/supported OS to use in the instances. |
26 |
When creating the instance you can give the OS-name as an option. |
27 |
|
28 |
Note that hidden or blacklisted OSes are not displayed by this |
29 |
command, use **diagnose** for showing those. |
30 |
|
31 |
**diagnose** |
32 |
|
33 |
This command will help you see why an installed OS is not available |
34 |
in the cluster. The **list** command shows only the OS-es that the |
35 |
cluster sees available on all nodes. It could be that some OS is |
36 |
missing from a node, or is only partially installed, and this |
37 |
command will show the details of all the OSes and the reasons they |
38 |
are or are not valid. |
39 |
|
40 |
**info** |
41 |
|
42 |
This command will list detailed information about each OS available |
43 |
in the cluster, including its validity status, the supported API |
44 |
versions, the supported parameters (if any) and their |
45 |
documentations, etc. |
46 |
|
47 |
| **modify** [-H *HYPERVISOR*:option=*value*[,...]] |
48 |
| [--hidden=*yes|no*] [--blacklisted=*yes|no*] |
49 |
| {*OS*} |
50 |
|
51 |
This command will allow you to modify OS parameters. |
52 |
|
53 |
To modify the per-OS hypervisor parameters (which override the |
54 |
global hypervisor parameters), you can run modify ``-H`` with the |
55 |
same syntax as in **gnt-cluster init** to override default |
56 |
hypervisor parameters of the cluster for specified *OS* argument. |
57 |
|
58 |
To modify the hidden and blacklisted states of an OS, pass the options |
59 |
``--hidden ``*yes|no*, or respectively ``--blacklisted ...``. The |
60 |
'hidden' state means that an OS won't be listed by default in the OS |
61 |
list, but is available for installation. The 'blacklisted' state means |
62 |
that the OS is not listed and is also not allowed for new instance |
63 |
creations (but can be used for reinstalling old instances). |
64 |
|
65 |
Note: The given operating system doesn't have to exists. This allows |
66 |
preseeding the settings for operating systems not yet known to |
67 |
**gnt-os**. |