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 attaching an interface depends on the interface type.

StarlingX supports three 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.

VLAN interfaces

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

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 PXE 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.

Procedure

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.