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
Syntax | Description |
---|---|
<domain-id> | The name of the bridge domain. |
Version History
Introduced in Cumulus Linux 5.0.0
nv set bridge domain br_default 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.
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
Syntax | Description |
---|---|
<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
Syntax | Description |
---|---|
<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
Syntax | Description |
---|---|
<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
Syntax | Description |
---|---|
<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 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
Syntax | Description |
---|---|
<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
Syntax | Description |
---|---|
<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> type vlan-aware
Configures the bridge domain to be VLAN-aware.
Command Syntax
Syntax | Description |
---|---|
<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
Syntax | Description |
---|---|
<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
Syntax | Description |
---|---|
<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
Syntax | Description |
---|---|
<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
Syntax | Description |
---|---|
<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
Syntax | Description |
---|---|
<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
Syntax | Description |
---|---|
<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
Syntax | Description |
---|---|
<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
Syntax | Description |
---|---|
<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
Syntax | Description |
---|---|
<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
Syntax | Description |
---|---|
<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
Syntax | Description |
---|---|
<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
Syntax | Description |
---|---|
<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
Syntax | Description |
---|---|
<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
Syntax | Description |
---|---|
<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
Syntax | Description |
---|---|
<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
Syntax | Description |
---|---|
<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
Syntax | Description |
---|---|
<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
Syntax | Description |
---|---|
<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
Syntax | Description |
---|---|
<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> 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
Syntax | Description |
---|---|
<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
Syntax | Description |
---|---|
<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