SMG SS7 Configuration

The SMG: Asterisk SS7 configuration consists of the following config files:

1. ss7box: MTP3/MTP2 Configuration File
   /etc/ss7box/ss7box.conf
2. ss7boost: ISUP Configuration File
   /etc/ss7box/ss7boost.conf
3. Sangoma MGD Daemon Configuration
   /etc/sangoma_mgd.conf
4. Asterisk Channel Woomera Configuration
   /etc/asterisk/woomera.conf
5. Asterisk Extensions
   /etc/asterisk/extensions.conf

 

---

ss7box: MTP3/MTP2 Configuration

This part of SS7 configuration is currently done by Sangoma SS7 Expert for you.

 

---

ss7boost: ISUP Configuration

This part of SS7 configuration is currently done by Sangoma SS7 Expert for you.

---

Sangoma MGD Daemon Configuration

File: /etc/sangoma_mgd.conf
Used by:  sangoma_mgd daemon

# config file
# lines that begin with # or newline are ignored.

[settings]

#When debugging set the debug flag to 10
#When in production set the debug flag to 1
debug_level        => 1  

#Sangoma MGD log file
logfile_path        => /var/log/sangoma_mgd.log

#Boost (ISUP) connectio info
#Local address/port used for boost -> mgd comm
#Remote addres/port used for mgd -> boost comm
boost_local_ip        => 127.0.0.65
boost_local_port    => 53000
boost_remote_ip        => 127.0.0.66
boost_remote_port    => 53000


#Woomera Server Configuration
#Server will listen on the following
#IP and PORT
media_ip        => 127.0.0.1
woomera_port        => 42420

#Used to play Sangoma Rocks on all
#outbound calls, regardless of Asterisk. 
#Test feature only.
#Options: 0 - Disable
#         1 - Enable
out_tx_test        => 0

#DTMF Timers in ms
#Note these values should be
#updated based on your network
#DTMF Standard values are ON=250 OFF=50

dtmf_on_duration  => 60
dtmf_off_duration => 10

#Number of chunks to wait between
#dtmfs.  Size of chunk is dependent
#on configuration. Default chunk size
#is 10ms.
#dtmf_inter_ch_duration => 0

#Enable disable Auto ISUP ACM transmission on incoming calls
#Some isup interop tests require no acm on hangup
#0-Disable
#1-Enable (Recommended)
autoacm => 1

#Strip non digits from incoming
#calls. Removes F from incoming cid
#when overlap signalling is used.
#0-Disable
#1-Enable
strip_cid_non_digits => 0

 

---

Asterisk Channel Woomera Configuration

File: /etc/asterisk/woomera.conf
Used by:  Asterisk Woomera Channel Driver: chan_woomera.so

;===========================================
; Global Configuration Section
;===========================================

[settings]

;Debug flags is used to enable/disable
;woomera channel debugging level.
;Production: set to 2
;Debugging: set to 3
;------------------------------
debug=2


;--- JITTER BUFFER CONFIGURATION --------------------------
;Enables the use of a jitterbuffer on the receiving side of a
;WOOMERA channel. Defaults to "no". An enabled jitterbuffer will
;be used only if the sending side can create and the receiving
;side can not accept jitter. The WOOMERA channel can accept jitter,
;thus a jitterbuffer on the receive WOOMERA side will be used only
; if it is forced and enabled.
;-------------------------------------
;jbenable = yes


;Forces the use of a jitterbuffer on the receive side of a WOOMERA
;channel. Defaults to "no".
;-------------------------------------
;jbforce = yes             


; Max length of the jitterbuffer in milliseconds.
;-------------------------------------
;jbmaxsize = 200      


; Jump in the frame timestamps over which the jitterbuffer is
; resynchronized. Useful to improve the quality of the voice, with
; big jumps in/broken timestamps, usualy sent from exotic devices
; and programs. Defaults to 1000.
;-------------------------------------
;jbresynchthreshold = 1000


;Jitterbuffer implementation, used on the receiving side of a WOOMERA
;channel. Two implementation are currenlty available - "fixed"
;(with size always equals to jb-max-size) and "adaptive" (with
;variable size, actually the new jb of IAX2). Defaults to fixed.
;-------------------------------------
;jbimpl = fixed           


; Enables jitterbuffer frame logging. Defaults to "no".
;-------------------------------------
;jblog = no  



;===========================================
;Default Profile Configuration Section
;===========================================

[default]

;Woomera Server IP Address
;This is the remote ip address of the
;Woomera Server (sangoma_mgd: SMG)
;By default both Asterisk and SMG
;will reside on same machine.
;------------------------------
host=localhost


;Woomera Server TCP/IP Port
;This is the remote port number of the
;Woomera Server (sangoma_mgd: SMG)
;------------------------------
port=42420


;IP address of remote SMG Audio Server
;(sangoma_mgd:SMG)
;By default both Asterisk and SMG
;will reside on same machine.
;------------------------------
audio_ip=127.0.0.1


;Incoming Context for Woomera Channels
;All incoming calls will be forwared to defined
;context in extensions.conf
;------------------------------
context=sangoma


;Debug flags is used to enable/disable woomera channel
;debugging level.
;Production: set to 2
;Debugging: set to 3
;------------------------------
debug=2


;Hard limit for woomera channels
;Woomera channel driver will only allow defined
;number of channels. Set this value based on
;number of T1/E1 channels supported.
;If unsure set this value to 0.
;Options: 1 to 600 - limited calls 
;         0 - unlimited Calls
;------------------------------
;max_calls=0


;Enable Incoming DTMF detection
;This option will enable Rx DTMF detection on each
;channel. The Tx DTMF is automatically enabled on SMG.
;If you dont need DTMF do not enable it.
;Options: 1 - Enable DTMF
;         0 - Disable DTMF
;------------------------------
dtmf_enable=1


;Enable Jitter buffer for this profile
;This option is tied to the above global
;jitter buffer options.
;NOTE: a jb patch must be applied to Asterisk.
;Options: 1 - Enable JitterBuffer
;         0 - Disable JitterBuffer
;------------------------------
jb_enable=0


;Enable Asterisk Progress Messaging
;Used for Asterisk Early Audio with
;Zap and SIP.
;Options: 1 - Enable ProgresMsg
;         0 - Disable ProgresMsg
;------------------------------
progress_enable=0


;Coding is necessary to identify
;ulaw/alaw rx/tx gain.
;Opionts: ulaw
;         alaw
;Adjust rx and tx gain
;Options: 0   - Disable
;         1.0-X.0 - Gain
;------------------------------
;coding=ulaw
;rxgain=0.0
;txgain=0.0


;These options are used to disable rx or tx paths.
;Should not be used.
;-------------------------------
;inbound=no
;outbound=no

 

---

Asterisk Extensions

File: /etc/asterisk/extensions.conf
Used by:  Asterisk Dial Plan

;Sangoma SS7 Outbound context
;Place call on ss7 woomera channel
;==================================

[outb]
exten => _X.,1,noop
exten => _X.,n,Dial(WOOMERA/g1/${EXTEN}|60|o)
exten => _X.,n,Hangup

;Sangoma SS7 Incoming Contexts
;Context name defined in /etc/asterisk/woomera.conf
;The number beside the context name indicates
;the ss7 trunk group.
;====================================

[sangoma1]
exten => _X.,1,noop
exten => _X.,n,Playback(demo-congrats)
exten => _X.,n,Hangup

[sangoma2]
exten => _X.,1,noop
exten => _X.,n,Playback(demo-congrats)
exten => _X.,n,Hangup

[sangoma3]
exten => _X.,1,noop
exten => _X.,n,Playback(demo-congrats)
exten => _X.,n,Hangup

;Early Media Example
;To play a file without answering the call
[sangoma4]
exten => _X.,1,noop
exten => _X.,n,Playback(demo-congrats|noanswer)
exten => _X.,n,Hangup

 

---

Asterisk Extensions (Misc)


Privacy

exten => _X.,1,noop
exten => _X.,n,SetCallerPres(allowed_not_screened)
exten => _X.,n,Dial(WOOMERA/g1/${EXTEN}|60|o)
exten => _X.,n,Hangup

This setting sets caller-ID presentation for the SIP device. You can use numbers (a la CallingPres) or a descriptive text (as in SetCallerPres).

Valid descriptive values are:
allowed_not_screened       
allowed_passed_screen     
allowed_failed_screen       
allowed                                
prohib_not_screened         
prohib_passed_screen     
prohib_failed_screen         
prohib                                  
unavailable                          
Default allowed_not_screened.