starlingx/docs
Code Issues Proposed changes
Files
53c952a04eb42f73e23a31ed0f96ca51fd649419
docs/doc/source/datanet/openstack/configuring-data-interfaces.rst
Ron Stone f125a8b892 Remove spurious escapes (r8,dsR8) 
This change addresses a long-standing issue in rST documentation imported from XML.
That import process added backslash escapes in front of various characters. The three
most common being '(', ')', and '_'.
These instances are removed.

Signed-off-by: Ron Stone <ronald.stone@windriver.com>
Change-Id: Id43a9337ffcd505ccbdf072d7b29afdb5d2c997e
2023-03-01 11:19:04 +00:00

8.3 KiB
Raw Blame History

Configure Data Interfaces

A data class interface attaches the host to a data network providing the underlying network for OpenStack Neutron Tenant/Project Networks.

For each of the above procedures, configure the node interface specifying the 'ifclass' as 'data' and assign one or more data networks to the node interface.

  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. Attach an interface 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-datanetwork-assign <hostname> <ifname> <data network>

    where the following options are available:

    ifname

    A name for the interface.

    mtu

    The MTU for the interface.

    Note

    The must be equal to or larger than the of the data network to which the interface is attached.

    ifclass

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

    data network

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

    hostname

    The name or of the host.

    ethname

    The name or 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.