Provided by: ganeti_2.9.3-1_all 
Name
gnt-network - Ganeti network administration
Synopsis
gnt-network {command} [arguments...]
DESCRIPTION
The gnt-network command is used for network definition and administration in the Ganeti
system. Each instance NIC can be connected to a network via the network NIC parameter.
See gnt-instance(8) for more details.
BUGS
The hail iallocator hasn't been updated to take networks into account in Ganeti 2.7. The
only way to guarantee that it works correctly is having your networks connected to all
nodegroups. This will be fixed in a future version.
COMMANDS
ADD
add
[--network=NETWORK]
[--gateway=GATEWAY]
[--add-reserved-ips=RESERVEDIPS]
[--network6=NETWORK6]
[--gateway6=GATEWAY6]
[--mac-prefix=MACPREFIX]
[--submit] [--print-job-id]
[--no-conflicts-check]
{network}
Creates a new network with the given name. The network will be unused initially. To
connect it to a node group, use gnt-network connect. --network option is mandatory. All
other are optional.
The --network option allows you to specify the network in a CIDR notation.
The --gateway option allows you to specify the default gateway for this network.
IPv6 semantics can be assigned to the network via the --network6 and --gateway6 options.
IP pool is meaningless for IPV6 so those two values can be used for EUI64 generation from
a NIC's MAC address.
The --no-conflicts-check option can be used to skip the check for conflicting IP
addresses.
Note that a when connecting a network to a node group (see below) you can specify also the
NIC mode and link that will be used by instances on that group to physically connect to
this network. This allows the system to work even if the parameters (eg. the VLAN
number) change between groups.
See ganeti(7) for a description of --submit and other common options.
MODIFY
modify
[--gateway=GATEWAY]
[--add-reserved-ips=RESERVEDIPS]
[--remove-reserved-ips=RESERVEDIPS]
[--network6=NETWORK6]
[--gateway6=GATEWAY6]
[--mac-prefix=MACPREFIX]
[--submit] [--print-job-id]
{network}
Modifies parameters from the network.
Unable to modify network (IP address range). Create a new network if you want to do so.
All other options are documented in the add command above.
See ganeti(7) for a description of --submit and other common options.
REMOVE
remove [--submit] [--print-job-id] {network}
Deletes the indicated network, which must be not connected to any node group.
See ganeti(7) for a description of --submit and other common options.
LIST
list [--no-headers] [--separator=SEPARATOR] [-v]
[-o [+]FIELD,...] [network...]
Lists all existing networks in the cluster. If no group names are given, then all groups
are included. Otherwise, only the named groups will be listed.
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:
ctime Creation timestamp
external_reservations
External reservations
free_count
Number of available addresses
gateway
IPv4 gateway
gateway6
IPv6 gateway
group_cnt
Number of nodegroups
group_list
List of nodegroups (group name, NIC mode, NIC link)
inst_cnt
Number of instances
inst_list
List of instances
mac_prefix
MAC address prefix
map Actual mapping
mtime Modification timestamp
name Name
network
IPv4 subnet
network6
IPv6 subnet
reserved_count
Number of reserved addresses
serial_no
Network object serial number, incremented on each modification
tags Tags
uuid Network UUID
LIST-FIELDS
list-fields [field...]
List available fields for networks.
INFO
info [network...]
Displays information about a given network.
CONNECT
connect
[--no-conflicts-check]
{network} {mode} {link} [groups...]
Connect a network to given node groups (all if not specified) with the network parameters
mode and link. Every network interface will inherit those parameters if assigned in a
network.
The --no-conflicts-check option can be used to skip the check for conflicting IP
addresses.
DISCONNECT
disconnect {network} [groups...]
Disconnect a network from given node groups (all if not specified). This is possible only
if no instance is using the network.
Tags
ADD-TAGS
add-tags [--from file] {networkname} {tag...}
Add tags to the given network. 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 {networkname}
List the tags of the given network.
REMOVE-TAGS
remove-tags [--from file] {networkname} {tag...}
Remove tags from the given network. If any of the tags are not existing on the network,
the entire operation 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.
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-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-storage(8) (storage 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).
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, 2007, 2008, 2009, 2010, 2011, 2012 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.