root / man / gnt-group.rst @ d2d3935a
History | View | Annotate | Download (8 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 | dcbeccd9 | Michael Hanselmann | | **add** [\--submit] |
27 | e8f936b0 | Iustin Pop | | [\--node-parameters=*NDPARAMS*] |
28 | e8f936b0 | Iustin Pop | | [\--alloc-policy=*POLICY*] |
29 | e8f936b0 | Iustin Pop | | [{-D|\--disk-parameters} *disk-template*:*disk-param*=*value*[,*disk-param*=*value*...]] |
30 | e8f936b0 | Iustin Pop | | [\--specs-cpu-count *spec-param*=*value* [,*spec-param*=*value*...]] |
31 | e8f936b0 | Iustin Pop | | [\--specs-disk-count *spec-param*=*value* [,*spec-param*=*value*...]] |
32 | e8f936b0 | Iustin Pop | | [\--specs-disk-size *spec-param*=*value* [,*spec-param*=*value*...]] |
33 | e8f936b0 | Iustin Pop | | [\--specs-mem-size *spec-param*=*value* [,*spec-param*=*value*...]] |
34 | e8f936b0 | Iustin Pop | | [\--specs-nic-count *spec-param*=*value* [,*spec-param*=*value*...]] |
35 | d2d3935a | Bernardo Dal Seno | | [\--ipolicy-bounds-specs *bound_ispecs*] |
36 | bfb1d750 | Ben Lipton | | [\--ipolicy-disk-templates *template* [,*template*...]] |
37 | d307d38c | Bernardo Dal Seno | | [\--ipolicy-spindle-ratio *ratio*] |
38 | d307d38c | Bernardo Dal Seno | | [\--ipolicy-vcpu-ratio *ratio*] |
39 | e8f936b0 | Iustin Pop | | [\--disk-state *diskstate*] |
40 | e8f936b0 | Iustin Pop | | [\--hypervisor-state *hvstate*] |
41 | 483be60d | Adeodato Simo | | {*group*} |
42 | 66e884e1 | Adeodato Simo | |
43 | 66e884e1 | Adeodato Simo | Creates a new group with the given name. The node group will be |
44 | 919852da | Adeodato Simo | initially empty; to add nodes to it, use ``gnt-group assign-nodes``. |
45 | 66e884e1 | Adeodato Simo | |
46 | 483be60d | Adeodato Simo | The ``--node-parameters`` option allows you to set default node |
47 | 354c4f62 | Michael Hanselmann | parameters for nodes in the group. Please see **ganeti**\(7) for more |
48 | e4c03256 | René Nussbaumer | information about supported key=value pairs and their corresponding |
49 | e4c03256 | René Nussbaumer | options. |
50 | 483be60d | Adeodato Simo | |
51 | 90e99856 | Adeodato Simo | The ``--alloc-policy`` option allows you to set an allocation policy for |
52 | 90e99856 | Adeodato Simo | the group at creation time. Possible values are: |
53 | 90e99856 | Adeodato Simo | |
54 | 90e99856 | Adeodato Simo | unallocable |
55 | 90e99856 | Adeodato Simo | nodes in the group should not be candidates for instance allocation, |
56 | 90e99856 | Adeodato Simo | and the operation (e.g., instance creation) should fail if only |
57 | 90e99856 | Adeodato Simo | groups in this state could be found to satisfy the requirements. |
58 | 90e99856 | Adeodato Simo | |
59 | 90e99856 | Adeodato Simo | last_resort |
60 | 90e99856 | Adeodato Simo | nodes in the group should not be used for instance allocations, |
61 | 90e99856 | Adeodato Simo | unless this would be the only way to have the operation succeed. |
62 | 90e99856 | Adeodato Simo | |
63 | 90e99856 | Adeodato Simo | preferred |
64 | 90e99856 | Adeodato Simo | nodes in the group can be used freely for allocation of instances |
65 | 90e99856 | Adeodato Simo | (this is the default). Note that prioritization among groups in this |
66 | 90e99856 | Adeodato Simo | state will be deferred to the iallocator plugin that's being used. |
67 | 90e99856 | Adeodato Simo | |
68 | a46b1883 | Andrea Spadaccini | The ``-D (--disk-parameters)`` option allows you to set the disk |
69 | a46b1883 | Andrea Spadaccini | parameters for the node group; please see the section about |
70 | 354c4f62 | Michael Hanselmann | **gnt-cluster add** in **gnt-cluster**\(8) for more information about |
71 | a46b1883 | Andrea Spadaccini | disk parameters |
72 | a46b1883 | Andrea Spadaccini | |
73 | d307d38c | Bernardo Dal Seno | The ``--specs-...`` and ``--ipolicy-...`` options specify instance |
74 | d307d38c | Bernardo Dal Seno | policies on the node group, and are documented in the |
75 | 354c4f62 | Michael Hanselmann | **gnt-cluster**\(8) man page. |
76 | d6033c14 | Agata Murawska | |
77 | 354c4f62 | Michael Hanselmann | See **ganeti**\(7) for a description of ``--submit`` and other common |
78 | dcbeccd9 | Michael Hanselmann | options. |
79 | dcbeccd9 | Michael Hanselmann | |
80 | 919852da | Adeodato Simo | ASSIGN-NODES |
81 | 919852da | Adeodato Simo | ~~~~~~~~~~~~ |
82 | 919852da | Adeodato Simo | |
83 | 919852da | Adeodato Simo | | **assign-nodes** |
84 | dcbeccd9 | Michael Hanselmann | | [\--force] [\--submit] |
85 | 919852da | Adeodato Simo | | {*group*} {*node*...} |
86 | 919852da | Adeodato Simo | |
87 | 919852da | Adeodato Simo | Assigns one or more nodes to the specified group, moving them from their |
88 | 919852da | Adeodato Simo | original group (or groups). |
89 | 919852da | Adeodato Simo | |
90 | 919852da | Adeodato Simo | By default, this command will refuse to proceed if the move would split |
91 | 919852da | Adeodato Simo | between groups any instance that was not previously split (a split |
92 | 919852da | Adeodato Simo | instance is an instance with a mirrored disk template, e.g. DRBD, that |
93 | 919852da | Adeodato Simo | has the primary and secondary nodes in different node groups). You can |
94 | 919852da | Adeodato Simo | force the operation with ``--force``. |
95 | 90e99856 | Adeodato Simo | |
96 | 354c4f62 | Michael Hanselmann | See **ganeti**\(7) for a description of ``--submit`` and other common |
97 | dcbeccd9 | Michael Hanselmann | options. |
98 | dcbeccd9 | Michael Hanselmann | |
99 | 4da7909a | Adeodato Simo | MODIFY |
100 | 4da7909a | Adeodato Simo | ~~~~~~ |
101 | 4da7909a | Adeodato Simo | |
102 | dcbeccd9 | Michael Hanselmann | | **modify** [\--submit] |
103 | e8f936b0 | Iustin Pop | | [\--node-parameters=*NDPARAMS*] |
104 | e8f936b0 | Iustin Pop | | [\--alloc-policy=*POLICY*] |
105 | e8f936b0 | Iustin Pop | | [\--hypervisor-state *hvstate*] |
106 | e8f936b0 | Iustin Pop | | [{-D|\--disk-parameters} *disk-template*:*disk-param*=*value*[,*disk-param*=*value*...]] |
107 | e8f936b0 | Iustin Pop | | [\--disk-state *diskstate*] |
108 | e8f936b0 | Iustin Pop | | [\--specs-cpu-count *spec-param*=*value* [,*spec-param*=*value*...]] |
109 | e8f936b0 | Iustin Pop | | [\--specs-disk-count *spec-param*=*value* [,*spec-param*=*value*...]] |
110 | e8f936b0 | Iustin Pop | | [\--specs-disk-size *spec-param*=*value* [,*spec-param*=*value*...]] |
111 | e8f936b0 | Iustin Pop | | [\--specs-mem-size *spec-param*=*value* [,*spec-param*=*value*...]] |
112 | e8f936b0 | Iustin Pop | | [\--specs-nic-count *spec-param*=*value* [,*spec-param*=*value*...]] |
113 | d2d3935a | Bernardo Dal Seno | | [\--ipolicy-bounds-specs *bound_ispecs*] |
114 | bfb1d750 | Ben Lipton | | [\--ipolicy-disk-templates *template* [,*template*...]] |
115 | d307d38c | Bernardo Dal Seno | | [\--ipolicy-spindle-ratio *ratio*] |
116 | d307d38c | Bernardo Dal Seno | | [\--ipolicy-vcpu-ratio *ratio*] |
117 | 4da7909a | Adeodato Simo | | {*group*} |
118 | 4da7909a | Adeodato Simo | |
119 | 4da7909a | Adeodato Simo | Modifies some parameters from the node group. |
120 | 4da7909a | Adeodato Simo | |
121 | a8282327 | René Nussbaumer | The ``--node-parameters`` and ``--alloc-policy`` options are documented |
122 | a8282327 | René Nussbaumer | in the **add** command above. ``--hypervisor-state`` as well as |
123 | 354c4f62 | Michael Hanselmann | ``--disk-state`` are documented in detail in **ganeti**\(7). |
124 | 4da7909a | Adeodato Simo | |
125 | d6033c14 | Agata Murawska | The ``--node-parameters``, ``--alloc-policy``, ``-D |
126 | 0ce212e5 | Iustin Pop | (--disk-parameters)`` options are documented in the **add** command |
127 | 0ce212e5 | Iustin Pop | above. |
128 | 0ce212e5 | Iustin Pop | |
129 | d307d38c | Bernardo Dal Seno | The ``--specs-...`` and ``--ipolicy-...`` options specify instance |
130 | d307d38c | Bernardo Dal Seno | policies on the node group, and are documented in the |
131 | 354c4f62 | Michael Hanselmann | **gnt-cluster**\(8) man page. |
132 | a46b1883 | Andrea Spadaccini | |
133 | 354c4f62 | Michael Hanselmann | See **ganeti**\(7) for a description of ``--submit`` and other common |
134 | dcbeccd9 | Michael Hanselmann | options. |
135 | dcbeccd9 | Michael Hanselmann | |
136 | 66e884e1 | Adeodato Simo | REMOVE |
137 | 66e884e1 | Adeodato Simo | ~~~~~~ |
138 | 66e884e1 | Adeodato Simo | |
139 | dcbeccd9 | Michael Hanselmann | | **remove** [\--submit] {*group*} |
140 | 66e884e1 | Adeodato Simo | |
141 | a7c5085d | Stephen Shirley | Deletes the indicated node group, which must be empty. There must always be at |
142 | a7c5085d | Stephen Shirley | least one group, so the last group cannot be removed. |
143 | 66e884e1 | Adeodato Simo | |
144 | 354c4f62 | Michael Hanselmann | See **ganeti**\(7) for a description of ``--submit`` and other common |
145 | dcbeccd9 | Michael Hanselmann | options. |
146 | dcbeccd9 | Michael Hanselmann | |
147 | 667dbd6b | Adeodato Simo | LIST |
148 | 667dbd6b | Adeodato Simo | ~~~~ |
149 | 667dbd6b | Adeodato Simo | |
150 | e8f936b0 | Iustin Pop | | **list** [\--no-headers] [\--separator=*SEPARATOR*] [-v] |
151 | e8f936b0 | Iustin Pop | | [-o *[+]FIELD,...*] [\--filter] [group...] |
152 | 667dbd6b | Adeodato Simo | |
153 | 667dbd6b | Adeodato Simo | Lists all existing node groups in the cluster. |
154 | 667dbd6b | Adeodato Simo | |
155 | 667dbd6b | Adeodato Simo | The ``--no-headers`` option will skip the initial header line. The |
156 | 667dbd6b | Adeodato Simo | ``--separator`` option takes an argument which denotes what will be |
157 | 667dbd6b | Adeodato Simo | used between the output fields. Both these options are to help |
158 | 667dbd6b | Adeodato Simo | scripting. |
159 | 667dbd6b | Adeodato Simo | |
160 | f0b1bafe | Iustin Pop | The ``-v`` option activates verbose mode, which changes the display of |
161 | 354c4f62 | Michael Hanselmann | special field states (see **ganeti**\(7)). |
162 | f0b1bafe | Iustin Pop | |
163 | 667dbd6b | Adeodato Simo | The ``-o`` option takes a comma-separated list of output fields. |
164 | 667dbd6b | Adeodato Simo | If the value of the option starts with the character ``+``, the new |
165 | f7b769b1 | Iustin Pop | fields will be added to the default list. This allows one to quickly |
166 | 667dbd6b | Adeodato Simo | see the default list plus a few other fields, instead of retyping |
167 | 667dbd6b | Adeodato Simo | the entire list of fields. |
168 | 667dbd6b | Adeodato Simo | |
169 | 667dbd6b | Adeodato Simo | The available fields and their meaning are: |
170 | 667dbd6b | Adeodato Simo | |
171 | fcdb582d | Michael Hanselmann | @QUERY_FIELDS_GROUP@ |
172 | 4edc512c | Adeodato Simo | |
173 | 1b1a08e8 | Michael Hanselmann | If exactly one argument is given and it appears to be a query filter |
174 | 354c4f62 | Michael Hanselmann | (see **ganeti**\(7)), the query result is filtered accordingly. For |
175 | 1b1a08e8 | Michael Hanselmann | ambiguous cases (e.g. a single field name as a filter) the ``--filter`` |
176 | 1b1a08e8 | Michael Hanselmann | (``-F``) option forces the argument to be treated as a filter. |
177 | 1b1a08e8 | Michael Hanselmann | |
178 | 667dbd6b | Adeodato Simo | If no group names are given, then all groups are included. Otherwise, |
179 | 667dbd6b | Adeodato Simo | only the named groups will be listed. |
180 | 66e884e1 | Adeodato Simo | |
181 | ca4ac9c9 | Adeodato Simo | LIST-FIELDS |
182 | ca4ac9c9 | Adeodato Simo | ~~~~~~~~~~~ |
183 | ca4ac9c9 | Adeodato Simo | |
184 | ca4ac9c9 | Adeodato Simo | **list-fields** [field...] |
185 | ca4ac9c9 | Adeodato Simo | |
186 | ca4ac9c9 | Adeodato Simo | List available fields for node groups. |
187 | ca4ac9c9 | Adeodato Simo | |
188 | 66e884e1 | Adeodato Simo | RENAME |
189 | 66e884e1 | Adeodato Simo | ~~~~~~ |
190 | 66e884e1 | Adeodato Simo | |
191 | dcbeccd9 | Michael Hanselmann | | **rename** [\--submit] {*oldname*} {*newname*} |
192 | 66e884e1 | Adeodato Simo | |
193 | 66e884e1 | Adeodato Simo | Renames a given group from *oldname* to *newname*. |
194 | 9ff4f2c0 | Michael Hanselmann | |
195 | 354c4f62 | Michael Hanselmann | See **ganeti**\(7) for a description of ``--submit`` and other common |
196 | dcbeccd9 | Michael Hanselmann | options. |
197 | dcbeccd9 | Michael Hanselmann | |
198 | 819cbfe5 | Michael Hanselmann | |
199 | f6eb380d | Michael Hanselmann | EVACUATE |
200 | f6eb380d | Michael Hanselmann | ~~~~~~~~ |
201 | f6eb380d | Michael Hanselmann | |
202 | dcbeccd9 | Michael Hanselmann | **evacuate** [\--submit] [\--iallocator *NAME*] [\--to *GROUP*...] {*group*} |
203 | f6eb380d | Michael Hanselmann | |
204 | f6eb380d | Michael Hanselmann | This command will move all instances out of the given node group. |
205 | f6eb380d | Michael Hanselmann | Instances are placed in a new group by an iallocator, either given on |
206 | f6eb380d | Michael Hanselmann | the command line or as a cluster default. |
207 | f6eb380d | Michael Hanselmann | |
208 | f6eb380d | Michael Hanselmann | If no specific destination groups are specified using ``--to``, all |
209 | f6eb380d | Michael Hanselmann | groups except the evacuated group are considered. |
210 | f6eb380d | Michael Hanselmann | |
211 | 354c4f62 | Michael Hanselmann | See **ganeti**\(7) for a description of ``--submit`` and other common |
212 | dcbeccd9 | Michael Hanselmann | options. |
213 | dcbeccd9 | Michael Hanselmann | |
214 | f6eb380d | Michael Hanselmann | Example:: |
215 | f6eb380d | Michael Hanselmann | |
216 | f6eb380d | Michael Hanselmann | # gnt-group evacuate -I hail --to rack4 rack1 |
217 | f6eb380d | Michael Hanselmann | |
218 | f6eb380d | Michael Hanselmann | |
219 | fa5121f0 | Iustin Pop | Tags |
220 | 819cbfe5 | Michael Hanselmann | ~~~~ |
221 | 819cbfe5 | Michael Hanselmann | |
222 | 819cbfe5 | Michael Hanselmann | ADD-TAGS |
223 | 819cbfe5 | Michael Hanselmann | ^^^^^^^^ |
224 | 819cbfe5 | Michael Hanselmann | |
225 | e8f936b0 | Iustin Pop | **add-tags** [\--from *file*] {*groupname*} {*tag*...} |
226 | 819cbfe5 | Michael Hanselmann | |
227 | 819cbfe5 | Michael Hanselmann | Add tags to the given node group. If any of the tags contains invalid |
228 | 819cbfe5 | Michael Hanselmann | characters, the entire operation will abort. |
229 | 819cbfe5 | Michael Hanselmann | |
230 | 819cbfe5 | Michael Hanselmann | If the ``--from`` option is given, the list of tags will be extended |
231 | 819cbfe5 | Michael Hanselmann | with the contents of that file (each line becomes a tag). In this case, |
232 | 819cbfe5 | Michael Hanselmann | there is not need to pass tags on the command line (if you do, both |
233 | 819cbfe5 | Michael Hanselmann | sources will be used). A file name of ``-`` will be interpreted as |
234 | 819cbfe5 | Michael Hanselmann | stdin. |
235 | 819cbfe5 | Michael Hanselmann | |
236 | 819cbfe5 | Michael Hanselmann | LIST-TAGS |
237 | 819cbfe5 | Michael Hanselmann | ^^^^^^^^^ |
238 | 819cbfe5 | Michael Hanselmann | |
239 | 819cbfe5 | Michael Hanselmann | **list-tags** {*groupname*} |
240 | 819cbfe5 | Michael Hanselmann | |
241 | 819cbfe5 | Michael Hanselmann | List the tags of the given node group. |
242 | 819cbfe5 | Michael Hanselmann | |
243 | 819cbfe5 | Michael Hanselmann | REMOVE-TAGS |
244 | 819cbfe5 | Michael Hanselmann | ^^^^^^^^^^^ |
245 | 819cbfe5 | Michael Hanselmann | |
246 | e8f936b0 | Iustin Pop | **remove-tags** [\--from *file*] {*groupname*} {*tag*...} |
247 | 819cbfe5 | Michael Hanselmann | |
248 | 819cbfe5 | Michael Hanselmann | Remove tags from the given node group. If any of the tags are not |
249 | 819cbfe5 | Michael Hanselmann | existing on the node, the entire operation will abort. |
250 | 819cbfe5 | Michael Hanselmann | |
251 | 819cbfe5 | Michael Hanselmann | If the ``--from`` option is given, the list of tags to be removed will |
252 | 819cbfe5 | Michael Hanselmann | be extended with the contents of that file (each line becomes a tag). In |
253 | 819cbfe5 | Michael Hanselmann | this case, there is not need to pass tags on the command line (if you |
254 | 819cbfe5 | Michael Hanselmann | do, tags from both sources will be removed). A file name of ``-`` will |
255 | 819cbfe5 | Michael Hanselmann | be interpreted as stdin. |
256 | 819cbfe5 | Michael Hanselmann | |
257 | 216d23c0 | René Nussbaumer | INFO |
258 | 216d23c0 | René Nussbaumer | ~~~~ |
259 | 216d23c0 | René Nussbaumer | |
260 | 216d23c0 | René Nussbaumer | **info** [group...] |
261 | 216d23c0 | René Nussbaumer | |
262 | 216d23c0 | René Nussbaumer | Shows config information for all (or given) groups. |
263 | 216d23c0 | René Nussbaumer | |
264 | 216d23c0 | René Nussbaumer | |
265 | 9ff4f2c0 | Michael Hanselmann | .. vim: set textwidth=72 : |
266 | 9ff4f2c0 | Michael Hanselmann | .. Local Variables: |
267 | 9ff4f2c0 | Michael Hanselmann | .. mode: rst |
268 | 9ff4f2c0 | Michael Hanselmann | .. fill-column: 72 |
269 | 9ff4f2c0 | Michael Hanselmann | .. End: |