SONiC WJH
For copy image paths and more information, please view on a desktop device.
Features
Description
SONiC What Just HappenedPublisher
NVIDIALatest Tag
1.6.2-202305Modified
April 2, 2024Compressed Size
169.56 MBMultinode Support
NoMulti-Arch Support
No1.6.2-202305 (Latest) Security Scan Results
Linux / amd64
NVIDIA SONiC
SONiC is an open source network operating system based on Linux that runs on switches. SONiC What Just Happened is an application giving the user a way to debug network issues.
SONiC What Just Happened (WJH)
What Just Happened is provided to the user as a docker image and can be installed on Nvidia SONiC switch using SONiC Application Extension infrastructure.
License
By pulling and using the container, you accept the terms and conditions of this End User License Agreement
Release History
| SONiC Release | Qualified Hash | WJH Tag | SDK |
|---|---|---|---|
| 2023-05 | 208c1705 | 1.6.2-202305 | 4.6.2202 |
| 2022-11_1 | e7ce179b | 1.5.4-202211 | 4.6.1062 |
| 2022-11 | d93970bc | 1.5.3-202211 | 4.5.5142 |
| 2022-05_2 | 50817f5b | 1.3.4-202205 | 4.5.4206 |
How to use SONiC WJH
In order to install the WJH package, do the following:
Add what-just-happened into sonic-package-manager repositories list:
admin@sonic:~$ sudo sonic-package-manager repository add what-just-happened nvcr.io/nvidia/sonic/sonic-wjh
Make sure what-just-happened appears in sonic-package-manager list table:
admin@sonic:~$ sonic-package-manager list
Name Repository Description Version Status
------------------ ---------------------------------------- ---------------------------- --------- -------------
database docker-database SONiC database package 1.0.0 Built-In
dhcp-relay docker-dhcp-relay N/A 1.0.0 Installed
fpm-frr docker-fpm-frr SONiC fpm-frr package 1.0.0 Built-In
lldp docker-lldp SONiC lldp package 1.0.0 Built-In
macsec docker-macsec SONiC macsec package 1.0.0 Built-In
mgmt-framework docker-sonic-mgmt-framework SONiC mgmt-framework package 1.0.0 Built-In
nat docker-nat SONiC nat package 1.0.0 Built-In
pmon docker-platform-monitor SONiC pmon package 1.0.0 Built-In
radv docker-router-advertiser SONiC radv package 1.0.0 Built-In
restapi docker-sonic-restapi SONiC restapi package 1.0.0 Built-In
sflow docker-sflow SONiC sflow package 1.0.0 Built-In
snmp docker-snmp SONiC snmp package 1.0.0 Built-In
swss docker-orchagent SONiC swss package 1.0.0 Built-In
syncd docker-syncd-mlnx SONiC syncd package 1.0.0 Built-In
teamd docker-teamd SONiC teamd package 1.0.0 Built-In
telemetry docker-sonic-telemetry SONiC telemetry package 1.0.0 Built-In
what-just-happened nvcr.io/nvidia/sonic/sonic-wjh N/A N/A Not Installed
During 1st phase you can add a description and a default version to be installed.
admin@sonic:~$ sudo sonic-package-manager repository add what-just-happened nvcr.io/nvidia/sonic/sonic-wjh --description "WJH package" --default-reference 1.0.0
admin@sonic:~$ sonic-package-manager list
Name Repository Description Version Status
------------------ --------------------------- ---------------------------- --------- -------------
database docker-database SONiC database package 1.0.0 Built-In
dhcp-relay docker-dhcp-relay N/A 1.0.0 Installed
fpm-frr docker-fpm-frr SONiC fpm-frr package 1.0.0 Built-In
lldp docker-lldp SONiC lldp package 1.0.0 Built-In
macsec docker-macsec SONiC macsec package 1.0.0 Built-In
mgmt-framework docker-sonic-mgmt-framework SONiC mgmt-framework package 1.0.0 Built-In
nat docker-nat SONiC nat package 1.0.0 Built-In
pmon docker-platform-monitor SONiC pmon package 1.0.0 Built-In
radv docker-router-advertiser SONiC radv package 1.0.0 Built-In
restapi docker-sonic-restapi SONiC restapi package 1.0.0 Built-In
sflow docker-sflow SONiC sflow package 1.0.0 Built-In
snmp docker-snmp SONiC snmp package 1.0.0 Built-In
swss docker-orchagent SONiC swss package 1.0.0 Built-In
syncd docker-syncd-mlnx SONiC syncd package 1.0.0 Built-In
teamd docker-teamd SONiC teamd package 1.0.0 Built-In
telemetry docker-sonic-telemetry SONiC telemetry package 1.0.0 Built-In
what-just-happened <docker repository> WJH package N/A Not Installed
Install WJH with the wanted version:
admin@sonic:~$ sudo sonic-package-manager install what-just-happened==<version>
what-just-happened==1.1.0-202106 is going to be installed, continue? [y/N]: y
Extracting c2fc991234e9 100%| 37.87/37.87 Mb [00:24<00:00, 1.61 Mb/s]
Extracting f714ae43fcbe 100%| 80.79/80.79 Mb [00:24<00:00, 3.43 Mb/s]
Extracting d960726af2be 100%| 48.10/48.10 Mb [00:24<00:00, 2.04 Mb/s]
Extracting 77e6ca625721 100%| 5.39/5.39 Mb [00:21<00:00, 0.25 Mb/s]
Extracting e4e9fbe90e50 100%| 5.67/5.67 Mb [00:21<00:00, 0.27 Mb/s]
Extracting 94d30986e75d 100%| 49.48/49.48 Mb [00:21<00:00, 2.36 Mb/s]
Extracting e1ec38773a81 100%| 8.47/8.47 Mb [00:21<00:00, 0.41 Mb/s]
Extracting 6a9310cc6314 100%| 0.00/0.00 Mb [00:20<00:00, 0.00 Mb/s]
Extracting e6bbe5c78b8b 100%| 0.00/0.00 Mb [00:20<00:00, 0.00 Mb/s]
Extracting 372b13cd48bd 100%| 0.00/0.00 Mb [00:20<00:00, 0.00 Mb/s]
Extracting ce6c9e0c0800 100%| 0.00/0.00 Mb [00:20<00:00, 0.00 Mb/s]
Extracting 82cf8e812ea5 100%| 0.00/0.00 Mb [00:20<00:00, 0.00 Mb/s]
Extracting 32d86fe1dae2 100%| 0.00/0.00 Mb [00:20<00:00, 0.00 Mb/s]
Extracting 912faf9c80e9 100%| 0.00/0.00 Mb [00:20<00:00, 0.00 Mb/s]
Extracting 5f0e11c30315 100%| 0.00/0.00 Mb [00:20<00:00, 0.00 Mb/s]
Extracting 920084c53ba5 100%| 0.00/0.00 Mb [00:00<00:00, 0.10 Mb/s]
generated /usr/bin/what-just-happened.sh
generated /usr/local/bin/what-just-happened.sh
generated /usr/lib/systemd/system/what-just-happened.service
generated /usr/lib/systemd/system/what-just-happened@.service
generated /usr/lib/systemd/system/what-just-happened.timer
generated /usr/lib/systemd/system/what-just-happened@.timer
generated /usr/local/bin/debug-dump/what-just-happened
In order to enable WJH feature, execute:
admin@sonic:~$ sudo config feature state what-just-happened enabled
admin@sonic:~$ show feature status
Feature State AutoRestart SetOwner
------------------ -------------- -------------- ----------
bgp enabled enabled
database always_enabled always_enabled
dhcp_relay enabled enabled local
lldp enabled enabled
macsec disabled enabled
mgmt-framework enabled enabled
nat disabled enabled
pmon enabled enabled
radv enabled enabled
restapi enabled enabled
sflow disabled enabled
snmp enabled enabled
swss enabled enabled
syncd enabled enabled
teamd enabled enabled
telemetry enabled enabled
what-just-happened enabled enabled local
In order to see drops, use "show what-just-happened" command
admin@sonic:~$ show what-just-happened poll
# Timestamp sPort dPort VLAN sMAC dMAC EthType Src IP:Port Dst IP:Port IP Proto Drop Severity Drop reason - Recommended action
Group
-- ---------------------- ----------- ------ ----- ------------------ ------------------ -------- ------------ ------------ --------- ------ --------- ---------------------
1 20/11/24 08:25:15.847 Ethernet60 N/A 500 00:11:22:33:44:55 00:00:00:00:00:01 Dot1Q 127.0.0.1 127.0.0.1 ip L2 Error Ingress VLAN filtering - Validate the VLAN membership
configuration on both ends of the link
2 20/11/24 08:25:15.925 Ethernet60 N/A N/A 00:11:22:33:44:55 b8:59:9f:a9:2a:00 0x0 N/A N/A N/A L3 Notice Non IP packet - Destination MAC is the router,
packet is not routable
3 20/11/24 08:25:20.667 Ethernet8 N/A N/A N/A N/A N/A N/A N/A N/A L1 Warn Generic L1 event - Check layer 1 aggregated information
Integrating WJH to SONiC Build System
Create mk file:
PACKAGE = my-package
$(PACKAGE)_REPOSITORY = <myrepo/mypackage>
$(PACKAGE)_VERSION = <version>
SONIC_PACKAGES += $(PACKAGE)
Add it to rules folder in source code
NOTE: SDK version in WJH must match the SDK version in the SONiC image. To check execute the following command
admin@sonic docker exec -ti syncd sx_sdk --version