IMG 1010 - Downgrading the System Software

Overview:

Summary of Topic:

• Downgrade GCEMS software

• Downgrade IMG switch software

Time Requirements:

• Time required to execute upgrade -  Approximately 1 hour

• Call processing downtime -  Approximately 10 minutes
   

Preliminary:

• Before starting the downgrade process, note the status of each of the entities listed below.

  • Spans

  • Channels

  • ISDN D-Channels

  • SS7 Links

  • Network Interfaces

  • ClientView users that are logged in. Notify them of the pending upgrade and have them log off if necessary.

• Acquire the desired IMG system software from the Sangoma Support BBS website located at http://excelbbs.sangoma.com/default.htm.

• Select ‘Download Information’. You will require a logon username and password to access the downloads site. (A support contract is needed to access this site.) Within this site will be two software binary files. Download the latest version of these files. If access to the downloads site is needed contact the Sangoma Technical Support Team through one of the sources listed on the following webpage: https://www.sangoma.com/support/contact/

• Obtain backup files created just prior to the previous upgrade.

Backup Software

• Backup the current installation by simply renaming the /opt/dialogic directory. If there is insufficient disk space available then only the common folder located in above directory needs to be archived.
  Example:  mv /opt/dialogic /opt/dialogic_rename  

IMPORTANT! Do not attempt to roll-back to an earlier build unless the appropriate configuration files have been backed-up/saved. Any configuration files that have been modified and saved by a newer version of software will get nack’ed when used with a previous version of software.

Restore the previous version

• During the previous upgrade procedure the /opt/dialogic folder was renamed to /opt/dialogic_YYYY-MM-DD_HH.MM. Follow example below and rename this folder to remove the timestamp that was added during the previous upgrade procedure. Example: mv /opt/dialogic_2008-08-26_11.15/ /opt/dialogic  
   

Installing IMG System Software (Create a common symbolic link)

• To be able to load system software onto the IMG, the FTP server (usually residing on the host computer) needs either a pathname to the .bin file being downloaded -or- a common link (img1010_id0101.bin) in the ftp server that points to the .bin file to be downloaded.

Creating a common/symbolic link will reduce upgrade time by eliminating the need to edit the /etc/dhcpd.conf file and restart the host FTP services. To create the symbolic link one of the two methods below can be used

Method 1: Use lnimg (link img) script

• A time saving script has been written that will also create the symbolic link described above.  Follow the procedure below to create the symbolic link using this tool.

Copy the file ‘lnimg’ which is located in /opt/dialogic/common/osconfig and paste it into the /home/excelsw/ftpBuilds directory.

• From the ftpBuilds run the lnimg script

  $./lnimg

• Follow the instructions and enter the appropriate ‘IMG 1010 Build Number’ from the ‘Available IMG 1010 Build Files'. Use the format described in the lnimg script. (1051=10.5.1, 1052=10.5.2, 1053=10.5.3).

• The following response will be generated: Link Created…

  img1010_ver1051123_id0101.bin -> img1010_id0101.bin

• Executing the ls –la command as shown above, verifies that the link was created.

Method 2: (Create link manually)

• In the GCEMS server, go to /home/excelsw/ftpBuilds. Within this folder is a file titled img1010_ver1051xxx_id0101.bin. (1051=10.5.1, 1052=10.5.2, 1053=10.5.3 and xxx=build number of the software). Execute the following commands within this folder.

  ln -sf img1010_ver1051123_id0101.bin img1010_id0101.bin

  The command above will create a link connecting software version 10.5.1 build 123 to the filename img1010_id0101.bin 

• To confirm the link has been created, enter the command

  $ ls -la

• The Response will be:

  lrwxrwxrwx  1 root   root   27 Jun 21 09:27 img1010_id0101.bin -> img1010_ver1051123_id0101.bin

  This verifies that the link created points to the correct .bin file.  

Re-Start IMG System Software

• Divert live traffic away from the IMG(s)

• Restart GCEMS. See IMG 1010 - Starting GateControl EMS

• Restart Clientview. See IMG 1010 - Starting ClientView - Overview

Select the load button to open and commit the configuration file (.csa)

• Verify that all nodes return to online state.

• Verify all spans etc that were in service prior to upgrade return to in-service state.

Post-Installation:

File Clean-Up

 Backup and remove all unused log, license and configuration files from the /opt/cantata and /opt/dialogic folders.

• Once the roll-back has been deemed successful remove any folders and/or files that were renamed and stored during the software Roll-Back process.
  Example:

  (root user)#rm –rf /opt/dialogic_rename