Bridge

The nv unset commands remove the configuration you set with the equivalent nv set commands. This guide only describes an nv unset command if it differs from the nv set command.

nv set bridge

Configures a bridge on the switch.


nv set bridge domain <domain-id>

Configures the bridge domain. The default bridge domain is br_default.

Command Syntax

SyntaxDescription
<domain-id>The name of the bridge domain.

Version History

Introduced in Cumulus Linux 5.0.0


nv set bridge domain <domain-id> ageing

Configures the number of seconds that Cumulus Linux stores MAC addresses in the Ethernet switching table. You can set a value between 0 and 65535. The default setting is 1800 seconds (30 minutes). A value of 0 turns MAC ageing off.

Command Syntax

SyntaxDescription
<domain-id>The name of the bridge domain.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv set bridge domain br_default ageing 600

nv set bridge domain <domain-id> encap 802.1Q

Configures all interfaces in this bridge domain to use 802.1Q encapsulation.

Command Syntax

SyntaxDescription
<domain-id>The name of the bridge domain.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv set bridge domain br_default encap 802.1Q

nv set bridge domain <domain-id> mac-address

Configures all interfaces in this bridge domain to use this MAC address.

Command Syntax

SyntaxDescription
<domain-id>The name of the bridge domain.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv set bridge domain br_default mac-address 00:00:00:00:00:10

nv set bridge domain <domain-id> multicast

Configures multicast on the bridge domain.


nv set bridge domain <domain-id> multicast snooping

Configures IGMP and MLD snooping to prevent hosts on a local network from receiving traffic for a multicast group they have not explicitly joined. IGMP snooping is for IPv4 environments and MLD snooping is for IPv6 environments.


nv set bridge domain <domain-id> multicast snooping enable

Turns IGMP and MLD snooping on or off. The default setting is off.

Command Syntax

SyntaxDescription
<domain-id>The name of the bridge domain.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv set bridge domain br_default multicast snooping enable on

nv set bridge domain <domain-id> multicast snooping querier

Configures the IGMP and MLD querier. Without a multicast router, a single switch in an IP subnet can coordinate multicast traffic flows. This switch is the querier or the designated router. The querier generates query messages to check group membership, and processes membership reports and leave messages.


nv set bridge domain <domain-id> multicast snooping querier enable

Turns the multicast querier on or off. The default setting is off.

Command Syntax

SyntaxDescription
<domain-id>The name of the bridge domain.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv set bridge domain br_default multicast snooping querier enable on

nv set bridge domain <domain-id> stp

Configures STP on the bridge domain.


nv set bridge domain <domain-id> stp force-protocol-version

Configures the switch to send BPDU type 0 STP configuration BPDUs. By default, the switch sends RSTP type 2 BPDUs. You can configure the switch to send BPDU type 0 STP configuration BPDUs when you need to interoperate with other systems.

You can specify either stp or rstp.

Command Syntax

SyntaxDescription
<domain-id>The name of the bridge domain.

Version History

Introduced in Cumulus Linux 5.7.0

Example

cumulus@switch:~$ nv set bridge domain br_default stp force-protocol-version stp

nv set bridge domain <domain-id> stp mode

Configures STP mode on the bridge. You can specify PVRST or RSTP mode. RSTP is the default mode.

Command Syntax

SyntaxDescription
<domain-id>The name of the bridge domain.

Version History

Introduced in Cumulus Linux 5.6.0

Example

cumulus@switch:~$ nv set bridge domain br_default stp mode pvrst

nv set bridge domain <domain-id> stp priority

Configures the spanning tree priority. The bridge with the lowest priority is the root bridge. The priority must be a number between 0 and 61440, and must be a multiple of 4096. The default value is 32768.

Command Syntax

SyntaxDescription
<domain-id>The name of the bridge domain.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv set bridge domain br_default stp priority 8192

nv set bridge domain <domain-id> stp state

Configures the STP state on the bridge. You can set a value of up, or down.

Command Syntax

SyntaxDescription
<domain-id>The name of the bridge domain.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv set bridge domain br_default stp state up

nv set bridge domain <domain-id> stp vlan <vid>

Configures PVRST settings for a VLAN.


nv set bridge domain <domain-id> stp vlan <vid> bridge-priority

Configures the spanning tree priority for a VLAN when in PVRST mode. You can set a value between 4096 and 61440.

Command Syntax

SyntaxDescription
<domain-id>The name of the bridge domain.
<vid>The VLAN identifier.

Version History

Introduced in Cumulus Linux 5.6.0

Example

cumulus@switch:~$ nv set bridge domain br_default stp vlan 10 bridge-priority 4096

nv set bridge domain <domain-id> stp vlan <vid> hello-time

Configures the hello timer for a VLAN when in PVRST mode. The hello timer sets how often to broadcast hello messages to other switches. You can set a value between 1 and 10 seconds.

Command Syntax

SyntaxDescription
<domain-id>The name of the bridge domain.
<vid>The VLAN identifier.

Version History

Introduced in Cumulus Linux 5.6.0

Example

cumulus@switch:~$ nv set bridge domain br_default stp vlan 10 hello-time 4 

nv set bridge domain <domain-id> stp vlan <vid> forward-delay

Configures the forward delay for a VLAN when in PVRST mode. The forward delay sets the delay before changing the spanning tree state from blocking to forwarding. You can set a value between 4 and 30 seconds.

Command Syntax

SyntaxDescription
<domain-id>The name of the bridge domain.
<vid>The VLAN identifier.

Version History

Introduced in Cumulus Linux 5.6.0

Example

cumulus@switch:~$ nv set bridge domain br_default stp vlan 10 forward-delay 4 

nv set bridge domain <domain-id> stp vlan <vid> max-age

Configures the max age for a VLAN when in PVRST mode. The max age sets the maximum amount of time STP information is retained before it is discarded. You can set a value between 6 and 40 seconds.

Command Syntax

SyntaxDescription
<domain-id>The name of the bridge domain.
<vid>The VLAN identifier.

Version History

Introduced in Cumulus Linux 5.6.0

Example

cumulus@switch:~$ nv set bridge domain br_default stp vlan 10 max-age 6

nv set bridge domain <domain-id> svi-force-up enable

Configures the SVIs in a specific bridge to be perpetually UP. The first time you configure a switch, all southbound bridge ports are down; therefore, by default, all SVIs are also down. You can run this command to force the SVIs in a bridge to always be UP even if all member ports are DOWN, which is beneficial if you want to perform connectivity testing.

You can specify on or off.

Command Syntax

SyntaxDescription
<domain-id>The name of the bridge domain.

Version History

Introduced in Cumulus Linux 5.8.0

Example

cumulus@switch:~$ nv set bridge domain br_default svi-force-up enable on

nv set bridge domain <domain-id> type vlan-aware

Configures the bridge domain to be VLAN-aware.

Command Syntax

SyntaxDescription
<domain-id>The name of the bridge domain.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv set bridge domain br_default type vlan-aware

nv set bridge domain <domain-id> untagged

Configures the interfaces on the bridge domain to be untagged so that they pass traffic for only a single VLAN.

Command Syntax

SyntaxDescription
<domain-id>The name of the bridge domain.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv set bridge domain br_default untagged none

nv set bridge domain <domain-id> vlan <vid>

Configures the VLAN tag identifier.

Command Syntax

SyntaxDescription
<domain-id>The name of the bridge domain.
<vid>The VLAN identifier.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv set bridge domain br_default vlan 10

nv set bridge domain <domain-id> vlan <vid> ptp

Configures Precision Time Protocol (PTP) on the all interfaces in the specified VLAN.


nv set bridge domain <domain-id> vlan <vid> ptp enable

Turns PTP on or off for the specified VLAN. The default setting is off.

Command Syntax

SyntaxDescription
<domain-id>The name of the bridge domain.
<vid>The VLAN identifier.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv set bridge domain br_default vlan vlan10 ptp enable on

nv set bridge domain <domain-id> vlan <vid> vni <vni-id>

Maps a VLAN to a VNI.

Command Syntax

SyntaxDescription
<domain-id>The name of the bridge domain.
<vid>The VLAN identifier.
<vni-id>The VXLAN ID.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv set bridge domain br_default vlan 10 vni 10

nv set bridge domain <domain-id> vlan <vid> vni <vni-id> flooding

Configures BUM traffic handling.


nv set bridge domain <domain-id> vlan <vid> vni <vni-id> flooding enable

Turns flooding on or off for the specified VNI.

Command Syntax

SyntaxDescription
<domain-id>The name of the bridge domain.
<vid>The VLAN identifier.
<vni-id>The VXLAN ID.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv set bridge domain br_default vlan 10 vni 10 flooding enable on

nv set bridge domain <domain-id> vlan <vid> vni <vni-id> flooding head-end-replication <hrep-id>

Configures replication of BUM traffic where individual copies send to remote destinations.

Command Syntax

SyntaxDescription
<domain-id>The name of the bridge domain.
<vid>The VLAN identifier.
<vni-id>The VXLAN ID.
<hrep-id>The IPv4 unicast addresses or evpn.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv set bridge domain br_default vlan 10 vni 10 flooding head-end-replication 10.10.10.2

nv set bridge domain <domain-id> vlan <vid> vni <vni-id> flooding multicast-group <ipv4-multicast>

Configures BUM traffic to go to the specified multicast group, where receivers who are interested in that group receive the traffic. This requires you to use PIM-SM in the network.

Command Syntax

SyntaxDescription
<domain-id>The name of the bridge domain.
<vid>The VLAN identifier.
<vni-id>The VXLAN ID.
<ipv4-multicast>The multicast group.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv set bridge domain br_default vlan 10 vni 10 flooding multicast-group 224.0.0.10

nv set bridge domain <domain-id> vlan <vid> vni <vni-id> mac-learning

Turns MAC learning on or off for the VNI. The default setting is off.

Command Syntax

SyntaxDescription
<domain-id>The name of the bridge domain.
<vid>The VLAN identifier.
<vni-id>The VXLAN ID.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv set bridge domain br_default vlan 10 vni 10 mac-learning off

nv set bridge domain <domain-id> vlan <vid> multicast

Configures multicast on the VLAN.


nv set bridge domain <domain-id> vlan <vid> multicast snooping

Configures IGMP and MLD snooping on the VLAN.


nv set bridge domain <domain-id> vlan <vid> multicast snooping querier

Configures the IGMP and MLD querier on the VLAN.

Version History

Introduced in Cumulus Linux 5.0.0


nv set bridge domain <domain-id> vlan <vid> multicast snooping querier source-ip <source-ip>

Configures the source IP address you want to use to send IGMP MLD queries.

Command Syntax

SyntaxDescription
<domain-id>The name of the bridge domain.
<vid>The VLAN identifier.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv set bridge domain br_default vlan vlan10 multicast snooping querier source-ip 10.10.10.1

nv set bridge domain <domain-id> vlan-vni-offset

Configures the VNI offset when mapping VLANs to VNIs automatically. You can set a value between 0 and 16773120. For example, if you specify an offset of 10000, the VNI is the VLAN plus 10000.

Command Syntax

SyntaxDescription
<domain-id>The name of the bridge domain.

Version History

Introduced in Cumulus Linux 5.1.0

Example

cumulus@switch:~$ nv set bridge domain br_default vlan-vni-offset 10000

nv set interface <interface-id> bridge

Configures the bridged interface.


nv set interface <interface-id> bridge domain <domain-id>

Configures the bridged interface domain.

Command Syntax

SyntaxDescription
<interface-id>The interface you want to configure.
<domain-id>The name of the bridge domain.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv set interface swp1 bridge domain default

nv set interface <interface-id> bridge domain <domain-id> access

Configures access ports to ignore all tagged packets. You can set a value between 1 and 4094, none, or auto.

Command Syntax

SyntaxDescription
<interface-id>The interface you want to configure.
<domain-id>The name of the bridge domain.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv set interface swp1 bridge domain default access 10

nv set interface <interface-id> bridge domain <domain-id> learning

Turns source MAC address learning on or off for this bridged interface.

Command Syntax

SyntaxDescription
<interface-id>The interface you want to configure.
<domain-id>The name of the bridge domain.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv set interface swp1 bridge domain default learning on

nv set interface <interface-id> bridge domain <domain-id> stp

Configures STP on the bridged interface domain.


nv set interface <interface-id> bridge domain <domain-id> stp admin-edge

Turns STP PortAdminEdge on or off on the bridged interface. PortAdminEdge is equivalent to the PortFast feature offered by other vendors. It enables or disables the initial edge state of a port in a bridge. All ports with PortAdminEdge on bypass the listening and learning states and go straight to forwarding.

Command Syntax

SyntaxDescription
<interface-id>The interface you want to configure.
<domain-id>The name of the bridge domain.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv set interface swp1 bridge domain default stp admin-edge on

nv set interface <interface-id> bridge domain <domain-id> stp auto-edge

Turns STP AutoEdge on or off on the bridged interface. PortAutoEdge is an enhancement to the standard PortAdminEdge (PortFast) mode, which allows for the automatic detection of edge ports. PortAutoEdge enables and disables the auto transition to and from the edge state of a port in a bridge.

When a port with PortAutoEdge receives a BPDU, the port stops being in the edge port state and transitions into a normal STP port. When the interface no longer receives BPDUs, the port becomes an edge port, and transitions through the discarding and learning states before it resumes forwarding.

Command Syntax

SyntaxDescription
<interface-id>The interface you want to configure.
<domain-id>The name of the bridge domain.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv set interface swp1 bridge domain default stp auto-edge on

nv set interface <interface-id> bridge domain <domain-id> stp bpdu-filter

Turns bpdufilter on or off on a bridge domain. When on, bpdufilter filters BPDUs in both directions.

Command Syntax

SyntaxDescription
<interface-id>The interface you want to configure.
<domain-id>The name of the bridge domain.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv set interface swp1 bridge domain default stp bpdu-filter on

nv set interface <interface-id> bridge domain <domain-id> stp bpdu-guard

Turns BPDU guard on or off on the bridged interface to protect the spanning tree topology from an unauthorized device affecting the forwarding path. For example, if you add a new host to an access port off a leaf switch and the host sends an STP BPDU, BPDU guard protects against undesirable topology changes in the environment.

Command Syntax

SyntaxDescription
<interface-id>The interface you want to configure.
<domain-id>The name of the bridge domain.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv set interface swp1 bridge domain default stp bpdu-guard on

nv set interface <interface-id> bridge domain <domain-id> stp network

Turns bridge assurance capability for a bridged port on or off.

Command Syntax

SyntaxDescription
<interface-id>The interface you want to configure.
<domain-id>The name of the bridge domain.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv set interface swp1 bridge domain default stp network

nv set interface <interface-id> bridge domain <domain-id> stp restrrole

Turns STP restricted role for the bridged port on or off.

Command Syntax

SyntaxDescription
<interface-id>The interface you want to configure.
<domain-id>The name of the bridge domain.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv set interface swp1 bridge domain default stp restrrole

nv set interface <interface-id> bridge domain <domain-id> stp vlan <vid>

Configures PVRST settings for an interface.


nv set interface <interface-id> bridge domain <domain-id> stp vlan <vid> priority

Configures the interface port priority for a VLAN. You can specify a priority between 0 and 240; the value must be a multiple of 16.

Command Syntax

SyntaxDescription
<interface-id>The interface you want to configure.
<domain-id>The name of the bridge domain.
<vid>The VLAN identifier.

Version History

Introduced in Cumulus Linux 5.6.0

Example

cumulus@switch:~$ nv set interface swp1 bridge domain default stp vlan 10 priority 240

nv set interface <interface-id> bridge domain <domain-id> stp vlan <vid> path-cost

Configures the interface path cost for a VLAN to influence the spanning tree forwarding path. You can specify a path cost between 1 and 200000000.

Command Syntax

SyntaxDescription
<interface-id>The interface you want to configure.
<domain-id>The name of the bridge domain.
<vid>The VLAN identifier.

Version History

Introduced in Cumulus Linux 5.6.0

Example

cumulus@switch:~$ nv set interface swp1 bridge domain default stp vlan 10 path-cost 4000

nv set interface <interface-id> bridge domain <domain-id> stp path-cost

Configures the path cost for an interface in the bridge to influence the spanning tree forwarding path. You can specify a value between 1 and 200000000.

For PVRST mode, the port cost for a VLAN takes precedence over the cost for a port. If you do not configure the port cost for a VLAN, Cumulus Linux applies the port cost to all the interfaces in the VLAN. If you do not configure either the port cost for a VLAN or the cost for a port, Cumulus Linux bases the port cost on the link speed.

Command Syntax

SyntaxDescription
<interface-id>The interface you want to configure.
<domain-id>The name of the bridge domain.

Version History

Introduced in Cumulus Linux 5.6.0

Example

cumulus@switch:~$ nv set interface swp1 bridge domain default stp path-cost 4000

nv set interface <interface-id> bridge domain <domain-id> untagged

Configures the VLAN in which untagged packets ingress this bridged interface. Egress packets are always tagged. You can set a value between 1 and 4094, none, or auto. If you specify none, the switch drops untagged packets.

Command Syntax

SyntaxDescription
<interface-id>The interface you want to configure.
<domain-id>The name of the bridge domain.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv set interface swp1 bridge domain default untagged none

nv set interface <interface-id> bridge domain <domain-id> vlan <vid>

Configures a VLAN for the bridged interface.

Command Syntax

SyntaxDescription
<interface-id>The interface you want to configure.
<domain-id>The name of the bridge domain.
<vid>The VLAN name.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv set interface swp1 bridge domain default vlan 10

nv set system global svi-force-up enable

Configures all SVIs in all bridges on the switch to be perpetually UP. The first time you configure a switch, all southbound bridge ports are down; therefore, by default, all SVIs are also down. You can run this command to force all SVIs on all bridges to always be UP even when all member ports are DOWN, which is beneficial if you want to perform connectivity testing.

You can specify on or off.

Version History

Introduced in Cumulus Linux 5.8.0

Example

cumulus@switch:~$ nv set system global svi-force-up enable on