Global Interface Settings

Global interface settings define device-wide defaults and behavior that apply across interfaces on NX-OS devices. They include Ethernet defaults for switchport mode, shutdown behavior, unsupported transceiver support, multicast storm control, native VLAN tagging, link-status syslog levels and interface syslog info, as well as port-channel load-balancing hash parameters, port-channel fast convergence, SVI autostate behavior, interface breakout maps for high-density ports, and errdisable detection and automatic recovery, which control which error conditions, such as link flap, BPDU guard, storm control or UDLD, place an interface into the error-disabled state and how it recovers.

ethernet.default_switchport (system default switchport) also sets the layer of interfaces.ethernets and interfaces.port_channels entries that do not set switchport.enabled. With layer3, these interfaces are configured as routed interfaces (no switchport), receive their IPv4 and IPv6 configuration, and their spanning-tree and VTP settings are skipped. Set switchport.enabled to override the default per interface. When feature vtp is enabled, NX-OS 10.5(6) rejects no system default switchport while any Layer 3 interface exists.

Diagram

Classes

nxos

Name	Type	Constraint	Mandatory
devices	List	devices	No
device_groups	List	device_groups	No
global	Class	global	No
templates	List	templates	No

devices (nxos)

Name	Type	Constraint	Mandatory	Default Value
configuration	Class	configuration	No

device_groups (nxos)

Name	Type	Constraint	Mandatory	Default Value
configuration	Class	configuration	No

global (nxos)

Name	Type	Constraint	Mandatory	Default Value
configuration	Class	configuration	No

templates (nxos)

Name	Type	Constraint	Mandatory	Default Value
configuration	Class	configuration	No

configuration (nxos.devices)

Name	Type	Constraint	Mandatory	Default Value
system	Class	system	No

system (nxos.devices.configuration)

Name	Type	Constraint	Mandatory
ethernet	Class	ethernet	No
port_channel	Class	port_channel	No
interface_vlan_autostate	Boolean	`true`, `false`	No
interface_breakout_modules	List	interface_breakout_modules	No
errdisable	Class	errdisable	No

ethernet (nxos.devices.configuration.system)

Name	Type	Constraint	Mandatory
default_switchport_shutdown	Boolean	`true`, `false`	No
service_unsupported_transceiver	Boolean	`true`, `false`	No
default_switchport	Choice	`layer2`, `layer3`	No
logging_event_port	Choice	`link-status-default`, `link-status-enable`, `none`, `trunk-status-default`, `trunk-status-enable`	No
default_interface_shutdown	Choice	`down`, `down-exclude-fabric`, `up`	No
link_failure_laser_on	Boolean	`true`, `false`	No
storm_control_multicast	Boolean	`true`, `false`	No
dot1q_tag_native	Boolean	`true`, `false`	No
admin_link_down_syslog_level	Integer	min: `0`, max: `7`	No
admin_link_up_syslog_level	Integer	min: `0`, max: `7`	No
interface_syslog_info	Choice	`default`, `info-1`	No

port_channel (nxos.devices.configuration.system)

Name	Type	Constraint	Mandatory
fast_convergence	Boolean	`true`, `false`	No
load_balance	Choice	`dlb`, `rtag7`, `rtag7-murmur`, `rtag7-local-crc`, `dynamic-pin`	No
load_balance2_resilient	Boolean	`true`, `false`	No
load_balance_mpls_label_ip	Boolean	`true`, `false`	No
load_balance_mpls_label_only	Boolean	`true`, `false`	No
load_balance_direction	Choice	`src-dst`, `src`, `dst`	No
load_balance_fields	Choice	`ip`, `ip-gre`, `ip-l4port`, `ip-l4port-vlan`, `ip-vlan`, `l4port`, `mac`, `inner-header`, `gtpu`	No
load_balance_encapsulation	Choice	`gre`, `gtp`, `mpls-label-ip`, `mpls-label-only`	No
load_balance_rotate	Integer	min: `0`, max: `63`	No
load_balance_concatenation	Boolean	`true`, `false`	No
load_balance_fex_all	Boolean	`true`, `false`	No
load_balance_symmetric	Boolean	`true`, `false`	No
scale_fanout	Boolean	`true`, `false`	No

interface_breakout_modules (nxos.devices.configuration.system)

Name	Type	Constraint	Mandatory	Default Value
id	Integer	min: `1`, max: `32`	Yes
ports	List	ports	No

errdisable (nxos.devices.configuration.system)

Name	Type	Constraint	Mandatory
detect_cause	Class	detect_cause	No
recovery_cause	Class	recovery_cause	No
recovery_interval	Integer	min: `30`, max: `65535`	No

ports (nxos.devices.configuration.system.interface_breakout_modules)

Name	Type	Constraint	Mandatory	Default Value
id	Integer	min: `1`, max: `108`	Yes
map	Choice	`no-breakout`, `10g-4x`, `50g-2x`, `25g-4x`, `10g-2x`, `100g-4x`, `50g-4x`, `200g-1x`, `100g-2x`, `200g-2x`, `40g-1x`, `400g-2x`, `100g-8x`, `800g-1x`, `100g-2x-pam4`	No

detect_cause (nxos.devices.configuration.system.errdisable)

Name	Type	Constraint	Mandatory	Default Value
link_flap	Boolean	`true`, `false`	No
loopback	Boolean	`true`, `false`	No

recovery_cause (nxos.devices.configuration.system.errdisable)

Name	Type	Constraint	Mandatory
bpduguard	Boolean	`true`, `false`	No
dcbx_no_ack	Boolean	`true`, `false`	No
failed_port_state	Boolean	`true`, `false`	No
link_flap	Boolean	`true`, `false`	No
loopback	Boolean	`true`, `false`	No
pause_rate_limit	Boolean	`true`, `false`	No
psecure_violation	Boolean	`true`, `false`	No
security_violation	Boolean	`true`, `false`	No
storm_control	Boolean	`true`, `false`	No
udld	Boolean	`true`, `false`	No
vpc_peerlink	Boolean	`true`, `false`	No

Examples

Example 1: VXLAN leaf switch with Ethernet defaults

nxos:
  devices:
    - name: LEAF1
      configuration:
        system:
          ethernet:
            default_switchport: layer2
            default_switchport_shutdown: false
            service_unsupported_transceiver: true

Example 2: Ethernet defaults with link-status syslog tuning and native VLAN tagging

nxos:
  devices:
    - name: LEAF1
      configuration:
        system:
          ethernet:
            default_switchport: layer2
            default_switchport_shutdown: false
            dot1q_tag_native: true
            logging_event_port: link-status-enable
            admin_link_down_syslog_level: 4
            admin_link_up_syslog_level: 4
            interface_syslog_info: info-1

Example 3: SVI autostate and interface breakout configuration for high-density ports

nxos:
  devices:
    - name: LEAF1
      configuration:
        system:
          interface_vlan_autostate: false
          interface_breakout_modules:
            - id: 1
              ports:
                - id: 49
                  map: 10g-4x
                - id: 50
                  map: 25g-4x

Example 4: Port-channel resilient load balancing

nxos:
  devices:
    - name: LEAF1
      configuration:
        system:
          port_channel:
            load_balance: rtag7
            load_balance2_resilient: true

Example 5: Port-channel load-balancing hash on source/destination IP and L4 port with rotation, concatenation and symmetric hashing (port-channel load-balance <src-dst|src|dst> <fields> [<encapsulation>] [rotate <rotate>] [concatenation] [fex all] [symmetric])

nxos:
  devices:
    - name: LEAF1
      configuration:
        system:
          port_channel:
            load_balance_direction: src-dst
            load_balance_fields: ip-l4port
            load_balance_rotate: 3
            load_balance_concatenation: true
            load_balance_symmetric: true

Example 6: Port-channel load-balancing on MPLS label and IP (port-channel load-balance src-dst ip-l4port mpls label-ip)

nxos:
  devices:
    - name: LEAF1
      configuration:
        system:
          port_channel:
            load_balance_direction: src-dst
            load_balance_fields: ip-l4port
            load_balance_encapsulation: mpls-label-ip

Example 7: Errdisable detection and automatic recovery (errdisable detect cause <cause>, errdisable recovery cause <cause>, errdisable recovery interval <seconds>)

nxos:
  devices:
    - name: LEAF1
      configuration:
        system:
          errdisable:
            recovery_interval: 600
            detect_cause:
              link_flap: true
              loopback: false
            recovery_cause:
              bpduguard: true
              link_flap: true
              psecure_violation: true
              storm_control: true
              udld: true