From c980a6de4c5c49d89cb31e30fb662d7546906333 Mon Sep 17 00:00:00 2001 From: Julia Kreger Date: Tue, 3 Dec 2024 07:48:04 -0800 Subject: [PATCH] docs: note ipv6 is a good idea with neutron interface One caveat around dhcpv6 and network interfaces, is the binding logic in the ``neutron`` network interface is able to generate multiple dhcp addresses for use, where as the flat interface is not able to. Change-Id: If89c618ec951f75b9b09d7218b8500fd43a0d381 --- doc/source/admin/networking.rst | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/doc/source/admin/networking.rst b/doc/source/admin/networking.rst index 873bfdfde3..fa00447619 100644 --- a/doc/source/admin/networking.rst +++ b/doc/source/admin/networking.rst @@ -96,7 +96,8 @@ the Ironic service: support for the switches attached to the baremetal servers so they can be programmed. This interface generally requires use of ML2 plugins or other Neutron SDN integrations to facilitate the port configuration actions in - the network fabric. + the network fabric. When using IPv6, use of the ``neutron`` interface + is preferred. To use these interfaces, they need to be enabled in *ironic.conf* utilizing the :oslo.config:option:`enabled_network_interfaces` setting. @@ -389,6 +390,14 @@ physical top of rack switches for the bare metal servers. To do this an ML2 mechanism driver which supports the ``baremetal`` VNIC type for the make and model of top of rack switch in the environment must be installed and enabled. +One case where you may wish to prefer the ``neutron`` network interface, even +when your architecture is statically configured interfaces similar to ``flat`` +networks, is when your using IPv6. Various hardware, bootloader, and Operating +System DHCP clients utilize different techneaques for generating the host +identifier string which DHCP servers utilize to track IPv6 hosts. The +``neutron`` interface generates additional IPv6 DHCP entries to account for +situations such as this, where as the ``flat`` interface is unable to do so. + This is a list of known top of rack ML2 mechanism drivers which work with the ``neutron`` network interface.