.. khl1551798962540
.. _attaching-ethernet-interfaces-to-networks-using-the-cli:

====================================================
Attach Ethernet Interfaces to Networks Using the CLI
====================================================

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

Ethernet interfaces are created automatically.

.. rubric:: |proc|

.. _attaching-ethernet-interfaces-to-networks-using-the-cli-steps-twz-gsh-lkb:

#.  List the attached interfaces.

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

    .. code-block:: none

        ~(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  |
        +-------------+-----------+-----------+----------+------+----------------+-------------+----------------------------+---------------------------+

#.  Modify the interface and attach it to a network.

    Use a command sequence of the following form:

    .. code-block:: none

        ~(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 |MTU| 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 :ref:`Interface Settings <interface-settings>`.

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

    #.  Lock the host:

        .. code-block:: none

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

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

        .. code-block:: none

            ~(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']                             |
            +-------------------+---------------------------------------+

    #.  To assign enp0s3 interface to |OAM| network, execute the following:

        .. code-block:: none

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

    #.  Unlock the host:

        .. code-block:: none

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

Interface Network Configuration for PCI-SRIOV Interfaces
--------------------------------------------------------

Platform networks must be associated with platform interfaces. If a platform
network needs to be associated with a |PCI|-|SRIOV| type interface, a logical
platform interface must be created that references the |PCI|-|SRIOV| interface.
In this case, the platform network functions as a standard platform interface.
This ensures consistent configuration between the platform network and its
associated platform interface. This procedure does not consume additional
physical system resources.

In the following example, the platform interface **pxeboot0** references
the **sriov0** interface.

.. code-block:: none

    ~(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  |
    +-------------+-----------+-----------+----------+------+----------------+-------------+----------------------------+---------------------------+

Then, the **pxeboot** network must be associated with the **pxeboot0** platform
interface.

.. code-block:: none

    ~(keystone_admin)$ system interface-network-assign controller-1 pxeboot0 pxeboot