.. ecd1551800000867
.. _configuring-vlan-interfaces-using-the-cli:

=======================================
Configure VLAN Interfaces Using the CLI
=======================================

You can use the CLI to attach |VLAN| interfaces to networks.

.. rubric:: |proc|

.. _configuring-vlan-interfaces-using-the-cli-steps-rf5-5wh-lkb:

#.  List the attached interfaces.

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

    .. code-block:: none

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


#.  Create a |VLAN| interface.

    Use the following command:

    .. code-block:: none

        ~(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 |VLAN| 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 |VLAN| interface named **clusterhost0** with
    |VLAN| ID **22** to the cluster-host network using Ethernet interface
    **enp0s8** on **storage-0**:

    .. code-block:: none

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

#.  Attach the newly created |VLAN| interface to a network.

    Use a command of the following format:

    .. code-block:: none

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

    For example:

    .. code-block:: none

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