root / man / gnt-group.rst @ 66e884e1
History | View | Annotate | Download (2.3 kB)
1 | 667dbd6b | Adeodato Simo | gnt-group(8) Ganeti | Version @GANETI_VERSION@ |
---|---|---|---|
2 | 667dbd6b | Adeodato Simo | ============================================== |
3 | 667dbd6b | Adeodato Simo | |
4 | 667dbd6b | Adeodato Simo | Name |
5 | 667dbd6b | Adeodato Simo | ---- |
6 | 667dbd6b | Adeodato Simo | |
7 | 667dbd6b | Adeodato Simo | gnt-group - Ganeti node-group administration |
8 | 667dbd6b | Adeodato Simo | |
9 | 667dbd6b | Adeodato Simo | Synopsis |
10 | 667dbd6b | Adeodato Simo | -------- |
11 | 667dbd6b | Adeodato Simo | |
12 | 667dbd6b | Adeodato Simo | **gnt-group** {command} [arguments...] |
13 | 667dbd6b | Adeodato Simo | |
14 | 667dbd6b | Adeodato Simo | DESCRIPTION |
15 | 667dbd6b | Adeodato Simo | ----------- |
16 | 667dbd6b | Adeodato Simo | |
17 | 667dbd6b | Adeodato Simo | The **gnt-group** command is used for node group administration in |
18 | 667dbd6b | Adeodato Simo | the Ganeti system. |
19 | 667dbd6b | Adeodato Simo | |
20 | 667dbd6b | Adeodato Simo | COMMANDS |
21 | 667dbd6b | Adeodato Simo | -------- |
22 | 667dbd6b | Adeodato Simo | |
23 | 66e884e1 | Adeodato Simo | ADD |
24 | 66e884e1 | Adeodato Simo | ~~~ |
25 | 66e884e1 | Adeodato Simo | |
26 | 66e884e1 | Adeodato Simo | | **add** {*group*} |
27 | 66e884e1 | Adeodato Simo | |
28 | 66e884e1 | Adeodato Simo | Creates a new group with the given name. The node group will be |
29 | 66e884e1 | Adeodato Simo | initially empty. |
30 | 66e884e1 | Adeodato Simo | |
31 | 66e884e1 | Adeodato Simo | REMOVE |
32 | 66e884e1 | Adeodato Simo | ~~~~~~ |
33 | 66e884e1 | Adeodato Simo | |
34 | 66e884e1 | Adeodato Simo | | **remove** {*group*} |
35 | 66e884e1 | Adeodato Simo | |
36 | 66e884e1 | Adeodato Simo | Deletes the indicated node group, which must be empty. |
37 | 66e884e1 | Adeodato Simo | |
38 | 667dbd6b | Adeodato Simo | LIST |
39 | 667dbd6b | Adeodato Simo | ~~~~ |
40 | 667dbd6b | Adeodato Simo | |
41 | 667dbd6b | Adeodato Simo | | **list** [--no-headers] [--separator=*SEPARATOR*] |
42 | 667dbd6b | Adeodato Simo | | [-o *[+]FIELD,...*] [group...] |
43 | 667dbd6b | Adeodato Simo | |
44 | 667dbd6b | Adeodato Simo | Lists all existing node groups in the cluster. |
45 | 667dbd6b | Adeodato Simo | |
46 | 667dbd6b | Adeodato Simo | The ``--no-headers`` option will skip the initial header line. The |
47 | 667dbd6b | Adeodato Simo | ``--separator`` option takes an argument which denotes what will be |
48 | 667dbd6b | Adeodato Simo | used between the output fields. Both these options are to help |
49 | 667dbd6b | Adeodato Simo | scripting. |
50 | 667dbd6b | Adeodato Simo | |
51 | 667dbd6b | Adeodato Simo | The ``-o`` option takes a comma-separated list of output fields. |
52 | 667dbd6b | Adeodato Simo | If the value of the option starts with the character ``+``, the new |
53 | 667dbd6b | Adeodato Simo | fields will be added to the default list. This allows to quickly |
54 | 667dbd6b | Adeodato Simo | see the default list plus a few other fields, instead of retyping |
55 | 667dbd6b | Adeodato Simo | the entire list of fields. |
56 | 667dbd6b | Adeodato Simo | |
57 | 667dbd6b | Adeodato Simo | The available fields and their meaning are: |
58 | 667dbd6b | Adeodato Simo | |
59 | 667dbd6b | Adeodato Simo | name |
60 | 667dbd6b | Adeodato Simo | the group name |
61 | 667dbd6b | Adeodato Simo | |
62 | 667dbd6b | Adeodato Simo | uuid |
63 | 667dbd6b | Adeodato Simo | the group's UUID |
64 | 667dbd6b | Adeodato Simo | |
65 | 667dbd6b | Adeodato Simo | node_cnt |
66 | 667dbd6b | Adeodato Simo | the number of nodes in the node group |
67 | 667dbd6b | Adeodato Simo | |
68 | 667dbd6b | Adeodato Simo | node_list |
69 | 667dbd6b | Adeodato Simo | the list of nodes that belong to this group |
70 | 667dbd6b | Adeodato Simo | |
71 | 667dbd6b | Adeodato Simo | pinst_cnt |
72 | 667dbd6b | Adeodato Simo | the number of primary instances in the group (i.e., the number of |
73 | 667dbd6b | Adeodato Simo | primary instances nodes in this group have) |
74 | 667dbd6b | Adeodato Simo | |
75 | 667dbd6b | Adeodato Simo | pinst_list |
76 | 667dbd6b | Adeodato Simo | the list of primary instances in the group |
77 | 667dbd6b | Adeodato Simo | |
78 | 4edc512c | Adeodato Simo | ctime |
79 | 4edc512c | Adeodato Simo | the creation time of the group; note that this field contains spaces |
80 | 4edc512c | Adeodato Simo | and as such it's harder to parse |
81 | 4edc512c | Adeodato Simo | |
82 | 4edc512c | Adeodato Simo | if this attribute is not present (e.g. when upgrading from older |
83 | 4edc512c | Adeodato Simo | versions), then "N/A" will be shown instead |
84 | 4edc512c | Adeodato Simo | |
85 | 4edc512c | Adeodato Simo | mtime |
86 | 4edc512c | Adeodato Simo | the last modification time of the group; note that this field |
87 | 4edc512c | Adeodato Simo | contains spaces and as such it's harder to parse |
88 | 4edc512c | Adeodato Simo | |
89 | 4edc512c | Adeodato Simo | serial_no |
90 | 4edc512c | Adeodato Simo | the so called 'serial number' of the group; this is a numeric field |
91 | 4edc512c | Adeodato Simo | that is incremented each time the node is modified, and it can be |
92 | 4edc512c | Adeodato Simo | used to detect modifications |
93 | 4edc512c | Adeodato Simo | |
94 | 667dbd6b | Adeodato Simo | If no group names are given, then all groups are included. Otherwise, |
95 | 667dbd6b | Adeodato Simo | only the named groups will be listed. |
96 | 66e884e1 | Adeodato Simo | |
97 | 66e884e1 | Adeodato Simo | RENAME |
98 | 66e884e1 | Adeodato Simo | ~~~~~~ |
99 | 66e884e1 | Adeodato Simo | |
100 | 66e884e1 | Adeodato Simo | | **rename** {*oldname*} {*newname*} |
101 | 66e884e1 | Adeodato Simo | |
102 | 66e884e1 | Adeodato Simo | Renames a given group from *oldname* to *newname*. |