Sangoma SMG Upgrade

This document assumes that SMG package has already been installed using SMG installation instructions.

The Sangoma SMG/SS7 upgrade uses the same smginstall package however, we will not have to change any configuration files since we have done so in previous full installation.


SMG Network Diagram:
 

1. Downlaod the SMG Release from Sangoma FTP
   -->Location: ftp.sangoma.com/linux/smg
   -->File: smginstall-<date>.tgz
   -->Refer to ChangeLog in above location for update info.
    
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. Stop SMG/Asterisk Service
   --> Make sure that asterisk is stopped
   --> Make sure wanpipe and SMG is stopped
   --> run: /etc/init.d/smgss7_init_ctrl stop
     
   
5. Backup SMG configs
   -> tar cvzf smg_config_backup.tgz  /etc/ss7box  /usr/local/ss7box  /etc/wanpipe/*.conf  /etc/wanpipe/*.rc
   Save the smg_config_backup.tgz in an arbitrary directory
    
6. Start SMG Upgrade/Install
   
   -->./smginstall archive  (This step will backup all your conf files)
   -->./smginstall install
   
   (Note: smginstall will abort if Asterisk 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 through 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 (This step will be done by wancfg_smg)
    
   Choose default for the rest of the options.
    
7. 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.
   
   At this point we are ready to bring up all our services.
    
8. 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
    
9. 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.
    
10. 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.
     
11. 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
     
12. 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 ]