With the introduction of F-5720 Offline Configuration, a user can now open a configuration file with ClientView and make modifications to the configuration. Feature F-5720 Offline configuration allows a user to create, examine, and modify the .csa files through the ClientView application by running the DataManager application in a offline mode that can generate configuration files without connecting to the IMG. This is especially beneficial if the configuration files need to be updated with new IP addresses. Once the new file is created, it can be loaded onto the IMG. Follow the documentation below for information on starting and running the Offline Configuration feature.
Background Information
When GCEMS application is installed, the scripts and processes are located in the following directories:
File | Location | Description |
installGCEMSoffline | /opt/dialogic/IMG/GateControlEMS/bin | Script that is run to create the offline.cfg license files and StartGCEMSoffline desktop shortcut. |
offline.cfg | /opt/dialogic/IMG/GateControlEMS/bin | The offline.cfg file is generated after running the installGCEMSoffline script. The offline.cfg contains the license files needed to run the Offline Configuration feature. |
StartGCEMSoffline | /opt/dialogic/IMG/GateControlEMS/bin | The StartGCEMSoffline file is used to start the Offline Configuration feature. A shortcut to this file is loaded on the Desktop. Double click on the shortcut and the Offline Configuration feature is started. Below is the icon loaded on the desktop. |
Installation Procedure
Install latest host files
The latest host files with the Offline Configuration feature must be loaded on the GCEMS server
Install the host files IMG_10.5.3.xxx.bin and IMGUserInterface_10.5.3.xxx.bin, that have the Offline Configuration feature functionality, onto the GCEMS server. Refer to the IMG 1010 - Installing GCEMS Software , IMG 1010 - Installing GCEMS Software - CentOS 7, or IMG 1010 - Installing GCEMS Software - Red Hat 6 topics for procedures on how to achieve this.
After installing, log out and log back in to the server -or- reboot the server. This will ensure all environment variables are loaded.
Install the Offline Configuration feature
The software with the Offline Configuration feature has been installed. The next step is to run the installGCEMSoffline file which will create a desktop icon and the offline license. The steps to creating the offline license vary depending on variables such as the type of license being generated. Therefore the procedure below is just one example to follow as a guideline when running the installGCEMSoffline file. Once the installGCEMSoffline file is running, it is up to the user to select the correct choices for their scenario.
Go to the /opt/dialogic/IMG/GateControlEMS/bin directory. Run the installGCEMSoffline script. Below is an example of running the script and creating a license file using the existing license files located in the /opt/dialogic/common/license directory
It doesn't matter whether the script is started as a root or excelsw user. The script will prompt for the root password if script was started as an excelsw user. Enter the root password if prompt.
[excelsw@kthomas-linux bin]$ ./installGCEMSoffline Enter Root User Password Password: *************************************************************** *** Dialogic Corporation - IMG *** *** installGCEMSoffline Revision 1.0 *** ***************************************************************** Installing desktop icon . . . Installing StartGCEMS script . . . Installing StartProcesses script . . . The Dialogic IMG1010 & IMG1004 Offline License tool. This tool will convert an existing IMG license, or allow the user to create a new offline license. How many IMG's are being licensed? [1 - 32]: 1 IMG #1: Enter the IMG node ID [0 - 63]: 0 IMG #1: IMG ID 0. Create a new offline license or Convert an existing license. 1) new license, or 2) convert existing license? [1 or 2]: 2 00902558_20090302114714.cfg 10305961_20090414091805.cfg 10307150_20091030195936.cfg 10308302_20100712143704.cfg Enter the filename from the this list for the IMG serial # to convert: 10307150_20091030195936.cfg IMG #1: IMG ID 0. Enter the I/O Interface type Enter 1 for DS1, or enter 2 for DS3 [1 or 2]: DS1 IMG #1: IMG ID 0. Enter the Span type. Enter 1 for T1, or 2 for E1) [1 or 2]: E1 IMG #1: IMG ID 0. Enter the Codec profile [1 - 4]: 1) Low Bit Rate (LBR) Codecs (only) - Profile 5 2) LBR + iLBC - Profile 6 3) LBR + iLBC + Wireless - Profile 7 4) LBR + AMR + GSM - Profile 8: 3 The offline.cfg file has been installed! Press enter to exit
Once completed, a file /opt/dialogic/IMG/GateControlEMS/bin/offline.cfg is created. The file will look similar to the following below. In this example, the license file offline.cfg was created with the existing license file attributes.
[excelsw@kthomas-linux bin]$ more offline.cfg ################################################################# # File: offline.cfg # Generated by: installGCEMSoffline Revision: 1.0 # Created on Fri 15 Apr 2011 09:22:46 AM EDT ################################################################# # NODE 0 License 10307150_20091030195936.cfg converted. NODE: 0 HostFlags: 18 NodeType: 1010 SS7BaseKey: 1 SS7LinkKey: 64 SS7ISUPKey: 768 VoipPortKey: 1056 TdmPortKey: 768 InterfaceType: DS1 ISDNBKey: 768 casPortKey: 768 DSPResourceKey: 5120 M3UAKey: 0 SS7TCAPKey: 2500 StLinkKey: 64 M3UASGKey: 4 M3UAASKey: 4 SRTPLicenseKey: 1 AMRCodecKey: 672 EVRCCodecKey: 672 ENDNODE
Start Offline feature after installation
Start the GCEMS offline feature by double-clicking on the StartGCEMS_Offline icon on the desktop. This icon was created during the execution of the installGCEMSoffline file:
A screen displaying the processes being started will appear. Press <ENTER> key when prompt.
Start the IMG ClientView by double-clicking on the IMG ClientView icon located on the desktop. Enter the admin password and run ClientView just as ClientView would normally be run.
Either load an existing configuration or create a new configuration will appear. Select accordingly.
Verify GCEMS is running in Offline mode by viewing the bar located above the menu file bar. See Below:
In the previous step, an existing file was loaded. Modify the naming format of the configuration file to a filename that distinguishes it as being created using the offline configuration tool. Save this file. In this example the extension _offline was added. See below:
This file is now saved in /opt/dialogic/common/config as a .csa file. (Ex: default_offline.csa)
Make changes to the file as needed. Once complete, save the changes.
Shut down the Offline Configuration GCEMS and restart the normal GCEMS
Close ClientView and stop GCEMS by double-clicking on the StopGCEMS icon on the desktop. Follow prompts.
Restart GCEMS normally using the StartGCEMS icon. Select Yes when asked Would you like to begin a new configuration? GCEMS will now start each of the processes.
Re-start ClientView and enter the admin password. A ClientView- Question box will appears asking "Would you like to Load an existing configuration, use Wizard to create a new configuration or Cancel into ClientView" hit the Load button and select the file just modified and Select OK. See below:
The modified file will now load to the IMG. Verify through ClientView the changes made have been loaded.
Additional Information
Each time a new version of GCEMS and ClientView software are loaded, the installGCEMSoffline file will need to be re-run to create the offline.cfg again.
An offline file can include up to 32 nodes with options for each node being independent.
If the offline.cfg license file is not present and the user tries to run in offline mode, the following assumptions can be made:
IMG type is set to IMG 1010
I/O type is set to T1 with hostflag value set to 0.