root / man / gnt-os.rst @ 81879d92
History | View | Annotate | Download (2.4 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 | 93e09cb7 | Iustin Pop | LIST |
24 | 93e09cb7 | Iustin Pop | ~~~~ |
25 | 93e09cb7 | Iustin Pop | |
26 | 93e09cb7 | Iustin Pop | **list** [\--no-headers] |
27 | 6165efb9 | Iustin Pop | |
28 | 6165efb9 | Iustin Pop | Gives the list of available/supported OS to use in the instances. |
29 | 6165efb9 | Iustin Pop | When creating the instance you can give the OS-name as an option. |
30 | 6165efb9 | Iustin Pop | |
31 | 6165efb9 | Iustin Pop | Note that hidden or blacklisted OSes are not displayed by this |
32 | 6165efb9 | Iustin Pop | command, use **diagnose** for showing those. |
33 | 6165efb9 | Iustin Pop | |
34 | 93e09cb7 | Iustin Pop | DIAGNOSE |
35 | 93e09cb7 | Iustin Pop | ~~~~~~~~ |
36 | 93e09cb7 | Iustin Pop | |
37 | 6165efb9 | Iustin Pop | **diagnose** |
38 | 6165efb9 | Iustin Pop | |
39 | 6165efb9 | Iustin Pop | This command will help you see why an installed OS is not available |
40 | 6165efb9 | Iustin Pop | in the cluster. The **list** command shows only the OS-es that the |
41 | 6165efb9 | Iustin Pop | cluster sees available on all nodes. It could be that some OS is |
42 | 6165efb9 | Iustin Pop | missing from a node, or is only partially installed, and this |
43 | 6165efb9 | Iustin Pop | command will show the details of all the OSes and the reasons they |
44 | 6165efb9 | Iustin Pop | are or are not valid. |
45 | 6165efb9 | Iustin Pop | |
46 | 93e09cb7 | Iustin Pop | INFO |
47 | 93e09cb7 | Iustin Pop | ~~~~ |
48 | 93e09cb7 | Iustin Pop | |
49 | 6165efb9 | Iustin Pop | **info** |
50 | 6165efb9 | Iustin Pop | |
51 | 6165efb9 | Iustin Pop | This command will list detailed information about each OS available |
52 | 6165efb9 | Iustin Pop | in the cluster, including its validity status, the supported API |
53 | 6165efb9 | Iustin Pop | versions, the supported parameters (if any) and their |
54 | 6165efb9 | Iustin Pop | documentations, etc. |
55 | 6165efb9 | Iustin Pop | |
56 | 93e09cb7 | Iustin Pop | MODIFY |
57 | 93e09cb7 | Iustin Pop | ~~~~~~ |
58 | 93e09cb7 | Iustin Pop | |
59 | d6cd74dd | Klaus Aehlig | | **modify** [\--submit] [\--print-job-id] |
60 | d6cd74dd | Klaus Aehlig | | [-H *HYPERVISOR*:option=*value*[,...]] |
61 | f624fa95 | Iustin Pop | | [\--hidden=*yes|no*] [\--blacklisted=*yes|no*] |
62 | 6165efb9 | Iustin Pop | | {*OS*} |
63 | 6165efb9 | Iustin Pop | |
64 | 6165efb9 | Iustin Pop | This command will allow you to modify OS parameters. |
65 | 6165efb9 | Iustin Pop | |
66 | 6165efb9 | Iustin Pop | To modify the per-OS hypervisor parameters (which override the |
67 | 6165efb9 | Iustin Pop | global hypervisor parameters), you can run modify ``-H`` with the |
68 | 6165efb9 | Iustin Pop | same syntax as in **gnt-cluster init** to override default |
69 | 6165efb9 | Iustin Pop | hypervisor parameters of the cluster for specified *OS* argument. |
70 | 6165efb9 | Iustin Pop | |
71 | 6165efb9 | Iustin Pop | To modify the hidden and blacklisted states of an OS, pass the options |
72 | 6165efb9 | Iustin Pop | ``--hidden ``*yes|no*, or respectively ``--blacklisted ...``. The |
73 | 6165efb9 | Iustin Pop | 'hidden' state means that an OS won't be listed by default in the OS |
74 | 6165efb9 | Iustin Pop | list, but is available for installation. The 'blacklisted' state means |
75 | 6165efb9 | Iustin Pop | that the OS is not listed and is also not allowed for new instance |
76 | 6165efb9 | Iustin Pop | creations (but can be used for reinstalling old instances). |
77 | 6165efb9 | Iustin Pop | |
78 | e98bb8c8 | Michael Hanselmann | Note: The given operating system doesn't have to exist. This allows |
79 | 6165efb9 | Iustin Pop | preseeding the settings for operating systems not yet known to |
80 | 6165efb9 | Iustin Pop | **gnt-os**. |
81 | 9ff4f2c0 | Michael Hanselmann | |
82 | 354c4f62 | Michael Hanselmann | See **ganeti**\(7) for a description of ``--submit`` and other common |
83 | ed4d8889 | Michael Hanselmann | options. |
84 | ed4d8889 | Michael Hanselmann | |
85 | 9ff4f2c0 | Michael Hanselmann | .. vim: set textwidth=72 : |
86 | 9ff4f2c0 | Michael Hanselmann | .. Local Variables: |
87 | 9ff4f2c0 | Michael Hanselmann | .. mode: rst |
88 | 9ff4f2c0 | Michael Hanselmann | .. fill-column: 72 |
89 | 9ff4f2c0 | Michael Hanselmann | .. End: |