Skip to content

Troubleshooting / FAQ

Symptom-driven troubleshooting. Find your symptom in the sidebar, follow the diagnostic flow, and act on the most likely cause first.

Every entry follows the same shape:

  1. What you'll see / hear — the symptom as the user describes it.
  2. Most likely causes — ranked by frequency, not by hope.
  3. Diagnose — the specific commands and screens that prove which cause it is. Don't guess. Capture.
  4. Fix — the cheapest action first.
  5. When to escalate — when the cheap fixes don't work.

When in doubt

  • Watch live SIP: sngrep -d any host <client-ip> — the source IP of the BYE tells you who hung up.
  • Watch Asterisk: asterisk -rvvvvv then have someone reproduce the issue.
  • Tail the log: tail -f /var/log/asterisk/full
  • Live channels: asterisk -rx "core show channels"

These four are the bedrock of every UnifiedBX investigation.