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

NVUE Command Reference

layout-top layout-6 layout-1

Adaptive Routing

The nv unset commands remove the configuration you set with the equivalent nv set commands. This guide only describes an nv unset command if it differs from the nv set command.

nv set interface <interface-id> router adaptive-routing state

Enables or disables adaptive routing on the specified interface. The default setting is disabled.

Adaptive routing is a load balancing feature that improves network utilization for eligible IP packets by selecting forwarding paths dynamically based on the state of the switch, such as queue occupancy and port utilization.

  • Adaptive routing does not make use of resilient hashing.
  • Cumulus Linux does not support adaptive routing on layer 3 subinterfaces, SVIs, bonds or bond members.

  • In cumulus Linux 5.12 and earlier, NVUE restarts switchd when applying the setting.
  • In Cumulus Linux 5.13 and later, NVUE reloads switchd when applying the setting.
  • In Cumulus Linux 5.14 and earlier, you specify enable on or enable off instead of state enabled or state disabled.

Command Syntax

Syntax Description
interface-id The interface you want to configure.

Version History

Introduced in Cumulus Linux 5.1.0

Example

cumulus@switch:~$ nv set interface swp1 router adaptive-routing state enabled

nv set router adaptive-routing state

Enables and disables adaptive routing globally. The default setting is disabled.

Adaptive routing is a load balancing feature that improves network utilization for eligible IP packets by selecting forwarding paths dynamically based on the state of the switch, such as queue occupancy and port utilization.

  • In cumulus Linux 5.12 and earlier, NVUE restarts switchd when applying the setting.
  • In Cumulus Linux 5.13 and later, NVUE reloads switchd when applying the setting.
  • In Cumulus Linux 5.14 and earlier, you specify enable on or enable off instead of state enabled or state disabled.

Version History

Introduced in Cumulus Linux 5.1.0

Example

cumulus@switch:~$ nv set router adaptive-routing state enabled

Turns on link utilization. The default setting is disabled. When link utilization is on, the default link utilization threshold percentage for an adaptive routing interface is 70. If you enable the adaptive routing custom-profile, you can change the percentage to a value between 1 and 100.

Link utilization is off by default; you must enable the global link utilization setting to use the link utilization thresholds set on adaptive routing interfaces. You cannot enable or disable link utilization per interface.

  • You can enable link utilization only when you enable the adaptive routing custom-profile.
  • When you enable or disable link utilization, NVUE reloads switchd.
  • In Cumulus Linux 5.14 and earlier, you specify on or off.

Version History

Introduced in Cumulus Linux 5.6.0

Example

cumulus@switch:~$ nv set router adaptive-routing link-utilization-threshold enabled

    Copyright © 2025  NVIDIA Corporation