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