Configuring STP Extensions Using Cisco NX-OS

Information About STP Extensions


Note

See the Cisco Nexus 9000 Series NX-OS Interfaces Configuration Guide, for information on creating Layer 2 interfaces.

Cisco has added extensions to STP that enhances loop prevention, protects against some possible user misconfigurations, and provides better control over the protocol parameters. Although, in some cases, similar functionality may be incorporated into the IEEE 802.1w Rapid Spanning Tree Protocol (RSTP) standard, we recommend using these extensions. All of these extensions, except PVST Simulation, can be used with both Rapid PVST+ and MST. You use PVST Simulation only with MST.

The available extensions are spanning tree edge ports (which supply the functionality previously known as PortFast), Bridge Assurance, BPDU Guard, BPDU Filtering, Loop Guard, Root Guard, and PVT Simulation. Many of these features can be applied either globally or on specified interfaces.


Note

Spanning tree is used to refer to IEEE 802.1w and IEEE 802.1s. If the text is discussing the IEEE 802.1D Spanning Tree Protocol, 802.1D is stated specifically.

STP Port Types

You can configure a spanning tree port as an edge port, a network port, or a normal port. A port can be in only one of these states at a given time. The default spanning tree port type is normal.

Edge ports, which are connected to Layer 2 hosts, can be either an access port or a trunk port.


Note

If you configure a port connected to a Layer 2 switch or bridge as an edge port, you might create a bridging loop.

Network ports are connected only to Layer 2 switches or bridges.


Note

If you mistakenly configure ports that are connected to Layer 2 hosts, or edge devices, as spanning tree network ports, those ports will automatically move into the blocking state.

STP Edge Ports

You connect STP edge ports only to Layer 2 hosts. The edge port interface immediately transitions to the forwarding state, without moving through the blocking or learning states. (This immediate transition was previously configured as the Cisco-proprietary feature PortFast.)

Interfaces that are connected to Layer 2 hosts should not receive STP bridge protocol data units (BPDUs).

Bridge Assurance

You can use Bridge Assurance to protect against certain problems that can cause bridging loops in the network. Specifically, you use Bridge Assurance to protect against a unidirectional link failure or other software failure and a device that continues to forward data traffic when it is no longer running the spanning tree algorithm.


Note

Bridge Assurance is supported only by Rapid PVST+ and MST.

Bridge Assurance takes 2 seconds to kick in on a regular link and ~84 seconds on a VPC peer-link.

Bridge Assurance is enabled by default and can only be disabled globally. Also, Bridge Assurance can be enabled only on spanning tree network ports that are point-to-point links. Finally, both ends of the link must have Bridge Assurance enabled. If the device on one side of the link has Bridge Assurance enabled and the device on the other side either does not support Bridge Assurance or does not have this feature enabled, the connecting port is blocked.

With Bridge Assurance enabled, BPDUs are sent out on all operational network ports, including alternate and backup ports, for each hello time period. If the port does not receive a BPDU for a specified period, the port moves into the blocking state and is not used in the root port calculation. Once that port receives a BPDU, it resumes the normal spanning tree transitions.

Figure 1. Network with Normal STP Topology. This figure shows a normal STP topology.
Figure 2. Network Problem without Running Bridge Assurance. This figure demonstrates a potential network problem when the device fails and you are not running Bridge Assurance.
Figure 3. Network STP Topology Running Bridge Assurance. This figure shows the network with Bridge Assurance enabled, and the STP topology progressing normally with bidirectional BPDUs issuing from every STP network port.
Figure 4. Network Problem Averted with Bridge Assurance Enabled. This figure shows how the potential network problem does not happen when you have Bridge Assurance enabled on your network.

BPDU Guard

Enabling BPDU Guard shuts down that interface if a BPDU is received.

You can configure BPDU Guard at the interface level. When configured at the interface level, BPDU Guard shuts the port down as soon as the port receives a BPDU, regardless of the port type configuration.

When you configure BPDU Guard globally, it is effective only on operational spanning tree edge ports. In a valid configuration, Layer 2 LAN edge interfaces do not receive BPDUs. A BPDU that is received by an edge Layer 2 LAN interface signals an invalid configuration, such as the connection of an unauthorized device. BPDU Guard, when enabled globally, shuts down all spanning tree edge ports when they receive a BPDU.

BPDU Guard provides a secure response to invalid configurations, because you must manually put the Layer 2 LAN interface back in service after an invalid configuration.


Note

When enabled globally, BPDU Guard applies to all operational spanning tree edge interfaces.

BPDU Filtering

You can use BPDU Filtering to prevent the device from sending or even receiving BPDUs on specified ports.

When configured globally, BPDU Filtering applies to all operational spanning tree edge ports. You should connect edge ports only to hosts, which typically drop BPDUs. If an operational spanning tree edge port receives a BPDU, it immediately returns to a normal spanning tree port type and moves through the regular transitions. In that case, BPDU Filtering is disabled on this port, and spanning tree resumes sending BPDUs on this port.

In addition, you can configure BPDU Filtering by the individual interface. When you explicitly configure BPDU Filtering on a port, that port does not send any BPDUs and drops all BPDUs that it receives. You can effectively override the global BPDU Filtering setting on individual ports by configuring the specific interface. This BPDU Filtering command on the interface applies to the entire interface, whether the interface is trunking or not.


Caution

Use care when configuring BPDU Filtering per interface. If you explicitly configure BPDU Filtering on a port that is not connected to a host, it can result in bridging loops because the port will ignore any BPDU that it receives and go to forwarding.

This table lists all the BPDU Filtering combinations.

Table 1. BPDU Filtering Configurations

BPDU Filtering Per Port Configuration

BPDU Filtering Global Configuration

STP Edge Port Configuration

BPDU Filtering State

Default 1

Enable

Enable

Enable 2

Default

Enable

Disable

Disable

Default

Disable

Not applicable

Disable

Disable

Not applicable

Not applicable

Disable

Enable

Not applicable

Not applicable

Enable

1 No explicit port configuration.
2 The port transmits at least 10 BPDUs. If this port receives any BPDUs, the port returns to the spanning tree normal port state and BPDU filtering is disabled.

Loop Guard

Loop Guard helps prevent bridging loops that could occur because of a unidirectional link failure on a point-to-point link.

An STP loop occurs when a blocking port in a redundant topology erroneously transitions to the forwarding state. Transitions are usually caused by a port in a physically redundant topology (not necessarily the blocking port) that stops receiving BPDUs.

When you enable Loop Guard globally, it is useful only in switched networks where devices are connected by point-to-point links. On a point-to-point link, a designated bridge cannot disappear unless it sends an inferior BPDU or brings the link down. However, you can enable Loop Guard on shared links per interface,

You can use Loop Guard to determine if a root port or an alternate/backup root port receives BPDUs. If the port that was previously receiving BPDUs is no longer receiving BPDUs, Loop Guard puts the port into an inconsistent state (blocking) until the port starts to receive BPDUs again. If such a port receives BPDUs again, the port—and link—is deemed viable again. The protocol removes the loop-inconsistent condition from the port, and the STP determines the port state because the recovery is automatic.

Loop Guard isolates the failure and allows STP to converge to a stable topology without the failed link or bridge. Disabling Loop Guard moves all loop-inconsistent ports to the listening state.

You can enable Loop Guard on a per-port basis. When you enable Loop Guard on a port, it is automatically applied to all of the active instances or VLANs to which that port belongs. When you disable Loop Guard, it is disabled for the specified ports.

Enabling Loop Guard on a root device has no effect but provides protection when a root device becomes a nonroot device.

Root Guard

When you enable Root Guard on a port, Root Guard does not allow that port to become a root port. If a received BPDU triggers an STP convergence that makes that designated port become a root port, that port is put into a root-inconsistent (blocked) state. After the port stops receiving superior BPDUs, the port is unblocked again. Through STP, the port moves to the forwarding state. Recovery is automatic.

When you enable Root Guard on an interface, this functionality applies to all VLANs to which that interface belongs.

You can use Root Guard to enforce the root bridge placement in the network. Root Guard ensures that the port on which Root Guard is enabled is the designated port. Normally, root bridge ports are all designated ports, unless two or more of the ports of the root bridge are connected. If the bridge receives superior BPDUs on a Root Guard-enabled port, the bridge moves this port to a root-inconsistent STP state. In this way, Root Guard enforces the position of the root bridge.

You cannot configure Root Guard globally.

Applying STP Extension Features

Figure 5. Network with STP Extensions Correctly Deployed.

We recommend that you configure the various STP extension features through your network as shown in this figure. Bridge Assurance is enabled on the entire network. You should enable either BPDU Guard or BPDU Filtering on the host interface.

PVST Simulation

MST interoperates with Rapid PVST+ with no need for user configuration. The PVST simulation feature enables this interoperability.


Note

PVST simulation is enabled by default when you enable MST. By default, all interfaces on the device interoperate between MST and Rapid PVST+.

However, you may want to control the connection between MST and Rapid PVST+ to protect against accidentally connecting an MST-enabled port to a port enabled to run Rapid PVST+. Because Rapid PVST+ is the default STP mode, you may encounter many Rapid PVST+ connections.

Disabling Rapid PVST+ simulation, which can be done per port or globally for the entire device, moves the MST-enabled port to the blocking state once it detects it is connected to a Rapid PVST+-enabled port. This port remains in the inconsistent state until the port stops receiving Rapid PVST+/SSTP BPDUs, and then the port resumes the normal STP transition process.

The root bridge for all STP instances must all be in either the MST region or the Rapid PVST+ side. If the root bridge for all STP instances are not on one side or the other, the software moves the port into a PVST simulation-inconsistent state.


Note

We recommend that you put the root bridge for all STP instances in the MST region.

High Availability for STP

The software supports high availability for STP. However, the statistics and timers are not restored when STP restarts. The timers start again and the statistics begin from 0.


Note

See the Cisco Nexus 9000 Series NX-OS High Availability and Redundancy Guide, for complete information on high-availability features.

Prerequisites for STP Extensions

STP has the following prerequisites:

  • You must be logged onto the device.

  • You must have STP configured already.

Guidelines and Limitations for Configuring STP Extensions

STP extensions have the following configuration guidelines and limitations:

  • show commands with the internal keyword are not supported.

  • Connect STP network ports only to switches.

  • You should configure host ports as STP edge ports and not as network ports.

  • If you enable STP network port types globally, ensure that you manually configure all ports connected to hosts as STP edge ports.

  • You should configure all access and trunk ports connected to Layer 2 hosts as edge ports.

  • Bridge Assurance runs only on point-to-point spanning tree network ports. You must configure each side of the link for this feature.

  • We recommend that you enable Bridge Assurance throughout your network.

  • We recommend that you enable BPDU Guard on all edge ports.

  • Enabling Loop Guard globally works only on point-to-point links.

  • Enabling Loop Guard per interface works on both shared and point-to-point links.

  • Root Guard forces a port to always be a designated port; it does not allow a port to become a root port. Loop Guard is effective only if the port is a root port or an alternate port. You cannot enable Loop Guard and Root Guard on a port at the same time.

  • Loop Guard has no effect on a disabled spanning tree instance or a VLAN.

  • Spanning tree always chooses the first operational port in the channel to send the BPDUs. If that link becomes unidirectional, Loop Guard blocks the channel, even if other links in the channel are functioning properly.

  • If you group together a set of ports that are already blocked by Loop Guard to form a channel, spanning tree loses all the state information for those ports and the new channel port may obtain the forwarding state with a designated role.

  • If a channel is blocked by Loop Guard and the channel members go back to an individual link status, spanning tree loses all the state information. The individual physical ports may obtain the forwarding state with the designated role, even if one or more of the links that formed the channel are unidirectional.


    Note

    You can enable UniDirectional Link Detection (UDLD) aggressive mode to isolate the link failure. A loop may occur until UDLD detects the failure, but Loop Guard will not be able to detect it. See the Cisco NX-OS Series NX-OS Interfaces Configuration Guide, for information on UDLD.

  • You should enable Loop Guard globally on a switch network with physical loops.

  • You should enable Root Guard on ports that connect to network devices that are not under direct administrative control.

Default Settings for STP Extensions

This table lists the default settings for STP extensions.

Table 2. Default STP Extension Parameters

Parameters

Default

Port type

Normal

Bridge Assurance

Enabled (on STP network ports only)

Global BPDU Guard

Disabled

BPDU Guard per interface

Disabled

Global BPDU Filtering

Disabled

BPDU Filtering per interface

Disabled

Global Loop Guard

Disabled

Loop Guard per interface

Disabled

Root Guard per interface

Disabled

PVST simulation

Enabled

Configuring STP Extensions Steps


Note

If you are familiar with the Cisco IOS CLI, be aware that the Cisco NX-OS commands for this feature might differ from the Cisco IOS commands that you would use.

You can enable Loop Guard per interface on either shared or point-to-point links.

Configuring Spanning Tree Port Types Globally

The spanning tree port type designation depends on the device the port is connected to, as follows:

  • Edge—Edge ports are connected to Layer 2 hosts and are access ports.

  • Network—Network ports are connected only to Layer 2 switches or bridges and can be either access or trunk ports.

  • Normal—Normal ports are neither edge ports nor network ports; they are normal spanning tree ports. These ports can be connected to any device.

You can configure the port type either globally or per interface. By default, the spanning tree port type is normal.

Before you begin

Before you configure the spanning port type, you should do the following:

  • Ensure that STP is configured.

  • Ensure that you are configuring the ports correctly as to the device to which the port is connected.

SUMMARY STEPS

  1. config t
  2. spanning-tree port type edge default or spanning-tree port type network default
  3. exit
  4. (Optional) show spanning-tree summary
  5. (Optional) copy running-config startup-config

DETAILED STEPS

  Command or Action Purpose

Step 1

config t

Example:

switch# config t
switch(config)#

Enters configuration mode.

Step 2

spanning-tree port type edge default or spanning-tree port type network default

Example:

switch(config)# spanning-tree port type edge default

  • spanning-tree port type edge default

    Configures all access ports connected to Layer 2 hosts as edge ports. Edge ports immediately transition to the forwarding state without passing through the blocking or learning state at linkup. By default, spanning tree ports are normal port types.

  • spanning-tree port type network default

    Configures all interfaces connected to Layer 2 switches and bridges as spanning tree network ports. If you enable Bridge Assurance, it automatically runs on network ports. By default, spanning tree ports are normal port types.

    Note

     

    If you configure interfaces connected to Layer 2 hosts as network ports, those ports automatically move into the blocking state.

Step 3

exit

Example:

switch(config)# exit
switch#

Exits configuration mode.

Step 4

(Optional) show spanning-tree summary

Example:

switch# show spanning-tree summary
 (Optional)

Displays the STP configuration including STP port types if configured.

Step 5

(Optional) copy running-config startup-config

Example:

switch# copy running-config startup-config
 (Optional)

Copies the running configuration to the startup configuration.

Example

This example shows how to configure all access ports connected to Layer 2 hosts as spanning tree edge ports: 

switch# config t
switch(config)# spanning-tree port type edge default
switch(config)# exit
switch#

This example shows how to configure all ports connected to Layer 2 switches or bridges as spanning tree network ports: 

switch# config t
switch(config)# spanning-tree port type network default 
switch(config)# exit
switch#

Configuring Spanning Tree Edge Ports on Specified Interfaces

You can configure spanning tree edge ports on specified interfaces. Interfaces configured as spanning tree edge ports immediately transition to the forwarding state, without passing through the blocking or learning states, on linkup.

This command has four states:

  • spanning-tree port type edge—This command explicitly enables edge behavior on the access port.

  • spanning-tree port type edge trunk—This command explicitly enables edge behavior on the trunk port.


Note

If you enter the spanning-tree port type edge trunk command, the port is configured as an edge port even in the access mode.

  • spanning-tree port type normal—This command explicitly configures the port as a normal spanning tree port and the immediate transition to the forwarding state is not enabled.

  • no spanning-tree port type—This command implicitly enables edge behavior if you define the spanning-tree port type edge default command in global configuration mode. If you do not configure the edge ports globally, the no spanning-tree port type command is equivalent to the spanning-tree port type normal command.

Before you begin

Before you configure the spanning port type, you should do the following:

  • Ensure that STP is configured.

  • Ensure that you are configuring the ports correctly as to the device to which the port is connected.

SUMMARY STEPS

  1. config t
  2. interface type slot/port
  3. spanning-tree port type edge
  4. exit
  5. (Optional) show spanning-tree interface type slot/port ethernet x/y
  6. (Optional) copy running-config startup-config

DETAILED STEPS

  Command or Action Purpose

Step 1

config t

Example:

switch# config t
switch(config)#

Enters configuration mode.

Step 2

interface type slot/port

Example:

switch(config)# interface ethernet 1/4
switch(config-if)#

Specifies the interface to configure, and enters the interface configuration mode.

Step 3

spanning-tree port type edge

Example:

switch(config-if)# spanning-tree port type edge

Configures the specified access interfaces to be spanning edge ports. Edge ports immediately transition to the forwarding state without passing through the blocking or learning state at linkup. By default, spanning tree ports are normal port types.

Step 4

exit

Example:

switch(config-if)# exit
switch(config)#

Exits interface configuration mode.

Step 5

(Optional) show spanning-tree interface type slot/port ethernet x/y

Example:

switch# show spanning-tree ethernet 1/4
 (Optional)

Displays the STP configuration including the STP port type if configured.

Step 6

(Optional) copy running-config startup-config

Example:

switch# copy running-config startup-config
 (Optional)

Copies the running configuration to the startup configuration.

Example

This example shows how to configure the Ethernet access interface 1/4 to be a spanning tree edge port: 

switch# config t
switch(config)# interface ethernet 1/4
switch(config-if)# spanning-tree port type edge
switch(config-if)# exit
switch(config)#

Configuring Spanning Tree Network Ports on Specified Interfaces

You can configure spanning tree network ports on specified interfaces.

Bridge Assurance runs only on spanning tree network ports.

This command has three states:

  • spanning-tree port type network—This command explicitly configures the port as a network port. If you enable Bridge Assurance globally, it automatically runs on a spanning tree network port.

  • spanning-tree port type normal —This command explicitly configures the port as a normal spanning tree port and Bridge Assurance cannot run on this interface.

  • no spanning-tree port type—This command implicitly enables the port as a spanning tree network port if you define the spanning-tree port type network default command in global configuration mode. If you enable Bridge Assurance globally, it automatically runs on this port.


Note

A port connected to Layer 2 hosts that is configured as a network ports automatically moves into the blocking state.

Before you begin

Before you configure the spanning port type, you should do the following:

  • Ensure that STP is configured.

  • Ensure that you are configuring the ports correctly as to the device to which the port is connected.

SUMMARY STEPS

  1. config t
  2. interface type slot/port
  3. spanning-tree port type network
  4. exit
  5. (Optional) show spanning-tree interface type slot/port
  6. (Optional) copy running-config startup-config

DETAILED STEPS

  Command or Action Purpose

Step 1

config t

Example:

switch# config t
switch(config)#

Enters configuration mode.

Step 2

interface type slot/port

Example:

switch(config)# interface ethernet 1/4
switch(config-if)#

Specifies the interface to configure, and enters the interface configuration mode.

Step 3

spanning-tree port type network

Example:

switch(config-if)# spanning-tree port type network

Configures the specified interfaces to be spanning network ports. If you enable Bridge Assurance, it automatically runs on network ports. By default, spanning tree ports are normal port types.

Step 4

exit

Example:

switch(config-if)# exit
switch(config)#

Exits interface configuration mode.

Step 5

(Optional) show spanning-tree interface type slot/port

Example:

switch# show spanning-tree interface ethernet 1/4
 (Optional)

Displays the STP configuration including the STP port type if configured.

Step 6

(Optional) copy running-config startup-config

Example:

switch# copy running-config startup-config
 (Optional)

Copies the running configuration to the startup configuration.

Example

This example shows how to configure the Ethernet interface 1/4 to be a spanning tree network port: 

switch# config t
switch(config)# interface ethernet 1/4
switch(config-if)# spanning-tree port type network
switch(config-if)# exit
switch(config)#

Enabling BPDU Guard Globally

You can enable BPDU Guard globally by default. In this condition, the system shuts down an edge port that receives a BPDU.


Note

We recommend that you enable BPDU Guard on all edge ports.

Before you begin

Before you configure the spanning port type, you should do the following:

  • Ensure that STP is configured.

  • Ensure that you are configuring the ports correctly as to the device to which the port is connected.

SUMMARY STEPS

  1. config t
  2. spanning-tree port type edge bpduguard default
  3. exit
  4. (Optional) show spanning-tree summary
  5. (Optional) copy running-config startup-config

DETAILED STEPS

  Command or Action Purpose

Step 1

config t

Example:

switch# config t
switch(config)#

Enters configuration mode.

Step 2

spanning-tree port type edge bpduguard default

Example:

switch(config)# spanning-tree port type edge bpduguard default

Enables BPDU Guard by default on all spanning tree edge ports. By default, global BPDU Guard is disabled.

Note

 

This command changes the behavior at the interface level, however, it is not visible on the show running interface. To verify the operational status, use the show spanning-tree summary command.

Step 3

exit

Example:

switch(config)# exit
switch#

Exits configuration mode.

Step 4

(Optional) show spanning-tree summary

Example:

switch# show spanning-tree summary
 (Optional)

Displays summary STP information.

Step 5

(Optional) copy running-config startup-config

Example:

switch# copy running-config startup-config
 (Optional)

Copies the running configuration to the startup configuration.

Example

This example shows how to enable BPDU Guard on all spanning tree edge ports: 

switch# config t
switch(config)# spanning-tree port type edge bpduguard default
switch(config)# exit
switch#

Enabling BPDU Guard on Specified Interfaces

You can enable BPDU Guard on specified interfaces. Enabling BPDU Guard shuts down the port if it receives a BPDU.

You can configure BPDU Guard on specified interfaces as follows:

  • spanning-tree bpduguard enable —Unconditionally enables BPDU Guard on the interface.

  • spanning-tree bpduguard disable —Unconditionally disables BPDU Guard on the interface.

  • no spanning-tree bpduguard —Enables BPDU Guard on the interface if it is an operational edge port and if the spanning-tree port type edge bpduguard default command is configured.

Before you begin

Before you configure this feature, you should do the following:

  • Ensure that STP is configured.

SUMMARY STEPS

  1. config t
  2. interface type slot/port
  3. spanning-tree bpduguard {enable | disable} or no spanning-tree bpduguard
  4. exit
  5. (Optional) show spanning-tree interface type slot/port detail
  6. (Optional) copy running-config startup-config

DETAILED STEPS

  Command or Action Purpose

Step 1

config t

Example:

switch# config t
switch(config)#

Enters configuration mode.

Step 2

interface type slot/port

Example:

switch(config)# interface ethernet 1/4
switch(config-if)#

Specifies the interface to configure, and enters the interface configuration mode.

Step 3

spanning-tree bpduguard {enable | disable} or no spanning-tree bpduguard

Example:

switch(config-if)# spanning-tree bpduguard enable

  • spanning-tree bpduguard {enable | disable}

    Enables or disables BPDU Guard for the specified spanning tree edge interface. By default, BPDU Guard is disabled on the interfaces.

  • no spanning-tree bpduguard

    Falls back to the default BPDU Guard global setting that you set for the interfaces by entering the spanning-tree port type edge bpduguard default command.

Step 4

exit

Example:

switch(config-if)# exit
switch(config)#

Exits interface mode.

Step 5

(Optional) show spanning-tree interface type slot/port detail

Example:

switch# show spanning-tree interface ethernet detail
 (Optional)

Displays summary STP information.

Step 6

(Optional) copy running-config startup-config

Example:

switch(config)# copy running-config startup-config
 (Optional)

Copies the running configuration to the startup configuration.

Example

This example shows how to explicitly enable BPDU Guard on the Ethernet edge port 1/4: 

switch# config t
switch(config)# interface ethernet 1/4
switch(config-if)# spanning-tree bpduguard enable
switch(config-if)# exit
switch(config)#

Enabling BPDU Filtering Globally

You can enable BPDU Filtering globally by default on spanning tree edge ports.

If an edge port with BPDU Filtering enabled receives a BPDU, it loses its operation status as edge port and resumes the regular STP transitions. However, this port maintains its configuration as an edge port.


Caution

Be careful when using this command. Using this command incorrectly can cause bridging loops.

Before you begin

Before you configure this feature, you should do the following:

  • Ensure that STP is configured.

  • Ensure that you have configured some spanning tree edge ports.


Note

When enabled globally, BPDU Filtering is applied only on ports that are operational edge ports. Ports send a few BPDUs at linkup before they effectively filter outbound BPDUs. If a BPDU is received on an edge port, it immediately loses its operational edge port status and BPDU Filtering is disabled.

SUMMARY STEPS

  1. config t
  2. spanning-tree port type edge bpdufilter default
  3. exit
  4. (Optional) show spanning-tree summary
  5. (Optional) copy running-config startup-config

DETAILED STEPS

  Command or Action Purpose

Step 1

config t

Example:

switch# config t
switch(config)#

Enters configuration mode.

Step 2

spanning-tree port type edge bpdufilter default

Example:

switch(config)# spanning-tree port type edge bpdufilter default

Enables BPDU Filtering by default on all operational spanning tree edge ports. Global BPDU Filtering is disabled by default.

Step 3

exit

Example:

switch(config)# exit
switch#

Exits configuration mode.

Step 4

(Optional) show spanning-tree summary

Example:

switch# show spanning-tree summary
 (Optional)

Displays summary STP information.

Step 5

(Optional) copy running-config startup-config

Example:

switch# copy running-config startup-config
 (Optional)

Copies the running configuration to the startup configuration.

Example

This example shows how to enable BPDU Filtering on all operational spanning tree edge ports: 

switch# config t
switch(config)# spanning-tree port type edge bpdufilter default
switch(config)# exit
switch#

Enabling BPDU Filtering on Specified Interfaces

You can apply BPDU Filtering to specified interfaces. When enabled on an interface, that interface does not send any BPDUs and drops all BPDUs that it receives. This BPDU Filtering functionality applies to the entire interface, whether trunking or not.


Caution

Be careful when you enter the spanning-tree bpdufilter enable command on specified interfaces. Explicitly configuring BPDU Filtering on a port that is not connected to a host can result in bridging loops because the port will ignore any BPDU that it receives and go to forwarding.

You can enter this command to override the port configuration on specified interfaces.

This command has three states:

  • spanning-tree bpdufilter enable—Unconditionally enables BPDU Filtering on the interface.

  • spanning-tree bpdufilter disable—Unconditionally disables BPDU Filtering on the interface.

  • no spanning-tree bpdufilter — —Enables BPDU Filtering on the interface if the interface is in operational edge port and if you configure the spanning-tree port type edge bpdufilter default command.

Before you begin

Before you configure this feature, you should do the following:

  • Ensure that STP is configured.


Note

When you enable BPDU Filtering locally on a port, this feature prevents the device from receiving or sending BPDUs on this port.

SUMMARY STEPS

  1. config t
  2. interface type slot/port
  3. spanning-tree bpdufilter {enable | disable} or no spanning-tree bpdufilter
  4. exit
  5. (Optional) show spanning-tree summary
  6. (Optional) copy running-config startup-config

DETAILED STEPS

  Command or Action Purpose

Step 1

config t

Example:

switch# config t
switch(config)#

Enters configuration mode.

Step 2

interface type slot/port

Example:

switch(config)# interface ethernet 1/4
switch(config-if)#

Specifies the interface to configure, and enters the interface configuration mode.

Step 3

spanning-tree bpdufilter {enable | disable} or no spanning-tree bpdufilter

Example:

switch(config-if)# spanning-tree bpdufilter enable

  • spanning-tree bpdufilter {enable | disable}

    Enables or disables BPDU Filtering for the specified spanning tree edge interface. By default, BPDU Filtering is disabled.

  • no spanning-tree bpdufilter

    Enables BPDU Filtering on the interface if the interface is an operational spanning tree edge port and if you enter the spanning-tree port type edge bpdufilter default command.

Step 4

exit

Example:

switch(config-if)# exit
switch(config)#

Exits interface mode.

Step 5

(Optional) show spanning-tree summary

Example:

switch# show spanning-tree summary
 (Optional)

Displays summary STP information.

Step 6

(Optional) copy running-config startup-config

Example:

switch(config)# copy running-config startup-config
 (Optional)

Copies the running configuration to the startup configuration.

Example

This example shows how to explicitly enable BPDU Filtering on the Ethernet spanning tree edge port 1/4: 

switch# config t
switch(config)# interface ethernet 1/4
switch(config-if)# spanning-tree bpdufilter enable
switch(config-if)# exit
switch(config)#

Enabling Loop Guard Globally

You can enable Loop Guard globally by default on all point-to-point spanning tree normal and network ports. Loop Guard does not run on edge ports.

Loop Guard provides additional security in the bridge network. Loop Guard prevents alternate or root ports from becoming the designated port because of a failure that could lead to a unidirectional link.


Note

Entering the Loop Guard command for the specified interface overrides the global Loop Guard command.

Before you begin

Before you configure this feature, you should do the following:

  • Ensure that STP is configured.

  • Ensure that you have spanning tree normal ports or have configured some network ports.

SUMMARY STEPS

  1. config t
  2. spanning-tree loopguard default
  3. exit
  4. (Optional) show spanning-tree summary
  5. (Optional) copy running-config startup-config

DETAILED STEPS

  Command or Action Purpose

Step 1

config t

Example:

switch# config t
switch(config)#

Enters configuration mode.

Step 2

spanning-tree loopguard default

Example:

switch(config)# spanning-tree loopguard default

Enables Loop Guard by default on all spanning tree normal and network ports. By default, global Loop Guard is disabled.

Step 3

exit

Example:

switch(config)# exit
switch#

Exits configuration mode.

Step 4

(Optional) show spanning-tree summary

Example:

switch# show spanning-tree summary
 (Optional)

Displays summary STP information.

Step 5

(Optional) copy running-config startup-config

Example:

switch# copy running-config startup-config
 (Optional)

Copies the running configuration to the startup configuration.

Example

This example shows how to enable Loop Guard on all spanning tree normal or network ports: 

switch# config t
switch(config)# spanning-tree loopguard default
switch(config)# exit
switch#

Enabling Loop Guard or Root Guard on Specified Interfaces


Note

You can run Loop Guard on spanning tree normal or network ports. You can run Root Guard on all spanning tree ports: normal, edge, or network.

You can enable either Loop Guard or Root Guard on specified interfaces.

Enabling Root Guard on a port means that port cannot become a root port, and Loop Guard prevents alternate or root ports from becoming the designated port because of a failure that could lead to a unidirectional link.

Both Loop Guard and Root Guard enabled on an interface apply to all VLANs to which that interface belongs.


Note

Entering the Loop Guard command for the specified interface overrides the global Loop Guard command.

Before you begin

Before you configure this feature, you should do the following:

  • Ensure that STP is configured.

  • Ensure that you are configuring Loop Guard on spanning tree normal or network ports.

SUMMARY STEPS

  1. config t
  2. interface type slot/port
  3. spanning-tree guard {loop | root | none}
  4. exit
  5. interface type slot/port
  6. spanning-tree guard {loop | root | none}
  7. exit
  8. (Optional) show spanning-tree interface type slot/port detail
  9. (Optional) copy running-config startup-config

DETAILED STEPS

  Command or Action Purpose

Step 1

config t

Example:

switch# config t
switch(config)#

Enters configuration mode.

Step 2

interface type slot/port

Example:

switch(config)# interface ethernet 1/4
switch(config-if)#

Specifies the interface to configure, and enters the interface configuration mode.

Step 3

spanning-tree guard {loop | root | none}

Example:

switch(config-if)# spanning-tree guard loop

Enables or disables either Loop Guard or Root Guard for the specified interface. By default, Root Guard is disabled by default, and Loop Guard on specified ports is also disabled.

Note

 

Loop Guard runs only on spanning tree normal and network interfaces. This example shows Loop Guard is enabled on the specified interface.

Step 4

exit

Example:

switch(config-if)# exit
switch(config)#

Exits interface mode.

Step 5

interface type slot/port

Example:

switch(config)# interface ethernet 1/10
switch(config-if)#

Specifies the interface to configure, and enters the interface configuration mode.

Step 6

spanning-tree guard {loop | root | none}

Example:

switch(config-if)# spanning-tree guard root

Enables or disables either Loop Guard or Root Guard for the specified interface. By default, Root Guard is disabled by default, and Loop Guard on specified ports is also disabled.

The example shows Root Guard is enabled on a different interface.

Step 7

exit

Example:

switch(config-if)# exit
switch(config)#

Exits interface mode.

Step 8

(Optional) show spanning-tree interface type slot/port detail

Example:

switch# show spanning-tree interface ethernet 1/4 detail
 (Optional)

Displays summary STP information.

Step 9

(Optional) copy running-config startup-config

Example:

switch(config)# copy running-config startup-config
 (Optional)

Copies the running configuration to the startup configuration.

Example

This example shows how to enable Root Guard on Ethernet port 1/4: 

switch# config t
switch(config)# interface ethernet 1/4
switch(config-if)# spanning-tree guard root
switch(config-if)# exit
switch(config)#

Configuring PVST Simulation Globally-CLI Version


Note

PVST simulation is enabled by default. By default, all interfaces on the device interoperate between MST and Rapid PVST+.

MST interoperates with Rapid PVST+. However, to prevent an accidental connection to a device that does not run MST as the default STP mode, you may want to disable this automatic feature. If you disable PVST simulation, the MST-enabled port moves to the blocking state once it detects it is connected to a Rapid PVST+-enabled port. This port remains in the inconsistent state until the port stops receiving BPDUs, and then the port resumes the normal STP transition process.

You can block this automatic feature either globally or per port. You can enter the global command and change the PVST simulation setting for the entire device while you are in interface command mode.

SUMMARY STEPS

  1. config t
  2. no spanning-tree mst simulate pvst global
  3. exit
  4. (Optional) show spanning-tree summary
  5. (Optional) copy running-config startup-config

DETAILED STEPS

  Command or Action Purpose

Step 1

config t

Example:

switch# config t
switch(config)#

Enters configuration mode.

Step 2

no spanning-tree mst simulate pvst global

Example:

switch(config)# no spanning-tree mst simulate pvst global

Disables all interfaces on the switch from automatically interoperating with a connected device that is running in Rapid PVST+ mode. The default for this is enabled; by default, all interfaces on the device operate between Rapid PVST+ and MST.

Step 3

exit

Example:

switch(config)# exit
switch#

Exits configuration mode.

Step 4

(Optional) show spanning-tree summary

Example:

switch# show spanning-tree summary
 (Optional)

Displays detailed STP information.

Step 5

(Optional) copy running-config startup-config

Example:

switch# copy running-config startup-config
 (Optional)

Copies the running configuration to the startup configuration.

Example

This example shows how to prevent the device from automatically interoperating with a connecting device that is running Rapid PVST+: 

switch# config t
switch(config)# no spanning-tree mst simulate pvst global
switch(config)# exit
switch#

Configuring PVST Simulation Per Port


Note

PVST simulation is enabled by default. By default, all interfaces on the device interoperate between MST and Rapid PVST+.

You can configure PVST simulation only when you are running MST on the device (Rapid PVST+ is the default STP mode). MST interoperates with Rapid PVST+. However, to prevent an accidental connection to a device that does not run MST as the default STP mode, you may want to disable this automatic feature. If you disable PVST simulation, the MST-enabled port moves to the blocking state once it detects that it is connected to a Rapid PVST+-enabled port. This port remains in the inconsistent state until the port stops receiving Rapid PVST+ BPDUs, and then the port resumes the normal STP transition process.

You can block this automatic feature either globally or per port.

SUMMARY STEPS

  1. config t
  2. interface {{type slot/port} |{port-channel number}}
  3. spanning-tree mst simulate pvst disable or spanning-tree mst simulate pvst or no spanning-tree mst simulate pvst
  4. exit
  5. (Optional) show spanning-tree interface type slot/port detail
  6. (Optional) copy running-config startup-config

DETAILED STEPS

  Command or Action Purpose

Step 1

config t

Example:

switch# config t
switch(config)#

Enters configuration mode.

Step 2

interface {{type slot/port} |{port-channel number}}

Example:

switch(config)# interface ethernet 3/1
switch(config-if)#

Specifies an interface to configure, and enters interface configuration mode.

Step 3

spanning-tree mst simulate pvst disable or spanning-tree mst simulate pvst or no spanning-tree mst simulate pvst

Example:

switch(config-if)# spanning-tree mst simulate pvst

  • spanning-tree mst simulate pvst disable

    Disables specified interfaces from automatically interoperating with a connected device that is running in Rapid PVST+ mode.

    By default, all interfaces on the device operate between Rapid PVST+ and MST.

  • spanning-tree mst simulate pvst

    Reenables seamless operation between MST and Rapid PVST+ on specified interfaces.

  • no spanning-tree mst simulate pvst

    Sets the interface to the device-wide MST and Rapid PVST+ interoperation that you configured using the spanning-tree mst simulate pvst global command.

Step 4

exit

Example:

switch(config-if)# exit
switch(config)#

Exits interface mode.

Step 5

(Optional) show spanning-tree interface type slot/port detail

Example:

switch# show spanning-tree interface ethernet 3/1 detail
 (Optional)

Displays detailed STP information.

Step 6

(Optional) copy running-config startup-config

Example:

switch(config)# copy running-config startup-config
 (Optional)

Copies the running configuration to the startup configuration.

Example

This example shows how to prevent the specified interfaces from automatically interoperating with a connecting device that is not running MST: 

switch(config-if)# spanning-tree mst simulate pvst
switch(config-if)#

Verifying the STP Extension Configuration

To display the configuration information for the STP extensions, perform one of the following tasks:

Command

Purpose

show running-config spanning-tree [all]

Displays information about STP.

show spanning-tree summary

Displays summary information on STP.

show spanning-tree mst instance-id interface {ethernet slot/port | port-channel channel-number} [detail]

Displays MST information for the specified interface and instance.

Configuration Examples for STP Extension

The following example shows how to configure the STP extensions: 

switch# configure terminal
switch(config)# spanning-tree port type network default
switch(config)# spanning-tree port type edge bpduguard default
switch(config)# spanning-tree port type edge bpdufilter default

switch(config)# interface ethernet 1/1
switch(config-if)# spanning-tree port type edge
switch(config-if)# exit

switch(config)# interface ethernet 1/2
switch(config-if)# spanning-tree port type edge
switch(config-if)# exit
switch(config)#

Additional References for STP Extensions -- CLI Version

Related Documents

Related Topic

Document Title

Layer 2 interfaces

Cisco Nexus 9000 Series NX-OS Interfaces Configuration Guide

NX-OS fundamentals

Cisco Nexus 9000 Series NX-OS Fundamentals Configuration Guide

High availability

Cisco Nexus 9000 Series NX-OS High Availability and Redundancy Guide

System management

Cisco Nexus 9000 Series NX-OS System Management Configuration Guide

Standards

Standards

Title

IEEE 802.1Q-2006 (formerly known as IEEE 802.1s), IEEE 802.1D-2004 (formerly known as IEEE 802.1w), IEEE 802.1D, IEEE 802.1t

—

MIBs

MIBs

MIBs Link

  • CISCO-STP-EXTENSION-MIB

  • BRIDGE-MIB

To locate and download MIBs, go to the following URL: ftp://ftp.cisco.com/pub/mibs/supportlists/nexus9000/Nexus9000MIBSupportList.html