layout-3layout-6layout-1layout-top
NVIDIA Docs Hubchevron_right NVIDIA Networkingchevron_right Networking Softwarechevron_right Switch Softwarechevron_right

Cumulus Linux

layout-toplayout-6layout-1

What's New

This document supports the Cumulus Linux 5.13 release, and lists new platforms, features, and enhancements.

What’s New in Cumulus Linux 5.13

Cumulus Linux 5.13.0 supports new platforms, provides bug fixes, and contains several new features and improvements.

Platforms

  • NVIDIA SN5600D (800G Spectrum-4 DC version)

New Features and Enhancements

  • NVIDIA SN5400 ITU-T G.8273.2 Class C (Compliance)
  • Enabling adaptive routing no longer restarts switchd
  • Optimized upgrade supports warmboot
  • 802.1 option to keep the port in the current state when the RADIUS server is unreachable
  • Support two DHCP static IP address assignments per port for a single host
  • syslog log filters
  • Erase all data from the switch (Beta)
  • Show SNR information for OSFP 100G per lane (NDR) capable transceivers
  • New maintenance mode commands
  • RADIUS multiple VRF support and RADIUS require-message-authenticate attribute
  • Message of the day shows system reboot cause and health information
  • Telemetry
  • NVUE
    • Command to list directory contents
    • Command to get the hash for a file
    • Commands to set the NAS IP address and NAS identifier for 802.1X
    • Command to power cycle the switch
    • SSH certificate-based authentication
    • Terminate a user session when you change the user role
    • CRL support
    • Replace and patch against a plain text file of nv set and nv unset commands
    • Maximum NVUE revisions limit
    • nv config diff --verbose option to see both previous and new configuration
    • Filter BGP received routes by neighbor and filter EVPN recieved routes by neighbor, RD and route type
    • Updated system health command output
    • ▼ Changed NVUE Commands
    • ▼ Removed NVUE Commands
    • ▼ New NVUE Commands

Release Considerations

Review the following considerations before you upgrade to Cumulus Linux 5.13.

Upgrade Requirements

You can use optimized image upgrade to upgrade the switch to Cumulus Linux 5.13 from Cumulus Linux 5.11.1 and later.

You can use package upgrade to upgrade the switch to Cumulus Linux 5.13 from the following releases. Package upgrade supports ISSU (warm boot) for these upgrade paths.

  • Cumulus Linux 5.12.1
  • Cumulus Linux 5.12.0
  • Cumulus Linux 5.11.1
  • Cumulus Linux 5.11.0

To upgrade to Cumulus Linux 5.13 from a release that does not support package upgrade or optimized image upgrade, you can install an image with ONIE.

Maximum Number of NVUE Revisions

Cumulus Linux 5.13 includes a new option to set the maximum number of revisions after which NVUE deletes older revisions automatically. The default setting is 100. After upgrading to Cumulus Linux 5.13, the first time you run nv set or nv unset commands, NVUE deletes older revisions if the number of revisions on the switch is greater than 100.

Linux Configuration Files Overwritten

If you use Linux commands to configure the switch, read the following information before you upgrade to Cumulus Linux 5.13 or later.

Cumulus Linux includes a default NVUE startup.yaml file. In addition, NVUE configuration auto save is enabled by default. As a result, Cumulus Linux overwrites any manual changes to Linux configuration files on the switch when the switch reboots after upgrade or you change the cumulus user account password with the Linux passwd command.

These issues occur only if you use Linux commands to configure the switch. If you use NVUE commands to configure the switch, these issues do not occur and no action is needed.

To prevent Cumulus Linux from overwriting manual changes to the Linux configuration files when the switch reboots or when changing the cumulus user account password with the passwd command, follow the steps below before you upgrade to 5.13 or later, or after a new binary image installation:

  1. Disable NVUE auto save:
cumulus@switch:~$ nv set system config auto-save state disabled
cumulus@switch:~$ nv config apply
cumulus@switch:~$ nv config save

  1. Delete the /etc/nvue.d/startup.yaml file:

    cumulus@switch:~$ sudo rm -rf /etc/nvue.d/startup.yaml

  2. Add the PASSWORD_NVUE_SYNC=no line to the /etc/default/nvued file:

    cumulus@switch:~$ sudo nano /etc/default/nvued
PASSWORD_NVUE_SYNC=no

DHCP Lease with the host-name Option

When a Cumulus Linux switch with NVUE enabled receives a DHCP lease containing the host-name option, it ignores the received hostname and does not apply it. For details, see this knowledge base article.

NVUE Commands After Upgrade

Cumulus Linux 5.13 includes the NVUE object model. After you upgrade to Cumulus Linux 5.13, running NVUE configuration commands might override configuration for features that are now configurable with NVUE and removes configuration you added manually to files or with automation tools like Ansible, Chef, or Puppet. To keep your configuration, you can do one of the following:

    Copyright © 2025  NVIDIA Corporation