Action Commands


nv action

Resets counters for interfaces, BGP, QoS buffers and pools, removes conflicts from protodown MLAG bonds, and disconnects system users.


nv action clear acl counters

Clears all ACL counters.

Version History

Introduced in Cumulus Linux 5.6.0

Example

cumulus@switch:~$ nv action clear acl counters
acl counters cleared.
Action succeeded

nv action clear evpn vni

Clears duplicate addresses for all VNIs.

Version History

Introduced in Cumulus Linux 5.6.0

Example

cumulus@switch:~$ nv action clear evpn vni
Action succeeded

nv action clear evpn vni <vni-id>

Clears duplicate addresses for the specified VNI.

Command Syntax

Syntax Description
<vni-id> The VNI ID.

Version History

Introduced in Cumulus Linux 5.6.0

Example

cumulus@switch:~$ nv action clear evpn vni 10
Action succeeded

nv action clear evpn vni <vni-id> host <host-id>

Clears the duplicate host address for the specified VNI

Command Syntax

Syntax Description
<vni-id> The VNI ID.
<host-id> The IP address of the host.

Version History

Introduced in Cumulus Linux 5.6.0

Example

cumulus@switch:~$ nv action clear evpn vni 10 host 10.0.0.9
Action succeeded

nv action clear evpn vni <vni> mac <mac-address>

Clears the duplicate MAC address for the specified VNI.

Version History

Introduced in Cumulus Linux 5.6.0

Example

cumulus@switch:~$ nv action clear evpn vni 10 mac 00:e0:ec:20:12:62
Action succeeded

nv action clear interface counters

Clears all interface-specific counters from all interfaces. Interface counters provide information about an interface, such as the number of packets intentionally or intentionally dropped, the number of inbound and outbound packets discarded even though the switch detected no errors, the number of inbound and outbound packets not transmitted because of errors, and so on.

This command does not clear counters in the kernel or hardware.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear interface counters
all interface counters cleared.
Action succeeded

nv action clear interface <interface> bond mlag lacp-conflict

Clears the MLAG LACP conflict on the specified interface bond. A conflict can be an LACP partner MAC address mismatch or a duplicate LACP partner MAC address.

Command Syntax

Syntax Description
<interface> The interface that has an LACP conflict.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv action clear interface swp1 bond mlag lacp-conflict

nv action clear interface <interface> counters

Clears all interface-specific counters from the specified interface. Interface counters provide information about an interface, such as the number of packets intentionally or intentionally dropped, the number of inbound and outbound packets discarded even though the switch detected no errors, the number of inbound and outbound packets not transmitted because of errors, and so on.

This command does not clear counters in the kernel or hardware.

Command Syntax

Syntax Description
<interface-id> The interface on which you want to clear counters.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear interface swp1 counters
swp1 counters cleared.
Action succeeded

nv action clear interface <interface-id> counters ptp

Clears PTP counters on the specified interface.

Command Syntax

Syntax Description
<interface-id> The interface on which you want to clear PTP counters.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear interface swp1 counters ptp
Action succeeded

nv action clear interface <interface-id> qos buffer

Clears QoS buffer counters on the specified interface.

Command Syntax

Syntax Description
<interface-id> The interface on which you want to clear the QoS buffer.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear interface swp1 qos buffer
Action succeeded

nv action clear interface <interface-id> qos pfc-watchdog deadlock-count

Clears the QoS PFC watchdog deadlock count on the specified interface. PFC watchdog detects and mitigates pause storms on ports where PFC or link pause is enabled.

Command Syntax

Syntax Description
<interface-id> The interface on which you want to clear the PFC watchdog deadlock count.

Version History

Introduced in Cumulus Linux 5.6.0

Example

cumulus@switch:~$ nv action clear interface swp1 qos pfc-watchdog deadlock-count
Action succeeded

nv action clear interface <interface-id> qos roce counters

Clears QoS RoCE counters on the specified interface.

Command Syntax

Syntax Description
<interface-id> The interface on which you want to clear RoCE counters.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear interface swp1 qos roce counters

nv action clear interface <interface-id> synce counters

Clears SyncE counters on the specified interface.

Command Syntax

Syntax Description
<interface-id> The interface on which you want to clear synce counters.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear interface swp1 synce counters

nv action clear mlag lacp-conflict

Clears the MLAG LACP conflict. A conflict can be an LACP partner MAC address mismatch or a duplicate LACP partner MAC address.

Version History

Introduced in Cumulus Linux 5.0.0

Example

cumulus@switch:~$ nv action clear mlag lacp-conflict 

nv action clear qos buffer multicast-switch-priority

Clears the QoS multicast switch priority buffers.

Version History

Introduced in Cumulus Linux 5.4.0

Example

cumulus@switch:~$ nv action clear qos buffer multicast-switch-priority 

nv action clear qos buffer pool

Clears the QoS pool buffers.

Version History

Introduced in Cumulus Linux 5.4.0

Example

cumulus@switch:~$ nv action clear qos buffer pool 

nv action clear router bgp

Clears BGP sessions with all neighbors.

Version History

Introduced in Cumulus Linux 5.6.0

Example

cumulus@switch:~$ nv action clear router bgp
Action succeeded

nv action clear router bgp in prefix-filter

Clears and refreshes inbound routes for all neighbors, address families, and VRFs and refreshes the outbound route filtering prefix list.

Version History

Introduced in Cumulus Linux 5.6.0

Example

cumulus@switch:~$ nv action clear router bgp in prefix-filter
Action succeeded

nv action clear router bgp out

Clears and refreshes outbound routes for all neighbors, address families, and VRFs.

Version History

Introduced in Cumulus Linux 5.6.0

Example

cumulus@switch:~$ nv action clear router bgp out
Action succeeded

nv action clear router bgp soft

Clears all routes with all neighbors, address families, and VRFs.

Version History

Introduced in Cumulus Linux 5.6.0

Example

cumulus@switch:~$ nv action clear router bgp soft
Action succeeded

nv action clear router bgp soft in

Clears and refreshes all inbound routes with all neighbors, address families, and VRFs.

Version History

Introduced in Cumulus Linux 5.6.0

Example

cumulus@switch:~$ nv action clear router bgp soft in
Action succeeded

nv action clear router bgp soft out

Clears and resends all outbound routes with all neighbors, address families, and VRFs.

Version History

Introduced in Cumulus Linux 5.6.0

Example

cumulus@switch:~$ nv action clear router bgp soft out
Action succeeded

nv action clear router igmp interfaces

Clears the IGMP interface state.

Version History

Introduced in Cumulus Linux 5.6.0

Example

cumulus@switch:~$ nv action clear router igmp interfaces
Action succeeded

nv action clear router policy prefix-list

Clears all IP prefix list statistics.

Version History

Introduced in Cumulus Linux 5.6.0

Example

cumulus@switch:~$ nv action clear router policy prefix-list
Action succeeded

nv action clear router policy prefix-list <prefix-list-id>

Clears statistics for the specified prefix list.

Command Syntax

Syntax Description
<prefix-list-id> The name of the prefix list whose statistics you want to clear.

Version History

Introduced in Cumulus Linux 5.6.0

Example

cumulus@switch:~$ nv action clear router policy prefix-list prefixlist1
Action succeeded

nv action clear router policy prefix-list <prefix-list-id> rule <rule-id> match <match-id>

Clears statistics for a specific prefix list rule number and match ID.

Command Syntax

Syntax Description
<prefix-list-id> The name of the prefix list whose statistics you want to clear.
<rule-id> The prefix list rule number.
<match-id> The prefix list match criteria.

Version History

Introduced in Cumulus Linux 5.6.0

Example

cumulus@switch:~$ nv action clear router policy prefix-list prefixlist1 rule 10 match 10.0.0.0/16
Action succeeded

nv action clear router policy route-map

Clears all route map counters.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear router policy route-map
Action succeeded

nv action clear router policy route-map <route-map-id>

Clears counters for the specified route map.

Command Syntax

Syntax Description
<route-map-id> The route map you want to clear.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear router policy route-map ROUTEMAP1
Action succeeded

nv action clear service ptp <instance-id> monitor violations log max-offset

Clears PTP monitor violation log maximum offset value.

Command Syntax

Syntax Description
<instance-id> The PTP instance number used for management purposes.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear service ptp 1 monitor violations log max-offset
Action succeeded

nv action clear service ptp <instance-id> monitor violations log min-offset

Clears PTP monitor violation log minumum offset value.

Command Syntax

Syntax Description
<instance-id> The PTP instance number used for management purposes.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear service ptp 1 monitor violations log min-offset
Action succeeded

nv action clear service ptp <instance-id> monitor violations log path-delay

Clears the PTP monitor violation log path delay value.

Command Syntax

Syntax Description
<instance-id> The PTP instance number used for management purposes.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear service ptp 1 monitor violations log path-delay
Action succeeded

nv action clear vrf <vrf-id> router bgp in prefix-filter

Clears and refreshes inbound routes for all neighbors and address families in the specified VRF and refreshes the outbound route filtering prefix list.

Command Syntax

Syntax Description
<vrf-id> The VRF name.

Version History

Introduced in Cumulus Linux 5.6.0

Example

cumulus@switch:~$ nv action clear vrf default router bgp in prefix-filter
Action succeeded

nv action clear vrf <vrf-id> router bgp out

Clears and refreshes outbound routes for all neighbors and address families in the specified VRF.

Command Syntax

Syntax Description
<vrf-id> The VRF name.

Version History

Introduced in Cumulus Linux 5.6.0

Example

cumulus@switch:~$ nv action clear vrf default router bgp out
Action succeeded

nv action clear vrf <vrf-id> router bgp soft

Clears all routes with all neighbors and address families in the specified VRF.

Command Syntax

Syntax Description
<vrf-id> The VRF name.

Version History

Introduced in Cumulus Linux 5.6.0

Example

cumulus@switch:~$ nv action clear vrf default router bgp soft
Action succeeded

nv action clear vrf <vrf-id> router bgp soft in

Clears and refreshes all inbound routes with all neighbors and address families in the specified VRF.

Command Syntax

Syntax Description
<vrf-id> The VRF name.

Version History

Introduced in Cumulus Linux 5.6.0

Example

cumulus@switch:~$ nv action clear vrf default router bgp soft in
Action succeeded

nv action clear vrf <vrf-id> router bgp soft out

Clears and resends all outbound routes with all neighbors and address families in the specified VRF.

Command Syntax

Syntax Description
<vrf-id> The VRF name.

Version History

Introduced in Cumulus Linux 5.6.0

Example

cumulus@switch:~$ nv action clear vrf default router bgp soft out
Action succeeded

nv action clear vrf <vrf-id> router bgp address-family ipv4-unicast in

Clears BGP IPv4 inbound routes.

This command does not clear counters in the kernel or hardware and does not reset BGP neighbor adjacencies.

  • When the switch has a neighbor configured with soft-reconfiguration inbound enabled, this command clears the routes in the soft reconfiguration table for the address family. This results in reevaluating routes in the BGP table against any applied input policies.
  • When the switch has a neighbor configured without the soft-reconfiguration inbound option enabled, this command sends the peer a route refresh message.

Command Syntax

Syntax Description
<vrf-id> The VRF name.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear vrf default router bgp address-family ipv4-unicast in
Action succeeded

nv action clear vrf <vrf-id> router bgp address-family ipv4-unicast out

Clears BGP IPv4 outbound routes.

This command does not:

  • Clear counters in the kernel or hardware.
  • Reset BGP neighbor adjacencies.
  • Readvertise all routes to BGP peers.

Command Syntax

Syntax Description
<vrf-id> The VRF name.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear vrf default router bgp address-family ipv4-unicast in
Action succeeded

nv action clear vrf <vrf-id> router bgp address-family ipv4-unicast soft in

Clears BGP IPv4 inbound routes for all BGP peers.

This command does not clear counters in the kernel or hardware and does not reset BGP neighbor adjacencies.

  • When the switch has a neighbor configured with soft-reconfiguration inbound enabled, this command clears the routes in the soft reconfiguration table for the address family. This results in reevaluating routes in the BGP table against any applied input policies.
  • When the switch has a neighbor configured without the soft-reconfiguration inbound option enabled, this command sends the peer a route refresh message.
  • If you do not specify the direction in, the command affects both inbound and outbound routes depending on whether you enable soft-reconfiguration inbound.

Command Syntax

Syntax Description
<vrf-id> The VRF name.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear vrf default router bgp address-family soft in
Action succeeded

nv action clear vrf <vrf-id> router bgp address-family ipv4-unicast soft out

Clears BGP IPv4 outbound routes for all BGP peers.

This command does not:

  • Clear counters in the kernel or hardware.
  • Reset BGP neighbor adjacencies.
  • Readvertise all routes to BGP peers.

If you do not specify the direction out, the command affects both inbound and outbound routes depending on whether soft-reconfiguration inbound is enabled.

Command Syntax

Syntax Description
<vrf-id> The VRF name.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear vrf default router bgp address-family soft out
Action succeeded

nv action clear vrf <vrf-id> router bgp address-family ipv6-unicast in

Clears BGP IPv6 inbound routes.

This command does not clear counters in the kernel or hardware and does not reset BGP neighbor adjacencies.

  • When the switch has a neighbor configured with soft-reconfiguration inbound enabled, this command clears the routes in the soft reconfiguration table for the address family. This results in reevaluating routes in the BGP table against any applied input policies.
  • When the switch has a neighbor configured without the soft-reconfiguration inbound option enabled, this command sends the peer a route refresh message.

Command Syntax

Syntax Description
<vrf-id> The VRF name.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear vrf default router bgp address-family ipv6-unicast in
Action succeeded

nv action clear vrf <vrf-id> router bgp address-family ipv6-unicast out

Clears BGP IPv6 outbound routes.

This command does not:

  • Clear counters in the kernel or hardware.
  • Reset BGP neighbor adjacencies.
  • Readvertise all routes to BGP peers.

Command Syntax

Syntax Description
<vrf-id> The VRF name.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear vrf default router bgp address-family ipv6-unicast out
Action succeeded

nv action clear vrf <vrf-id> router bgp address-family ipv6-unicast soft in

Clears BGP IPv6 inbound routes for all BGP peers.

This command does not clear counters in the kernel or hardware and does not reset BGP neighbor adjacencies.

  • When the switch has a neighbor configured with soft-reconfiguration inbound enabled, this command clears the routes in the soft reconfiguration table for the address family. This results in reevaluating routes in the BGP table against any applied input policies.
  • When the switch has a neighbor configured without the soft-reconfiguration inbound option enabled, this command sends the peer a route refresh message.
  • If you do not specify the direction in, the command affects both inbound and outbound routes depending on whether soft-reconfiguration inbound is enabled.

Command Syntax

Syntax Description
<vrf-id> The VRF name.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear vrf default router bgp address-family ipv6-unicast soft in
Action succeeded

nv action clear vrf <vrf-id> router bgp address-family ipv6-unicast soft out

Clears BGP IPv6 outbound routes for all BGP peers.

This command does not:

  • Clear counters in the kernel or hardware.
  • Reset BGP neighbor adjacencies.
  • Readvertise all routes to BGP peers.

If you do not specify the direction out, the command affects both inbound and outbound routes depending on whether soft-reconfiguration inbound is enabled.

Command Syntax

Syntax Description
<vrf-id> The VRF name.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear vrf default router bgp address-family ipv6-unicast soft out
Action succeeded

nv action clear vrf <vrf-id> router bgp address-family l2vpn-evpn in

Clears BGP EVPN inbound routes.

This command does not clear counters in the kernel or hardware and does not reset BGP neighbor adjacencies.

  • When the switch has a neighbor configured with soft-reconfiguration inbound enabled, this command clears the routes in the soft reconfiguration table for the address family. This results in reevaluating routes in the BGP table against any applied input policies.
  • When the switch has a neighbor configured without the soft-reconfiguration inbound option enabled, this command sends the peer a route refresh message.

Command Syntax

Syntax Description
<vrf-id> The VRF name.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear vrf default router bgp address-family l2vpn-evpn in
Action succeeded

nv action clear vrf <vrf-id> router bgp address-family l2vpn-evpn out

Clears BGP EVPN outbound routes.

This command does not:

  • Clear counters in the kernel or hardware.
  • Reset BGP neighbor adjacencies.
  • Readvertise all routes to BGP peers.

Command Syntax

Syntax Description
<vrf-id> The VRF name.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear vrf default router bgp address-family l2vpn-evpn out
Action succeeded

nv action clear vrf <vrf-id> router bgp address-family l2vpn-evpn soft in

Clears BGP EVPN inbound routes for all BGP peers.

This command does not clear counters in the kernel or hardware and does not reset BGP neighbor adjacencies.

  • When the switch has a neighbor configured with soft-reconfiguration inbound enabled, this command clears the routes in the soft reconfiguration table for the address family. This results in reevaluating routes in the BGP table against any applied input policies.
  • When the switch has a neighbor configured without the soft-reconfiguration inbound option enabled, this command sends the peer a route refresh message.
  • If you do not specify the direction in, the command affects both inbound and outbound routes depending on whether soft-reconfiguration inbound is enabled.

Command Syntax

Syntax Description
<vrf-id> The VRF name.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear vrf default router bgp address-family l2vpn-evpn soft in
Action succeeded

nv action clear vrf <vrf-id> router bgp address-family l2vpn-evpn soft out

Clears BGP EVPN outbound routes for all BGP peers.

This command does not:

  • Clear counters in the kernel or hardware.
  • Reset BGP neighbor adjacencies.
  • Readvertise all routes to BGP peers.

If you do not specify the direction out, the command affects both inbound and outbound routes depending on whether soft-reconfiguration inbound is enabled.

Command Syntax

Syntax Description
<vrf-id> The VRF name.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear vrf default router bgp address-family l2vpn-evpn soft out
Action succeeded

nv action clear vrf <vrf-id> router bgp neighbor <neighbor-id> in

Clears inbound routes for a specific BGP peer in the specified VRF.

This command does not clear counters in the kernel or hardware and does not reset BGP neighbor adjacencies.

  • When the switch has a neighbor configured with soft-reconfiguration inbound enabled, this command clears the routes in the soft reconfiguration table for the address family. This results in reevaluating routes in the BGP table against any applied input policies.
  • When the switch has a neighbor configured without the soft-reconfiguration inbound option enabled, this command sends the peer a route refresh message.

Command Syntax

Syntax Description
<vrf-id> The VRF name.
<neighbor-id> The IP address of the BGP peer or the interface if you are using unnumbered BGP.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear vrf default router bgp neighbor swp51 in
Action succeeded

nv action clear vrf <vrf-id> router bgp neighbor <neighbor-id> out

Clears outbound routes for a specific BGP peer in the specified VRF.

This command does not:

  • Clear counters in the kernel or hardware.
  • Reset BGP neighbor adjacencies.
  • Readvertise all routes to BGP peers.

Command Syntax

Syntax Description
<vrf-id> The VRF name.
<neighbor-id> The IP address of the BGP peer or the interface if you are using unnumbered BGP.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear vrf default router bgp neighbor swp51 out
Action succeeded

nv action clear vrf <vrf-id> router bgp neighbor <neighbor-id> soft in

Clears inbound routes for a specific BGP peer in the specified VRF without resetting the peer session.

This command does not clear counters in the kernel or hardware and does not reset BGP neighbor adjacencies.

  • When the switch has a neighbor configured with soft-reconfiguration inbound enabled, this command clears the routes in the soft reconfiguration table for the address family. This results in reevaluating routes in the BGP table against any applied input policies.
  • When the switch has a neighbor configured without the soft-reconfiguration inbound option enabled, this command sends the peer a route refresh message.
  • If you do not specify the direction in, the command affects both inbound and outbound routes depending on whether soft-reconfiguration inbound is enabled.

Command Syntax

Syntax Description
<vrf-id> The VRF name.
<neighbor-id> The IP address of the BGP peer or the interface if you are using unnumbered BGP.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear vrf default router bgp neighbor swp51 soft in
Action succeeded

nv action clear vrf <vrf-id> router bgp neighbor <neighbor-id> soft out

Clears outbound routes for a specific BGP peer in the specified VRF without resetting the peer session.

This command does not:

  • Clear counters in the kernel or hardware.
  • Reset BGP neighbor adjacencies.
  • Readvertise all routes to BGP peers.

If you do not specify the direction out, the command affects both inbound and outbound routes depending on whether soft-reconfiguration inbound is enabled.

Command Syntax

Syntax Description
<vrf-id> The VRF name.
<neighbor-id> The IP address of the BGP peer or the interface if you are using unnumbered BGP.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear vrf default router bgp neighbor swp51 soft out
Action succeeded

nv action clear vrf <vrf-id> router bgp neighbor <neighbor-id> address-family ipv4-unicast in

Clears IPv4 inbound routes for a specific BGP peer in the specified VRF.

This command does not clear counters in the kernel or hardware and does not reset BGP neighbor adjacencies.

  • When the switch has a neighbor configured with soft-reconfiguration inbound enabled, this command clears the routes in the soft reconfiguration table for the address family. This results in reevaluating routes in the BGP table against any applied input policies.
  • When the switch has a neighbor configured without the soft-reconfiguration inbound option enabled, this command sends the peer a route refresh message.

Command Syntax

Syntax Description
<vrf-id> The VRF name.
<neighbor-id> The IP address of the BGP peer or the interface if you are using unnumbered BGP.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear vrf default router bgp neighbor swp51 address-family ipv4-unicast in
Action succeeded

nv action clear vrf <vrf-id> router bgp neighbor <neighbor-id> address-family ipv4-unicast out

Clears IPv4 outbound routes for a specific BGP peer in the specified VRF.

This command does not:

  • Clear counters in the kernel or hardware.
  • Reset BGP neighbor adjacencies.
  • Readvertise all routes to BGP peers.

Command Syntax

Syntax Description
<vrf-id> The VRF name.
<neighbor-id> The IP address of the BGP peer or the interface if you are using unnumbered BGP.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear vrf default router bgp neighbor swp51 address-family ipv4-unicast out
Action succeeded

nv action clear vrf <vrf-id> router bgp neighbor <neighbor-id> address-family ipv4-unicast soft in

Clears IPv4 inbound routes for a specific BGP peer in the specified VRF without resetting the peer session.

This command does not clear counters in the kernel or hardware and does not reset BGP neighbor adjacencies.

  • When the switch has a neighbor configured with soft-reconfiguration inbound enabled, this command clears the routes in the soft reconfiguration table for the address family. This results in reevaluating routes in the BGP table against any applied input policies.
  • When the switch has a neighbor configured without the soft-reconfiguration inbound option enabled, this command sends the peer a route refresh message.
  • If you do not specify the direction in, the command affects both inbound and outbound routes depending on whether soft-reconfiguration inbound is enabled.

Command Syntax

Syntax Description
<vrf-id> The VRF name.
<neighbor-id> The IP address of the BGP peer or the interface if you are using unnumbered BGP.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear vrf default router bgp neighbor swp51 address-family ipv4-unicast soft in
Action succeeded

nv action clear vrf <vrf-id> router bgp neighbor <neighbor-id> address-family ipv4-unicast soft out

Clears IPv4 outbound routes for a specific BGP peer in the specified VRF without resetting the peer session.

This command does not:

  • Clear counters in the kernel or hardware.
  • Reset BGP neighbor adjacencies.
  • Readvertise all routes to BGP peers.

If you do not specify the direction out, the command affects both inbound and outbound routes depending on whether soft-reconfiguration inbound is enabled.

Command Syntax

Syntax Description
<vrf-id> The VRF name.
<neighbor-id> The IP address of the BGP peer or the interface if you are using unnumbered BGP.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear vrf default router bgp neighbor swp51 address-family ipv4-unicast soft out
Action succeeded

nv action clear vrf <vrf-id> router bgp neighbor <neighbor-id> address-family ipv6-unicast in

Clears IPv6 inbound routes for a specific BGP peer in the specified VRF.

This command does not clear counters in the kernel or hardware and does not reset BGP neighbor adjacencies.

  • When the switch has a neighbor configured with soft-reconfiguration inbound enabled, this command clears the routes in the soft reconfiguration table for the address family. This results in reevaluating routes in the BGP table against any applied input policies.
  • When the switch has a neighbor configured without the soft-reconfiguration inbound option enabled, this command sends the peer a route refresh message.

Command Syntax

Syntax Description
<vrf-id> The VRF name.
<neighbor-id> The IP address of the BGP peer or the interface if you are using unnumbered BGP.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear vrf default router bgp neighbor swp51 address-family ipv6-unicast in
Action succeeded

nv action clear vrf <vrf-id> router bgp neighbor <neighbor-id> address-family ipv6-unicast out

Clears IPv6 outbound routes for a specific BGP peer in the specified VRF.

This command does not:

  • Clear counters in the kernel or hardware.
  • Reset BGP neighbor adjacencies.
  • Readvertise all routes to BGP peers.

Command Syntax

Syntax Description
<vrf-id> The VRF name.
<neighbor-id> The IP address of the BGP peer or the interface if you are using unnumbered BGP.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear vrf default router bgp neighbor swp51 address-family ipv6-unicast out
Action succeeded

nv action clear vrf <vrf-id> router bgp neighbor <neighbor-id> address-family ipv6-unicast soft in

Clears IPv6 inbound routes for a specific BGP peer in the specified VRF without resetting the peer session.

This command does not clear counters in the kernel or hardware and does not reset BGP neighbor adjacencies.

  • When the switch has a neighbor configured with soft-reconfiguration inbound enabled, this command clears the routes in the soft reconfiguration table for the address family. This results in reevaluating routes in the BGP table against any applied input policies.
  • When the switch has a neighbor configured without the soft-reconfiguration inbound option enabled, this command sends the peer a route refresh message.
  • If you do not specify the direction in, the command affects both inbound and outbound routes depending on whether soft-reconfiguration inbound is enabled.

Command Syntax

Syntax Description
<vrf-id> The VRF name.
<neighbor-id> The IP address of the BGP peer or the interface if you are using unnumbered BGP.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear vrf default router bgp neighbor swp51 address-family ipv6-unicast soft in
Action succeeded

nv action clear vrf <vrf-id> router bgp neighbor <neighbor-id> address-family ipv6-unicast soft out

Clears IPv6 outbound routes for a specific BGP peer in the specified VRF without resetting the peer session.

This command does not:

  • Clear counters in the kernel or hardware.
  • Reset BGP neighbor adjacencies.
  • Readvertise all routes to BGP peers.

If you do not specify the direction out, the command affects both inbound and outbound routes depending on whether soft-reconfiguration inbound is enabled.

Command Syntax

Syntax Description
<vrf-id> The VRF name.
<neighbor-id> The IP address of the BGP peer or the interface if you are using unnumbered BGP.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear vrf default router bgp neighbor swp51 address-family ipv6-unicast soft out
Action succeeded

nv action clear vrf <vrf-id> router bgp neighbor <neighbor-id> address-family l2vpn-evpn in

Clears EVPN inbound routes for a specific BGP peer in the specified VRF.

This command does not clear counters in the kernel or hardware and does not reset BGP neighbor adjacencies.

  • When the switch has a neighbor configured with soft-reconfiguration inbound enabled, this command clears the routes in the soft reconfiguration table for the address family. This results in reevaluating routes in the BGP table against any applied input policies.
  • When the switch has a neighbor configured without the soft-reconfiguration inbound option enabled, this command sends the peer a route refresh message.

Command Syntax

Syntax Description
<vrf-id> The VRF name.
<neighbor-id> The IP address of the BGP peer or the interface if you are using unnumbered BGP.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear vrf default router bgp neighbor swp51 address-family l2vpn-evpn in
Action succeeded

nv action clear vrf <vrf-id> router bgp neighbor <neighbor-id> address-family l2vpn-evpn out

Clears EVPN outbound routes for a specific BGP peer in the specified VRF.

This command does not:

  • Clear counters in the kernel or hardware.
  • Reset BGP neighbor adjacencies.
  • Readvertise all routes to BGP peers.

Command Syntax

Syntax Description
<vrf-id> The VRF name.
<neighbor-id> The IP address of the BGP peer or the interface if you are using unnumbered BGP.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear vrf default router bgp neighbor swp51 address-family l2vpn-evpn out
Action succeeded

nv action clear vrf <vrf-id> router bgp neighbor <neighbor-id> address-family l2vpn-evpn soft in

Clears EVPN inbound routes for a specific BGP peer in the specified VRF without resetting the peer session.

This command does not clear counters in the kernel or hardware and does not reset BGP neighbor adjacencies.

  • When the switch has a neighbor configured with soft-reconfiguration inbound enabled, this command clears the routes in the soft reconfiguration table for the address family. This results in reevaluating routes in the BGP table against any applied input policies.
  • When the switch has a neighbor configured without the soft-reconfiguration inbound option enabled, this command sends the peer a route refresh message.
  • If you do not specify the direction in, the command affects both inbound and outbound routes depending on whether soft-reconfiguration inbound is enabled.

Command Syntax

Syntax Description
<vrf-id> The VRF name.
<neighbor-id> The IP address of the BGP peer or the interface if you are using unnumbered BGP.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear vrf default router bgp neighbor swp51 address-family l2vpn-evpn soft in
Action succeeded

nv action clear vrf <vrf-id> router bgp neighbor <neighbor-id> address-family l2vpn-evpn soft out

Clears EVPN outbound routes for a specific BGP peer in the specified VRF without resetting the peer session.

This command does not:

  • Clear counters in the kernel or hardware.
  • Reset BGP neighbor adjacencies.
  • Readvertise all routes to BGP peers.

If you do not specify the direction out, the command affects both inbound and outbound routes depending on whether soft-reconfiguration inbound is enabled.

Command Syntax

Syntax Description
<vrf-id> The VRF name.
<neighbor-id> The IP address of the BGP peer or the interface if you are using unnumbered BGP.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear vrf default router bgp neighbor swp51 address-family l2vpn-evpn soft out
Action succeeded

nv action clear vrf <vrf-id> router bgp peer-group <peer-group-id> in

Clears inbound routes for a specific BGP peer group in the specified VRF.

This command does not clear counters in the kernel or hardware and does not reset BGP neighbor adjacencies.

  • When the switch has a neighbor configured with soft-reconfiguration inbound enabled, this command clears the routes in the soft reconfiguration table for the address family. This results in reevaluating routes in the BGP table against any applied input policies.
  • When the switch has a neighbor configured without the soft-reconfiguration inbound option enabled, this command sends the peer a route refresh message.

Command Syntax

Syntax Description
<vrf-id> The VRF name.
<peer-group-id> The peer group name.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear vrf default router bgp peer-group SPINES in
Action succeeded

nv action clear vrf <vrf-id> router bgp peer-group <peer-group-id> out

Clears outbound routes for a specific BGP peer group in the specified VRF.

This command does not:

  • Clear counters in the kernel or hardware.
  • Reset BGP neighbor adjacencies.
  • Readvertise all routes to BGP peers.

Command Syntax

Syntax Description
<vrf-id> The VRF name.
<peer-group-id> The peer group name.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear vrf default router bgp peer-group SPINES out
Action succeeded

nv action clear vrf <vrf-id> router bgp peer-group <peer-group-id> soft in

Clears inbound routes for a specific BGP peer group in the specified VRF.

This command does not clear counters in the kernel or hardware and does not reset BGP neighbor adjacencies.

  • When the switch has a neighbor configured with soft-reconfiguration inbound enabled, this command clears the routes in the soft reconfiguration table for the address family. This results in reevaluating routes in the BGP table against any applied input policies.
  • When the switch has a neighbor configured without the soft-reconfiguration inbound option enabled, this command sends the peer a route refresh message.
  • If you do not specify the direction in, the command affects both inbound and outbound routes depending on whether soft-reconfiguration inbound is enabled.

Command Syntax

Syntax Description
<vrf-id> The VRF name.
<peer-group-id> The peer group name.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear vrf default router bgp peer-group SPINES soft in
Action succeeded

nv action clear vrf <vrf-id> router bgp peer-group <peer-group-id> soft out

Clears outbound routes for a specific BGP peer group in the specified VRF.

This command does not:

  • Clear counters in the kernel or hardware.
  • Reset BGP neighbor adjacencies.
  • Readvertise all routes to BGP peers.

If you do not specify the direction out, the command affects both inbound and outbound routes depending on whether soft-reconfiguration inbound is enabled.

Command Syntax

Syntax Description
<vrf-id> The VRF name.
<peer-group-id> The peer group name.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear vrf default router bgp peer-group SPINES soft out
Action succeeded

nv action clear vrf <vrf-id> router bgp peer-group <peer-group-id> address-family ipv4-unicast in

Clears IPv4 inbound routes for a specific BGP peer group in the specified VRF.

This command does not clear counters in the kernel or hardware and does not reset BGP neighbor adjacencies.

  • When the switch has a neighbor configured with soft-reconfiguration inbound enabled, this command clears the routes in the soft reconfiguration table for the address family. This results in reevaluating routes in the BGP table against any applied input policies.
  • When the switch has a neighbor configured without the soft-reconfiguration inbound option enabled, this command sends the peer a route refresh message.

Command Syntax

Syntax Description
<vrf-id> The VRF name.
<peer-group-id> The peer group name.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear vrf default router bgp peer-group SPINES address-family ipv4-unicast in
Action succeeded

nv action clear vrf <vrf-id> router bgp peer-group <peer-group-id> address-family ipv4-unicast out

Clears IPv4 outbound routes for a specific BGP peer group in the specified VRF.

This command does not:

  • Clear counters in the kernel or hardware.
  • Reset BGP neighbor adjacencies.
  • Readvertise all routes to BGP peers.

Command Syntax

Syntax Description
<vrf-id> The VRF name.
<peer-group-id> The peer group name.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear vrf default router bgp peer-group SPINES address-family ipv4-unicast out
Action succeeded

nv action clear vrf <vrf-id> router bgp peer-group <peer-group-id> address-family ipv4-unicast soft in

Clears IPv4 inbound routes for a specific BGP peer group in the specified VRF.

This command does not clear counters in the kernel or hardware and does not reset BGP neighbor adjacencies.

  • When the switch has a neighbor configured with soft-reconfiguration inbound enabled, this command clears the routes in the soft reconfiguration table for the address family. This results in reevaluating routes in the BGP table against any applied input policies.
  • When the switch has a neighbor configured without the soft-reconfiguration inbound option enabled, this command sends the peer a route refresh message.
  • If you do not specify the direction in, the command affects both inbound and outbound routes depending on whether soft-reconfiguration inbound is enabled.

Command Syntax

Syntax Description
<vrf-id> The VRF name.
<peer-group-id> The peer group name.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear vrf default router bgp peer-group SPINES address-family ipv4-unicast soft in
Action succeeded

nv action clear vrf <vrf-id> router bgp peer-group <peer-group-id> address-family ipv4-unicast soft out

Clears IPv4 outbound routes for a specific BGP peer group in the specified VRF.

This command does not:

  • Clear counters in the kernel or hardware.
  • Reset BGP neighbor adjacencies.
  • Readvertise all routes to BGP peers.

If you do not specify the direction out, the command affects both inbound and outbound routes depending on whether soft-reconfiguration inbound is enabled.

Command Syntax

Syntax Description
<vrf-id> The VRF name.
<peer-group-id> The peer group name.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear vrf default router bgp peer-group SPINES address-family ipv4-unicast soft out
Action succeeded

nv action clear vrf <vrf-id> router bgp peer-group <peer-group-id> address-family ipv6-unicast in

Clears IPv6 inbound routes for a specific BGP peer group in the specified VRF.

This command does not clear counters in the kernel or hardware and does not reset BGP neighbor adjacencies.

  • When the switch has a neighbor configured with soft-reconfiguration inbound enabled, this command clears the routes in the soft reconfiguration table for the address family. This results in reevaluating routes in the BGP table against any applied input policies.
  • When the switch has a neighbor configured without the soft-reconfiguration inbound option enabled, this command sends the peer a route refresh message.

Command Syntax

Syntax Description
<vrf-id> The VRF name.
<peer-group-id> The peer group name.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear vrf default router bgp peer-group SPINES address-family ipv6-unicast in
Action succeeded

nv action clear vrf <vrf-id> router bgp peer-group <peer-group-id> address-family ipv6-unicast out

Clears IPv6 outbound routes for a specific BGP peer group in the specified VRF.

This command does not:

  • Clear counters in the kernel or hardware.
  • Reset BGP neighbor adjacencies.
  • Readvertise all routes to BGP peers.

Command Syntax

Syntax Description
<vrf-id> The VRF name.
<peer-group-id> The peer group name.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear vrf default router bgp peer-group SPINES address-family ipv6-unicast out
Action succeeded

nv action clear vrf <vrf-id> router bgp peer-group <peer-group-id> address-family ipv6-unicast soft in

Clears IPv6 inbound routes for a specific BGP peer group in the specified VRF.

This command does not clear counters in the kernel or hardware and does not reset BGP neighbor adjacencies.

  • When the switch has a neighbor configured with soft-reconfiguration inbound enabled, this command clears the routes in the soft reconfiguration table for the address family. This results in reevaluating routes in the BGP table against any applied input policies.
  • When the switch has a neighbor configured without the soft-reconfiguration inbound option enabled, this command sends the peer a route refresh message.
  • If you do not specify the direction in, the command affects both inbound and outbound routes depending on whether soft-reconfiguration inbound is enabled.

Command Syntax

Syntax Description
<vrf-id> The VRF name.
<peer-group-id> The peer group name.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear vrf default router bgp peer-group SPINES address-family ipv6-unicast soft in
Action succeeded

nv action clear vrf <vrf-id> router bgp peer-group <peer-group-id> address-family ipv6-unicast soft out

Clears IPv6 outbound routes for a specific BGP peer group in the specified VRF.

This command does not:

  • Clear counters in the kernel or hardware.
  • Reset BGP neighbor adjacencies.
  • Readvertise all routes to BGP peers.

If you do not specify the direction out, the command affects both inbound and outbound routes depending on whether soft-reconfiguration inbound is enabled.

Command Syntax

Syntax Description
<vrf-id> The VRF name.
<peer-group-id> The peer group name.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear vrf default router bgp peer-group SPINES address-family ipv6-unicast soft out
Action succeeded

nv action clear vrf <vrf-id> router bgp peer-group <peer-group-id> address-family l2vpn-evpn in

Clears EVPN inbound routes for a specific BGP peer group in the specified VRF.

This command does not clear counters in the kernel or hardware and does not reset BGP neighbor adjacencies.

  • When the switch has a neighbor configured with soft-reconfiguration inbound enabled, this command clears the routes in the soft reconfiguration table for the address family. This results in reevaluating routes in the BGP table against any applied input policies.
  • When the switch has a neighbor configured without the soft-reconfiguration inbound option enabled, this command sends the peer a route refresh message.

Command Syntax

Syntax Description
<vrf-id> The VRF name.
<peer-group-id> The peer group name.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear vrf default router bgp peer-group SPINES address-family l2vpn-evpn in
Action succeeded

nv action clear vrf <vrf-id> router bgp peer-group <peer-group-id> address-family l2vpn-evpn out

Clears EVPN outbound routes for a specific BGP peer group in the specified VRF.

This command does not:

  • Clear counters in the kernel or hardware.
  • Reset BGP neighbor adjacencies.
  • Readvertise all routes to BGP peers.

Command Syntax

Syntax Description
<vrf-id> The VRF name.
<peer-group-id> The peer group name.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear vrf default router bgp peer-group SPINES address-family l2vpn-evpn out
Action succeeded

nv action clear vrf <vrf-id> router bgp peer-group <peer-group-id> address-family l2vpn-evpn soft in

Clears EVPN inbound routes for a specific BGP peer group in the specified VRF.

This command does not clear counters in the kernel or hardware and does not reset BGP neighbor adjacencies.

  • When the switch has a neighbor configured with soft-reconfiguration inbound enabled, this command clears the routes in the soft reconfiguration table for the address family. This results in reevaluating routes in the BGP table against any applied input policies.
  • When the switch has a neighbor configured without the soft-reconfiguration inbound option enabled, this command sends the peer a route refresh message.
  • If you do not specify the direction in, the command affects both inbound and outbound routes depending on whether soft-reconfiguration inbound is enabled.

Command Syntax

Syntax Description
<vrf-id> The VRF name.
<peer-group-id> The peer group name.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear vrf default router bgp peer-group SPINES address-family l2vpn-evpn soft in
Action succeeded

nv action clear vrf <vrf-id> router bgp peer-group <peer-group-id> address-family l2vpn-evpn soft out

Clears EVPN outbound routes for a specific BGP peer group in the specified VRF.

This command:

  • Does not clear counters in the kernel or hardware
  • Does not reset BGP neighbor adjacencies.
  • Does not readvertise all routes to BGP peers.

If you do not specify the direction out, the command affects both inbound and outbound routes depending on whether soft-reconfiguration inbound is enabled.

Command Syntax

Syntax Description
<vrf-id> The VRF name.
<peer-group-id> The peer group name.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear vrf default router bgp peer-group SPINES address-family l2vpn-evpn soft out
Action succeeded

nv action clear vrf <vrf-id> router ospf interface

Clears all counters for the OSPF interfaces.

Command Syntax

Syntax Description
<vrf-id> The VRF name.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear vrf default router ospf interface

nv action clear vrf <vrf-id> router ospf interface <interface-id>

Clears OSPF neighbor adjacency on the specified interface.

Command Syntax

Syntax Description
<vrf-id> The VRF name.
<interface-id> The interface on which you want to clear OSPF neighbor adjacency.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action clear vrf default router ospf interface swp2
Action succeeded

nv action clear vrf <vrf-id> router pim interfaces

Clears PIM neighbors for all PIM interfaces in the specified VRF.

Command Syntax

Syntax Description
<vrf-id> The VRF name.

Version History

Introduced in Cumulus Linux 5.6.0

Example

cumulus@switch:~$ nv action clear vrf default router pim interfaces
Action succeeded

nv action clear vrf <vrf-id> router pim interface-traffic

Clears traffic statistics for all PIM interfaces in the specified VRF.

Command Syntax

Syntax Description
<vrf-id> The VRF name.

Version History

Introduced in Cumulus Linux 5.6.0

Example

cumulus@switch:~$ nv action clear vrf default router pim interface-traffic
Action succeeded

nv action disconnect system aaa user <user>

Disconnects authenticated and authorized users.

Command Syntax

Syntax Description
<user> The user you want to disconnect.

Version History

Introduced in Cumulus Linux 5.4.0

Example

cumulus@switch:~$ nv action disconnect system aaa user admin2

nv action reboot system

Reboots the switch.

Version History

Introduced in Cumulus Linux 5.5.0

Example

cumulus@switch:~$ nv action reboot system
Rebooting System in cold mode
True
Action succeeded

nv show action

Shows actions, such as cleared interface counters and routes, removed protodown MLAG bond conflicts, and disconnected system users.

Version History

Introduced in Cumulus Linux 5.4.0

Example

cumulus@switch:~$ nv show action
id  state         
--  --------------
1   action_success
2   action_error  
3   action_success
4   action_success 
5   action_success
6   action_success

nv show action <action-job-id>

Shows information about the specified action.

Command Syntax

Syntax Description
<action-job-id> The action ID.

Version History

Introduced in Cumulus Linux 5.4.0

Example

cumulus@switch:~$ nv show action 3
detail: acl counters cleared.
http_status: 200
issue: []
state: action_success
status: acl counters cleared.
timeout: 60
type: ''