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

Cumulus Linux

layout-top layout-6 layout-1

What's New

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

What’s New in Cumulus Linux 5.12

Platforms

  • NVIDIA SN2201M includes an updated Parameter-Set IDentification (PSID) and firmware. You cannot downgrade the switch to 5.11.

New Features and Enhancements

  • 1G (optical) supported with SyncE on the SN5400 switch
  • Ability to ugrade from Cumulus Linux 5.11 with Optimized Image Upgrade
  • RoCE single shared buffer pool
  • Graceful BGP shutdown on a peer group
  • Software module reset
  • Clear dynamic MAC address entries from the forwarding database
  • BGP Prefix Independent Convergence
  • ECMP Resource Sharing During Next Hop Group Updates
  • RADIUS user command accounting support for multiple servers with first response option
  • SPIFFE ID support for user accounts
  • Open Telemetry:
  • NVUE
    • Traceroute command
    • Ping command
    • Commands to monitor interface traffic rate and PPS
    • Command to monitor disk usage
    • Configure additional package repositories
    • Look up the route for a destination
    • Addtional nv show command filters to filter by protocol, filter by neighbor state, and to filter neighbor details
    • API support for views with show commands
    • Logging commands
    • Commands to translate a revision or yaml configuration file
    • ▼ Removed NVUE Commands
    • ▼ New NVUE Commands

Release Considerations

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

Linux Configuration Files Overwritten

If you use Linux commands to configure the switch, read the following information before you upgrade to Cumulus Linux 5.12.0 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.12.0 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.12 includes the NVUE object model. After you upgrade to Cumulus Linux 5.12, 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