Dot1q Ethernet Port

Diagram

Classes

topology_switch_dot1q_host_interface (vxlan.topology.switches.interfaces)

Name	Type	Constraint	Mandatory
name	String	Regex: `^(?:e\|eth(?:ernet)?)\d(?:\/\d+){1,2}$`	Yes
mode	Choice	`dot1q`	Yes
description	String	max: `256`	No
mtu	Any	Integer[min: `1500`, max: `9216`] or Choice[`default`, `jumbo`]	No
speed	String	Regex: `(?i)^(auto\|100mb\|1gb\|10gb\|25gb\|40gb\|100gb\|200gb\|400gb\|800gb)$`	No
enabled	Boolean	`true`, `false`	No
enable_cdp	Boolean	`true`, `false`	No
access_vlan	Integer	min: `1`, max: `4094`	No
spanning_tree_portfast	Boolean	`true`, `false`	No
enable_bpdu_guard	Boolean	`true`, `false`	No
duplex	Choice	`auto`, `full`, `half`	No
orphan_port	Boolean	`true`, `false`	No
freeform_config	String		No
fec	Choice	`auto`, `fc-fec`, `off`, `rs-cons16`, `rs-fec`, `rs-ieee`	No
enable_storm_control	Boolean	`true`, `false`	No
storm_control_action	Choice	`shutdown`, `trap`, `default`	No
storm_control_broadcast_level_percent	Number	min: `0.0`, max: `100.0`	No
storm_control_broadcast_level_pps	Integer	min: `0`, max: `200000000`	No
storm_control_multicast_level_percent	Number	min: `0.0`, max: `100.0`	No
storm_control_multicast_level_pps	Integer	min: `0`, max: `200000000`	No
storm_control_unicast_level_percent	Number	min: `0.0`, max: `100.0`	No
storm_control_unicast_level_pps	Integer	min: `0`, max: `200000000`	No

Forward Error Correction (FEC)

If you previously configured FEC via freeform_config, you must migrate to the fec parameter using the same value and remove the FEC configuration from freeform_config to avoid conflicts.

Forward Error Correction (FEC) controls error correction on the physical interface. The following FEC modes are supported:

auto - Automatic FEC selection (default, not visible in show run)
fc-fec - FireCode FEC (also known as BASE-R or Clause 74)
off - FEC disabled
rs-cons16 - Reed-Solomon FEC Consortium 1.6
rs-fec - Reed-Solomon FEC (Clause 91 for 100G, Consortium 1.5 for 25G/50G)
rs-ieee - Reed-Solomon FEC IEEE standard

Storm Control

If you previously configured storm control via freeform_config, you must migrate to the storm control parameters using the same values and remove the storm control configuration from freeform_config to avoid conflicts.

You cannot configure both percentage-based (*_percent) and PPS-based (*_pps) thresholds on the same interface. Choose one method per interface.

Storm control prevents traffic storms on Layer 2 interfaces by limiting broadcast, multicast, and unicast traffic. The following parameters are supported:

Control Parameters:

enable_storm_control - Enable or disable storm control (boolean)
storm_control_action - Action when threshold is exceeded: shutdown, trap, or default

Percentage-based Thresholds (0.00-100.00%):

storm_control_broadcast_level_percent - Broadcast traffic threshold as percentage of bandwidth
storm_control_multicast_level_percent - Multicast traffic threshold as percentage of bandwidth
storm_control_unicast_level_percent - Unicast traffic threshold as percentage of bandwidth

PPS-based Thresholds (0-200000000 packets/sec):

storm_control_broadcast_level_pps - Broadcast traffic threshold in packets per second
storm_control_multicast_level_pps - Multicast traffic threshold in packets per second
storm_control_unicast_level_pps - Unicast traffic threshold in packets per second

Example 1 - Basic Dot1q Configuration

The provided CLI configures interface Ethernet1/11 with the following settings:

switchport mode dot1q-tunnel: Sets the port to operate in 802.1Q tunnel mode (Q-in-Q), encapsulating VLAN tags for tunneling VLAN traffic transparently.

interface Ethernet1/11
  no shutdown
  description Dot1q tunnel interface
  spanning-tree port type edge
  spanning-tree bpduguard enable
  mtu 9216
  spanning-tree bpdufilter enable
  switchport
  switchport mode dot1q-tunnel

vxlan:
  topology:
    switches:
      - name: dc1-leaf1
        interfaces:
          - name: e1/11
            mode: dot1q
            description: 'Dot1q Interface 1'
            enabled: true
            speed: auto
            access_vlan: 1

Example 2 - Dot1q with FEC on 25G Interface

vxlan:
  topology:
    switches:
      - name: dc1-leaf1
        interfaces:
          - name: Ethernet1/7
            mode: dot1q
            description: '25G Dot1q with RS-FEC Consortium 1.6'
            speed: 25gb
            fec: rs-cons16
            access_vlan: 1

Example 3 - Dot1q with Storm Control

vxlan:
  topology:
    switches:
      - name: dc1-leaf1
        interfaces:
          - name: Ethernet1/12
            mode: dot1q
            description: 'Dot1q with storm control'
            access_vlan: 1
            enable_storm_control: true
            storm_control_action: shutdown
            storm_control_broadcast_level_percent: 10.00