Poster of Linux kernelThe best gift for a Linux geek
gnt-group

gnt-group

Section: Version 2.4.1 (8) Updated:
Local index Up
 

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

[--node-parameters=NDPARAMS]

[--alloc-policy=POLICY]

{group}

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.

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

remove {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.  

LIST

list [--no-headers] [--separator=SEPARATOR] [-v]

[-o [+]FIELD,...] [group...]

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 to quickly see the default list plus a few other fields, instead of retyping the entire list of fields.

The available fields and their meaning are:

name
the group name
uuid
the group's UUID
node_cnt
the number of nodes in the node group
node_list
the list of nodes that belong to this group
pinst_cnt
the number of primary instances in the group (i.e., the number of primary instances nodes in this group have)
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

if this attribute is not present (e.g. when upgrading from older versions), then "N/A" will be shown instead

mtime
the last modification time of the group; note that this field contains spaces and as such it's harder to parse
serial_no
the so called 'serial number' of the group; this is a numeric field that is incremented each time the node is modified, and it can be used to detect modifications

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 {oldname} {newname}

Renames a given group from oldname to newname.  

REPORTING BUGS

Report bugs to project website (http://code.google.com/p/ganeti/) or contact the developers using the Ganeti mailing list (ganeti@googlegroups.com).  

SEE ALSO

Ganeti overview and specifications: ganeti(7) (general overview), ganeti-os-interface(7) (guest OS definitions).

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-group(8) (node group commands), gnt-backup(8) (instance import/export commands), 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-masterd(8) (master daemon), ganeti-rapi(8) (remote API daemon).  

COPYRIGHT

Copyright (C) 2006, 2007, 2008, 2009, 2010 Google Inc. Permission is granted to copy, distribute and/or modify under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL.


 

Index

Name
Synopsis
DESCRIPTION
COMMANDS
ADD
ASSIGN-NODES
MODIFY
REMOVE
LIST
LIST-FIELDS
RENAME
REPORTING BUGS
SEE ALSO
COPYRIGHT

This document was created by man2html, using the manual pages.
Time: 08:00:52 GMT, June 15, 2011