blog articles

JUNIPER TROUBLESHOOTING TRICKS

🧰 JUNIPER TROUBLESHOOTING TRICKS

In day to day network operations, some of the most disruptive incidents come from very small components. A link drops because an optic stops responding, an interface refuses to come back, or a transceiver behaves inconsistently. Traditionally, this often ends with a request for a field engineer to reseat the module.

However, on certain Juniper platforms, there is a lesser known capability that can help recover a port remotely. At the forwarding plane level, it is possible to simulate removing and reinserting an optic, which effectively mimics a physical reseat without touching the hardware.

A commonly used workflow on supported QFX platforms looks like this:

start shell pfe network fpc0
set cmqfx xcvr remove pic {PIC_NUMBER} port {PORT_NUMBER}
set cmqfx xcvr insert pic {PIC_NUMBER} port {PORT_NUMBER}

This approach can restore links quickly, therefore avoiding unnecessary travel and reducing recovery time.

⚠️ Important operational note: commands executed in the underlying shell are not treated the same as standard CLI operations. They should be used carefully, with proper access control and change discipline.

For deeper dataplane visibility, Junos also allows controlled execution of PFE level queries directly from the CLI, which is often extremely useful during incident analysis:

request pfe execute target fpc0 command “show nhdb”
request pfe execute target fpc0 command “show firewall”

request pfe execute target fpc0 command “show xmchip 0 q-node all-stats 0” | no-more 

request pfe execute target fpc0 command “show xmchip 0 q-node all-stats 1” | no-more 

request pfe execute target fpc0 command “show xmchip 0 phy-stream list 0” | no-more 

request pfe execute target fpc0 command “show xmchip 0 q-node list 0” | no-more 

request pfe execute target fpc0 command “show jnh 0 exceptions” | no-more | refresh 20 

 

Used correctly, these mechanisms allow engineers to recover interfaces faster, inspect forwarding behavior, and resolve issues that might otherwise require physical intervention. At the same time, they reinforce an important principle of modern NetOps: operational efficiency comes from understanding platform internals, not just configuration syntax.

If your environment relies on Juniper infrastructure and you want to optimize troubleshooting and recovery workflows, this is exactly the type of practical engineering we help teams implement.

#Juniper #Junos #NetworkOperations #Troubleshooting #NetOps #NOC #ITcare