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 domain <domain-id>
Configures the bridge.
Command Syntax
Syntax | Description |
---|---|
<domain-id> |
The bridge name. |
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
Syntax | Description |
---|---|
<domain-id> |
The bridge name. |
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> dhcp-snoop vlan <vid>
Enables DHCP snooping for IPv4 on a VLAN under a bridge.
Command Syntax
Syntax | Description |
---|---|
<domain-id> |
The bridge name. |
<vlan-id> |
The VLAN name. |
Version History
Introduced in Cumulus Linux 5.11.0
Example
cumulus@switch:~$ nv set bridge domain br_default dhcp-snoop vlan 10
nv set bridge domain <domain-id> dhcp-snoop vlan <vid> trust <interface-id>
Configures a trusted interface for IPv4. Cumulus Linux allows DHCP offers from only trusted interfaces to prevent malicious DHCP servers from assigning IPv4 addresses inside the network. The interface must be a member of the bridge you specify.
Command Syntax
Syntax | Description |
---|---|
<domain-id> |
The bridge name. |
<vlan-id> |
The VLAN name. |
<interface-id> |
The trusted interface ID. |
Version History
Introduced in Cumulus Linux 5.11.0
Example
cumulus@switch:~$ nv set bridge domain br_default dhcp-snoop vlan 10 trust swp3
nv set bridge domain <domain-id> dhcp-snoop6 vlan <vid>
Enables DHCP snooping for IPv6 on a VLAN under a bridge.
Command Syntax
Syntax | Description |
---|---|
<domain-id> |
The bridge name. |
<vlan-id> |
The VLAN name. |
Version History
Introduced in Cumulus Linux 5.11.0
Example
cumulus@switch:~$ nv set bridge domain br_default dhcp-snoop6 vlan 10
nv set bridge domain <domain-id> dhcp-snoop6 vlan <vid> trust <interface-id>
Configures a trusted interface for IPv6. Cumulus Linux allows DHCP offers from only trusted interfaces to prevent malicious DHCP servers from assigning IPv6 addresses inside the network. The interface must be a member of the bridge you specify.
Command Syntax
Syntax | Description |
---|---|
<domain-id> |
The bridge name. |
<vlan-id> |
The VLAN name. |
<interface-id> |
The trusted interface ID. |
Version History
Introduced in Cumulus Linux 5.11.0
Example
cumulus@switch:~$ nv set bridge domain br_default dhcp-snoop6 vlan 10 trust swp3
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 bridge name. |
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 bridge name. |
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.
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 bridge name. |
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 enable
Turns the IGMP and MLD multicast querier on or off. The default setting is off
.
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.
Command Syntax
Syntax | Description |
---|---|
<domain-id> |
The bridge name. |
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 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
Syntax | Description |
---|---|
<domain-id> |
The bridge name. |
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
Syntax | Description |
---|---|
<domain-id> |
The bridge name. |
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
Syntax | Description |
---|---|
<domain-id> |
The bridge name. |
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 bridge name. |
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> 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
Syntax | Description |
---|---|
<domain-id> |
The bridge name. |
<vlan-id> |
The VLAN name. |
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
Syntax | Description |
---|---|
<domain-id> |
The bridge name. |
<vlan-id> |
The VLAN name. |
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
Syntax | Description |
---|---|
<domain-id> |
The bridge name. |
<vlan-id> |
The VLAN name. |
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
Syntax | Description |
---|---|
<domain-id> |
The bridge name. |
<vlan-id> |
The VLAN name. |
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
Syntax | Description |
---|---|
<domain-id> |
The bridge name. |
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 to be VLAN-aware.
Command Syntax
Syntax | Description |
---|---|
<domain-id> |
The bridge name. |
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 to be untagged so that they pass traffic for only a single VLAN.
Command Syntax
Syntax | Description |
---|---|
<domain-id> |
The bridge name. |
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 bridge name. |
<vlan-id> |
The VLAN name. |
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 enable
Turns PTP on or off for the specified VLAN. The default setting is off
.
Command Syntax
Syntax | Description |
---|---|
<domain-id> |
The bridge name. |
<vlan-id> |
The VLAN name. |
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 bridge name. |
<vlan-id> |
The VLAN name. |
<vni-id> |
The VXLAN name. |
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 enable
Turns BUM traffic handling on or off for the specified VNI.
Command Syntax
Syntax | Description |
---|---|
<domain-id> |
The bridge name. |
<vlan-id> |
The VLAN name. |
<vni-id> |
The VXLAN name. |
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 bridge name. |
<vlan-id> |
The VLAN name. |
<vni-id> |
The VXLAN name. |
<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 bridge name. |
<vlan-id> |
The VLAN name. |
<vni-id> |
The VXLAN name. |
<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 bridge name. |
<vlan-id> |
The VLAN name. |
<vni-id> |
The VXLAN name. |
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 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 bridge name. |
<vlan-id> |
The VLAN name. |
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 bridge name. |
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 domain <domain-id>
Configures the bridged interface domain.
Command Syntax
Syntax | Description |
---|---|
<interface-id> |
The interface you want to configure. |
<domain-id> |
The bridge name. |
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 bridge name. |
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 bridge name. |
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 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 bridge name. |
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 bridge name. |
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 bridge name. |
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 bridge name. |
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 bridge name. |
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 bridge name. |
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> 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
Syntax | Description |
---|---|
<interface-id> |
The interface you want to configure. |
<domain-id> |
The bridge name. |
<vlan-id> |
The VLAN name. |
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
Syntax | Description |
---|---|
<interface-id> |
The interface you want to configure. |
<domain-id> |
The bridge name. |
<vlan-id> |
The VLAN name. |
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
Syntax | Description |
---|---|
<interface-id> |
The interface you want to configure. |
<domain-id> |
The bridge name. |
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
Syntax | Description |
---|---|
<interface-id> |
The interface you want to configure. |
<domain-id> |
The bridge name. |
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 bridge name. |
<vlan-id> |
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