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

If you are using the current version of Cumulus Linux, the content on this page may not be up to date. The current version of the documentation is available here. If you are redirected to the main page of the user guide, then this page may have been renamed; please search for it there.

What's New

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

What’s New in Cumulus Linux 5.10.1

Cumulus Linux 5.10.1 provides new SDK and firmware versions, and includes bug fixes.

  • To upgrade to Cumulus Linux 5.10.1 from Cumulus Linux 5.9.2, you must install the Cumulus Linux 5.10.1 image. You cannot use package upgrade.
  • Package upgrade to Cumulus Linux 5.10.1 from 5.9.1 and earlier does not support warm restart mode.

What’s New in Cumulus Linux 5.10.0

Platforms

NVIDIA SN5400 (400G Spectrum-4) - C2P (connnector-to-power) version only

PTP and PPS on the NVIDIA SN5400 switch are in BETA.

New Features and Enhancements

  • High frequency telemetry
  • Telemetry export with the OpenTelemetry protocol (OTLP) on Spectrum-4 switches (BETA)
  • SSH login notifications
  • QoS lossy headroom configuration and QoS Ingress and Egress Management Buffer Configuration
  • Ignore reserved field in VXLAN header
  • DHCP Option 61 (pre-provision a switch with its serial number) is enabled by default when Cumulus Linux boots
  • Graceful shutdown on a peer
  • SyncE minimum acceptable quality level option
  • Adaptive routing ECMP resource optimization
  • ▼ Additional OID support for SNMP MIBs
  • NVUE
    • AmBER PHY counters
    • Interface MAC address configuration
    • Commands to generate and delete a cl-support file
    • Session-based authentication
    • Redesigned BGP show output flags now similar to vtysh output
    • NVUE encrypts passwords by default in the NVUE startup.yaml file
    • ▼ Changed NVUE Commands
    • ▼ New NVUE Commands

Release Considerations

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

Linux Configuration Files Overwritten

If you use Linux commands to configure the switch, read the following information before you upgrade to Cumulus Linux 5.10.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
  • You change the cumulus 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 after upgrade:

  1. Before you upgrade to 5.10.0 or later, disable NVUE auto save:

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

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

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

To prevent Cumulus Linux from overriding changes to the Linux configuration files when you change the cumulus account password with the Linux passwd command, comment out the password optional pam_exec.so seteuid /usr/lib/cumulus/reconcile_password_with_nvue.sh line from the following files before you upgrade to 5.10.0 or later:

  • /etc/pam.d/chpasswd
  • /etc/pam.d/login
  • /etc/pam.d/passwd

DHCP Lease with the host-name Option

When a Cumulus Linux switch running 5.10.0 or later 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.10 includes the NVUE object model. After you upgrade to Cumulus Linux 5.10, 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:

Cumulus Linux 3.7, 4.3, and 4.4 continue to support NCLU. For more information, contact your NVIDIA Spectrum platform sales representative.

ASIC Monitoring Histogram Collection

In Cumulus Linux 5.10.0, there is an issue with ASIC monitoring histogram collection (release note issue ID 4037224).

▼ Issue Workaround

    Copyright © 2024  NVIDIA Corporation