root / man / gnt-os.rst @ 383477e9
History | View | Annotate | Download (2.3 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 | ed4d8889 | Michael Hanselmann | | **modify** [\--submit] [-H *HYPERVISOR*:option=*value*[,...]] |
48 | f624fa95 | 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 | e98bb8c8 | Michael Hanselmann | Note: The given operating system doesn't have to exist. 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 | ed4d8889 | Michael Hanselmann | See **ganeti(7)** for a description of ``--submit`` and other common |
70 | ed4d8889 | Michael Hanselmann | options. |
71 | ed4d8889 | Michael Hanselmann | |
72 | 9ff4f2c0 | Michael Hanselmann | .. vim: set textwidth=72 : |
73 | 9ff4f2c0 | Michael Hanselmann | .. Local Variables: |
74 | 9ff4f2c0 | Michael Hanselmann | .. mode: rst |
75 | 9ff4f2c0 | Michael Hanselmann | .. fill-column: 72 |
76 | 9ff4f2c0 | Michael Hanselmann | .. End: |