docs/doc/source/node_management/kubernetes/node_interfaces/attaching-ethernet-interfaces-to-networks-using-the-cli.rst

Attach Ethernet Interfaces to Networks Using the CLI

You can use the CLI to attach Ethernet interfaces to networks.

Ethernet interfaces are created automatically.

1. List the attached interfaces.

   For example, to list all the interfaces on the system, use the system host-if-list and include the -a flag:

   ~(keystone_admin)$ system host-if-list -a controller-1
   +-------------+-----------+-----------+----------+------+----------------+-------------+----------------------------+---------------------------+
   | 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=9000                  |
   |             |           |           |          |      |                |             | 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. Modify the interface and attach it to a network.

   Use a command sequence of the following form:

   ~(keystone_admin)$ system host-if-modify -n <ifname> -m <mtu> -c <ifclass> <hostname> <ethname> [--ipv4-mode=ip4_mode [ipv4-pool addr_pool]] [--ipv6-mode=ip6_mode [ipv6-pool addr_pool]]
   ~(keystone_admin)$ system interface-network-assign <hostname> <ifname> <network>

   where the following options are available:

   ifname

   A name for the interface.

   mtu

   The for the interface.

   ifclass

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

   network

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

   hostname

   The name or UUID of the host.

   ethname

   The name or UUID of the Ethernet interface to use.

   ip4_mode

   The mode for assigning IPv4 addresses to a data interface (static or pool.)

   ip6_mode

   The mode for assigning IPv6 addresses to a data interface (static or pool.)

   addr_pool

   The name of an IPv4 or IPv6 address pool, for use with the pool mode of IP address assignment for data interfaces.

   For valid values, see Interface Settings <interface-settings>.

   For example, to attach an interface named enp0s3 to the network, using Ethernet interface enp0s3 on controller-1:

   1. Lock the host:

      ~(keystone_admin)]$ system host-lock controller-1

   2. To modify the interface enp0s3 class type from none to platform, execute the following:

      ~(keystone_admin)$ system host-if-modify -n enp0s3 -c platform controller-1 enp0s3
      +-------------------+---------------------------------------+
      | Property          | Value                                 |
      +-------------------+---------------------------------------+
      | ifname            | enp0s3                                |
      | ifclass           | platform                              |
      | iftype            | ethernet                              |
      | ports             | [u'enp0s3']                           |
      | providernetworks  | None                                  |
      | imac              | 08:00:27:58:0c:e5                     |
      | imtu              | 1500                                  |
      | aemode            | None                                  |
      | schedpolicy       | None                                  |
      | txhashpolicy      | None                                  |
      | uuid              | 14300770-13bf-48fd-b9af-756ec7d8adc1  |
      | ihost_uuid        | e1c47086-3230-4b92-91d0-208c55130a52  |
      | vlan_id           | None                                  |
      | uses              | []                                    |
      | used_by           | []                                    |
      | created_at        | 2015-12-10T14:24:25.967362+00:00      |
      | updated_at        | 2015-12-10T17:01:08.761323+00:00      |
      | sriov_numvfs      | 0                                     |
      | accelerated       | [u'True']                             |
      +-------------------+---------------------------------------+

   3. To assign enp0s3 interface to network, execute the following:

      ~(keystone_admin)$ system interface-network-assign controller-1 enp0s3 oam

   4. Unlock the host:

      ~(keystone_admin)$ system host-unlock controller-1