Licensing (Gateway Mode)
The IMG 2020 can have Gateway functionality, Session Border Controller Functionality, or both. Using the IMG 2020 specifically as a Gateway requires a license to open various functions including SS7 Signaling, ISDN Signaling, and VoIP. The licenses are distributed by email when the product is purchased. Each license will unlock a different function and the licenses are sold in multiple increments to address each customer needs. After receiving the license, transfer the license using SFTP to the SD card or FTP server (whichever the system software file is loaded from). Click on the Physical Node IMG 2020 object. In the object page, click on the Download New License button. The license will automatically download to the IMG 2020 node.
The license file needs to be loaded into the directory that the system software binary file is loaded. If using SD Card, load license file onto the SD Card if loading through FTP server, the license must be loaded in the directory that the system software file is loaded.
File Format
The license file supplied contains a unique number which is derived from the serial number of the I/O board located on a white sticker near the power supplies on the rear of the IMG 2020 and a 12 bit unique number embedded in the hardware. The format of the file includes an eight digit serial number (NNNNNNNN) followed by a timestamp (YYYYMMDDhhmmss). If the license is renamed or altered, it will become unusable. Refer to the example below.
License Naming Convention -NNNNNNNN_YYYYMMDDhhmmss.cfg
Downloading the license
When downloading a license file to the IMG 2020, the download utility looks for a file whose name includes the serial number of the IMG 2020. Therefore when downloading a new license file, the old license should either be removed or modified to not contain the serial number, so when the download utility looks for the serial number it won't find the old license. For example, if the old license file was 10311234_20180101130221.cfg then the old license should either be removed from the directory or renamed to something like xx311234_20180101130221.cfg
On the SD Card or FTP server, remove or rename any existing licenses (Refer to paragraph above). Using an SFTP application, transfer the updated license file to either the SD card or the FTP server. Refer to the SFTP Server topic for information on transferring. It is recommended to use the original file name for the current license, but it can be renamed as long as it includes the IMG serial number and has the extension .cfg (and doesn't include more than one ".", compound extensions like ".new.cfg" are not supported).
Create the License Info object by right clicking on the Physical Node object and selecting New Licensing Info. Within the License Info page, make note of the current licensing since this will be updated after the license download. Refer to the License Info topic for more information on this object.
Within the Web GUI, click on the Physical Node IMG 2020 object in the object tree.
Click on the Download New License button at the bottom of the License Info object pane. The license loaded will be sent to the IMG 2020.
After license is sent, refresh the Web GUI page. Click on the License Info object and verify the new license has been loaded.
The license is downloaded based on the serial number and a unique number embedded in the hardware. If a license other than the license intended for this node is sent, the license will not download. The license being sent has to be specifically created for this nodes serial number and unique number. If license is renamed or in any way altered, it will become unusable.
Viewing License Information
Use the License Info page to view page status
Evaluation License
Evaluation licenses expire after a specified number of days. The License Expiration field within the License Info pane indicates the date and time the evaluation license expires. Licenses that are not designated as evaluation licenses will display Does Not Expire. Seventy-two hours before an evaluation license is set to expire, an EventView alarm displays the number of hours remaining on the evaluation license.
License Validation Failure
The following icon below is displayed in front of the IMG 2020 object if the license does not validate with the node it was sent to.
 | A license validation has failed. Verify the serial number for license is serial number of IMG 2020. Refer to the License Info topic |
Licensed Components
Below is a list of licenses that can be created. Information on each is provided in the table below.
If licensing remote CIC's, each remote node must have an SS7_ISUP port license that equals the number of CIC's being configured on that remote node.
If configuring SS7 Redundancy, both the Active node and its Peer/Redundant node must have an SS7 Base license.
License | Description |
|---|---|
License Expiration Info(Optional) | Licenses generated for the IMG 2020 do not expire unless the license is specifically generated as an evaluation license. If the license is an evaluation license then the Date and Time the license expires is displayed in the License Expiration field of the License Info pane. If the license loaded is NOT an evaluation license then the License Expiration field will display Does Not Expire. Licenses do not expire unless the license is configured as an evaluation license. |
SYSTEM_SOFTWARE | System Software License is needed on all IMG 2020 nodes and is specific to the software build. |
SECURITY_ID | The security ID is a code embedded in the ROM of the IMG 2020 node. Each license generated must have the code embedded in the license file for the system to work. |
SS7_BASE | Must be included in license file if SS7 stacks are going to be configured and used. |
SS7_TCAP_TRANSACTION | Up to 2500 TCAP transactions/second in 100 transactions/second increments can be licensed. |
SS7_LINK | Links are licensed in 2 link pairs, up to 64 links. |
SS7_ISUP_PORT (CIC's) | Up to 2016 CIC's can be licensed. |
SS7_M3UA_APP_SERVER_STACK | Up to four M3UA Application Server stacks can be licensed per IMG 2020 node. Licenses are created in one stack increments. |
SS7_M3UA_SIG_GATEWAY_STACK | Up to four M3UA Signaling Gateway stacks can be licensed per IMG 2020 node. Licenses are created in one stack increments. |
SS7_M3UA_SIGTRAN_LINK | Up to 64 associations can be licensed. Licenses are created in 2 step increments. |
ISDN_PORT | Up to 2016 ports can be licensed for ISDN B channels. See table below. |
TDM_PORT | There are a total of 2016 TDM ports available to be licensed. When initially purchasing the product, the licenses are sold as 1 DS3, 2 DS3's, or 3 DS3's. Once the initial license bundles are created, the TDM ports can then be licensed in subsequent 32 DS-0 increments. The table below displays the increments that the licenses are created in. If required, an additional 128 TDM Port licenses can be purchased and added making the total number of TDM ports 2144. Adding the extra TDM ports allows SS7 signaling links to be added to the four DS-1 interfaces located on the rear of the system. |
VOIP_PORT | There are a total of 2016 VoIP Ports. The Maximum number of VoIP ports that can be licensed is 2016. The IMG 2020 has a maximum IP Port density of 2016 VoIP ports. This is true for all codecs except the AMR-NB and AMR-WB codecs. |
AMR_CODEC (GW)_32 (NB) | The maximum number of VoIP ports using AMR-NB with two installed DSP modules is 1536. The maximum number of VoIP ports using AMR-NB with three installed DSP modules is 2016. |
AMR_CODEC_WB (Wide Band) | The maximum number of VoIP ports using AMR-WB (G.722.2 RFC 3267) with two installed DSP modules is 768. The maximum number of VoIP ports using AMR-WB (G.722.2 RFC 3267) with three installed DSP modules is 1088. The maximum number of VoIP ports using AMR-WB (G.722.2 RFC 3267) with four installed DSP modules is 1376. |
VIDEO_TRANSCODING | The maximum number of Video Transcoding licenses is 864. It takes 2 video transcoding licenses to achieve an end to end video call with transcoding functionality. To make a video call without changing codecs (no transcoding), no licenses are required. Video calls do not need a license unless transcoding is to be applied. |
AUDIO_TRANSCODING | The maximum number of Audio Transcoding licenses is 2016. It takes 2 audio transcoding licenses to achieve an end to end audio call with transcoding functionality. To make a audio call without changing codecs (no transcoding), no licenses are required. Audio calls do not need a license unless transcoding is to be applied. |
DSP_RESOURCE_POINT | All IMG 2020's comes fully licensed with 6144 DSP Resource Points. |
SECURE_COMMUNICATIONS | The secure communication license adds the licensing needed to configure TLS. Once TLS is configured, SRTP can then be configured. |
SYSTEM_SOFTWARE | System Software License is needed on all IMG 2020 nodes and is specific to the software build. |
AUDIO_TRANSCODING | Maximum is Transcoding RTP |
License Increments
The table below displays the increments in which licenses are generated. The IMG 2020 can have Gateway functionality, Session Border Controller Functionality, or both. The functionality is determined through licensing. The table below displays the increments in which the IMG 2020 with Gateway Functionality (Any Protocol to Any Protocol) are generated. Refer to Sangoma Sales and Support to determine which functionality would meet your needs.
License Scheme - Gateway
When purchasing a new unit, the minimum number of DS0's that can be purchased is One DS3 Bundle + 96 (4-RJ48 interfaces) = 768
TDM DS0's | SS7 ISUP Ports | ISDN | VoIP Ports | EVRC | AMR-NB | AMR-WB |
|---|---|---|---|---|---|---|
(768 DS0's) Bundle 1 | 768 | 768 | 32 | 32 | 32 | 32 |
800 | 800 | 800 | 64 | 64 | 64 | 64 |
832 | 832 | 832 | 96 | 96 | 96 | 96 |
864 | 864 | 864 | 128 | 128 | 128 | 128 |
896 | 896 | 896 | 160 | 160 | 160 | 160* |
928 | 928 | 928 | 192 | 192 | 192 | 192* |
960 | 960 | 960 | 224 | 224 | 224 | 224* |
896 | 896 | 896 | 256 | 256 | 256 | 256* |
928 | 928 | 928 | 288 | 288 | 288 | 288* |
960 | 960 | 960 | 320 | 320 | 320* | 320* |
992 | 992 | 992 | 352 | 352 | 352* | 352* |
1024 | 1024 | 1024 | 384 | 384 | 384* | 384* |
1056 | 1056 | 1056 | 416 | 416 | 416* | 416* |
1088 | 1088 | 1088 | 448 | 448 | 448* | 448* |
1120 | 1120 | 1120 | 480 | 480 | 480* | 480** |
1152 | 1152 | 1152 | 512 | 512 | 512* | 512** |
1184 | 1184 | 1184 | 544 | 544 | 544* | 544** |
1216 | 1216 | 1216 | 576 | 576 | 576* | 576** |
1248 | 1248 | 1248 | 608 | 608 | 608* | 608** |
1280 | 1280 | 1280 | 640 | 640 | 640* | 640** |
1312 | 1312 | 1312 | 672 | 672 | 672* | 672** |
1344 | 1344 | 1344 | 704 | 704 | 704* | 704** |
1376 | 1376 | 1376 | 736 | 736 | 736* | 736** |
1408 | 1408 | 1408 | 768 | 768 | 768* | 768** |
1440 (DS0's) Bundle 2 | 1440 | 1440 | 800 | 800 | 800* | 800*** |
1472 | 1472 | 1472 | 832 | 832 | 832* | 832*** |
1504 | 1504 | 1504 | 864 | 864 | 864* | 864*** |
1536 | 1536 | 1536 | 896 | 896 | 896* | 896*** |
1568 | 1568 | 1568 | 928 | 928 | 928* | 928*** |
1600 | 1600 | 1600 | 960 | 960 | 960** | 960*** |
1632 | 1632 | 1632 | 992 | 992 | 992** | 992*** |
1664 | 1664 | 1664 | 1024 | 1024 | 1024** | 1024*** |
1696 | 1696 | 1696 | 1056 | 1056 | 1056** | 1056*** |
1728 | 1728 | 1728 | 1088 | 1088 | 1088** | 1088*** |
1760 | 1760 | 1760 | 1120 | 1120 | 1120** | 1120** |
1792 | 1792 | 1792 | 1152 | 1152 | 1152** | 1152** |
1824 | 1824 | 1824 | 1184 | 1184 | 1184** | 1184** |
1856 | 1856 | 1856 | 1216 | 1216 | 1216** | 1216** |
1888 | 1888 | 1888 | 1248 | 1248 | 1248** | 1248** |
1920 | 1920 | 1920 | 1280 | 1280 | 1280** | 1280** |
1952 | 1952 | 1952 | 1312 | 1312 | 1312** | 1312** |
1984 | 1984 | 1984 | 1344 | 1344 | 1344** | 1344** |
2016 (DS0's) Bundle 3 | 2016 | 2016 | 1376 | 1376 | 1376** | 1376** |
2048 |
|
| 1408 | 1408 | 1408** |
|
2080 |
|
| 1440 | 1440 | 1440** |
|
2112 |
|
| 1472 | 1472 | 1472** |
|
2144 |
|
| 1504 | 1504 | 1504** |
|
|
|
| 1536 | 1536 | 1536** |
|
|
|
| 1568 | 1568 | 1568*** |
|
|
|
| 1600 | 1600 | 1600*** |
|
|
|
| 1632 | 1632 | 1632*** |
|
|
|
| 1664 | 1664 | 1664*** |
|
|
|
| 1696 | 1696 | 1696*** |
|
|
|
| 1728 | 1728 | 1728*** |
|
|
|
| 1760 | 1760 | 1760*** |
|
|
|
| 1792 | 1792 | 1792*** |
|
|
|
| 1824 | 1824 | 1824*** |
|
|
|
| 1856 | 1856 | 1856*** |
|
|
|
| 1888 | 1888 | 1888*** |
|
|
|
| 1920 | 1920 | 1920*** |
|
|
|
| 1952 | 1952 | 1952*** |
|
|
|
| 1984 | 1984 | 1984*** |
|
|
|
| 2016 | 2016 | 2016*** |
|
In the table above, the number of asterisks equals the number of DSP modules required to meet the densities displayed.
Requires on board plus one DSP Modules.
** Requires two modules plus the on board DSP's
*** Requires three modules plus the on board DSP's
**** Requires four modules plus the on board DSP's