...
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
...
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
...
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
...
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
...
Info |
---|
NOTE The NSG gateway must be running and started in Control PannelPanel. |
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.
...