docs/doc/source/node_management/kubernetes/node_interfaces/changing-a-management-interface-to-aggregated-using-the-cli.rst

Change a Management Interface to Aggregated Using the CLI

When worker and storage nodes are provisioned, the Ethernet interface used for booting is automatically assigned to the internal management network.

To configure a management interface you first need to remove the internal management network type from the existing management Ethernet interface and then add a new interface, specifying the mgmt network type, ae interface type, 802.3 mode, transmit hash policy and the standby interfaces.

The node must be locked to edit an interface.

1. From the command line, delete and then recreate the management interface.

   ~(keystone_admin)$ system host-if-modify -c <node> <interface>

   where the following options are available:

   node

   The name of the node from which to delete an interface.

   interface

   The Ethernet interface to delete.

2. Create the new interface.

   1. Add the interface to the host.

      ~(keystone_admin)$ system host-if-add -c platform -a 802.3ad -x layer2 <node> <interface> ae <ports>

   2. Assign the interface to a network.

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

   where the following options are available:

   node

   The name of the node.

   interface

   The name to be assigned to the interface.

   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.

   ports

   The Ethernet ports to assign.

   network

   The network to assign the interface to.

   For example:

   ~(keystone_admin)$ system host-if-add -c platform -a 802.3ad -x layer2 worker-0 bond0 ae enp0s8 enp0s9
   ~(keystone_admin)$ system interface-network-assign worker-0 enp0s8  enp0s9 mgmt