WELCOME [ Log In · Register ]        SITE [ Search · Page Index · Recent Changes ]    RSS

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



SMG Network Diagram:
 

 Astersk <---(woomera) --> sangoma_mgd <---(sctp)---> ss7boost <---(sctp)---> ss7box
                                                   |                                                                                    |
                                             wanpipe/AFT                                               mtp2/wanpipe/AFT
                                            voice only T1/E1                                                A/F link ss7

 

SS7 T1/E1 Port Map & Questionare

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.

 

 eth0 Mac: 00:01:02:03:04:05
 Self Point Code: 200 (decimal)      
 Port  Type T1/E1 Cfg  Signaling  Sig Ch
  Audio Ch
  CIC Base
  APC  DPC
 1 E1  hdb3/crc4/normal SS7
 1
2-31
1
 100
n/a 
 2 E1
hdb3/crc4/normal SS7
 16
1-15.17-31
33
 100
 n/a
 3 E1
hdb3/crc4/normal n/a
 n/a
1-31
65  100
 n/a
 4 E1
hdb3/ncrc4/normal n/a
n/a
1 -31
 97 100
  n/a
5
 E1
 hdb3/ncrc4/normal SS7
 1
 2-31
 1 101
  102
6
 E1
 hdb3/ncrc4/normal n/a
 n/a
 1-31
 33
 101
  102
 7 E1
hdb3/ncrc4/normal PRI
cpe/national
 16
1-15.17-31
n/a
 n/a
 n/a
 8 E1
hdb3/ncrc4/normal
 PRI
cpe/national		 16
1-15.17-31
n/a
 n/a
 n/a

 

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.

 

Customer Wanpipe/Asterisk/Callweaver Pre-Installation
 
 

 Asterisk Installation
 CallWeaver Installation

  1. Download and Install latest asterisk release from www.asterisk.org

    Copy asterisk release into /usr/src/ directory
    --> cp <asterisk package name> /usr/src

    Untar asterisk release:
    --> tar xvfz <asterisk release name>

    Question: 
    Will you be mixing SS7 and PRI in Asterisk?
    If Yes, then proceed to download and install zaptel, libpri as well as asterisk
    Instructions are located here on how to install all three.
     
  2. Asterisk Pre-Installation Check

    If you already have an old asterisk installation make sure to remove old asterisk modules.
    --> cd /usr/lib/asterisk
    --> rm -rf modules
     
  3. Asterisk Installation

    Create a symbolic link asterisk to point to the newly untared directory
    (in this case I am using example asterisk-1.2.10)
    --> cd /usr/src
    --> ln -s asterisk-1.2.10 asterisk

    Change directory to newly untarred asterisk directory
    --> cd asterisk
    --> make clean
    --> make
    --> make install

    If this is very fist time you are installing asterisk also run
    --> make samples
  1. Download and Install latest callweaver release from www.callweaver.org

    Callweaver should be installed from
    SVN repository
    --> Installation Instructions

    Question: 
    Will you be mixing SS7 and PRI in Asterisk?
    If Yes, then proceed to download and install zaptel, libpri as well as callweaver
    Installation Instructions
     
 

 

  1. Download Sangoma SMG Installation Package
    --> FTP: ftp.sangoma.com/linux/smg/2.X
         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 -ss7  -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.

 

Customer Wanpipe Configuration - Pre-Test

The customer pre-test will test the new T1/E1 line, and confirm that the line is working properly. 

  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)

 

Sangoma SMG SS7 (MTP2/MTP3/ISUP) Configuration/Startup

At this point we confirmed that T1/E1 ports are up and active.
Now we are ready to configure SS7 Links along with Voice.

  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 ]
     
     




Sangoma Support Assisted SS7 Installation

  1. Once the above installation is complete contact Sangoma Support

 

More Info

For the ones that would like to have more information on detailed installation instructions of SMG (Asterisk SS7) product please visit the SMG User Manual located on ss7box website.