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


     

 

WebGUI Structure

Overview

  • Control Panel

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

       

  • 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

NOTE

The NSG gateway must be running and started in Control Pannel.

 

Command

Description

status

Shows NSG Status

show channels

List all active calls

ftdm list

Lists Information on all available spans

ftdm ss7

Displays all SS7 Related Commands

mg

Displays all Megaco Related Commands

log [debug|error|crit]

Set log level to debug loglevel critical

 

Shell/CLI from GUI

  • Select Command Execution from side/top Configuration Menu

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

 

Do not run shell commands that run indefinitely. Such as “ping <ip>”.  In such case the webgui will get stuck forever executing the command.  In such case, user must login via CLI and kill the process.

In case of ping command one can limit number of pings to perform. eg: ping –c 10 <ip>

Return to Documentation Home I Return to Sangoma Support