Revision 6165efb9
b/man/gnt-os.rst | ||
---|---|---|
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**. |
Also available in: Unified diff