Skip to content

Breakout Interface

Diagram

Diagram

Classes

switches (vxlan.topology)

NameTypeConstraintMandatoryDefault Value
interface_breakoutsList[interface_breakouts]No

interface_breakouts (vxlan.topology.switches)

NameTypeConstraintMandatoryDefault Value
moduleIntegermin: 0, max: 32No1
fromIntegermin: 0, max: 256No1
toIntegermin: 0, max: 256No1
mapChoice10g-4x, 25g-4x, 50g-2x, 50g-4x, 100g-2x, 100g-2x-pam4, 100g-4x, 200g-2xNo10g-4x
enable_during_bootstrapBooleantrue, falseNofalse

Example 1

Starting with release 0.4.3, breakout interfaces can be configured.

In the following example the command interface breakout module 1 port 49,51-52 map 10g-4x is used on Cisco Nexus switches to split specific high-bandwidth physical ports into multiple lower-speed interfaces. Here’s what it means in detail:

  • Module 1: Refers to the line card or module number in the switch chassis.
  • Ports 49, 51-52: Specifies the individual ports on the module to be broken out.
  • map 10g-4x: Indicates that each specified port, which is originally a single 40G port, will be split into four separate 10G interfaces.

This feature is available on multiple Nexus platforms; however, the supported breakout modes may vary based on the specific hardware and NX-OS version. Please consult your switch’s data sheet to confirm the supported configurations. Nexus 9000 serie switches Data Sheets

Terminal window
interface breakout module 1 port 49,51-52 map 10g-4x
interface Ethernet1/49/1
description trunk breakout eth1/49/1
switchport
switchport mode trunk
switchport trunk allowed vlan none
spanning-tree port type edge trunk
mtu 9216
no shutdown
interface Ethernet1/49/2
switchport
switchport mode trunk
switchport trunk allowed vlan none
spanning-tree port type edge trunk
mtu 9216
no shutdown
interface Ethernet1/49/3
switchport
switchport mode trunk
switchport trunk allowed vlan none
spanning-tree port type edge trunk
mtu 9216
no shutdown
interface Ethernet1/49/4
switchport
switchport mode trunk
switchport trunk allowed vlan none
spanning-tree port type edge trunk
mtu 9216
no shutdown
interface Ethernet1/50
switchport
switchport mode trunk
switchport trunk allowed vlan none
spanning-tree port type edge trunk
mtu 9216
no shutdown
interface Ethernet1/51/1
switchport
switchport mode trunk
switchport trunk allowed vlan none
spanning-tree port type edge trunk
mtu 9216
no shutdown
interface Ethernet1/51/2
description trunk breakout eth1/51/2
switchport
spanning-tree port type edge
mtu 9216
no shutdown
interface Ethernet1/51/3
switchport
switchport mode trunk
switchport trunk allowed vlan none
spanning-tree port type edge trunk
mtu 9216
no shutdown
interface Ethernet1/51/4
switchport
switchport mode trunk
switchport trunk allowed vlan none
spanning-tree port type edge trunk
mtu 9216
no shutdown
interface Ethernet1/52/1
switchport
switchport mode trunk
switchport trunk allowed vlan none
spanning-tree port type edge trunk
mtu 9216
no shutdown
interface Ethernet1/52/2
switchport
switchport mode trunk
switchport trunk allowed vlan none
spanning-tree port type edge trunk
mtu 9216
no shutdown
interface Ethernet1/52/3
description trunk breakout eth1/52/3
switchport
spanning-tree port type edge
mtu 9216
no shutdown
interface Ethernet1/52/4
switchport
switchport mode trunk
switchport trunk allowed vlan none
spanning-tree port type edge trunk
mtu 9216
no shutdown
topology.nac.yaml
---
vxlan:
topology:
switches:
- name: dc1-leaf1
role: leaf
management:
default_gateway_v4: 172.16.0.254
management_ipv4_address: 172.16.0.6
subnet_mask_ipv4: 24
serial_number: AAAAAAAAAA
interface_breakouts:
- module: 1
from: 49
map: 10g-4x
- module: 1
from: 51
to: 52
map: 10g-4x
interfaces:
- name: Ethernet1/49/1
mode: trunk
description: 'trunk breakout eth1/49/1'
enabled: true
mtu: jumbo
speed: auto
spanning_tree_portfast: true
enable_bpdu_guard: true
- name: Ethernet1/51/2
mode: access
description: 'access breakout eth1/51/2'
enabled: true
mtu: jumbo
speed: auto
spanning_tree_portfast: true
enable_bpdu_guard: true
- name: Ethernet1/52/3
mode: access
description: 'access breakout eth1/52/3'
enabled: true
mtu: jumbo
speed: auto
spanning_tree_portfast: true
enable_bpdu_guard: true