What's New
This document supports the Cumulus Linux 5.13 release, and lists new platforms, features, and enhancements.
- For a list of open and fixed issues in Cumulus Linux 5.13, see the Cumulus Linux 5.13 Release Notes.
- To upgrade to Cumulus Linux 5.13, follow the steps in Upgrading Cumulus Linux.
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 (400G 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
- Updated system health command
- 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 transceivers
- New maintenance mode commands
- RADIUS multiple VRF support
- RADIUS require-message-authenticate attribute
- Message of the day shows system reboot cause and health information
- Telemetry
- gNMI streaming
- OTEL LLDP metrics
- OTEL Adaptive routing statistics
- OTEL Transceiver statistics
- OTEL temporality mode for histogram metrics
- OTEL Buffer Occupancy and watermark metrics
- 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
- Replace and patch against a plain text file of `nv set` and `nv unset` commands
- Additional FRR filters
Release Considerations
Review the following considerations before you upgrade to Cumulus Linux 5.13.
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:
- Disable NVUE auto save:
cumulus@switch:~$ nv set system config auto-save state disabled
cumulus@switch:~$ nv config apply
cumulus@switch:~$ nv config save
-
Delete the
/etc/nvue.d/startup.yaml
file:cumulus@switch:~$ sudo rm -rf /etc/nvue.d/startup.yaml
-
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:
- Update your automation tools to use NVUE.
- Configure NVUE to ignore certain underlying Linux files when applying configuration changes.
- Use Linux and FRR (vtysh) commands instead of NVUE for all switch configuration.