docs/doc/source/node_management/kubernetes/node_interfaces/configuring-vlan-interfaces-using-the-cli.rst

Configure VLAN Interfaces Using the CLI

You can use the CLI to attach interfaces to networks.

1. List the attached interfaces.

   To list all interfaces, use the system host-if-list command and include the -a flag.

   ~(keystone_admin)$ system host-if-list -a controller-0
    +-------------+-----------+-----------+----------+------+----------------+-------------+----------------------------+---------------------------+
   | uuid        | name      | class     | type     | vlan | ports          | uses i/f    | used by i/f                | attributes                |
   |             |           |           |          | id   |                |             |                            |                           |
   +-------------+-----------+-----------+----------+------+----------------+-------------+----------------------------+---------------------------+
   | 0aa20d82-...| sriovvf2  | pci-sriov | vf       | None | []             | [u'sriov0'] | []                         | MTU=1500,max_tx_rate=100  |
   | 0e5f162d-...| mgmt0     | platform  | vlan     | 163  | []             | [u'sriov0'] | []                         | MTU=1500                  |
   | 14f2ed53-...| sriov0    | pci-sriov | ethernet | None | [u'enp24s0f0'] | []          | [u'sriovnet1', u'oam0',    | MTU=9216                  |
   |             |           |           |          |      |                |             | u'sriovnet2', u'sriovvf2', |                           |
   |             |           |           |          |      |                |             | u'sriovvf1', u'mgmt0',     |                           |
   |             |           |           |          |      |                |             | u'pxeboot0']               |                           |
   |             |           |           |          |      |                |             |                            |                           |
   | 163592bd-...| data1     | data      | ethernet | None | [u'enp24s0f1'] | []          | []                         | MTU=1500,accelerated=True |
   | 1831571d-...| sriovnet2 | pci-sriov | vf       | None | []             | [u'sriov0'] | []                         | MTU=1956,max_tx_rate=100  |
   | 5741318f-...| eno2      | None      | ethernet | None | [u'eno2']      | []          | []                         | MTU=1500                  |
   | 5bd79fbd-...| enp26s0f0 | None      | ethernet | None | [u'enp26s0f0'] | []          | []                         | MTU=1500                  |
   | 623d5494-...| oam0      | platform  | vlan     | 103  | []             | [u'sriov0'] | []                         | MTU=1500                  |
   | 78b4080a-...| enp26s0f1 | None      | ethernet | None | [u'enp26s0f1'] | []          | []                         | MTU=1500                  |
   | a6f1f901-...| eno1      | None      | ethernet | None | [u'eno1']      | []          | []                         | MTU=1500                  |
   | f37eac1b-...| pxeboot0  | platform  | ethernet | None | []             | [u'sriov0'] | []                         | MTU=1500                  |
   | f7c62216-...| sriovnet1 | pci-sriov | vf       | None | []             | [u'sriov0'] | []                         | MTU=1500,max_tx_rate=100  |
   | fcbe3aca-...| sriovvf1  | pci-sriov | vf       | None | []             | [u'sriov0'] | []                         | MTU=1956,max_tx_rate=100  |
   +-------------+-----------+-----------+----------+------+----------------+-------------+----------------------------+---------------------------+

2. Create a interface.

   Use the following command:

   ~(keystone_admin)$ system host-if-add <hostname> -V <vlan_id> -c <ifclass> <interface name> <ethname> [<datanetwork>]

   where the following options are available:

   interface name

   A name or UUID for the interface (Required).

   Caution

   To avoid potential internal inconsistencies, do not use upper case characters when creating interface names. Some components normalize all interface names to lower case.

   vlan_id

   The identifier for the network.

   hostname

   The name or UUID of the host.

   ifclass

   The class of the interface. The valid classes are platform, data, pci-sriov, and pci-passthrough.

   ethname

   The name or UUID of the Ethernet interface to use.

   datanetworks

   A list of data networks, delimited by quotes and separated by commas; for example, "net-a, net-b". To specify a single data network, omit the quotes. This parameter is required only if the <networktype> is set to data,pci-sriov or pci-passthru.

   network

   The name or ID of the network to assign the interface to

   For example, to attach a interface named clusterhost0 with ID 22 to the cluster-host network using Ethernet interface enp0s8 on storage-0:

   ~(keystone_admin)$ system host-if-add storage-0 -V 22 -c platform clusterhost0 vlan enp0s8
   +------------------+----------------------------------------+
   | Property         | Value                                  |
   +------------------+----------------------------------------+
   | ifname           | clusterhost0                           |
   | ifclass          | platform                               |
   | iftype           | vlan                                   |
   | ports            | []                                     |
   | providernetworks | None                                   |
   | imac             | 08:00:27:f2:0d:68                      |
   | imtu             | 1500                                   |
   | aemode           | None                                   |
   | schedpolicy      | None                                   |
   | txhashpolicy     | None                                   |
   | uuid             | 8ca9854e-a18e-4a3c-8afe-f050da702fdf   |
   | ihost_uuid       | 3d207384-7d30-4bc0-affe-d68ab6a00a5b   |
   | vlan_id          | 22                                     |
   | uses             | [u'enp0s8']                            |
   | used_by          | []                                     |
   | created_at       | 2015-02-04T16:23:28.917084+00:00       |
   | updated_at       | None                                   |
   +------------------+----------------------------------------+

3. Attach the newly created interface to a network.

   Use a command of the following format:

   ~(keystone_admin)$ system interface-network-assign <hostname> <interface name> <network>

   For example:

   ~(keystone_admin)$ system interface-network-assign storage-0 clusterhost0 cluster-host