SMG-SS7 for Asterisk Upgrade

1. Backup original configuration
2. Download new version of SMG-SS7
3. Download the ss7boxd binary
4. Create Configuration Files
5. Stop existing SMG-SS7 suite
6. Installing SMG-SS7 Stage 1
7. Installing SMG-SS7 Stage 2 - Standard Setup
8. Installing SMG-SS7 Stage 2 - Distributed Setup

-

Backup Original Configuration

Before starting the upgrade process you MUST backup your original configuration.  The SMG-SS7 package includes an easy method to backup all your configuration files

1. Change directory to the currently running version of SMG-SS7... this is likely the SMG-SS7 package with the latest date code.
   

   # cd /usr/src/smgss7-itu-2.5.XXX
   

2. Use the "archive" option of SMG-SS7 install to copy all configuration and binary files from SMG-SS7 to the current directory.
   

   # smginstall archive

-

Download New Version of SMG-SS7

SMG-SS7 has a type version as well as a package version.  The type version indicates the major and minor revision of ss7boxd and sangoma_isupd.  i.e. 2.1, 2.2, 2.3, etc  The main method of versioning in SMG-SS7 is the date code that the suite was packaged.  i.e. smgss7-itu-2.5.XXX.tgz

The SMG-SS7 packages also come in the 2 variants of SS7: ITU and ANSI.  Please make sure to download the correct variant for your install.

1. Download the latest date coded SMG-SS7 package from Sangoma's FTP server to /usr/src/ (Sangoma recommended location):
   

   ftp://ftp.sangoma.com/linux/smg/2.5/

2. Un-archive the tar-ball
   

   # tar xfz smgss7-itu-2.5.XXX<tab>

3. Change directory to the newly created directory
   

   # cd smginstall<tab>

 -

Downloading the SS7boxd Binary

The ss7boxd binary is the only file that is licensed and therefore it must be downloaded separately from the rest of the SMG-SS7 package

1. Open a new web browser and go to https://www.sangomapbx.com/ss7box/
2. Enter the "eth0" MAC address from the SMG-SS7 server
3. Enter the "Self Point Code" of your server in the correct version (ITU or ANSI)
4. Enter the "user key" provided to you when you bought your SMG-SS7 license.
5. Press the "Submit" key to continue
6. A page will appear showing the status of the ss7boxd build...the build can take several minutes
7. Once the build has been completed hight light and save all the text on the page to a safe location as the page shows you the user key, the MAC address this build is for, the SPC this build is for, the auth key (used in the next step), and lastly a link to download the actual file
8. Use "wget" and the link from the web build to save the "ss7boxd-<user key>" file to /usr/src/smginstall<verison> directory
9. Copy the "ss7boxd-<user key>" file to "ss7boxd"

 -

Create Configuration Files

First confirm that there has not been a major change to the configuration files for SMG-SS7.

1. Check which version of the configuration file parser your new SMG-SS7 package has.  The version number is part of the file name.
   

   # ls /usr/src/smginstall<version> smgcfg*
   [root@konrad-131 smginstall-2009-10-29-ITU]# ls smgcfg*
   smgcfg04.py
   
   -> the version is 0.4 in this example
   
   

2. Check the version number on your Google Docs configuration page.  The version is at the top

-

Stop Existing SMG-SS7 Suite

Before installing the new version of SMG-SS7 you need to stop the old version.

1. Stop the SMG-SS7 suite using the SMG-SS7 unified stop/start script
   

   # /etc/init.d/smgss7_init_ctrl stop

-

Installing SMG-SS7 Stage 1

Stage 1 installs the Sangoma driver, creates various folders, and copies the configuration files from the install directory to their finally location

1. Start the installation
   

   # ./smginstall install

2. The installer will try to stop Asterisk, existing SMG-SS7, and any existing Wanpipes and ask the user to confirm success
3. The installer will then install the Sangoma driver, since you have already run the pre-test the driver should install with out problem and the process should be familiar.
4. Choose install option #4 if you are only installing SMG-SS7, option #5 if you want Wanpipe to also compile with Dahdi support (Dahdi must be installed)
5. Do not install the start up scripts, this should be done manually once proper operation as been confirmed
6. Install the sample extensions.conf contexts if you are new to SMG-SS7
7. Once the install is finished you will be returned to the Linux command prompt

 -

Installing SMG-SS7 Stage 2 - Standard Setup

Stage 2 checks your system logger and setups the SMG-SS7 log files, compiles and installs SMG and Chan_woomera.

1. In Stage 1 the installer created /smg and copied the SMG and Chan_woomera sources file there.  Change directory to /smg
2. Start the installer passing in the arguments for SS7 and the location of the Asterisk source files
   

   # ./install -ss7 -pbxdir <asterisk source location>

3. Once successfully installed you can move on to finalizing the configuration

 -

Installing SMG-SS7 Stage 2 - Distributed Setup

Stage 2 checks your system logger and setups the SMG-SS7 log files, compiles and installs SMG and Chan_Woomera

1. In Stage 1 the installer created /smg and copied the SMG and Chan_woomera sources file there.  Change directory to /smg
2. Start the installer passing in the arguments for SS7 and the location of the Asterisk source files
   

   # ./install -ss7
   

3. Next you need to upgrade Chan_Woomera on the server running Asterisk.  Start by going to the directory that contains the Chan_woomera sources (most likely /usr/src/chan_woomera.trunk)
4. Update via SVN the Chan_Woomera Source files.  The user name and password is "svnanon"
5. Clean out the old compiled files and compile again
6. Finally install the compiled woomera sources

-