Rename a few instance field titles

[ganeti-local] / man / gnt-group.rst

diff --git a/man/gnt-group.rst b/man/gnt-group.rst
index 777b0d2..84a2c01 100644 (file)
--- a/man/gnt-group.rst
+++ b/man/gnt-group.rst
@@ -25,15 +25,62 @@ ADD
 
 | **add**
 | [--node-parameters=*NDPARAMS*]
+| [--alloc-policy=*POLICY*]
 | {*group*}
 
 Creates a new group with the given name. The node group will be
-initially empty.
+initially empty; to add nodes to it, use ``gnt-group assign-nodes``.
 
 The ``--node-parameters`` option allows you to set default node
 parameters for nodes in the group. Please see **ganeti**(7) for more
 information about supported key=value pairs.
 
+The ``--alloc-policy`` option allows you to set an allocation policy for
+the group at creation time. Possible values are:
+
+unallocable
+    nodes in the group should not be candidates for instance allocation,
+    and the operation (e.g., instance creation) should fail if only
+    groups in this state could be found to satisfy the requirements.
+
+last_resort
+    nodes in the group should not be used for instance allocations,
+    unless this would be the only way to have the operation succeed.
+
+preferred
+    nodes in the group can be used freely for allocation of instances
+    (this is the default). Note that prioritization among groups in this
+    state will be deferred to the iallocator plugin that's being used.
+
+ASSIGN-NODES
+~~~~~~~~~~~~
+
+| **assign-nodes**
+| [--force]
+| {*group*} {*node*...}
+
+Assigns one or more nodes to the specified group, moving them from their
+original group (or groups).
+
+By default, this command will refuse to proceed if the move would split
+between groups any instance that was not previously split (a split
+instance is an instance with a mirrored disk template, e.g. DRBD, that
+has the primary and secondary nodes in different node groups). You can
+force the operation with ``--force``.
+
+MODIFY
+~~~~~~
+
+| **modify**
+| [--node-parameters=*NDPARAMS*]
+| [--alloc-policy=*POLICY*]
+| {*group*}
+
+Modifies some parameters from the node group.
+
+The ``--node-parameters`` and ``--alloc-policy`` optiosn are documented
+in the **add** command above.
+
 REMOVE
 ~~~~~~
 
@@ -81,6 +128,9 @@ pinst_cnt
 pinst_list
     the list of primary instances in the group
 
+alloc_policy
+    the current allocation policy for the group
+
 ctime
     the creation time of the group; note that this field contains spaces
     and as such it's harder to parse
@@ -100,6 +150,13 @@ serial_no
 If no group names are given, then all groups are included. Otherwise,
 only the named groups will be listed.
 
+LIST-FIELDS
+~~~~~~~~~~~
+
+**list-fields** [field...]
+
+List available fields for node groups.
+
 RENAME
 ~~~~~~