openstack/ironic
Code Issues Proposed changes

Merge "Document PXE with Spanning Tree in troubleshooting FAQ"

Browse Source
This commit is contained in:
Jenkins 2017-03-28 19:02:46 +00:00 committed by Gerrit Code Review
commit 14b62d246f
1 changed files with 17 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
doc/source/deploy/troubleshooting.rst
View File

@ -292,3 +292,20 @@ distribution that uses ``systemd``:
journal journal
ip_addr ip_addr
iptables iptables
DHCP during PXE or iPXE is inconsistent or unreliable
=====================================================
This can be caused by the spanning tree protocol delay on some switches. The
delay prevents the switch port moving to forwarding mode during the nodes
attempts to PXE, so the packets never make it to the DHCP server. To resolve
this issue you should set the switch port that connects to your baremetal nodes
as an edge or PortFast type port. Configured in this way the switch port will
move to forwarding mode as soon as the link is established. An example on how to
do that for a Cisco Nexus switch is:
.. code-block:: bash
$ config terminal
$ (config) interface eth1/11
$ (config-if) spanning-tree port type edge