Software version Installation

Overview

NetBorder SS7 Gateway (NSG) is a standalone TDM-to-SIP SS7 Gateway that runs on top of our Sangoma TDM cards.

It is designed to operate on a 64-bit Linux based Operating system.
The following Linux operating systems have been tested with the NSG application:

• CentOS (Recommended, Tested, and Certified with NSG, and supported by Sangoma)

• Debian (Has been tested, but is not currently supported by Sangoma)

• Ubuntu (Has been tested, but is not currently supported by Sangoma)

It requires the following two software packages to be installed, over the base Linux operating system:

1. Sangoma TDM Card driver (called 'Wanpipe')

2. NetBorder SS7 Gateway Software

NSG is operated using the browser-based web-GUI

Installation

Operating system

Selecting your Linux Operating system

Sangoma TDM cards and NSG application are compatible with several Linux distributions and kernels (i.e. CentOS, Debian, Ubuntu) 64bit.
Sangoma recommends the use of CentOS.  It is our officially supported distribution.  You are welcome to try to use other distros of your choice, but if you have issues installing or configuring them for NSG, or encounter errors that not cannot be duplicated when using CentOS, we do not guarantee that we can support you with those issues.

Below are instructions for CentOS Installation:

1. Download latest CentOS distribution:
   64-bit: http://isoredirect.centos.org/centos/6/isos/x86_64/

2. After downloading the CentOS ISO, simply burn the image on CD/DVD using your choice of burning utility

3. Boot your server with the CD/DVD containing your CentOS ISO.  Verify your BIOS settings allow for Boot from CD/DVD ROM drive

4. Follow the on-screen prompts to Install your new operating system. You may wish to visit some online step-by-step tutorials (google:))

5. Once completed, remove the CD/DVD from your server and reboot your server and log in to your freshly installed operating system

Preparing your Operating system for software packages

After installing your Linux operating system, you must prepare your server with the following system requirements before continuing.
To install system requirements simply copy and paste the below string directly into your Linux command line. The string will automatically download and install missing dependencies on your server.

Select only the option that applies to your environment:

CentOS (RedHat distros)

yum -y install kernel-devel-$(uname -r) libtool* make gcc patch perl bison flex-devel gcc-c++ ncurses-devel flex libtermcap-devel autoconf* automake* autoconf libxml2-devel cmake pcre libssh2 unixODBC pstack openssl098e compat-expat1 libjpeg libjpeg-devel libusb libusb-devel

Ubuntu/Debian

apt-get install libpcre3 libpcre3-dev libssh2-1 libssh2-1-dev unixodbc unixodbc-dev pstack openssl libssl-dev python expat libexpat1 insserv libdb5.1 libhashkit2 libjpeg62 git-core build-essential libncurses5 libncurses5-dev gawk libjpeg-dev libz-dev pkg-config

 

Example for a CentOS system:

Download Software Packages

The following software packages need to be installed:

• Wanpipe - Sangoma TDM card device driver

• NSG - NetBorder SS7 software application
   

1. Navigate to the /usr/src/ directory which will be used to store the downloaded packages. To do this type the following in your Linux command line, then press <enter>:

   1. -> cd /usr/src

2. Download Wanpipe and NSG by copy and pasting the following (without the quotes ""), then press <enter>:

   1. Wanpipe: " wget ftp://ftp.sangoma.com/linux/current_wanpipe/wanpipe-current.tgz " 

   2. NSG: " wget ftp://ftp.sangoma.com/nsg/5.2/Binary/nsg-5.2.0-113.x86_64.tar.gz " 

Example:

Install Software Packages

The following instructions will guide you to un-compress the downloaded '.tgz' files and install using make command

1. Wanpipe Installation

   1. un-compress the downloaded Wanpipe device driver (.tgz file) located in /usr/src/ directory

      1. type: tar xvfz wanpipe-current.tgz

      2. type: cd wanpipe-<version>/
         
         example:
         

         

   2. Install the Wanpipe device driver

      1. type: make

type: make install

c. Once the Wanpipe driver is installed, test that it did indeed install correctly

i. Type "wanrouter version" in any directory and verify that the output shows the version
example: 

ii. type: "wanrouter hwprobe". This command will present you with the details of the Sangoma TDM card currently installed inside your server
(make sure your Sangoma TDM Card(s) are physically installed inside the server before running this command, otherwise the output will return error)
example

2. NSG installation

   1. un-compress the downloaded NSG software (.tgz file) located in /usr/src/ directory

      1. type: tar xfz nsg-<version>.tar.gz

      2. type: cd nsg-<version>
         
         example:
         

         

   2. Install the NSG Gateway application 

      1. type: make install

The NSG software package is now installed.  

License Installation

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
      To get this information, simply type "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

      2. ANSI point codes are used typically in North America. Rest of world uses ITU point codes

      3. Your SS7 telco will provide you this information. It is the your registration number with them

      4. Insert the point code in decimal format only

      5. if you need assistance to convert your given point code to decimal format, there are plenty of online converters that will do this for you. Use a web search engine of your choice to accomplish this.

   3. User Key

      1. This is the SS7 license 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)

   3. Your license is now installed.

Log into WebGUI

Once the NSG software is installed, it will automatically start the webGUI engine and listen on port 8888.

To log into the NSG webGUI simply open a web browser on any computer, located on the same network as the NSG server, and type in the IP address of main LAN interface of the server NSG , with port 8888

Example

If you don't know what the IP address is of the main LAN interface of the NSG server, simply type 'ifconfig' and look for the IP address beside ethX (x being the interface hosting the IP address)

Example:

 You should be greeted with the NSG SS7 log in screen at this point:

The default login credentials for NSG are:

• username: admin

• password: admin
   

Log into the NSG webgui to begin user configuration: