NAPT
Data Center guide
Management
Fault finding
Deployment
Back to Learn

Nokia SR Linux — Fault finding

Telemetry-driven troubleshooting and health assertions for Nokia SR Linux data center fabrics (VXLAN/EVPN). Part of the multi-vendor Data Center automation guide.

Repository
Nokia
SR Linux
gNMI / JSON-RPC
VXLAN / EVPN
Pull structured state, then assert health
Check Nokia EVPN peers, VTEPs and interfaces
Flag faults automatically — don't eyeball CLI

Setup, key commands & run examples

evpn_check.sh
EVPN health

Confirm the overlay is up on Nokia SR Linux: every EVPN/BGP peer should be Established.

evpn_check.sh
bash
show network-instance default protocols bgp neighbor
# any neighbor not "Established" / Up is a fault
faultfind.py
Assert peers

Collect BGP/EVPN neighbors from Nokia and print any peer that is down.

faultfind.py
python
# parse "show network-instance default protocols bgp neighbor" structured output
for nbr in get_bgp_neighbors():   # via gNMI
    if nbr["state"] != "established":
        print(f"[FAULT] Nokia EVPN peer {nbr['peer']} {nbr['state']}")
underlay_check.sh
Underlay first

Most overlay faults hide in the underlay — verify routes and interfaces on Nokia before blaming EVPN.

underlay_check.sh
bash
show interface brief
show network-instance default route-table ipv4-unicast summary

Best practices

  • Assert, don't eyeball

    Codify the checks — Nokia EVPN peers up, all VTEPs reachable, no climbing error counters.

  • Underlay before overlay

    Verify OSPF/eBGP and MTU first; VXLAN/EVPN faults usually trace back to the underlay.

  • Compare against a baseline

    Snapshot a healthy fabric state and diff against it so you spot what changed.

  • Both members of a pair

    Check MLAG/ESI consistency on both leaves of a redundant pair, not just one.

Hands-on exercises

Guided practice tasks — copy the starter snippet, run it against a lab device, and extend it to meet the goal.

Exercise 1
Nokia EVPN fault sweep

Goal: Loop over leaves, collect EVPN neighbors and print any peer that is not up.

exercise_1
python
for dev in leaves:
    # TODO: collect EVPN neighbors and report any down peer
Exercise 2
VTEP reachability

Goal: For each remote VTEP, confirm it is present in the overlay and reachable in the underlay.

exercise_2
python
expected_vteps = {"10.255.0.21", "10.255.0.22", "10.255.0.23"}
# TODO: compare against learned VTEPs and ping in the underlay VRF

Curated videos & guides

Checklist — pitfalls, gotchas & verification

Common pitfalls

  • •Blaming the overlay when the underlay (routing/MTU) is the real fault.
  • •Reading Nokia CLI by eye instead of asserting on structured state.
  • •Checking only one leaf of an MLAG/ESI pair.

Gotchas to watch

  • •An empty diff/return is not the same as healthy — assert peers are explicitly up.
  • •Nokia counters reset on reload — compare deltas, not absolutes.

Verify it works

  • •Re-read EVPN neighbors and confirm every peer is Established.
  • •Confirm all expected VTEPs appear and L2/L3 VNIs are programmed.