WJH
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 system wjh
Provides commands to configure WJH to provide real time visibility into network problems. You can diagnose network problems by looking at dropped packets.
nv set system wjh channel <channel-id>
Configures a WJH channel where you want to monitor packet drops.
Command Syntax
| Syntax | Description |
|---|---|
<channel-id> | The channel name. |
Version History
Introduced in Cumulus Linux 5.3.0
Example
cumulus@switch:~$ nv set system wjh channel forwarding
nv set system wjh channel <channel-id> aggregate-cache-size
Configures the cache size for the WJH channel. You can specify a value between 500 and 5000.
Command Syntax
| Syntax | Description |
|---|---|
<channel-id> | The channel name. |
Version History
Introduced in Cumulus Linux 5.18.0
Example
cumulus@switch:~$ nv set system wjh channel forwarding aggregate-cache-size 1000
nv set system wjh channel <channel-id> buffer-threshold congestion tc <tc-id> interface <interface-id> high
Configures the channel buffer congestion (the percentage of the buffer occupancy on the switch) for all traffic classes or a specific traffic class for an interface.
Command Syntax
| Syntax | Description |
|---|---|
<channel-id> | The channel name. |
<tc-id> | The traffic class. |
<interface-id> | The interface name. |
Version History
Introduced in Cumulus Linux 5.18.0
Example
cumulus@switch:~$ nv set system wjh channel forwarding buffer-threshold congestion tc 3 interface all high 4
nv set system wjh channel <channel-id> buffer-threshold latency tc <tc-id> interface <interface-id> high
Configures the channel buffer packet latency (the time spent in the switch) for all traffic classes or a specific traffic class for an interface.
Command Syntax
| Syntax | Description |
|---|---|
<channel-id> | The channel name. |
<tc-id> | The traffic class. |
<interface-id> | The interface name. |
Version History
Introduced in Cumulus Linux 5.18.0
Example
cumulus@switch:~$ nv set system wjh channel forwarding buffer-threshold latency tc all interface swp1-3 high 100
nv set system wjh channel <channel-id> drop-filter <filter-id> drop-type <drop-filter-drop-type-id> drop-reason <drop-filter-drop-reason-id>
Configures traffic drop filters to prevent drops from being monitored based on the reason for the drop.
Command Syntax
| Syntax | Description |
|---|---|
<channel-id> | The channel name. |
<filter-id> | The filter name. |
<drop-filter-drop-type-id> | The drop type. |
<drop-filter-drop-reason-id> | The drop reason. See table below. |
| Traffic Drop Type | Drop Reasons |
|---|---|
| ACL | egress-cpu-port-acl egress-tunnel-acl ingress-router-acl egress-port-acl ingress-cpu-port-acl ingress-tunnel-acl egress-router-acl ingress-port-acl multi-points-acl |
| Buffer | packet-latency-threshold-crossed tail-drop port-tc-congestion-threshold-crossed wred |
| l2 | dest-mac-is-reserved source-mac-is-multicast ingress-spanning-tree-filter source-mac-is-zero ingress-vlan-filtering unicast-egress-port-list-is-empty mlag-port-isolation unicast-mac-table-action-discard multicast-egress-port-list-is-empty vlan-or-vni-lookup-failed port-loopback-filter vlan-tagging-mismatch source-mac-equals-dest-mac |
| l3 | blackhole-arp blackhole-route checksum-or-ipver-or-ipv4-ihl-too-short dest-ip-is-loopback-addr egress-router-intf-is-disabled ingress-router-intf-is-disabled ipv4-dest-ip-is-link-local ipv4-dest-ip-is-local-network ipv4-routing-table-unicast-miss ipv4-src-ip-is-limited-broadcast ipv6-dest-in-multicast-scope-ffx0 ipv6-dest-in-multicast-scope-ffx1 ipv6-routing-table-unicast-miss multicast-mac-mismatch non-ip-packet non-routable-pck packet-size-is-larger-than-router-intf-mtu packet-source-ip-cant-be-verified router-interface-loopback src-ip-equals-dest-ip src-ip-is-in-class-e src-ip-is-loopback-addr src-ip-is-multicast src-ip-is-unspecified ttl-value-is-too-small unicast-dest-ip-but-multicast-dest-mac unresolved-neighbor |
| Tunnel | decapsulation-error encapsulation-port-isolation overlay-switch-src-mac-equals-dest-mac overlay-switch-src-mac-equals-zero overlay-switch-src-mac-is-multicast |
Version History
Introduced in Cumulus Linux 5.18.0
Example
cumulus@switch:~$ nv set system wjh channel forwarding drop-filter TUNNEL1 drop-type tunnel drop-reason overlay-switch-src-mac-equals-dest-mac
nv set system wjh channel <channel-id> drop-filter <filter-id> drop-type <drop-filter-drop-type-id> severity
Configures traffic drop filters to prevent drops from being monitored based on severity level.
Command Syntax
| Syntax | Description |
|---|---|
<channel-id> | The channel name. |
<filter-id> | The filter name. |
<drop-filter-drop-type-id> | The drop type. |
<drop-filter-severity-id | The severity: error, warning, or notice. |
Version History
Introduced in Cumulus Linux 5.18.0
Example
cumulus@switch:~$ nv set system wjh channel forwarding drop-filter SEVERITY drop-type l2 severity notice
nv set system wjh channel <channel-id> drop-filter <filter-id> ip
Configures traffic drop filters to prevent drops from being monitored based on IP address.
Command Syntax
| Syntax | Description |
|---|---|
<channel-id> | The channel name. |
<filter-id> | The filter name. |
Version History
Introduced in Cumulus Linux 5.18.0
Example
cumulus@switch:~$ nv set system wjh channel forwarding drop-filter IP-DROPS ip 10.10.10.10
nv set system wjh channel <channel-id> polling-interval
Configures aggregation interval for the WJH channel. You can specify a value between 5 and 300 seconds.
Command Syntax
| Syntax | Description |
|---|---|
<channel-id> | The channel name. |
Version History
Introduced in Cumulus Linux 5.18.0
Example
cumulus@switch:~$ nv set system wjh channel forwarding polling-interval 100
nv set system wjh channel <channel-id> trigger
Configures the type of packet drops you want to monitor. You can monitor layer 1 (l1), layer 2 (l2), layer 3 (l3), or tunnel (tunnel1) related packet drops.
Command Syntax
| Syntax | Description |
|---|---|
<channel-id> | The channel name. |
Version History
Introduced in Cumulus Linux 5.3.0
Example
cumulus@switch:~$ nv set system wjh channel forwarding trigger l3
nv set system wjh state
Enables and disables the WJH service. The default value is enabled.
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.3.0
Example
cumulus@switch:~$ nv set system wjh state enabled