Time required to execute upgrade - Approximately 1 hour
Call processing downtime - Approximately 10 minutes
Prior to upgrading the IMG software perform the following:
In ClientView, observe the status of each of the entities listed
below. Entities that were not in service before the upgrade should
not be expected to be in service after the upgrade.
Spans
Channels
ISDN D-Channels
SS7 Links
Network Interfaces
If running a redundant GCEMS verify which server is active and which is standby. This information will be needed later.
Notify other ClientView users that are logged in of the pending upgrade and have them logoff.
Obtain the desired IMG system software from the Dialogic Technical Support BBS (Bulletin Board System) website. Go to http://www.dialogic.com/support and click on Downloads.
Once at the Downloads page, select the IMG in the product selection drop down menu. On the page that appears, click on Support Page link.
A logon username and password
are required to access the BBS
site. If you do not have a username and password and access to the
BBS site is required, contact the Dialogic Technical Support Team
through one of the sources below or refer to the welcome letter e-mailed
after purchase of product. (A support contract is required to access
the site)
Email -- americas.support@dialogic.com
Phone -- +1-973-993-1443
Once logged into the BBS site, download the IMG 1010/1004 ClientView and GCEMS files along with any release notes available.
Backup the existing system configuration before upgrading. Depending on the version software, the backup procedure varies. See below.
If upgrading from system software version 10.5.x, the configuration portion can be automatically backed up using the ClientView Support Object. Use this object to backup the /opt/dialogic/common/config folder. Once the config directory is backed up, manually create a backup of the license directory. From here the Installation of the system software files can be achieved. Move to the Installation section below after the backups are complete.
If upgrading from software 10.3.x the backing up of files will need to be achieved manually. The next few steps described how to back up files manually. Once all files are backed up manually, proceed to the Installation section below.
For a more in depth procedure on backing up the GCEMS server manually refer to the following tech note: http://www.dialogic.com/support/helpweb/img/iw2532.aspx |
Note: Upgrading software from 10.5.0 to 10.5.1+ will create a local backup by automatically renaming the entire /opt/cantata directory to /opt/cantata_<timestamp>, and create a new /opt/dialogic directory. However, it is still recommended to perform a backup of all the files explained above before attempting the upgrade.
Transfer via FTP the new software to the GCEMS server. Software files must be transferred in binary mode and the Username and Password for FTP are:
Username = excelsw |
Pasword = excelsw |
Note: For installations with Redundant Hosts/GCEMS servers, copy the files below to both primary and secondary servers.
Transfer the following files to the /home/excelsw/ftpBuilds directory.
Note: Copy the IMG binaries to either the /home/excelsw/ftpBuilds directory or the location indicated in the dhcpd.conf file. The dhcpd.conf file is located in the /etc directory. If you open this file there is a line in it which states <filename "ftpBuilds/IMG1010_id0101.bin">. This is the directory path to the IMG software.
If using an SD Card to load system software, appropriate files must be transferred to the card. Files can be transferred to the SD card in one of two ways:
All GCEMS applications must be stopped before upgrading. If running a redundant GCEMS application, determine which server has the active GCEMS application and which server has the standby. Open the IMG EMS object in the ClientView application (Configuration -> IMG EMS). The Connection State field displays the status of the two GCEMS applications. Once the active/standby status is determined, achieve step 1 on the standby GCEMS application first. Once the standby has been stopped, repeat step 1 on the active server.
Note: Up-revving the GCEMS Software and does not contain any specific service-affecting steps. Calls will continue to process on the IMG while the GCEMS software is being up-revved.
Shutdown the current GCEMS Applications.
|
Note: If there isn’t a StopGCEMS desktop ICON, the GCEMS application can be stopped by running StopGCEMS from the installs folder located in the opt/dialogic/installs/IMG_10.5.x.xx/GateControlEMS/bin directory. (./StopGCEMS)
$ su
Password: excel2
Change the mode to executable for the following files. This is accomplished by performing the following commands.
# chmod +x IMG_10.5.x.xxx.bin xxx = build number
# chmod +x IMGUserInterface_10.5.x.xxx.bin xxx = build number
Install GCEMS software.
# ./IMG_10.5.x.xxx.bin
Follow the prompts. Refer to the Starting GCEMS topic which describes the installation process. The IMG_10.5.x.xxx.bin will be installed in the /opt/dialogic/installs/IMG_10.5.x.xxx directory. Once completed, you will be prompted to log out and then log back in. Do not log out yet, you will be prompted to log out later in installation process.
Note: For redundant GCEMS installs answer you must answer yes when prompted "if this is a redundant system".
Retstart the NFS service. See below
# /sbin/service nfs restart
# ./IMGUserInterface_10.5.1.xxx.bin (xxx=build number) (Follow the prompts)
If using RADIUS then existing servers that are migrating to 10.5.3 and beyond must revise the dictionary file. Starting with version 10.5.3 the Radius dictionary file dictionary.dialogic has replaced dictionary.cantata.
Refer to the technical publications, Configuring Free RADIUS using GCEMS as Radius Server, for additional details.
After installing the IMGUserInterface (ClientView) at the end of the previous step you will be prompted to log out. Log out as root user by entering the "exit" command.
For redundant GCEMS servers repeat steps 2 – 5 to upgrade the secondary server.
Note: A new license file will be required if upgrading from version 10.3.x:x to 10.5.x. Starting with 10.5.3 licensing is required for secure communications and SIP Signaling over TLS. When Transport Layer Security is used ensure that the license file includes SECURE COMMUNICATIONS.
To load system software, the FTP server residing on the GCEMS host computer needs either a pathname to the specific file that is to be installed -or- a common link (img1010_id0101.bin) in the ftp server that points to the specific file. With redundant GCEMS servers if you are running dhcp/ftp on both servers the IMG binary will need to be copied to both servers and the link updated on both servers. The two methods below describe how to create a symbolic link.
Note: 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. Create the symbolic link using one of the two methods explained below:
In the GCEMS server, navigate to the /home/excelsw/ftpBuilds directory. In this folder will be a file labeled img1010_ver1053xxx_id0101.bin. (1053=10.5.3 software and xxx=build number of the software). Perform the following commands within this folder.
$ ln -sf img1010_ver1053123_id0101.bin img1010_id0101.bin
$ ln -sf img1004_ver1053123_id0106.bin img1004_id0106.bin
The command above will create a link connecting software 10.5.3 build 123
to the filename img1010_id0101.bin or img1004_id0106.bin.
To confirm the link has been created, enter the command
$ ls -lrt
The Response below will be displayed in the ftpBuilds list:
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.
$ cd /home/excelsw/ftpBuilds
$ ln -sf /opt/dialogic/common/osconfig/lnimg lnimg
$ chmod +x lnimg
$./lnimg
Follow the instructions and enter the build number only. For example upgrading to 1053123 (1053 = 10.5.3 build 231).
A response Link Created --> img1010_ver1053123_id0101.bin img1010_id0101.bin will be output.
Executing the ls –lrt command as described above will verify the link was created.
If changes were made to the dhcpd.conf file it will be necessary to restart the dhcpd service. The service can be restarted by root user only.
# /sbin/service dhcpd restart
If installing the IMG software from an SD card, insert the card into the SD slot on the IMG. See SD Card information.
If a new license has been received, copy it to the stand alone GCEMS server or to both the primary and secondary GCEMS servers in the /opt/dialogic/common/license directory.
Restart GCEMS
Restart ClientView. Refer to the Starting ClientView topic.
Load the desired configuration file. Click the load button to open and commit the configuration file (.csa).
Note: At this point all IMG's will be reset.
Verify that all nodes return to online state.
Verify all spans that were in service prior to upgrade return to in-service state.
Verify calls are being processed to all trunk groups.
For redundant GCEMS servers now start the GCEMS service on the secondary server.
Backup and remove all unused log, license and configuration files from the /opt/dialogic folders.