Skip to content

System

System configuration encompasses fundamental device-level settings that define core operational behavior including hostname identification, global MTU, NV overlay VXLAN UDP port settings, SVI autostate behavior, and interface breakout maps. 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, ICMPv6 adjacency stale timer, ICMPv6 redirect syslog). System configuration also manages Ethernet defaults for switchport mode, shutdown behavior, transceiver support, storm control, link-status syslog levels, and interface syslog info. Additional sub-sections cover boot options, CFS distribution, CLI aliases, CoPP profiles, iCAM monitoring, hardware platform profiles (including TCAM region carving for ACL, QoS, and other forwarding table sizes), smart licensing transport, terminal timeouts, VTY access class ACL assignments, and VDC resource limits, establishing the foundational operational baseline for NX-OS devices.

Diagram
NameTypeConstraintMandatoryDefault Value
hostnameStringNo
mtuIntegermin: 576, max: 9216No
nv_overlay_vxlan_udp_portIntegermin: 1024, max: 65535No
nv_overlay_vxlan_udp_source_port_modeChoicelow, high, rfcNo
nve_ipmc_index_sizeIntegermin: 0, max: 7000No
nve_overlay_vlansClass[nve_overlay_vlans]No
nve_infra_vlansList[nve_infra_vlans]No
interface_vlan_autostateBooleantrue, falseNo
ip_routingBooleantrue, falseNo
ip_access_list_match_local_trafficBooleantrue, falseNo
logging_level_ipChoiceemergency, alert, critical, error, warning, notification, informational, debugNo
ip_redirect_syslogBooleantrue, falseNo
ip_redirect_syslog_intervalIntegermin: 30, max: 1800No
ip_source_routeBooleantrue, falseNo
hardware_ecmp_hash_offset_concatenationBooleantrue, falseNo
hardware_ecmp_hash_offset_valueIntegermin: 0, max: 63No
hardware_ecmp_hash_polynomialChoicecrc16, crc32hiNo
ipv6_routingBooleantrue, falseNo
ipv6_access_list_match_local_trafficBooleantrue, falseNo
ipv6_adjacency_stale_timerIntegermin: 30, max: 65535No
ipv6_adjacency_stale_timer_icmpBooleantrue, falseNo
ipv6_redirect_syslogBooleantrue, falseNo
ipv6_redirect_syslog_intervalIntegermin: 30, max: 1800No
bootClass[boot]No
interface_breakout_modulesList[interface_breakout_modules]No
cfs_distributeBooleantrue, falseNo
cfs_eth_distributeBooleantrue, falseNo
cfs_ipv4_distributeBooleantrue, falseNo
cfs_ipv4_mcast_addressIPNo
cfs_ipv6_distributeBooleantrue, falseNo
cfs_ipv6_mcast_addressIPNo
cli_aliasesList[cli_aliases]No
copp_profileChoicestrict, moderate, lenient, denseNo
copp_rate_limitBooleantrue, falseNo
ethernetClass[ethernet]No
icam_monitor_intervalIntegermin: 1, max: 24No
icam_monitor_historyIntegermin: 168, max: 1344No
icam_monitor_scaleBooleantrue, falseNo
icam_monitor_scale_threshold_criticalIntegermin: 1, max: 100No
icam_monitor_scale_threshold_infoIntegermin: 1, max: 100No
icam_monitor_scale_threshold_warningIntegermin: 1, max: 100No
systemClass[system]No
smart_licensing_transportChoicecallhome, cslu, off, smartNo
smart_licensing_url_csluStringNo
line_console_exec_timeoutIntegermin: 0, max: 525600No
line_vty_access_class_inStringNo
line_vty_access_class_outStringNo
line_vty_exec_timeoutIntegermin: 0, max: 525600No
line_vty_session_limitIntegermin: 1, max: 64No
vdcsList[vdcs]No
ttag_marker_intervalIntegermin: 1, max: 25200No

nve_overlay_vlans (nxos.devices.configuration.system)

Section titled “nve_overlay_vlans (nxos.devices.configuration.system)”
NameTypeConstraintMandatoryDefault Value
idsListInteger[min: 1, max: 4094]No
rangesList[ranges]No

nve_infra_vlans (nxos.devices.configuration.system)

Section titled “nve_infra_vlans (nxos.devices.configuration.system)”
NameTypeConstraintMandatoryDefault Value
vlansClass[vlans]Yes
forceBooleantrue, falseNo

NameTypeConstraintMandatoryDefault Value
auto_copyBooleantrue, falseNo
dhcpIntegermin: 0, max: 2147483647No
exclude_configurationBooleantrue, falseNo
modeChoicenone, lxcNo
orderChoicebootflash, pxe, pxe2bootflash, bootflash2pxeNo
poapBooleantrue, falseNo
image_verifyBooleantrue, falseNo
nxos_sup_1StringNo
nxos_sup_2StringNo
aciStringNo

interface_breakout_modules (nxos.devices.configuration.system)

Section titled “interface_breakout_modules (nxos.devices.configuration.system)”
NameTypeConstraintMandatoryDefault Value
idIntegermin: 1, max: 32Yes
portsList[ports]No

cli_aliases (nxos.devices.configuration.system)

Section titled “cli_aliases (nxos.devices.configuration.system)”
NameTypeConstraintMandatoryDefault Value
nameStringYes
commandStringYes

ethernet (nxos.devices.configuration.system)

Section titled “ethernet (nxos.devices.configuration.system)”
NameTypeConstraintMandatoryDefault Value
default_switchport_shutdownBooleantrue, falseNo
service_unsupported_transceiverBooleantrue, falseNo
default_switchportChoicelayer2, layer3No
logging_event_portChoicelink-status-default, link-status-enable, none, trunk-status-default, trunk-status-enableNo
default_interface_shutdownChoicedown, down-exclude-fabric, upNo
link_failure_laser_onBooleantrue, falseNo
storm_control_multicastBooleantrue, falseNo
dot1q_tag_nativeBooleantrue, falseNo
admin_link_down_syslog_levelIntegermin: 0, max: 7No
admin_link_up_syslog_levelIntegermin: 0, max: 7No
interface_syslog_infoChoicedefault, info-1No

platform (nxos.devices.configuration.system)

Section titled “platform (nxos.devices.configuration.system)”
NameTypeConstraintMandatoryDefault Value
hostnameStringNo
mtuIntegermin: 576, max: 9216No
nxapiClass[nxapi]No
nv_overlay_vxlan_udp_portIntegermin: 1024, max: 65535No
nv_overlay_vxlan_udp_source_port_modeChoicelow, high, rfcNo
nve_ipmc_index_sizeIntegermin: 0, max: 7000No
nve_overlay_vlansClass[nve_overlay_vlans]No
nve_infra_vlansList[nve_infra_vlans]No
interface_vlan_autostateBooleantrue, falseNo
hsrp_bfdBooleantrue, falseNo
hsrp_timers_extended_holdIntegermin: 10, max: 255No
hypershieldClass[hypershield]No
ip_routingBooleantrue, falseNo
ip_access_list_match_local_trafficBooleantrue, falseNo
logging_level_ipChoiceemergency, alert, critical, error, warning, notification, informational, debugNo
ip_redirect_syslogBooleantrue, falseNo
ip_redirect_syslog_intervalIntegermin: 30, max: 1800No
ip_source_routeBooleantrue, falseNo
hardware_access_list_tcam_regionClass[hardware_access_list_tcam_region]No
hardware_ecmp_hash_offset_concatenationBooleantrue, falseNo
hardware_ecmp_hash_offset_valueIntegermin: 0, max: 63No
hardware_ecmp_hash_polynomialChoicecrc16, crc32hiNo
ipv6_routingBooleantrue, falseNo
ipv6_access_list_match_local_trafficBooleantrue, falseNo
ipv6_adjacency_stale_timerIntegermin: 30, max: 65535No
ipv6_adjacency_stale_timer_icmpBooleantrue, falseNo
ipv6_redirect_syslogBooleantrue, falseNo
ipv6_redirect_syslog_intervalIntegermin: 30, max: 1800No
bootClass[boot]No
interface_breakout_modulesList[interface_breakout_modules]No
cfs_distributeBooleantrue, falseNo
cfs_eth_distributeBooleantrue, falseNo
cfs_ipv4_distributeBooleantrue, falseNo
cfs_ipv4_mcast_addressIPNo
cfs_ipv6_distributeBooleantrue, falseNo
cfs_ipv6_mcast_addressIPNo
cli_aliasesList[cli_aliases]No
copp_profileChoicestrict, moderate, lenient, denseNo
copp_rate_limitBooleantrue, falseNo
ethernetClass[ethernet]No
erspan_origin_ip_addressIPNo
erspan_origin_ipv6_addressIPNo
clockClass[clock]No
icam_monitor_intervalIntegermin: 1, max: 24No
icam_monitor_historyIntegermin: 168, max: 1344No
icam_monitor_scaleBooleantrue, falseNo
icam_monitor_scale_threshold_criticalIntegermin: 1, max: 100No
icam_monitor_scale_threshold_infoIntegermin: 1, max: 100No
icam_monitor_scale_threshold_warningIntegermin: 1, max: 100No
hardwareClass[hardware]No
hardware_profileClass[hardware_profile]No
port_channelClass[port_channel]No
switch_modeChoicedefault, n3k, n9kNo
fabric_modeChoicefull-rate, defaultNo
routingChoicenon-hierarchical-routing, non-hierarchical-routing-max-l3-mode, max-mode-host, max-mode-tor-l3, mode-hierarchical-64b-alpm, non-hierarchical-max-mode-l3-nh-64b-alpm-nh, hierarchical-def-max-mode-l3-64b-alpm, max-mode-tor-l2, max-mode-tor-l2-l3, template-overlay-host-scale, template-lpm-heavy, template-lpm-scale-v6-64, template-dual-stack-host-scale, template-service-provider, template-multicast-heavy, template-vxlan-scale, template-mpls-heavy, template-internet-peering, template-multicast-ext-heavy, template-l3-heavy, template-dual-stack-mcast, template-l2-heavy, template-l2-scale, template-security-groupsNo
sshClass[ssh]No
smart_licensing_transportChoicecallhome, cslu, off, smartNo
smart_licensing_url_csluStringNo
line_console_exec_timeoutIntegermin: 0, max: 525600No
line_vty_access_class_inStringNo
line_vty_access_class_outStringNo
line_vty_exec_timeoutIntegermin: 0, max: 525600No
line_vty_session_limitIntegermin: 1, max: 64No
vdcsList[vdcs]No
ttag_marker_intervalIntegermin: 1, max: 25200No

NameTypeConstraintMandatoryDefault Value
idIntegermin: 0, max: 65535Yes
resource_limitsClass[resource_limits]No

ranges (nxos.devices.configuration.system.nve_overlay_vlans)

Section titled “ranges (nxos.devices.configuration.system.nve_overlay_vlans)”
NameTypeConstraintMandatoryDefault Value
fromIntegermin: 1, max: 4094Yes
toIntegermin: 1, max: 4094Yes

vlans (nxos.devices.configuration.system.nve_infra_vlans)

Section titled “vlans (nxos.devices.configuration.system.nve_infra_vlans)”
NameTypeConstraintMandatoryDefault Value
idsListInteger[min: 1, max: 4096]No
rangesList[ranges]No

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

Section titled “ports (nxos.devices.configuration.system.interface_breakout_modules)”
NameTypeConstraintMandatoryDefault Value
idIntegermin: 1, max: 108Yes
mapChoiceno-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-pam4No

nxapi (nxos.devices.configuration.system.platform)

Section titled “nxapi (nxos.devices.configuration.system.platform)”
NameTypeConstraintMandatoryDefault Value
http_portIntegermin: -1, max: 65535No
https_portIntegermin: -1, max: 65535No
vrfStringNo
idle_timeoutIntegermin: 1, max: 1440No
certificate_enableBooleantrue, falseNo
certificate_httpscrtStringNo
certificate_httpskeyStringNo
certificate_httpskey_passphraseStringNo
certificate_trustpointStringNo
ssl_protocolsStringNo
ssl_ciphers_weakBooleantrue, falseNo
client_cert_authChoiceoff, optional, strict, two-stepNo
sudiBooleantrue, falseNo

hypershield (nxos.devices.configuration.system.platform)

Section titled “hypershield (nxos.devices.configuration.system.platform)”
NameTypeConstraintMandatoryDefault Value
source_interface_typeChoiceethernet, loopback, mgmt, port-channel, vlan, vniNo
source_interface_idAnyString or Integer[min: 0]No
https_proxyStringNo
https_proxy_portIntegermin: 1, max: 65535No
firewall_in_serviceBooleantrue, falseNo
firewall_vrfsList[firewall_vrfs]No

hardware_access_list_tcam_region (nxos.devices.configuration.system.platform)

Section titled “hardware_access_list_tcam_region (nxos.devices.configuration.system.platform)”
NameTypeConstraintMandatoryDefault Value
arp_acl_sizeIntegermin: 0, max: 2147483647No
copp_sizeIntegermin: 0, max: 2147483647No
e_hw_telemetry_sizeIntegermin: 0, max: 2147483647No
e_ifacl_all_per_port_statsBooleantrue, falseNo
e_ifacl_all_sizeIntegermin: 0, max: 2147483647No
e_ipv6_racl_per_port_statsBooleantrue, falseNo
e_racl_per_port_statsBooleantrue, falseNo
egr_copp_sizeIntegermin: 0, max: 2147483647No
egr_flow_sizeIntegermin: 0, max: 2147483647No
egr_ifacl_sizeIntegermin: 0, max: 2147483647No
egr_l2_qos_sizeIntegermin: 0, max: 2147483647No
egr_l3_vlan_qos_sizeIntegermin: 0, max: 2147483647No
egr_racl_sizeIntegermin: 0, max: 2147483647No
egr_sup_sizeIntegermin: 0, max: 2147483647No
e_ipv6_qos_sizeIntegermin: 0, max: 2147483647No
e_ipv6_racl_sizeIntegermin: 0, max: 2147483647No
e_mac_qos_sizeIntegermin: 0, max: 2147483647No
e_qos_lite_sizeIntegermin: 0, max: 2147483647No
e_qos_sizeIntegermin: 0, max: 2147483647No
e_racl_sizeIntegermin: 0, max: 2147483647No
egress_vacl_sizeIntegermin: 0, max: 2147483647No
fcoe_egress_sizeIntegermin: 0, max: 2147483647No
fcoe_ingress_sizeIntegermin: 0, max: 2147483647No
fhs_sizeIntegermin: 0, max: 2147483647No
hw_telemetry_sizeIntegermin: 0, max: 2147483647No
ifacl_all_per_port_statsBooleantrue, falseNo
ifacl_all_profileIntegermin: 0, max: 15No
ifacl_all_sizeIntegermin: 0, max: 2147483647No
ifacl_lite_sizeIntegermin: 0, max: 2147483647No
ifacl_per_port_statsBooleantrue, falseNo
ifacl_sizeIntegermin: 0, max: 2147483647No
ifacl_udf_sizeIntegermin: 0, max: 2147483647No
ing_dacl_sizeIntegermin: 0, max: 2147483647No
ing_flow_redirect_sizeIntegermin: 0, max: 2147483647No
ing_flow_sizeIntegermin: 0, max: 2147483647No
ing_ifacl_sizeIntegermin: 0, max: 2147483647No
ing_ifacl_wide_sizeIntegermin: 0, max: 2147483647No
ing_ipv6_ifacl_lite_sizeIntegermin: 0, max: 2147483647No
ing_l2_l3_qos_sizeIntegermin: 0, max: 2147483647No
ing_l2_qos_sizeIntegermin: 0, max: 2147483647No
ing_l2_span_filter_sizeIntegermin: 0, max: 2147483647No
ing_l3_span_filter_sizeIntegermin: 0, max: 2147483647No
ing_pacl_sb_sizeIntegermin: 0, max: 2147483647No
ing_racl_sizeIntegermin: 0, max: 2147483647No
ing_rbacl_sizeIntegermin: 0, max: 2147483647No
ing_redirect_sizeIntegermin: 0, max: 2147483647No
ing_storm_control_sizeIntegermin: 0, max: 2147483647No
ing_sup_sizeIntegermin: 0, max: 2147483647No
ing_vacl_nh_sizeIntegermin: 0, max: 2147483647No
ing_vlan_qos_sizeIntegermin: 0, max: 2147483647No
ipsg_sizeIntegermin: 0, max: 2147483647No
ipv6_ifacl_per_port_statsBooleantrue, falseNo
ipv6_ifacl_sizeIntegermin: 0, max: 2147483647No
ipv6_l3_qos_sizeIntegermin: 0, max: 2147483647No
ipv6_pbr_sizeIntegermin: 0, max: 2147483647No
ipv6_qos_sizeIntegermin: 0, max: 2147483647No
ipv6_racl_per_port_statsBooleantrue, falseNo
ipv6_racl_sizeIntegermin: 0, max: 2147483647No
ipv6_span_l2_sizeIntegermin: 0, max: 2147483647No
ipv6_span_sizeIntegermin: 0, max: 2147483647No
ipv6_sup_sizeIntegermin: 0, max: 2147483647No
ipv6_vacl_sizeIntegermin: 0, max: 2147483647No
ipv6_vqos_sizeIntegermin: 0, max: 2147483647No
l3qos_intra_lite_sizeIntegermin: 0, max: 2147483647No
mac_ifacl_per_port_statsBooleantrue, falseNo
mac_ifacl_sizeIntegermin: 0, max: 2147483647No
mac_l3_qos_sizeIntegermin: 0, max: 2147483647No
mac_qos_sizeIntegermin: 0, max: 2147483647No
mac_vacl_sizeIntegermin: 0, max: 2147483647No
mac_vqos_sizeIntegermin: 0, max: 2147483647No
mcast_bidir_sizeIntegermin: 0, max: 2147483647No
mcast_nat_sizeIntegermin: 0, max: 2147483647No
mcast_nbm_sizeIntegermin: 0, max: 2147483647No
mpls_double_wideBooleantrue, falseNo
mpls_sizeIntegermin: 0, max: 2147483647No
mvpn_sizeIntegermin: 0, max: 10No
arp_ether_sizeIntegermin: 0, max: 2147483647No
nat_sizeIntegermin: 0, max: 2147483647No
openflow_double_wideBooleantrue, falseNo
openflow_lite_sizeIntegermin: 0, max: 2147483647No
openflow_sizeIntegermin: 0, max: 2147483647No
pbr_sizeIntegermin: 0, max: 2147483647No
qos_intra_lite_sizeIntegermin: 0, max: 2147483647No
qos_sizeIntegermin: 0, max: 2147483647No
racl_all_per_port_statsBooleantrue, falseNo
racl_all_profileIntegermin: 0, max: 15No
racl_all_sizeIntegermin: 0, max: 2147483647No
racl_lite_sizeIntegermin: 0, max: 2147483647No
racl_per_port_statsBooleantrue, falseNo
racl_sizeIntegermin: 0, max: 2147483647No
racl_udf_sizeIntegermin: 0, max: 2147483647No
redirect_sizeIntegermin: 0, max: 2147483647No
span_sizeIntegermin: 0, max: 2147483647No
sup_sizeIntegermin: 0, max: 2147483647No
svi_sizeIntegermin: 0, max: 2147483647No
tcp_nat_sizeIntegermin: 0, max: 100No
vacl_lite_sizeIntegermin: 0, max: 2147483647No
vacl_sizeIntegermin: 0, max: 2147483647No
vpc_convergence_sizeIntegermin: 0, max: 2147483647No
vqos_intra_lite_sizeIntegermin: 0, max: 2147483647No
vqos_sizeIntegermin: 0, max: 2147483647No
vxlan_p2p_sizeIntegermin: 0, max: 2147483647No

clock (nxos.devices.configuration.system.platform)

Section titled “clock (nxos.devices.configuration.system.platform)”
NameTypeConstraintMandatoryDefault Value
formatChoice24hours, 12hoursNo
format_show_timezone_debugBooleantrue, falseNo
format_show_timezone_syslogBooleantrue, falseNo
protocolChoiceunspecified, ptp, ntp, none, gnssNo
timezone_nameStringNo
timezone_hoursIntegermin: -12, max: 14No
timezone_minutesIntegermin: 0, max: 59No
summer_timeClass[summer_time]No

hardware (nxos.devices.configuration.system.platform)

Section titled “hardware (nxos.devices.configuration.system.platform)”
NameTypeConstraintMandatoryDefault Value
acl_redirect_share_disableBooleantrue, falseNo
counter_feature_bfdIntegermin: 0, max: 4294967295No
counter_bfd_feature_scaleIntegermin: 0, max: 4294967295No
counter_feature_ecnIntegermin: 0, max: 4294967295No
counter_ecn_feature_scaleIntegermin: 0, max: 4294967295No
counter_feature_egr_aclIntegermin: 0, max: 4294967295No
counter_egr_acl_feature_scaleIntegermin: 0, max: 4294967295No
counter_feature_ingr_aclIntegermin: 0, max: 4294967295No
counter_ingr_acl_feature_scaleIntegermin: 0, max: 4294967295No
counter_feature_l2vniIntegermin: 0, max: 4294967295No
counter_l2vni_feature_scaleIntegermin: 0, max: 4294967295No
counter_feature_l3vniIntegermin: 0, max: 4294967295No
counter_l3vni_feature_scaleIntegermin: 0, max: 4294967295No
counter_feature_siIntegermin: 0, max: 4294967295No
counter_si_feature_scaleIntegermin: 0, max: 4294967295No
counter_feature_sviIntegermin: 0, max: 4294967295No
counter_svi_feature_scaleIntegermin: 0, max: 4294967295No
counter_feature_tunnelIntegermin: 0, max: 4294967295No
counter_tunnel_feature_scaleIntegermin: 0, max: 4294967295No
counter_feature_vlanIntegermin: 0, max: 4294967295No
counter_vlan_feature_scaleIntegermin: 0, max: 4294967295No
counter_feature_voqIntegermin: 0, max: 4294967295No
counter_voq_feature_scaleIntegermin: 0, max: 4294967295No
dme_load_intervalIntegermin: 0, max: 4294967295No
egr_l2_qos_ifacl_label_sizeBooleantrue, falseNo
gpe_5_timer_enableBooleantrue, falseNo
ing_ifacl_label_sizeBooleantrue, falseNo
vrf_nat_label_widthIntegermin: 0, max: 6No
mpls_qos_pipe_modeBooleantrue, falseNo
multicast_nlb_port_channelBooleantrue, falseNo
multicast_priorityIntegermin: 0, max: 15No
multicast_stats_disableBooleantrue, falseNo
pbr_ecmp_pathsIntegermin: 1, max: 64No
pbr_next_hop_fast_convergenceBooleantrue, falseNo
pbr_match_default_routeBooleantrue, falseNo
access_list_tcam_per_entry_stats_templateChoicel3qos, racl, span-acl, pbrNo
storm_control_priorityChoicedefault, drop-l3, drop-l2, drop-allNo
sub_interface_flex_statsChoicedisable, l3, l2No
access_list_update_atomicBooleantrue, falseNo
access_list_update_atomic_strictBooleantrue, falseNo
access_list_update_default_resultBooleantrue, falseNo
vrf_aware_nat_enableBooleantrue, falseNo

hardware_profile (nxos.devices.configuration.system.platform)

Section titled “hardware_profile (nxos.devices.configuration.system.platform)”
NameTypeConstraintMandatoryDefault Value
access_list_match_inner_headerBooleantrue, falseNo
acl_tap_aggregationBooleantrue, falseNo
disable_parse_errorBooleantrue, falseNo
flow_redirect_forward_pduBooleantrue, falseNo
front_portmodeChoicesfp-plus, qsfpNo
forwarding_modeStringNo
global_tx_spanBooleantrue, falseNo
high_multicast_priorityBooleantrue, falseNo
hardware_lou_resource_thresholdIntegermin: 1, max: 50No
ingress_bd_ifacl_label_optimizationBooleantrue, falseNo
ingress_racl_sizeBooleantrue, falseNo
ingress_replication_round_robinBooleantrue, falseNo
ip_statisticsBooleantrue, falseNo
ipv6_alpm_carve_valueIntegermin: 0, max: 4096No
ipv6_lpm_max_entriesIntegermin: 0, max: 6144No
lpm_max_limitIntegermin: 0, max: 4096No
multicast_dcs_checkBooleantrue, falseNo
multicast_flex_statsBooleantrue, falseNo
multicast_lpm_max_entriesIntegermin: 0, max: 4096No
multicast_max_limitIntegermin: 0, max: 8000No
multicast_nlbBooleantrue, falseNo
multicast_racl_bridgeBooleantrue, falseNo
multicast_rpf_check_optimizationBooleantrue, falseNo
multicast_service_reflect_portIntegermin: 0, max: 48No
multicast_syslog_thresholdIntegermin: 1, max: 100No
mld_snoopingBooleantrue, falseNo
mpls_adjacency_stats_modeChoicepackets, bytesNo
mpls_ecmpBooleantrue, falseNo
mrouting_disable_l2_updateBooleantrue, falseNo
mrouting_disable_second_route_updateBooleantrue, falseNo
mrouting_performance_modeBooleantrue, falseNo
pbr_skip_self_ipBooleantrue, falseNo
pic_coreBooleantrue, falseNo
portmode_tupleBooleantrue, falseNo
pstatBooleantrue, falseNo
qos_min_bufferChoiceall, none, defaultNo
service_template_nameStringNo
svi_and_si_flex_stats_enableBooleantrue, falseNo
svi_flex_statsBooleantrue, falseNo
tcam_syslog_thresholdIntegermin: 1, max: 100No
unicast_max_limitIntegermin: 0, max: 8000No
unicast_syslog_thresholdIntegermin: 1, max: 100No
unicast_traceBooleantrue, falseNo
unknown_unicast_floodBooleantrue, falseNo
urpfBooleantrue, falseNo
wrr_unicast_bandwidthIntegermin: 0, max: 100No

port_channel (nxos.devices.configuration.system.platform)

Section titled “port_channel (nxos.devices.configuration.system.platform)”
NameTypeConstraintMandatoryDefault Value
fast_convergenceBooleantrue, falseNo
load_balanceChoicedlb, rtag7, rtag7-murmur, rtag7-local-crc, dynamic-pinNo
load_balance2_resilientBooleantrue, falseNo
load_balance_mpls_label_ipBooleantrue, falseNo
load_balance_mpls_label_onlyBooleantrue, falseNo
scale_fanoutBooleantrue, falseNo

ssh (nxos.devices.configuration.system.platform)

Section titled “ssh (nxos.devices.configuration.system.platform)”
NameTypeConstraintMandatoryDefault Value
ciphers_allBooleantrue, falseNo
ciphers_weakBooleantrue, falseNo
kexalgos_allBooleantrue, falseNo
keytypes_allBooleantrue, falseNo
login_attemptsIntegermin: 1, max: 10No
login_gracetimeIntegermin: 0, max: 3600No
macs_allBooleantrue, falseNo
portIntegermin: 22, max: 65535No
keysList[keys]No

resource_limits (nxos.devices.configuration.system.vdcs)

Section titled “resource_limits (nxos.devices.configuration.system.vdcs)”
NameTypeConstraintMandatoryDefault Value
port_channel_maximumIntegermin: 0, max: 766No
port_channel_minimumIntegermin: 0, max: 766No
vlan_maximumIntegermin: 16, max: 4094No
vlan_minimumIntegermin: 16, max: 4094No
vrf_maximumIntegermin: 2, max: 4097No
vrf_minimumIntegermin: 2, max: 4097No

firewall_vrfs (nxos.devices.configuration.system.platform.hypershield)

Section titled “firewall_vrfs (nxos.devices.configuration.system.platform.hypershield)”
NameTypeConstraintMandatoryDefault Value
nameStringYes

summer_time (nxos.devices.configuration.system.platform.clock)

Section titled “summer_time (nxos.devices.configuration.system.platform.clock)”
NameTypeConstraintMandatoryDefault Value
nameStringYes
offset_minutesIntegermin: 1, max: 1440No
start_weekIntegermin: 1, max: 5No
start_dayChoiceSun, Mon, Tue, Wed, Thu, Fri, SatNo
start_monthChoiceJan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, DecNo
start_timeStringNo
end_weekIntegermin: 1, max: 5No
end_dayChoiceSun, Mon, Tue, Wed, Thu, Fri, SatNo
end_monthChoiceJan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, DecNo
end_timeStringNo

keys (nxos.devices.configuration.system.platform.ssh)

Section titled “keys (nxos.devices.configuration.system.platform.ssh)”
NameTypeConstraintMandatoryDefault Value
typeChoicersa, dsa, ecdsaYes
key_lengthIntegermin: 0, max: 4096No

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/ICMPv6 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
ipv6_adjacency_stale_timer: 500
ipv6_adjacency_stale_timer_icmp: true
ipv6_redirect_syslog: true
ipv6_redirect_syslog_interval: 120
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

Example 5: System boot configuration with NXOS image and POAP

nxos:
devices:
- name: LEAF1
configuration:
system:
boot:
auto_copy: true
poap: false
image_verify: true
nxos_image_sup_1: bootflash:nxos64-cs.10.4.3.F.bin
order: bootflash

Example 6: CFS distribution and CoPP profile

nxos:
devices:
- name: LEAF1
configuration:
system:
cfs_distribute: true
cfs_eth_distribute: true
copp_profile: strict

Example 7: CLI aliases, terminal timeouts, and smart licensing

nxos:
devices:
- name: LEAF1
configuration:
system:
cli_aliases:
- name: wr
command: copy running-config startup-config
- name: sri
command: show running-config interface
line_console_exec_timeout: 0
line_vty_exec_timeout: 30
line_vty_session_limit: 10
line_vty_access_class_in: VTY-ACL-IN
line_vty_access_class_out: VTY-ACL-OUT
smart_licensing_transport: cslu
smart_licensing_url_cslu: https://cslu.example.com

Example 8: System routing template for security groups

nxos:
devices:
- name: LEAF1
configuration:
system:
routing: template-security-groups

Example 10: Hardware profile and port-channel configuration for VXLAN leaf

nxos:
devices:
- name: LEAF1
configuration:
system:
hardware_profile:
multicast_rpf_check_optimization: true
ingress_replication_round_robin: true
urpf: true
port_channel:
load_balance: rtag7
load_balance2_resilient: true

Example 11: Extended hardware profile with counter management and PBR tuning

nxos:
devices:
- name: LEAF1
configuration:
system:
hardware:
dme_load_interval: 300
access_list_update_atomic: true
access_list_update_atomic_strict: false
pbr_ecmp_paths: 16
pbr_next_hop_fast_convergence: true
pbr_match_default_route: false
counter_feature_bfd: 7
counter_bfd_feature_scale: 256
counter_feature_svi: 10
counter_svi_feature_scale: 1024
multicast_nlb_port_channel: true
multicast_stats_disable: false
storm_control_priority: drop-l3
sub_interface_flex_stats: l3
vrf_aware_nat_enable: true

Example 12: NVE platform configuration with infra VLANs for bud-node VXLAN

nxos:
devices:
- name: LEAF1
configuration:
system:
nve_ipmc_index_size: 4096
nve_overlay_vlans:
ranges:
- from: 2
to: 10
nve_infra_vlans:
- vlans:
ids: [2]
force: true
- vlans:
ids: [3]
force: true

Example 13: iCAM monitoring with scale thresholds

nxos:
devices:
- name: LEAF1
configuration:
system:
icam_monitor_interval: 1
icam_monitor_history: 168
icam_monitor_scale: true
icam_monitor_scale_threshold_critical: 90
icam_monitor_scale_threshold_warning: 75
icam_monitor_scale_threshold_info: 50

Example 14: VDC resource limits for multi-tenant chassis

nxos:
devices:
- name: N7K-1
configuration:
system:
vdcs:
- id: 2
resource_limits:
vlan_minimum: 16
vlan_maximum: 2048
vrf_minimum: 2
vrf_maximum: 512
port_channel_minimum: 0
port_channel_maximum: 256
unicast_ipv4_route_memory_minimum: 1
unicast_ipv4_route_memory_maximum: 384

Example 15: Interface breakout configuration for high-density ports

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

Example 16: PTP ttag global marker interval configuration

nxos:
devices:
- name: LEAF1
configuration:
system:
ttag_marker_interval: 120

Example 17: TCAM region carving for VXLAN leaf

nxos:
devices:
- name: LEAF1
configuration:
system:
hardware_access_list_tcam_region:
ifacl_size: 256
vacl_size: 256
qos_size: 256
racl_size: 512
ipv6_racl_size: 256
e_racl_size: 256
ing_flow_size: 512
ing_racl_size: 512
ifacl_all_size: 256
racl_all_size: 256

System configuration encompasses fundamental device-level settings that define core operational behavior including hostname identification, global MTU, NV overlay VXLAN UDP port settings, SVI autostate behavior, and interface breakout maps. 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, ICMPv6 adjacency stale timer, ICMPv6 redirect syslog). System configuration also manages Ethernet defaults for switchport mode, shutdown behavior, transceiver support, storm control, link-status syslog levels, and interface syslog info. Additional sub-sections cover boot options, CFS distribution, CLI aliases, CoPP profiles, iCAM monitoring, hardware platform profiles, smart licensing transport, terminal timeouts, VTY access class ACL assignments, and VDC resource limits, establishing the foundational operational baseline for NX-OS devices.

Diagram
NameTypeConstraintMandatoryDefault Value
hostnameStringNo
mtuIntegermin: 576, max: 9216No
nv_overlay_vxlan_udp_portIntegermin: 1024, max: 65535No
nv_overlay_vxlan_udp_source_port_modeChoicelow, high, rfcNo
interface_vlan_autostateBooleantrue, falseNo
ip_routingBooleantrue, falseNo
ip_access_list_match_local_trafficBooleantrue, falseNo
logging_level_ipChoiceemergency, alert, critical, error, warning, notification, informational, debugNo
ip_redirect_syslogBooleantrue, falseNo
ip_redirect_syslog_intervalIntegermin: 30, max: 1800No
ip_source_routeBooleantrue, falseNo
hardware_ecmp_hash_offset_concatenationBooleantrue, falseNo
hardware_ecmp_hash_offset_valueIntegermin: 0, max: 63No
hardware_ecmp_hash_polynomialChoicecrc16, crc32hiNo
ipv6_routingBooleantrue, falseNo
ipv6_access_list_match_local_trafficBooleantrue, falseNo
ipv6_adjacency_stale_timerIntegermin: 30, max: 65535No
ipv6_adjacency_stale_timer_icmpBooleantrue, falseNo
ipv6_redirect_syslogBooleantrue, falseNo
ipv6_redirect_syslog_intervalIntegermin: 30, max: 1800No
bootClass[boot]No
interface_breakout_modulesList[interface_breakout_modules]No
cfs_distributeBooleantrue, falseNo
cfs_eth_distributeBooleantrue, falseNo
cfs_ipv4_distributeBooleantrue, falseNo
cfs_ipv4_mcast_addressStringNo
cfs_ipv6_distributeBooleantrue, falseNo
cfs_ipv6_mcast_addressStringNo
cli_aliasesList[cli_aliases]No
copp_profileChoicestrict, moderate, lenient, denseNo
copp_rate_limitBooleantrue, falseNo
ethernetClass[ethernet]No
icam_monitor_intervalIntegermin: 1, max: 24No
icam_monitor_intervalsIntegermin: 168, max: 1344No
icam_monitor_scaleBooleantrue, falseNo
icam_monitor_threshold_criticalIntegermin: 1, max: 100No
icam_monitor_threshold_infoIntegermin: 1, max: 100No
icam_monitor_threshold_warningIntegermin: 1, max: 100No
platformClass[platform]No
smart_licensing_transportChoicecallhome, cslu, off, smartNo
smart_licensing_url_csluStringNo
terminal_console_exec_timeoutIntegermin: 0, max: 525600No
line_vty_access_class_inStringNo
line_vty_access_class_outStringNo
line_vty_exec_timeoutIntegermin: 0, max: 525600No
line_vty_session_limitIntegermin: 1, max: 64No
vdcsList[vdcs]No

NameTypeConstraintMandatoryDefault Value
auto_copyBooleantrue, falseNo
dhcpIntegermin: 0, max: 2147483647No
exclude_configurationBooleantrue, falseNo
modeChoicenone, lxcNo
orderChoicebootflash, pxe, pxe2bootflash, bootflash2pxeNo
poapBooleantrue, falseNo
image_verifyBooleantrue, falseNo
nxos_image_sup_1StringNo
nxos_image_sup_2StringNo
aciStringNo

interface_breakout_modules (nxos.devices.configuration.system)

Section titled “interface_breakout_modules (nxos.devices.configuration.system)”
NameTypeConstraintMandatoryDefault Value
idIntegermin: 1, max: 32Yes
portsList[ports]No

cli_aliases (nxos.devices.configuration.system)

Section titled “cli_aliases (nxos.devices.configuration.system)”
NameTypeConstraintMandatoryDefault Value
nameStringYes
commandStringYes

ethernet (nxos.devices.configuration.system)

Section titled “ethernet (nxos.devices.configuration.system)”
NameTypeConstraintMandatoryDefault Value
default_switchport_shutdownBooleantrue, falseNo
service_unsupported_transceiverBooleantrue, falseNo
default_switchportChoicelayer2, layer3No
logging_event_portChoicelink-status-default, link-status-enable, none, trunk-status-default, trunk-status-enableNo
default_interface_shutdownChoicedown, down-exclude-fabric, upNo
link_failure_laser_onBooleantrue, falseNo
storm_control_multicastBooleantrue, falseNo
dot1q_tag_nativeBooleantrue, falseNo
admin_link_down_syslog_levelIntegermin: 0, max: 7No
admin_link_up_syslog_levelIntegermin: 0, max: 7No
interface_syslog_infoChoicedefault, info-1No

platform (nxos.devices.configuration.system)

Section titled “platform (nxos.devices.configuration.system)”
NameTypeConstraintMandatoryDefault Value
access_list_match_inner_headerBooleantrue, falseNo
acl_tap_aggregationBooleantrue, falseNo
disable_parse_errorBooleantrue, falseNo
global_tx_spanBooleantrue, falseNo
high_multicast_priorityBooleantrue, falseNo
hardware_lou_resource_thresholdIntegermin: 1, max: 50No
ingress_bd_ifacl_label_optimizationBooleantrue, falseNo
ingress_racl_sizeBooleantrue, falseNo
ingress_replication_round_robinBooleantrue, falseNo
ip_statisticsBooleantrue, falseNo
ipv6_alpm_carve_valueIntegermin: 0, max: 4096No
ipv6_lpm_max_entriesIntegermin: 0, max: 6144No
lpm_max_limitIntegermin: 0, max: 4096No
multicast_dcs_checkBooleantrue, falseNo
multicast_flex_statsBooleantrue, falseNo
multicast_lpm_max_entriesIntegermin: 0, max: 4096No
multicast_max_limitIntegermin: 0, max: 8000No
multicast_nlbBooleantrue, falseNo
multicast_racl_bridgeBooleantrue, falseNo
multicast_rpf_check_optimizationBooleantrue, falseNo
multicast_service_reflect_portIntegermin: 0, max: 48No
multicast_syslog_thresholdIntegermin: 1, max: 100No
mld_snoopingBooleantrue, falseNo
mpls_adjacency_stats_modeChoicePACKETS, BYTESNo
mpls_ecmpBooleantrue, falseNo
mrouting_disable_l2_updateBooleantrue, falseNo
mrouting_disable_second_route_updateBooleantrue, falseNo
mrouting_performance_modeBooleantrue, falseNo
openflow_forward_pduBooleantrue, falseNo
pbr_skip_self_ipBooleantrue, falseNo
pic_coreBooleantrue, falseNo
port_channel_fast_convergenceBooleantrue, falseNo
port_channel_load_balanceChoicedlb, rtag7, rtag7-murmur, rtag7-local-crc, dynamic-pinNo
port_channel_load_balance_resilientBooleantrue, falseNo
port_channel_mpls_load_balance_label_ipBooleantrue, falseNo
port_channel_mpls_load_balance_label_onlyBooleantrue, falseNo
port_channel_scale_fanoutBooleantrue, falseNo
profile_front_portmodeChoicesfp-plus, qsfpNo
profile_modeStringNo
profile_tupleBooleantrue, falseNo
pstatBooleantrue, falseNo
qos_min_bufferChoiceall, none, defaultNo
routing_modeStringNo
service_template_nameStringNo
svi_and_si_flex_statsBooleantrue, falseNo
svi_flex_statsBooleantrue, falseNo
switch_modeChoicedefault, n3k, n9kNo
switching_fabric_speedChoicedefault, fabric-speed-40gNo
switching_modeChoicestore-forward, cut-throughNo
system_fabric_modeChoicefull-rate, defaultNo
tcam_syslog_thresholdIntegermin: 1, max: 100No
unicast_max_limitIntegermin: 0, max: 8000No
unicast_syslog_thresholdIntegermin: 1, max: 100No
unicast_traceBooleantrue, falseNo
unknown_unicast_floodBooleantrue, falseNo
urpfBooleantrue, falseNo
wrr_unicast_bandwidthIntegermin: 0, max: 100No

NameTypeConstraintMandatoryDefault Value
idIntegermin: 0, max: 65535Yes
resource_limitsClass[resource_limits]No

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

Section titled “ports (nxos.devices.configuration.system.interface_breakout_modules)”
NameTypeConstraintMandatoryDefault Value
idIntegermin: 1, max: 108Yes
mapChoiceno-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-pam4No

resource_limits (nxos.devices.configuration.system.vdcs)

Section titled “resource_limits (nxos.devices.configuration.system.vdcs)”
NameTypeConstraintMandatoryDefault Value
multicast_ipv4_route_memory_maximumIntegermin: 3, max: 150No
multicast_ipv4_route_memory_minimumIntegermin: 3, max: 150No
multicast_ipv6_route_memory_maximumIntegermin: 3, max: 20No
multicast_ipv6_route_memory_minimumIntegermin: 3, max: 20No
port_channel_maximumIntegermin: 0, max: 766No
port_channel_minimumIntegermin: 0, max: 766No
unicast_ipv4_route_memory_maximumIntegermin: 1, max: 768No
unicast_ipv4_route_memory_minimumIntegermin: 1, max: 768No
unicast_ipv6_route_memory_maximumIntegermin: 1, max: 512No
unicast_ipv6_route_memory_minimumIntegermin: 1, max: 512No
vlan_maximumIntegermin: 16, max: 4094No
vlan_minimumIntegermin: 16, max: 4094No
vrf_maximumIntegermin: 2, max: 4097No
vrf_minimumIntegermin: 2, max: 4097No

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/ICMPv6 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
ipv6_adjacency_stale_timer: 500
ipv6_adjacency_stale_timer_icmp: true
ipv6_redirect_syslog: true
ipv6_redirect_syslog_interval: 120
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

Example 5: System boot configuration with NXOS image and POAP

nxos:
devices:
- name: LEAF1
configuration:
system:
boot:
auto_copy: true
poap: false
image_verify: true
nxos_image_sup_1: bootflash:nxos64-cs.10.4.3.F.bin
order: bootflash

Example 6: CFS distribution and CoPP profile

nxos:
devices:
- name: LEAF1
configuration:
system:
cfs_distribute: true
cfs_eth_distribute: true
copp_profile: strict

Example 7: CLI aliases, terminal timeouts, and smart licensing

nxos:
devices:
- name: LEAF1
configuration:
system:
cli_aliases:
- name: wr
command: copy running-config startup-config
- name: sri
command: show running-config interface
terminal_console_exec_timeout: 0
line_vty_exec_timeout: 30
line_vty_session_limit: 10
line_vty_access_class_in: VTY-ACL-IN
line_vty_access_class_out: VTY-ACL-OUT
smart_licensing_transport: cslu
smart_licensing_url_cslu: https://cslu.example.com

Example 8: Hardware platform profile for VXLAN leaf

nxos:
devices:
- name: LEAF1
configuration:
system:
platform:
switching_mode: store-forward
port_channel_load_balance: rtag7
port_channel_load_balance_resilient: true
multicast_rpf_check_optimization: true
ingress_replication_round_robin: true
urpf: true

Example 9: iCAM monitoring with scale thresholds

nxos:
devices:
- name: LEAF1
configuration:
system:
icam_monitor_interval: 1
icam_monitor_intervals: 168
icam_monitor_scale: true
icam_monitor_threshold_critical: 90
icam_monitor_threshold_warning: 75
icam_monitor_threshold_info: 50

Example 10: VDC resource limits for multi-tenant chassis

nxos:
devices:
- name: N7K-1
configuration:
system:
vdcs:
- id: 2
resource_limits:
vlan_minimum: 16
vlan_maximum: 2048
vrf_minimum: 2
vrf_maximum: 512
port_channel_minimum: 0
port_channel_maximum: 256
unicast_ipv4_route_memory_minimum: 1
unicast_ipv4_route_memory_maximum: 384

Example 11: Interface breakout configuration for high-density ports

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

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
NameTypeConstraintMandatoryDefault Value
systemClass[system]No

NameTypeConstraintMandatoryDefault Value
hostnameStringNo
mtuIntegermin: 576, max: 9216No
nv_overlay_vxlan_udp_portIntegermin: 1024, max: 65535No
nv_overlay_vxlan_udp_source_port_modeChoicelow, high, rfcNo
interface_vlan_autostateBooleantrue, falseNo
hsrp_bfdBooleantrue, falseNo
hsrp_timers_extended_holdIntegermin: 10, max: 255No
ip_routingBooleantrue, falseNo
ip_access_list_match_local_trafficBooleantrue, falseNo
logging_level_ipChoiceemergency, alert, critical, error, warning, notification, informational, debugNo
ip_redirect_syslogBooleantrue, falseNo
ip_redirect_syslog_intervalIntegermin: 30, max: 1800No
ip_source_routeBooleantrue, falseNo
hardware_ecmp_hash_offset_concatenationBooleantrue, falseNo
hardware_ecmp_hash_offset_valueIntegermin: 0, max: 63No
hardware_ecmp_hash_polynomialChoicecrc16, crc32hiNo
ipv6_routingBooleantrue, falseNo
ipv6_access_list_match_local_trafficBooleantrue, falseNo
ethernetClass[ethernet]No

ethernet (nxos.devices.configuration.system)

Section titled “ethernet (nxos.devices.configuration.system)”
NameTypeConstraintMandatoryDefault Value
default_switchport_shutdownBooleantrue, falseNo
service_unsupported_transceiverBooleantrue, falseNo
default_switchportChoicelayer2, layer3No
logging_event_portChoicelink-status-default, link-status-enable, none, trunk-status-default, trunk-status-enableNo
default_interface_shutdownChoicedown, down-exclude-fabric, upNo
link_failure_laser_onBooleantrue, falseNo
storm_control_multicastBooleantrue, falseNo
dot1q_tag_nativeBooleantrue, falseNo
admin_link_down_syslog_levelIntegermin: 0, max: 7No
admin_link_up_syslog_levelIntegermin: 0, max: 7No
interface_syslog_infoChoicedefault, info-1No

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