commit 6b498bc23d073e936463d87a3d348c0c93244c93 Author: Harald Jensås Date: Wed Oct 7 22:17:36 2020 +0200 [DOC] Add note regarding ``[pxe_filter]deny_unknown_macs`` Add a note in the user guide section related to validate_interfaces plug-in. When [pxe_filter]deny_unknown_macs is enabled no node without a pre-enrolled port will boot into introspection, so one cannot rely on the validate network interfaces plug-in to create the PXE-booting port in this case. This is a follow up to: https://review.opendev.org/753435 Change-Id: I41c7693f3f73ddb29725741075b9fb0b4c0ebd02 diff --git a/doc/source/user/usage.rst b/doc/source/user/usage.rst index 5f82047..ab6d93e 100644 --- a/doc/source/user/usage.rst +++ b/doc/source/user/usage.rst @@ -209,6 +209,15 @@ unless you understand what you're doing: unsets it for all the other ports to avoid **nova** picking a random port to boot the node. + .. note:: + + When the ``pxe_filter`` is configured to only open the DHCP server for + known MAC addresses, i.e the ``[pxe_filter]deny_unknown_macs`` + configuration option is enabled, it is not possible to rely on the + ``validate_interfaces`` processing plug-in to create the PXE-booting port + in ironic. Nodes must have at least one enrolled port prior to + introspection in this case. + The following plugins are enabled by default, but can be disabled if not needed: