Free Whitepapers

Konrad's Cheat Sheet of Useful Debugging Commands

     Command Application  What does it do?  What is it good for? 
     lspci   Linux  shows all devices on the PCI  bus
    		  use it to verify that your Sangoma card is recognized by the BIOS.  You should have an entry for each card, but ignore the type of device.  The fact that our cards use a common PCI interface means they show up as either an A200 or an A104 normally
     wanrouter hwprobe verbose
    		  Wanpipe
    		  shows all Sangoma cards recognized by the Wanpipe drivers as well as physical location, # of HWEC channels, and firmware version  this command loads a basic Wanpipe driver (no configuration needed) to communicate to the Sangoma hardware.  This will confirm that the drivers see the hardware (PCI communications), the wanpipe drivers and it's dependencies (aka Zaptel) are installed properly, the presence of an echo canceler, and the firmware running on the card
     wanrouter status
    		  Wanpipe
    		  shows the status of all loaded wanpipes

     use to confirm that all the Wanpipes started (if one failed it will be missing), and the status of the physical layer connecton.

    "Connected" - physical layer is healthy
    "Connecting" - physical layer alarm is active on the line  PROBLEM
    "Disconnected" - either there is no cable connected to the port or the cable has been connected and disconnected a couple of times and the card is confused (restart the drivers)
     wanpipemon -i w1g1 -c Ta
    		  Wanpipe shows the T1/E1 line alarms, line stats as well as the signal level for the Wanpipe interface called w1g1

     LIU Alarms:
    Loss of Signal - no electrical signal on line
    Short Circuit - the tip and ring pins are crossed on the cable
    Open Circuit - no cable detected

    Framer Alarms:
    LOS - no T1/E1 signal on the line
    OOF - clock and data are not decoding properly
    AIS - upstream repeater in alarm TELCO PROBLEM ALWAYS
    RAI - other side of T1/E1 in alarm
    RED - always on when in LOS or OOF Alarm

    wanpipemon -i w1g1 -c Tadlb

    wanpipemon -i w1g1 -c Tddlb

    		 Wanpipe Activate and Deactivate Digital Line Loopback

    This command will enable/disable line loop back.  It will loop the port locally all the way down to the LIU.  This command should only be used when there is no access to a hard loop back

    NOTE: PORT CLOCK NEEDS TO BE SET TO MASTER

     wanpipemon -i w1g1 -c astats -m X

    (X is the channel number) 

    		  Wanpipe
    		  shows the voltage on an analog line  FXO:
    0-1 - no line detected
    6-12 - offhook
    45-55 - normal line onhook
    wanpipemon -i w1g1 -c ehw Wanpipe shows which channels currently have HWEC  
     ztcfg -vvv
    		  Zaptel
    		  applies Zaptel.conf to the spans
    		  any error messages mean that the zaptel config and the hardware config are not matching
     zap show channels
    		  Asterisk
    		  shows all zap channels
    		  confirms that chan_zap loaded properly
     pri show span 1
    		  Asterisk  shows the status of the PRI
    		  confirms that span 1 is "up and active" 
     pri intense debug span 1
    		  Asterisk  shows ISDN signalling
    		  confirms proper D-channel communication

     

     Log File
    		 Purpose 
     /var/log/messages  contains log info of all Wanpipe activies
     /var/log/sangoma_mgd  log file for Sangoma Media Gateway
     /var/log/sangoma_bri  log file for Sangoma BRI stack
     /var/log/asterisk/messages  Asterisk log files