configure stpd add vlan

configure stpd stpd_name add [ {vlan} vlan_name | vlan vlan_list] ports [all | port_list] {[dot1d | emistp | pvst-plus]}


Adds all ports or a list of ports within a VLAN to a specified STPD.

Syntax Description

stpd_name Specifies an STPD name on the switch.
vlan_name Specifies a VLAN name.
vlan_list Specifies a VLAN list of IDs.
all Specifies all of the ports in the VLAN to be included in the STPD.
port_list Specifies the port or ports to be included in the STPD.
dot1d Specifies the STP encapsulation mode of operation to be 802.1D.
emistp Specifies the STP encapsulation mode of operation to be EMISTP.
pvst-plus Specifies the STP encapsulation mode of operation to be PVST+.


Default port mode for default STPD (s0) and user-created STPDs is dot1d.

Usage Guidelines

To create an STP domain, use the create stpd command. To create a VLAN, use the create vlan command.

In an EMISTP or PVST+ environment, this command adds a list of ports within a VLAN to a specified STPD provided the carrier VLAN already exists on the same set of ports. You can also specify the encapsulation mode for those ports.

In an MSTP environment, you do not need a carrier VLAN. A CIST controls the connectivity of interconnecting MSTP regions and sends BPDUs across the regions to communicate region status. You must use the dot1d encapsulation mode in an MSTP environment.

You cannot configure STP on the following ports:
  • Mirroring target ports.
  • Software-controlled redundant ports.

If you see an error similar to the following:

Error: Cannot add VLAN default port 3:5 to STP domain
You might be attempting to add:
  • A carrier VLAN port to a different STP domain than the carrier VLAN belongs.
  • A VLAN/port for which the carrier VLAN does not yet belong.


    This restriction is enforced only in an active STP domain and when you enable STP to make sure you have a legal STP configuration.

Care must be taken to ensure that ports in overlapping domains do not interfere with the orderly working of each domain‘s protocol.

By default, when the switch boots for the first time, it automatically creates a VLAN named default with a tag value of 1 and STPD s0. The switch associates VLAN default to STPD s0. All ports that belong to this VLAN and STPD are in 802.1D encapsulation mode with autobind enabled. If you disable autobind on the VLAN default, that configuration is saved across a reboot.

Naming Conventions

If your STPD has the same name as another component, for example a VLAN, we recommend that you specify the identifying keyword as well as the name. If your STPD has a name unique only to that STPD, the keywords stpd and vlan are optional.

STP Encapsulations Modes

You can specify the following STP encapsulation modes:
  • dot1d—This mode is reserved for backward compatibility with previous STP versions. BPDUs are sent untagged in 802.1D mode. Because of this, any given physical interface can have only one STPD running in 802.1D mode.

    This encapsulation mode supports the following STPD modes of operation: 802.1D, 802.1w, and MSTP.

  • emistp—This mode sends BPDUs with an 802.1Q tag having an STPD ID in the VLAN ID field.

    This encapsulation mode supports the following STPD modes of operation: 802.1D and 802.1w.

  • pvst-plus—This mode implements PVST+ in compatibility with third-party switches running this version of STP. The STPDs running in this mode have a one-to-one relationship with VLANs, and send and process packets in PVST+ format.

    This encapsulation mode supports the following STPD modes of operation: 802.1D and 802.1w.

These encapsulation modes are for STP ports, not for physical ports. When a physical port belongs to multiple STPDs, it is associated with multiple STP ports. It is possible for the physical port to run in different modes for different domains for which it belongs.

MSTP STPDs use 802.1D BPDU encapsulation mode by default. To ensure correct operation of your MSTP STPDs, do not configure EMISTP or PVST+ encapsulation mode for MSTP STPDs.

STPD Identifier

An StpdID is used to identify each STP domain. You assign the StpdID when configuring the domain. An STPD ID must be identical to the VLAN ID of the carrier VLAN in that STPD and that VLAN cannot belong to another STPD.

MSTP uses two different methods to identify the STPDs that are part of the MSTP network. An instance ID of 0 identifies the Common and Internal Spanning Tree (CIST). The switch assigns this ID automatically when you configure the CIST STPD. A multiple spanning tree instance identifier identifies each STP domain that is part of an MSTP region. You assign the MSTI ID when configuring the STPD that participates in the MSTP region. In an MSTP region, MSTI IDs only have local significance. You can reuse MSTI IDs across MSTP regions.

Automatically Inheriting Ports--MSTP Only

In an MSTP environment, whether you manually or automatically bind a port to an MSTI in an MSTP region, the switch automatically binds that port to the CIST. The CIST handles BPDU processing for itself and all of the MSTIs; therefore, the CIST must inherit ports from the MSTIs in order to transmit and receive BPDUs.


Create a VLAN named marketing and an STPD named STPD1 as follows:

create vlan marketing
create stpd stpd1

The following command adds the VLAN named marketing to the STPD STPD1, and includes all the ports of the VLAN in STPD1:

configure stpd stpd1 add vlan marketing ports all


This command was first available in ExtremeXOS 10.1.

The vlan_list variable was added in ExtremeXOS 16.1.

Platform Availability

This command is available on ExtremeSwitching X435, X440-G2, X450-G2, X460-G2, X465, X590, X620, and X695 series switches.