[Bug 300522] handbook: Warn about STP delays on switch ports facing CARP hosts

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=300522

            Bug ID: 300522
           Summary: handbook: Warn about STP delays on switch ports facing
                    CARP hosts
           Product: Documentation
           Version: Latest
          Hardware: Any
                OS: Any
            Status: New
          Severity: Affects Only Me
          Priority: ---
         Component: Books & Articles
          Assignee: doc@FreeBSD.org
          Reporter: ale_sagra@hotmail.com

Created attachment 277002
  --> https://bugs.freebsd.org/bugzilla/attachment.cgi?id=277002&action=edit
Warn about STP delays on switch ports facing CARP hosts

This adds a warning to the CARP section of the Handbook about Spanning Tree on
the switch ports facing CARP hosts, plus a cross-reference from the HAST
section.

I ran into this on a two-node FreeBSD router pair using CARP and HAST: after a
reboot, the switch ports stayed in the STP learning state long enough for both
nodes to become CARP MASTER, and both switched HAST to primary. Configuring the
ports as edge ports fixed it. The Handbook doesn’t currently mention this
interaction, and it’s easy to miss because everything works once the network
has settled.

I built and checked locally with make run: the warning renders in the CARP
section, and the link from the HAST section resolves to the new carp-stp
anchor.

Let me know if you have any comments, thank you

-- 
You are receiving this mail because:
You are the assignee for the bug.