SMG-SS7 Cheatsheet

Konrad Hammel

Important Configuration Files Description

/etc/wanpipe/wanpipeX.conf Physical Layer Port Configuration
/etc/wanpipe/wanrouter.rc Wanrouter options
/etc/ss7box/ss7box.conf SS7boxd Configuration file
/etc/ss7box/ss7boost.conf SS7boost Configuration file
/etc/sangoma_mgd.conf sangoma_mgd configuration file
/etc/dahdi/system.conf Dahdi Configuration File
/etc/asterisk/chan_dahdi.conf Chan_Dahdi Configuration file
/etc/asterisk/extensions.conf Asterisk Dialplan
/etc/asterisk/woomera.conf Chan_woomera Configuration File
/etc/asterisk/sip.conf Chan_SIP configuration File
/etc/asterisk/iax.conf Chan_Iax configuration File
/etc/asterisk/logger.conf Asterisk Logger Configuration File

Important Log Files Description

/var/log/messages System log file…SS7boxd and SS7boost log here
/var/log/sangoma_mgd.log Sangoma_mgd log file
/usr/local/ss7box/msu.log SS7boxd logs MSUs here
/var/log/asterisk/messages Simple Asterisk log file
/var/log/asterisk/full Advanced Asterisk log file

Starting the SMG-SS7 Suite Description

/usr/local/ss7box/ss7boxd Starts SS7boxd….also starts Wanpipes with Signaling Links
wanrouter start Starts the voice only Wanpipes
smg_ctrl start Starts SMG and ss7boost
asterisk Starts Asterisk
asterisk -r Connects to local Asterisk instance

Stopping the SMG-SS7 Suite Description

smg_ctrl stop Stops SMG and SS7boost
killall ss7boxd Stops SS7boxd
wanrouter stop all Stops all Wanpipes

Monitoring Commands Description

tail -f /var/log/messages display the last 10 lines of a file and append when newlines are added
tail -n 100 /var/log/messages display only the last 100 lines of /var/log/messages
watch -n 1 ifconfig display the output of ifconfig and update it every 1 second
grep -i "suerm" /var/log/messages search for and display any lines contain "suerm" in an case in /var/log/messages
vmstat 1 display system load information and update every 1 second

Asterisk Commands Description

exit Exit out of Asterisk CLI
stop now Stop the current instance of Asterisk
core set verbose 10 Set the Asterisk CLI verbosity to level 10 (default is 3)
core show channels Show all current active channels
sip show peers Show all configured SIP accounts
iax2 show peers Show all configured IAX accounts
SMG-SS7 Cheatsheet Continued
Konrad Hammel

General Debug Description

lspci Show the devices attached to the PCI/PCIe bus recognized by the BIOS
wanrouter hwprobe Show the Sangoma Hardware recognized by the current Wanpipe driver

MTP1 Debug Commands Description

wanrouter status Shows the status of the Wanpipes
ifconfig Shows the status of the network interfaces
wanpipemon -I w1g1 -c Ta Shows the status of the T1/E1 line Alarms

MTP2 Debug Commands Description

wanpipemon -I w1g1 -c tr Raw trace of all data on w1g1
wanpipemon -I w1g1 -c trd Hex trace of MSUs on w1g1
wanpipemon -I w1g1 -mtp2_all -c trd Hex trace of all SS7 signaling units on w1g1
wanpipemon -I w1g1 -rx -c trd Hex trace of incoming MSUs on w1g1
wanpipemon -I w1g1 -tx -c trd Hex trace of outgoing MSUs on w1g1
wanpipemon -I w1g1 -diff -mtp2_all -c trd Hex trace of all SS7 signaling units if last unit was different on w1g1
wanpipemon -I w1g1 -7bit-hdlc -c trd Hex trace of MSUs on w1g1 using a 7bit HDLC Engine
wanpipemon -i w1g1 -pcap -pcap_file mtp2.pcap -mtp2-msu -prot MTP2 -full -systime -c trd PCAP capture of all MSUs
wanpipemon -i w1g1 -pcap -pcap_file mtp2.pcap -prot MTP2 -full -systime -c trd PCAP capture of all FISU, LSSU and MSU

MTP3 Debug Commands Description

/usr/local/ss7box/ss7box_cli --showmsu on Turns on MSU capture inside of ss7boxd to msu.log
/usr/local/ss7box/ss7box_cli --showmsu off Turns off MSU capture inside of ss7boxd

ISUP Debug Commands Description

/usr/local/ss7box/vb.sh on 1 Turns on verbose logging to call signaling in ss7boost to /var/log/messages
/usr/local/ss7box/vb.sh off 1 Turns off verbose logging to call signaling in ss7boost to /var/log/messages
/usr/local/cr.sh all Reports the status of all CICs on all spans
/usr/local/cr.sh 0 Reports the status of all CICs on span 0
/usr/local/cr.sh 0 3 Reports the status of CIC 3 on span 0

Chan_Woomera Commands Description

woomera status Show general information about all Woomera Profiles
woomera default version Display version of Woomera Client and Woomera Server
woomera default call_status Display Call status information from Woomera Client since start
woomera default debug 5 Increase the Woomera debug to 5
woomera default smgdebug 3 Increase the SMG debug to 3

Wanrouter Commands Descrition

wanrouter start Start the wanpipes that are listed in /etc/wanpipe/wanrouter.rc
wanrouter start wanpipe1 Start only Wanpipe1
wanrouter stop Stop the wanpipes that are listed in /etc/wanpipe/wanrouter.rc
wanrouter stop wanpipe2 Stop only Wanpipe2
wanrouter restart Stop and Start the wanpipe listed in /etc/wanpipe/wanrouter.rc
wanrouter version Show the version of Wanpipe currently installed
wanrouter hwprobe Show the Sangoma hardware currently supported by the Wanpipe drivers
wanrouter status Show the status of the current running Wanpipes