User Interface

Netborder SS7 to VoIP media gateway provides the user with two interfaces

• WebGUI

  • Web GUI is preferred for almost all operations

  • Configuration, Operations, Statistics, Reports

• Console via ssh or usb-serial

  • For power users familiar with Linux operating system, ssh or usb-serial console provides advanced and flexible interface for troubleshooting and automation.

WebGUI

• WebGUI resides on the port 81

• Interface provides two identical menus for easy access to all options

  • Top Horizontal Menu

• Side Vertical Menu
  
  
  

  Open

  

   

WebGUI Structure

Overview

• Control Panel

  • Used to control the global gateway operations: start, stop, restart
    
    

    Open

    

     

• Profile Panel

  • Used to Sync configuration on the fly without Restarting full gateway.

  • Allows configuration of the gateway without service interruption.

  • Supported from NSG Version v5.0.1

• TDM Status

  • Provides full overview of gateway utilization and states
    
    

     

• SIP Status

  • Provides full SIP statistics, call count
    
    

     

• MG Status

  • Megaco detail call status report per Profile

• VLAN Status

  • Provides full VLAN statistics, VLAN ID, IP, Netmask for each VLAN.
    
    

     

Configuration

• Network

  • Allows network configuration such as IP,  Static IP Routes, VLAN, DNS and Firewall
    
    

     

• Gateway

  • Core product configuration

  • Provides configuration of all Signaling and Media Protocols

    • SIP, RTP, Media Processing, Megaco(MG),  SS7/Sigtran (TDM), ISDN (TDM)

  • Routing Logic / Dialplan

  • XML based dialplan
    
    

     

• Management

  • Apply

    • Write all configurations changed and set in Gateway section.

  • Backup

    • Backup all system configurations into a zip file.

    • Recover a system from a backup file

  •  
     

• Advanced

  • File Editor

    • Allows custom file editing for custom configuration

    • Troubleshooting

  • Command Execution

    • Instead of logging into a shell

    • Execute any system command via the WebGUI.

System

• Settings

  • Date

    • Set date time and sync to time server

  • Password

    • Change password

  • Shutdown

    • Shutdown or reboot a system

  • Update

    • Software and patch update system
      
      

• Resources

  • Processes

    • List of currently running process

  • Services

    • List of all available services

  • SSH service start/stop
    
    

     

• Hardware

  • Self-Test

    • Allow for system software and hw components test.

  • Firmware Update

    • Allows for firmware updates

    • Sangoma TDM boards

    • Sangoma Media processing boards

• Help

  • About

    • Shows system version and version of all important packages.

  • PBX Integration

    • Help documentation

Reports

• Dashboard

  • Overview

    • Overview of network interfaces
      
      

• Network

  • Network Report

    • Long term usage charts for each network device

  • Protocol Capture

    • PCAP packet capture with filter support for any network interface

• System

  • Gateway Logs

    • Specific gateway logs used to quickly trouble shoot gateway issues

    • Allows for log download

  • Advanced Logs

    • Full system wide logs with filters

• Hardware Report

  • Full hardware overview and description

  • HDD, Memory and system usage

  • Device enumeration

  • Resource Report

    • Long term statistics

Console Structure

• Console access via ssh

• Console access via usb-serial

• Shell Commands via WebUI – Command Execution

• Gateway CLI Commands via WebUI – Command Execution

• Operating system is Linux based.  Therefore Linux expertise is mandatory.

• WARNING

  • Working in shell is very powerful and flexible, but also dangerous

  • A system can be corrupted, formatted, erased if user makes a mistake.

Connect via SSH

Use default SSH clients on any desktop

• Windows – putty

• Linux – native ssh

On login prompt

• Username: root

• Password: <your custom password>

Connect via USB Serial

• usb to serial cable

  • One must use usb to serial cable + null modem cable

  • If Laptop does not have a serial port then use two usb to serial cables plus null modem cable per diagram below.

• Connect to any usb port on NSG appliance

  • All NSG appliances have usb port on rear panel

  • 2U NSG appliances have usb port in front panel as well.

• Configure Terminal Client on Laptop

  • Windows HyperTerminal

  • Linux – mincomm

• Serial Settings

o 115200, N, 8, 1  vt100

• Press enter a few times until a login prompt appears.

  • Login via:  username: root,  password: <your personal password>

Bash Shell

 Once successfully logged into the system, either via ssh or usb serial, user will be offered a bash prompt.

• NSG system is based on Linux

• The initial console after login will be a bash shell

System Commands

 System commands are based on Linux operating systems. Listed here are some most useful debugging commands.

• tcpdump

  • Provides network capture to a pcap file

  • Can be analyzed using wireshark on Desktop or Laptop.

• ethtool

  • Provides detail network interface information, like Ethernet link status.

  • Run: ethtool <enter>  for all the options

  • Eg: ethtool eth0  - show Ethernet status

• Ifconfig

  • Network interface statistics tool

  • Shows error counters on Ethernet and TDM interfaces.

  • Notice the error and overrun counters on wanpipe w1g1 interfaces.

• wanpipemon

  • Sangoma TDM troubleshooting tool

  • T1/E1 alarms

    • wanpipemon –i w1g1 –c Ta

• nsg_cli

• Provides Gateway low level CLI Refer to the appendix for all System Commands

Gateway CLI – nsg_cli

• First log into the System Console (bash)

• Once on bash prompt run

o nsg_cli

Shell/CLI from GUI

• Select Command Execution from side/top Configuration Menu

• Specify a shell or CLI command.  Refer to guide below.