Sangoma SMG Installation

The Sangoma SMG (Asterisk SS7) Installation is included in the SMG price.
The Sangoma Team will help you through the SS7 installation and configuration until you are able to make calls on Asterisk.  Once you are making calls we leave the extensions.conf file up to you.

Note: SMG does not support 64bit Kernels.
Note: Latest SMG relelase now supports Asterisk 1.4 and 1.2
Any 32bit Linux Distribution is supported however we recommend
Centos 5.1  (or greater)/ Fedora 6 (or greater) - using normal kernel (no XEN or PAE kernels)


The Sangoma SMG installation is comprised of the following parts: 

1. SS7 Specification Questions & T1/E1 Port Map
2. Customer Wanpipe/Asterisk Pre-Installation
3. Customer Wanpipe Configuration - Pre-Test
4. Sangoma SS7 Configuration & Startup
5. Sangoma Support Assisted SS7 Installation

Please send the following diagram to Sangoma Support filled YOUR network information.  The port map will eliminate misunderstandings and simplify configuration.  Please note that first port on any Sangoma T1/E1 AFT card is closest to the PCI slot. 

Please consult your Telco when filling out this matrix.

From the above example we have 2 linksets, one F link one A link.  First F-linkset has 2 links and 4 media ports associated with it.   Second A-link linkset has 1 link and 2 media ports associated with it.   The last two ports are PRI lines.  

Legend:
ITU point codes are in decimal format eg: 9000
ANSI point codes are in Network-Cluster-Member format eg: 1-2-3
 
APC :  Adjacent Point Code 
DPC :  Destination Point Code (only used with A Links)
CIC Base: CIC is a map of each physical ds0 on a T1/E1 line including the signaling channels!
                 Please consult your Telco on CIC values for each channel on each T1/E1 line.

1. Download Sangoma SMG Installation Package
   --> FTP: ftp.sangoma.com/linux/smg
        Download the latest smginstall package!
    
2. Copy and Untar the smg package into /usr/src directory
   --> cp <smgpackagename> /usr/src
   --> cd /usr/src
   --> tar xvfz <smgpackagename>
    
3. Change directory into newly created smginstall directory
   --> cd smginstall-<version>
    
4. Before starting smginstall check the following:
   --> Make sure that asterisk is stopped
    
5. Start SMG installation
   
   -->./smginstall archive  (optional to backup existing ss7/smg configs in /etc)
   -->./smginstall install
   
   (Note: smginstall will abort if Asterisk/Callweaver is running!)
   (Note: smginstall will check for asterisk in /usr/src/asterisk)
   
   The SMG installation will execute standard wanpipe ./Setup script, that will lead you throught full wanpipe installation.
   
   Proceed with installation Select "Y" for each option.
   
   Under compilation mode: 
   
             Select SMG (Option 4)   (Default)
   
             Select SMG + TDMV (Option 5) if mixing zaptel and smg.
                        Setup will ask you for location of zaptel sources?
                        [By default Setup will look in /usr/src/zaptel]
   
                        Setup will ask you if you would like to add support
                        for Sangoma HW HDLC DCHAN PRI to Zaptel.
   
                        "Compile TDMV DCHAN Native HDLC Support (y/n)?"
                         Select "Y" to Enable HW HDLC on DCHAN PRI in Zaptel.
   
                         Note: This option will PATCH the ZAPTEL driver.
                         Therefore zaptel must be recompiled after
                         ./Setup is complete.
   
   Proceed to compile wanpipe drivers.
   
   Specify NO For Autostart on Bootup
   
   Choose default for the rest of the options.
    
6. After successful SMG Installation run SMG install script
   --> cd /smg
   --> ./install  -pbxdir <path to asterisk/callweaver source>
          eg: ./install -pbxdir /usr/src/asterisk
          eg: ./install -pbxdir /usr/src/callweaver
   

   The install script will setup syslog and logroate
   install SMG and Asterisk woomera module.
   

7. At this point you are ready for Pre-Test
    
   Where you will check that your E1/T1 lines are operational.

1. Configure wanpipe T1/E1 ports for Voice Only Mode
   --> run: /usr/sbin/wancfg_smg
   
   For each wanpipe port configure it for NO Signalling.
   At this time we will test only the voice channels.
   Once you are done with each port select option 1: to save cfg.
           
2. Start wanpipe1 device
   --> wanrouter start
        confirm that wanpipe started properly
        --> tail -f /var/log/messages   (displays drivers error messages)
    
3. Connect a LoopBack cable to wanpipe T1/E1 port.
   --> run: wanrouter status 
        (check that status is connected)
   --> run: tail -f /var/log/messages
        (check that T1/E1 is connected and no error messages appear).
   --> run: ifconfig
        (check that tx/rx counters are incrementing)
    
   If you see that all ports are up and running!
   We are now ready to configure ss7box and bring up the ss7 line.
    
4. Sangoma Support Assisted SS7 Installation (call sangoma support)

1. Configure wanpipe  T1/E1 ports for SS7 + Voice
   -> run: /usr/sbin/wancfg_smg
   
   For each wanpipe port configure it for SS7 or Voice Only depending on your T1/E1 line configuration that you received from the telco. Once you are done with each port select option 1: to save cfg.
    
2. Download Licensed ss7box from Sangoma
    
   Sangoma Sales will issue you a key to use on ss7box build site
   https://www.sangomapbx.com/ss7box/
   -> Input your eth0 MAC address
   -> Input your SS7 Self Point Code
   -> Input your Build/User Key (obtained from Sangoma  Sales)
    
   Once the ss7box is built using your parameters:
   -> Save the ss7box build information including the Authentication key
       This key must be inserted into /etc/ss7box/ss7box.conf file
       (Authentication key is not the same as the build key used to generate ss7boxd)
   -> Download ss7boxd from ss7box build site and copy it into /usr/local/ss7box/ss7boxd
     
3. Configure SS7BOX (MTP2/MTP3)
    
   (Note this step will be auto configured using wancfg_smg in the future)
   --> vi /etc/ss7box/ss7box.conf   (Follow the ss7box config page)
   
   Remember to insert the Authentication Key received from the ss7box build site into ss7box.conf
   Remember to insert the User Build Key as serial number into the ss7box.conf
    
4. Configure SS7Boost (ISUP)
    
   (Note this step will be auto configured using wancfg_smg in the future)
   --> vi /etc/ss7box/ss7boost.conf    (Follow the ss7boost conf page)
    
5. Startup ss7boxd
    
   At this point we are ready to start up ss7box (mtp2/mtp3) daemon and attempt to bring the ss7 link in service.
   --> cd /usr/local/ss7box
   --> ./ss7boxd <enter>            #Start ss7box
   --> wanrouter start                 #Start all voice only ports
   -->  tail -f /var/log/messages
         Confirm that ss7 link comes in service
         W:mtp3_slm.c:mtp3_lsac_ars:Link In Service:LS/LINK id follow::0:0
           W:mtp3_slm.c:mtp3_llsc:LLSC_STATE_ACTIVE/LLSC_CAUSE_EMERGENCY_CEASES: ...
           R:link util:ls 0:link 0:msu oc 5584:tot oc 160000:util 0 
    
   Once ss7 link comes in service we can proceed to startup ISUP
    
6. Startup ss7boost and sangoma_mgd
    
   --> smg_ctrl start
         (This command is equivalent to ztcfg in Asterisk/Zaptel configuration)   
         ss7boost and sangoma_mgd daemons will startup.
   --> tail -f /var/log/messages
        Confirm that ISUP performs reset on all CIC circuits
        : W:sb_mpc.c:sg_crs_wait_rlc:circuit reset complet:span/chan/csupid follow:0:0:0
         : W:sb_mpc.c:sg_crs_wait_rlc:circuit reset complet:span/chan/csupid follow:0:1:0
         : W:sb_mpc.c:sg_crs_wait_rlc:circuit reset complet:span/chan/csupid follow:0:2:0
    
   At this point ISUP/MTP3/MTP2 is up and running and sangoma_mgd is ready.
    
7. Startup Asterisk
    
   --> safe_asterisk <enter>
    
   --> asterisk -r
   --> CLI> woomera default version
         Check that woomera version and SMG version numbers exist
         eg:  Woomera version v1.18 : SMG Version v1.21     
         This indicates that Asterisk/woomera has connected to sangoma_mgd.
   
   The asterisk /etc/asterisk/extensions.conf have already been pre-configured to accept incoming calls and play demo-congrats.  At this point one should start testing incoming calls.
   Using an IAX/SIP Client one can use [outb] context to place outbound calls.
   Please refer to SMG configuration section.
          
8. Confirm all processes are running
   
   --> ps fax
   
   You should see the following processes:
   2654 ?        S<s    0:03 ./ss7boxd
   4729 ?        S<s    0:00 ./ss7boost
   4733 ?        Sl    72:30 /usr/sbin/sangoma_mgd -bg
   4741 ?        Ssl  576:37 safe_asterisk
   
     
9. Unified Startup/Shutdown
    
   These steps  should be done one by one when bringing up the system for the first time. However on bootup and on subsequent startups/shutdowns one can use the smgss7_init_ctrl script.
   --> /etc/init.d/smgss7_init_ctrl [ start | stop | restart ]
    
    

1. Once the above installation is complete contact Sangoma Support