Provided by: ganeti-3.0_3.0.2-1ubuntu1_all 
Name
gnt-group - Ganeti node-group administration
Synopsis
gnt-group {command} [arguments...]
DESCRIPTION
The gnt-group command is used for node group administration in the Ganeti system.
COMMANDS
ADD
add [--submit] [--print-jobid]
[--node-parameters=*NDPARAMS*]
[--alloc-policy=*POLICY*]
[{-D|--disk-parameters} disk-template:disk-param=*value*[,*disk-param*=*value*...]]
[--ipolicy-bounds-specs bound_ispecs]
[--ipolicy-disk-templates template [,*template*...]]
[--ipolicy-spindle-ratio ratio]
[--ipolicy-vcpu-ratio ratio]
[--disk-state diskstate]
[--hypervisor-state hvstate]
{group-name}
Creates a new group with the given name. The node group will be 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 and their corresponding options.
The --alloc-policy option allows you to set an allocation policy for the group at creation time. Possi‐
ble values are:
unallocable
nodes in the group should not be candidates for instance allocation, and the operation (e.g., in‐
stance creation) should fail if only groups in this state could be found to satisfy the require‐
ments.
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.
The -D (--disk-parameters) option allows you to set the disk parameters for the node group; please see
the section about gnt-cluster add in gnt-cluster(8) for more information about disk parameters
The --ipolicy-... options specify instance policies on the node group, and are documented in the gnt-
cluster(8) man page.
See ganeti(7) for a description of --submit and other common options.
ASSIGN-NODES
assign-nodes
[--force] [--submit] [--print-jobid]
{group-name} {node-name...}
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.
See ganeti(7) for a description of --submit and other common options.
MODIFY
modify [--submit] [--print-jobid]
[--node-parameters=*NDPARAMS*]
[--alloc-policy=*POLICY*]
[--hypervisor-state hvstate]
[{-D|--disk-parameters} disk-template:disk-param=*value*[,*disk-param*=*value*...]]
[--disk-state diskstate]
[--ipolicy-bounds-specs bound_ispecs]
[--ipolicy-disk-templates template [,*template*...]]
[--ipolicy-spindle-ratio ratio]
[--ipolicy-vcpu-ratio ratio]
{group}
Modifies some parameters from the node group.
The --node-parameters and --alloc-policy options are documented in the add command above. --hypervisor-
state as well as --disk-state are documented in detail in ganeti(7).
The --node-parameters, --alloc-policy, -D (--disk-parameters) options are documented in the add command
above.
The --ipolicy-... options specify instance policies on the node group, and are documented in the gnt-
cluster(8) man page.
See ganeti(7) for a description of --submit and other common options.
REMOVE
remove [--submit] [--print-jobid] {group}
Deletes the indicated node group, which must be empty. There must always be at least one group, so the
last group cannot be removed.
See ganeti(7) for a description of --submit and other common options.
LIST
list [--no-headers] [--separator=*SEPARATOR*] [-v]
[-o [+]FIELD,...] [--filter] [group-name...]
Lists all existing node groups in the cluster.
The --no-headers option will skip the initial header line. The --separator option takes an argument
which denotes what will be used between the output fields. Both these options are to help scripting.
The -v option activates verbose mode, which changes the display of special field states (see ganeti(7)).
The -o option takes a comma-separated list of output fields. If the value of the option starts with the
character +, the new fields will be added to the default list. This allows one to quickly see the de‐
fault list plus a few other fields, instead of retyping the entire list of fields.
The available fields and their meaning are:
alloc_policy
Allocation policy for group
ctime Creation timestamp
custom_diskparams
Custom disk parameters
custom_ipolicy
Custom instance policy limitations
custom_ndparams
Custom node parameters
diskparams
Disk parameters (merged)
ipolicy
Instance policy limitations (merged)
mtime Modification timestamp
name Group name
ndp/cpu_speed
The "cpu_speed" node parameter
ndp/exclusive_storage
The "exclusive_storage" node parameter
ndp/oob_program
The "oob_program" node parameter
ndp/ovs
The "ovs" node parameter
ndp/ovs_link
The "ovs_link" node parameter
ndp/ovs_name
The "ovs_name" node parameter
ndp/spindle_count
The "spindle_count" node parameter
ndp/ssh_port
The "ssh_port" node parameter
ndparams
Node parameters
node_cnt
Number of nodes
node_list
List of nodes
pinst_cnt
Number of primary instances
pinst_list
List of primary instances
serial_no
Group object serial number, incremented on each modification
tags Tags
uuid Group UUID
If exactly one argument is given and it appears to be a query filter (see ganeti(7)), the query result is
filtered accordingly. For ambiguous cases (e.g. a single field name as a filter) the --filter (-F) op‐
tion forces the argument to be treated as a filter.
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
rename [--submit] [--print-jobid] {oldname} {newname}
Renames a given group from oldname to newname.
See ganeti(7) for a description of --submit and other common options.
EVACUATE
evacuate [--submit] [--print-jobid] [--sequential] [--force-failover]
[--iallocator name] [--to group...] {source-group}
This command will move all instances out of the given node group. Instances are placed in a new group by
an iallocator, either given on the command line or as a cluster default.
If no specific destination groups are specified using --to, all groups except the evacuated group are
considered.
The moves of the individual instances are handled as separate jobs to allow for maximal parallelism. If
the --sequential option is given, the moves of the individual instances will be executed sequentially.
This can be useful if the link between the groups is vulnerable to congestion. If the --force-failover
option is given, no migrations will be made. This might be necessary if the group being evacuated is too
different from the other groups in the cluster.
See ganeti(7) for a description of --submit and other common options.
Example:
# gnt-group evacuate -I hail --to rack4 rack1
Tags
ADD-TAGS
add-tags [--from file] {group} {tag...}
Add tags to the given node group. If any of the tags contains invalid characters, the entire operation
will abort.
If the --from option is given, the list of tags will be extended with the contents of that file (each
line becomes a tag). In this case, there is not need to pass tags on the command line (if you do, both
sources will be used). A file name of - will be interpreted as stdin.
LIST-TAGS
list-tags {group}
List the tags of the given node group.
REMOVE-TAGS
remove-tags [--from file] {group} {tag...}
Remove tags from the given node group. If any of the tags are not existing on the node, the entire oper‐
ation will abort.
If the --from option is given, the list of tags to be removed will be extended with the contents of that
file (each line becomes a tag). In this case, there is not need to pass tags on the command line (if you
do, tags from both sources will be removed). A file name of - will be interpreted as stdin.
INFO
info [group...]
Shows config information for all (or given) groups.
SHOW-ISPECS-CMD
show-ispecs-cmd [--include-defaults] [group...]
Shows the command line that can be used to recreate the given groups (or all groups, if none is given)
with the same options relative to specs in the instance policies.
If --include-defaults is specified, include also the default values (i.e. the cluster-level settings),
and not only the configuration items that a group overrides.
REPORTING BUGS
Report bugs to the project's issue tracker (https://github.com/ganeti/ganeti/issues) or contact the de‐
velopers using the Ganeti mailing list.
SEE ALSO
Ganeti overview and specifications: ganeti(7) (general overview), ganeti-os-interface(7) (guest OS defin‐
itions), ganeti-extstorage-interface(7) (external storage providers).
Ganeti commands: gnt-cluster(8) (cluster-wide commands), gnt-job(8) (job-related commands), gnt-node(8)
(node-related commands), gnt-instance(8) (instance commands), gnt-os(8) (guest OS commands), gnt-stor‐
age(8) (storage commands), gnt-group(8) (node group commands), gnt-backup(8) (instance import/export com‐
mands), gnt-debug(8) (debug commands).
Ganeti daemons: ganeti-watcher(8) (automatic instance restarter), ganeti-cleaner(8) (job queue cleaner),
ganeti-noded(8) (node daemon), ganeti-rapi(8) (remote API daemon).
Ganeti htools: htools(1) (generic binary), hbal(1) (cluster balancer), hspace(1) (capacity calculation),
hail(1) (IAllocator plugin), hscan(1) (data gatherer from remote clusters), hinfo(1) (cluster information
printer), mon-collector(7) (data collectors interface).
COPYRIGHT
Copyright (C) 2006-2015 Google Inc. All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted provided
that the following conditions are met:
1. Redistributions of source code must retain the above copyright notice, this list of conditions and
the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and
the following disclaimer in the documentation and/or other materials provided with the distribution.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED
WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMIT‐
ED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUP‐
TION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (IN‐
CLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
THE POSSIBILITY OF SUCH DAMAGE.
Ganeti gnt-group(8)