1 gnt-network(8) Ganeti | Version @GANETI_VERSION@
2 ================================================
7 gnt-network - Ganeti network administration
12 **gnt-network** {command} [arguments...]
17 The **gnt-network** command is used for network definition
18 administration in the Ganeti system.
27 | [--network=*NETWORK*]
28 | [--gateway=*GATEWAY*]
29 | [--add-reserved-ips=*RESERVEDIPS*]
30 | [--network6=*NETWORK6*]
31 | [--gateway6=*GATEWAY6*]
32 | [--mac-prefix=*MACPREFIX*]
33 | [--network-type=*NETWORKTYPE*]
37 Creates a new network with the given name. The network will be unused
38 initially. To connect it to a node group, use ``gnt-network connect``.
39 ``--network`` option is mandatory. All other are optional.
41 The ``--network`` option allows you to specify the network in a CIDR
44 The ``--gateway`` option allows you to specify the default gateway for
47 The ``--network-type`` can be none, private or public.
49 IPv6 semantics can be assigned to the network via the ``--network6`` and
50 ``--gateway6`` options. IP pool is meaningless for IPV6 so those two
51 values can be used for EUI64 generation from a NIC's MAC address.
53 See **ganeti(7)** for a description of ``--submit`` and other common
60 | [--gateway=*GATEWAY*]
61 | [--add-reserved-ips=*RESERVEDIPS*]
62 | [--remove-reserved-ips=*RESERVEDIPS*]
63 | [--network6=*NETWORK6*]
64 | [--gateway6=*GATEWAY6*]
65 | [--mac-prefix=*MACPREFIX*]
66 | [--network-type=*NETWORKTYPE*]
70 Modifies parameters from the network.
72 Unable to modify network (IP address range). Create a new network if you
73 want to do so. All other options are documented in the **add** command
76 See **ganeti(7)** for a description of ``--submit`` and other common
82 | **remove** [--submit] {*network*}
84 Deletes the indicated network, which must be not connected to any node group.
86 See **ganeti(7)** for a description of ``--submit`` and other common options.
91 | **list** [--no-headers] [--separator=*SEPARATOR*] [-v]
92 | [-o *[+]FIELD,...*] [network...]
94 Lists all existing networks in the cluster. If no group names are given,
95 then all groups are included. Otherwise, only the named groups will be
98 The ``--no-headers`` option will skip the initial header line. The
99 ``--separator`` option takes an argument which denotes what will be used
100 between the output fields. Both these options are to help scripting.
102 The ``-v`` option activates verbose mode, which changes the display of
103 special field states (see **ganeti(7)**).
105 The ``-o`` option takes a comma-separated list of output fields. If the
106 value of the option starts with the character ``+``, the new fields will
107 be added to the default list. This allows to quickly see the default
108 list plus a few other fields, instead of retyping the entire list of
111 The available fields and their meaning are:
113 @QUERY_FIELDS_NETWORK@
118 **list-fields** [field...]
120 List available fields for networks.
125 | **info** [network...]
127 Displays information about a given network.
132 | **connect** {*network*} {*mode*} {*link*} [*groups*...]
134 Connect a network to given node groups (all if not specified) with the
135 network parameters *mode* and *link*. Every network interface will
136 inherit those parameters if assigned in a network.
141 | **disconnect** {*network*} [*groups*...]
143 Disconnect a network from given node groups (all if not specified). This
144 is possible only if no instance is using the network.
153 **add-tags** [\--from *file*] {*networkname*} {*tag*...}
155 Add tags to the given network. If any of the tags contains invalid
156 characters, the entire operation will abort.
158 If the ``--from`` option is given, the list of tags will be extended
159 with the contents of that file (each line becomes a tag). In this case,
160 there is not need to pass tags on the command line (if you do, both
161 sources will be used). A file name of ``-`` will be interpreted as
167 **list-tags** {*networkname*}
169 List the tags of the given network.
174 **remove-tags** [\--from *file*] {*networkname*} {*tag*...}
176 Remove tags from the given network. If any of the tags are not existing
177 on the network, the entire operation will abort.
179 If the ``--from`` option is given, the list of tags to be removed will
180 be extended with the contents of that file (each line becomes a tag). In
181 this case, there is not need to pass tags on the command line (if you
182 do, tags from both sources will be removed). A file name of ``-`` will
183 be interpreted as stdin.
185 .. vim: set textwidth=72 :