[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
This commit is contained in:
Harald Jensås 2020-10-07 22:17:36 +02:00
parent 4e5529ecf3
commit 6b498bc23d
1 changed files with 9 additions and 0 deletions

View File

@ -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: