starlingx/docs
Code Issues Proposed changes
docs/doc/source/node_management/kubernetes/node_interfaces/interface-ip-address-provisioning-using-the-cli.rst
Adil ac4d8fea44 Node Management and Distributed cloud Guide updates 
Global Pass Upgrades

Added content from emails attached to ticket and sharepoint

Pacth 01: inputs from email by Greg

Patch 03: Created new section for subcloud group
          updated table 1 shared system configurations

Patch 04: corrected typos (Mary's comments)

Patch 05: solved merged conflict

patch 06: removed broken link

Story: TBD
Task: TBD



Signed-off-by: Adil <mohamed.adilassakkali@windriver.com>
Change-Id: I60b0a40a60a44d30429cd3a4dd8374c16345951a
2021-05-27 16:31:17 -03:00

3.2 KiB
Raw Blame History

Interface IP Address Provisioning Using the CLI

On a network that uses static addressing, you must assign an IP address to the interface using the system host-addr-add command.

The procedure for adding an IP address depends on the interface type.

supports the following types of interfaces:

Ethernet interfaces

These are created automatically for each port on the host. You must configure Ethernet interfaces by specifying the interface class.

Aggregated Ethernet interfaces

For link protection, you can create an aggregated Ethernet interface with two or more ports, and configure it with the interface class.

~(keystone_admin)$ system host-if-add <hostname> -m mtu -a aemode -x txhashpolicy ifname ae <ethname1> <ethname2>
VLAN interfaces

To support multiple interfaces on the same physical Ethernet or aggregated Ethernet interface, you can create interfaces and configure them with the interface class.

~(keystone_admin)$ systemhost-if-add <hostname> -V --vlan_id -c --ifclass <interfacename> <ethname>
Virtual Function interfaces

You can create an SROIV VF interface on top of an existing SROIV VF interface in order to configure a subset of virtual functions with different drivers. For example, if the ethernet SR-IOV interface is configured with the kernel VF driver, you can create a VF interface to configure a subset of virtual functions with the vfio driver that can be used with userspace libraries such as DPDK.

~(keystone_admin)$ system host-if-add -c pci-sriov <hostname> <interfacename> vf <parentinterfacename> -N numvfs --vf-driver=drivername

Logical interfaces of network types oam and mgmt cannot be deleted. They can only be modified to use different physical ports when required.

Note

On the second worker and storage nodes, the Ethernet interface for the internal management network is attached automatically to support installation using booting. On the initial controller node, the interface for the internal management network is attached according to the settings specified during the Ansible bootstrapping of the system.

  1. Lock the node.

  2. Add the IP address to the interface using the system host-addr-add command.

    ~(keystone_admin)$ system host-addr-add <node> <ifname> <ip_address> <prefix>

    where the following options are available:

    node

    The name or UUID of the worker node.

    ifname

    The name of the interface.

    ip\_address

    An IPv4 or IPv6 address.

    prefix

    The netmask length for the address.

  3. Unlock the node and wait for it to become available.