bionic (8) gnt-network.8.gz

Provided by: ganeti-2.16_2.16.0~rc2-1build1_all bug

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=*reserved-ips*]
       [--network6=*network6*]
       [--gateway6=*gateway6*]
       [--mac-prefix=*macprefix*]
       [--submit] [--print-jobid]
       [--no-conflicts-check]
       {network-name}

       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=*reserved-ips*]
       [--remove-reserved-ips=*reserved-ips*]
       [--network6=*network6*]
       [--gateway6=*gateway6*]
       [--mac-prefix=*macprefix*]
       [--submit] [--print-jobid]
       {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-jobid] {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-name...]

       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]
       [{-N|--nic-parameters} nic-param=*value*[,*nic-param*=*value*...]]
       {network} [groups...]

       Connect a network to given node groups (all if not specified) with the network parameters defined via the
       --nic-parameters option.  Every network interface will inherit those parameters if assigned to a network.

       The --no-conflicts-check option can be used to skip the check for conflicting IP addresses.

       Passing  mode  and  link  as  possitional  arguments  along with network and groups is deprecated and not
       supported any more.

   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] {network} {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 {network}

       List the tags of the given network.

   REMOVE-TAGS
       remove-tags [--from file] {network} {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-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 (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
       LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF  USE,  DATA,  OR  PROFITS;  OR  BUSINESS
       INTERRUPTION)  HOWEVER  CAUSED  AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR
       TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE  OF  THIS  SOFTWARE,  EVEN  IF
       ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.