License Upgrade

The following information will guide you to update the license on your NSG Gateway if you are increasing your license capacity from the original purchased.

NSG Appliance License Upgrade

Viewing Your Current License Capacity

To view the current license capacity of your NSG appliance log into the NSG WebGUI and navigate to Configuration > License
example:

Open

Your current license capacity is indicted by the CIC value. CICS represent the maximum number of channels allowed to use with your license

Open

Updating Your License

The Sangoma sales department will have provided you with the software license upgrade key.
The software license key is required in order to create your license package.
The license package will be installed on your server to enable the specified number of T1/E1 SS7 ports for your installation.

1. Take note of your license key (example: xy2z6h37f) and navigate to the following website to create your license package
   -> http://prod-license.sangoma.com/nsg-license-gen/

2. At this website you will be required to enter:

   1. MAC address of one of the Ethernet interfaces on your NSG server
      To find the MAC address simply choose one from the list visible on the license page of the NSG webGUI.
      Example: In the below picture, we selected the MAC address of Eth0: 00:90:0B:38:B2:2D

If your NSG appliance is the smaller 4-port appliance (visible with only one TDM slot in the front), then you will only have one serial number since there is only one hard drive in this device.

The Hard drive serial numbers can be identified from the license area in the NSG webGUI (as seen in the above image).
example:

The alphanumeric digits beside "Hard Drive 1 Serial Number" and "Hard Drive 2 serial Number" and the serial numbers to be used. Enter them in with a comma separating the numbers (no spaces in between)
Example: CVWL408400JH240NGN,CVWL408100Z8240NGN 

3, After entering the above three pieces of information click the submit button to generate the license upgrade package

4. A license package will be presented which you can click to download to your local computer

5. Once downloaded, navigate back to the license area of the NSG webGUI (Configuration > License) and select the 'Choose File' button.

   1. Find the license package previously downloaded and select it.

6. Click the upload button to upload the new license package to update the license on the NSG appliance.

Do not modify the downloaded license package otherwise it will be rendered invalid upon upload to the NSG appliance

7. Once the license section updates with the increased license capacity, the license upgrade process is complete. (No saving or restarting is required)

NSG Software License Upgrade

This section only applies to NSG installations on third party hardware, not Sangoma NSG appliances

All the below steps require Linux command line access

Viewing Your Current License Capacity

To view the current license capacity of your NSG Gateway open a terminal session to the NSG server you will need to access the Linux command line and open this file:
-> /usr/local/nsg/conf/license.txt 

To do this, you can use the editor of your choice (we will use vi) and type the following in the Linux command line:
-> vi /usr/local/nsg/conf/license.txt

The current license capacity is the number beside "CIC":
Example:

Take Note of the MAC address and SPC value in this file which will be required for the next step.

Exit the edit view. If using 'vi 'editor, do this by typing:
Esc :q <enter> 

Updating Your License

The Sangoma sales department will have provided the software license key.
The software license key is required in order to create your license package.
The license package will be installed on your server to enable the specified number of T1/E1 SS7 ports for your installation.

1. Take note of your license key (example: xy2z6h37f) and navigate to the following website to create your license package
   -> http://prod-license.sangoma.com/nsg-license-gen/

2. At this website you will be required to enter:

   1. MAC address of one of the Ethernet interfaces on your NSG server
      Copy the MAC address which is currently listed in the license.txt file in /usr/local/nsg/conf/ directory.

      Alternatively, you can find the MAC address by typing "ifconfig" on your Linux command line and records the HWaddr
      example:
      
      

   2. ITU Self Point Code or ANSI Self Point Code

      1. You will be required to fill in only one of these fields, the one that applies to your installation (ANSI point codes are used typically in North America. Rest of world uses ITU point codes)

      2. Copy the self point code which is currently listed in license.txt in /usr/local/nsg/conf directory. 

      3. Paste this point code

   3. User Key

      1. This is the SS7 license upgrade key provided to you by the sales department

3. Once the information is entered click the 'submit' button near the bottom of the page
   
   

4. A license package will be created. Click the download button or the copy the link.

5. The license package must be installed in the following directory in the NSG server:
   -> /usr/local/nsg/conf 

   1. To install the license package in this directory:

      1. type: cd /usr/local/nsg/conf

      2. type: wget <license package link>

         1. this will automatically download the license package to this location

   2. un-compress the license package:

      1. type: tar xfz <license package>.tgz

      2. this will create two files in /usr/local/nsg/conf:

         1. license.txt and license.txt.sig  (Do not modify any of these files or it will render license invalid). You may be asked to overwrite the currently license.txt. and license.txt.sig. Please say "yes" as we want to update these files.

   3. Your license is now installed.

6. A restart of the NSG Gateway will be required for the changes to take affect. You can restart NSG Gateway directly from the Linux command line by typing: 
   -> service nsg restart