System

System configuration encompasses fundamental device-level settings that define core operational behavior including hostname identification, global MTU, NV overlay VXLAN UDP port settings, and SVI autostate behavior. It includes global IPv4 settings (IP routing, ECMP hash tuning, ICMP redirect logging, source route control), and global IPv6 settings (IPv6 routing, access list local match behavior). System configuration also manages Ethernet defaults for switchport mode, shutdown behavior, transceiver support, storm control, link-status syslog levels, and interface syslog info, establishing the foundational operational baseline for NX-OS devices.

Diagram

Classes

configuration (nxos.devices)

Name	Type	Constraint	Mandatory	Default Value
system	Class	`[system]`	No

system (nxos.devices.configuration)

Name	Type	Constraint	Mandatory
hostname	String		No
mtu	Integer	min: `576`, max: `9216`	No
nv_overlay_vxlan_udp_port	Integer	min: `1024`, max: `65535`	No
nv_overlay_vxlan_udp_source_port_mode	Choice	`low`, `high`, `rfc`	No
interface_vlan_autostate	Boolean	`true`, `false`	No
hsrp_bfd	Boolean	`true`, `false`	No
hsrp_timers_extended_hold	Integer	min: `10`, max: `255`	No
ip_routing	Boolean	`true`, `false`	No
ip_access_list_match_local_traffic	Boolean	`true`, `false`	No
logging_level_ip	Choice	`emergency`, `alert`, `critical`, `error`, `warning`, `notification`, `informational`, `debug`	No
ip_redirect_syslog	Boolean	`true`, `false`	No
ip_redirect_syslog_interval	Integer	min: `30`, max: `1800`	No
ip_source_route	Boolean	`true`, `false`	No
hardware_ecmp_hash_offset_concatenation	Boolean	`true`, `false`	No
hardware_ecmp_hash_offset_value	Integer	min: `0`, max: `63`	No
hardware_ecmp_hash_polynomial	Choice	`crc16`, `crc32hi`	No
ipv6_routing	Boolean	`true`, `false`	No
ipv6_access_list_match_local_traffic	Boolean	`true`, `false`	No
ethernet	Class	`[ethernet]`	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

Examples

Example 1: VXLAN leaf switch with system and Ethernet defaults

nxos:
  devices:
    - name: LEAF1
      configuration:
        system:
          hostname: LEAF1
          mtu: 9216
          ip_routing: true
          ipv6_routing: true
          ethernet:
            default_switchport: layer2
            default_switchport_shutdown: false
            service_unsupported_transceiver: true

Example 2: Spine switch with ECMP hash tuning for VXLAN fabric load balancing

nxos:
  devices:
    - name: SPINE1
      configuration:
        system:
          hostname: SPINE1
          mtu: 9216
          ip_routing: true
          ip_source_route: false
          hardware_ecmp_hash_polynomial: crc32hi
          hardware_ecmp_hash_offset_concatenation: true
          hardware_ecmp_hash_offset_value: 32
          ethernet:
            default_switchport: layer3
            default_switchport_shutdown: false

Example 3: Border leaf with IP/IPv6 routing, ICMP redirect logging, and Ethernet security

nxos:
  devices:
    - name: BORDER-LEAF1
      configuration:
        system:
          hostname: BORDER-LEAF1
          mtu: 9216
          ip_routing: true
          ip_source_route: false
          ip_access_list_match_local_traffic: true
          ip_redirect_syslog: true
          ip_redirect_syslog_interval: 300
          logging_level_ip: warning
          ipv6_routing: true
          ipv6_access_list_match_local_traffic: true
          ethernet:
            default_switchport: layer2
            default_switchport_shutdown: true
            dot1q_tag_native: true
            logging_event_port: link-status-enable

Example 4: Ethernet defaults with link-status syslog tuning

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