Sangoma Netborder SS7 User manual

v1.14
1
Netborder SS7 to VoIP
Gateway
User Manual
[Type the abstract of the document here. The abstract is typically a short
summary of the contents of the document. Type the abstract of the document
here. The abstract is typically a short summary of the contents of the document.]

v1.14
2
Date: Dec 28 2012: Version: 1.14
Document Revision
Date
Description of Changes
1.14
Dec 28 2012
Profile Panel Support, On the fly config.
1.12
Nov 08 2012
Theory section and minor updates
1.11
Sep 23 2012
Quickstart section 5, Layout change
1.10
Sep 14 2012
Added MG Status, VLAN auto startup on eth config
1.09
Sep 12 2012
Updated network setup overview, snmp and monitoring
1.08
Sep 11 2012
Updated channel map, added more background info
1.07
Sep 09 2012
Added T38_Fax option in Media Gateway profile.
1.06
Sep 05 2012
Added rtpip on megaco profile
1.05
Aug 31 2012
Cosmetic Changes A.O, Added Megaco Overivew, VLAN routes, Reload
1.04
Aug 23 2012
USB CLI, Static Routes, Alarms, Improved instructions
1.03
Aug 22 2012
Pinout label
1.02
Aug 22 2012
VLAN, Factory Reset, Static Routes, Eth Options, usb console, DC PSU
info
1.01
Aug 19 2012
Added extra diagrams, Media, SIP, Relay, Dialplan, Update, Cables,
Appendix
1.00
Aug 2012
Initial revision of the document.
Conventions
This font indicates screen menus and parameters.
<> indicates keyboard keys (<Enter>, <q>, <s>).
NOTE
Notes inform the user of additional but essential information or features.
CAUTION
Cautions inform the user of potential damage, malfunction, or disruption
to equipment, software, or environment.
Sangoma Technologies provides technical support for this product.
Tech-support e-mail: [email protected]

v1.14
3
This page is intentionally blank.

v1.14
4
Sangoma
Netborder SS7 to VoIP GW User Manual

v1.14
5
Contents
Sangoma...............................................................................................................................................4
Netborder SS7 to VoIP GW User Manual.............................................................................................4
1Product Overview..........................................................................................................................10
1.1 Features / Advantages...........................................................................................................10
1.1.1 Any to Any Signaling and Media Gateway ......................................................................11
1.2 TDM T1/E1 Interfaces............................................................................................................12
1.3 Ethernet Network Interfaces ..................................................................................................12
1.4 VoIP Protocols.......................................................................................................................12
1.4.1 SIP ..................................................................................................................................12
1.4.2 Megaco/H.248 & MGCP..................................................................................................12
1.4.3 H.323...............................................................................................................................13
1.5 TDM Protocols.......................................................................................................................13
1.5.1 SS7 .................................................................................................................................13
1.5.2 ISDN................................................................................................................................14
1.6 Call Routing...........................................................................................................................14
1.7 Media Processing & Transcoding ..........................................................................................14
1.8 Echo Cancellation & VQE......................................................................................................15
1.9 DTMF Detection and Generation...........................................................................................15
1.10 Management and Configuration .........................................................................................15
1.11 Monitoring...........................................................................................................................15
1.12 Accounting..........................................................................................................................15
1.13 Shipping Options................................................................................................................16
1.14 Support and Professional Services.....................................................................................16
2NSG Product Information..............................................................................................................17
2.1 NetBorder SS7 to VoIP Gateway Appliance..........................................................................17
2.1.1 Hardware Specifications..................................................................................................17
2.2 NSG Shipping Box Contents..................................................................................................18
2.2.1 What is included in the box .............................................................................................18
2.2.2 What is not included........................................................................................................18
2.2.3 Front Panel......................................................................................................................19
2.2.4 Rear Panel 1U.................................................................................................................20
2.2.5 Front Panel 2u.................................................................................................................21
2.2.6 Rear Panel 2U.................................................................................................................22
2.3 NSG T1/E1 Port Identification................................................................................................23
2.3.1 Cable Pinouts: T1/E1 ......................................................................................................24
2.4 NSG Appliance Default Configuration....................................................................................26
3User Interface ...............................................................................................................................27
3.1 WebGUI.................................................................................................................................27
3.1.1 WebGUI Structure...........................................................................................................28
3.2 Console Structure..................................................................................................................31
3.2.1 Connect via SSH.............................................................................................................31

v1.14
6
3.2.2 Connect via USB Serial...................................................................................................32
3.2.3 Bash Shell.......................................................................................................................33
3.2.4 Gateway CLI –nsg_cli ....................................................................................................34
3.3 Shell/CLI from GUI.................................................................................................................35
4Usage Scenarios...........................................................................................................................36
4.1 Signaling Gateway: M2UA....................................................................................................36
4.2 Megaco/H.248 Media Gateway: MG + SG.............................................................................36
4.2.1 Megaco Quick Configuration...........................................................................................37
4.3 SIP/H323 to SS7 ISUP ..........................................................................................................38
4.3.1 H323 to SS7 ISUP Quick Start Guide .............................................................................39
4.4 Any to Any Signaling and Media Gateway.............................................................................40
5First Boot/Initial Setup...................................................................................................................41
5.1 Power Connection..................................................................................................................41
5.1.1 PSU Connection..............................................................................................................41
5.1.2 DC PSU Connection........................................................................................................42
5.2 Establishing Initial WebGUI Connection ................................................................................43
5.3 Change Password..................................................................................................................44
5.4 Console SSH Configuration...................................................................................................45
5.5 Self Test.................................................................................................................................47
5.5.1 Running Self-Test............................................................................................................47
5.6 NSG License..........................................................................................................................49
6Network Configuration...................................................................................................................51
6.1 Physical Network Interface Configuration..............................................................................53
6.2 Appliance Network Interfaces................................................................................................54
6.3 Selecting Default Route.........................................................................................................54
6.4 Network Section.....................................................................................................................55
6.5 Interface Section....................................................................................................................56
6.5.1 Network Role...................................................................................................................56
6.5.2 Types ..............................................................................................................................57
6.5.3 Ethernet Options .............................................................................................................58
6.6 Virtual IP’s..............................................................................................................................59
6.7 IP Troubleshooting.................................................................................................................59
6.8 Static Routes .........................................................................................................................60
6.8.1 Routing Table Status.......................................................................................................62
6.9 VLAN .....................................................................................................................................63
6.9.1 VLAN Configuration.........................................................................................................64
6.9.2 VLAN Routes...................................................................................................................65
6.9.3 Additional VLAN..............................................................................................................66
6.9.4 vconfig help.....................................................................................................................66
6.9.5 VLAN Status....................................................................................................................67
6.10 Date & Time Service Config ...............................................................................................69
7Initial Gateway Configuration........................................................................................................71
7.1 Global Gateway Configuration...............................................................................................72

v1.14
7
8Megaco/H.248 Media Gateway Configuration...............................................................................74
8.1 Overview................................................................................................................................74
8.1.1 Terminations....................................................................................................................74
8.1.2 Contexts..........................................................................................................................74
8.2 Commands ............................................................................................................................75
8.2.1 Sent from controller to gateway.......................................................................................75
8.2.2 Sent from gateway to controller.......................................................................................75
8.3 Packages...............................................................................................................................76
8.4 Create MG Profile..................................................................................................................77
8.5 Create MG Peer Profile..........................................................................................................80
8.6 TDM Termination for Media Gateway....................................................................................82
8.6.1 Identify.............................................................................................................................83
8.6.2 Edit T1/E1 Config............................................................................................................84
8.7 Span Link Type......................................................................................................................87
8.8 Signaling Gateway Overview.................................................................................................88
8.8.1 MTP1/2 Link Configuration..............................................................................................89
8.8.2 M2UA Interface ...............................................................................................................91
8.8.3 M2UA Cluster Creation ...................................................................................................92
8.8.4 M2UA Cluster Peers........................................................................................................93
8.8.5 SCTP Interface................................................................................................................95
8.8.6 Binding all components ...................................................................................................96
8.8.7 Mixed Mode Configuration ..............................................................................................97
8.8.8 Bind Megaco to TDM.......................................................................................................98
8.8.9 TDM Termination Complete ..........................................................................................101
9SS7 ISUP....................................................................................................................................102
9.1 TDM SS7 Configuration Page..............................................................................................104
9.2 Port Identification.................................................................................................................105
9.3 Edit T1/E1 Config.................................................................................................................106
9.3.1 Standard T1/E1 Parameters..........................................................................................106
9.3.2 Advanced T1/E1 Parameters ........................................................................................108
9.4 Span Link Type....................................................................................................................109
9.5 SS7 Network Overview........................................................................................................110
9.5.1 Links..............................................................................................................................111
9.5.2 Linksets.........................................................................................................................111
9.5.3 Routes...........................................................................................................................111
9.6 MTP2 Link Configuration .....................................................................................................112
9.7 MTP3 Linkset Configuration.................................................................................................115
9.8 MTP3 SS7 Route.................................................................................................................118
9.9 ISUP Interface Configuration...............................................................................................120
9.10 ISUP CIC Channel Mapping.............................................................................................124
10 Relay: SS7..............................................................................................................................130
10.1 Relay Configuration..........................................................................................................131
10.1.1 Configuring the master gateway....................................................................................132

v1.14
8
10.1.2 Configuring the slave gateway ......................................................................................136
10.1.3 Configuring the slave TDM configurations from the master gateway ............................140
11 Media Transcoding Configuration ...........................................................................................142
11.1 Media Hardware...............................................................................................................143
12 Applying Configuration............................................................................................................144
13 Dialplan...................................................................................................................................146
13.1 Dialplan Reload/Apply ......................................................................................................147
13.2 PSTN to SIP Dialplan .......................................................................................................148
13.3 PSTN to H323 Dialplan.....................................................................................................149
13.4 SIP/H323 to PSTN Dialplan..............................................................................................150
13.5 Dialplan Syntax.................................................................................................................151
13.5.1 Context..........................................................................................................................152
13.5.2 Extensions.....................................................................................................................153
13.5.3 Conditions .....................................................................................................................154
13.5.4 Multiple Conditions (Logical AND).................................................................................155
13.5.5 Multiple Conditions (Logical OR, XOR).........................................................................156
13.5.6 Complex Condition/Action Rules...................................................................................159
13.5.7 Variables .......................................................................................................................161
14 Backup Restore System..........................................................................................................163
14.1 Restore a System.............................................................................................................164
14.2 Restore to a new System..................................................................................................165
15 Factory Reset & Reboot..........................................................................................................166
15.1 Factory Reset ...................................................................................................................166
15.2 Appliance Soft Reboot......................................................................................................166
15.3 Appliance Shutdown.........................................................................................................166
16 Upgrade ..................................................................................................................................167
16.1 WebUI System Update.....................................................................................................167
16.2 Console SSH Update .......................................................................................................168
17 Operations...............................................................................................................................169
17.1 Starting the Gateway........................................................................................................169
17.2 Profile Panel.....................................................................................................................171
17.3 Gateway Status................................................................................................................173
17.3.1 Megaco/M2UA TDM......................................................................................................173
17.4 Megaco Status..................................................................................................................178
17.5 Gateway Logs...................................................................................................................179
17.5.1 Gateway Log Download ................................................................................................180
17.6 Advanced Logs.................................................................................................................181
17.7 Packet Capture.................................................................................................................181
17.7.1 Ethernet Capture Filter Options.....................................................................................183
18 Monitoring & Management......................................................................................................184
18.1 SNMP...............................................................................................................................184
18.2 SNMP Configuration.........................................................................................................185
18.3 SNMP Test.......................................................................................................................186

v1.14
9
19 Troubleshooting ......................................................................................................................188
19.1 Physical Layer..................................................................................................................189
19.1.1 NSG TDM Driver related commands.............................................................................190
19.1.2 T1/E1 Port Status..........................................................................................................191
19.1.3 T1/E1 Port Debugging...................................................................................................191
19.2 TDM Signaling Link Debugging........................................................................................195
20 Appendix.................................................................................................................................197
20.1 Redundant DC PSU .........................................................................................................197
20.1.1 DC PSU Cables.............................................................................................................198
20.1.2 Hot-swap procedures....................................................................................................199
20.1.3 Trouble Shooting...........................................................................................................200
21 Theory.....................................................................................................................................201

v1.14
10
1 Product Overview
The NetBorder SS7 to VoIP Gateway is Sangoma’s Carrier Class TDM to SIP VoIP Gateway product.
For short, it is often referred to as NSG.
1.1 Features / Advantages
Any to any switching gateway.
oAbility to run all endpoints/protocols on single software image and appliance
oSS7, Sigtran, SIP, H.323, Megaco Media Gateway, Signaling Gateway
oFlexible dial plan to route from any endpoint to any endpoint
Scalable and very high density
oUp to 32 E1 per appliance appliance
oCan scale up to 288 E1s in relay mode where multiple systems act as one
oTranscoding available on all channels
Extensive VoIP Signaling
oSIP, H.323, Megaco/H.248
Full featured SS7/Sigtran Signaling
oSS7 ISUP Signaling with several national variants
oITU, ANSI, Bellcore, France, UK, China, India and Russia
oSigtran, M3UA, M2UA & Sigtran signaling gateway
ISDN signaling
oQ.931, QSIG,
Faxing and Media Support
oPass-through
oT.38
Wide range of narrowband and wideband codecs supported
For any-to-any codec transcoding
oG.711, G.729, AMR
Robust implementation with distribution
Profile Panel, on the fly configuration with no service interruption.

v1.14
11
1.1.1 Any to Any Signaling and Media Gateway
Route any signaling traffic from eny signaling endpoint.
All protocols and signalling suppored from single gateway image.
oAbility to change from Megaco GW to SIP gateway via config change.
Route media with transcoding/dtmf/T.38 to/from end media endpoint.
NOTE:
Limitations exist when running specific signaling combinations at same time.
oEg: M2UA SG cannot run at the same time as ISUP+MTP3+MTP2
oSome codes such as AMR will reduce session capacity.
oNo reduction of capacity for G711, G729, iLBC

v1.14
12
1.2 TDM T1/E1 Interfaces
Electrical G.703.6/G.704 balanced
Minimum 4 T1/E1
Maximum 32 T1/E1 (960 ds0/sessions) per appliance
Transcoding supported on all channels
Extend capacity over 960 ports via ISUP relay feature and multiple appliances.
1.3 Ethernet Network Interfaces
Two Gigabit network interfaces
1.4 VoIP Protocols
1.4.1 SIP
SIP V2 / RFC 3261 RFC 3261 Session Initiate Protocol
RFC 2976 SIP INFO Method
RFC 3398 ISUP-SIP Mapping
RFC 3515 Refer Method
RFC 2327 Session Description Protocol
RFC 3581 An Extension to the Session Initiation Protocol (SIP) for Symmetric Response
Routing
RFC 3892 Referred-By Mechanism
RFC 3891 "Replaces" Header
RFC 3551: RTP/AVP
RFC 3515: REFER
RFC 2617: HTTP Digest Authentication
SDP Bypass
NSG exports all SS7 parameters via SIP custom X headers.
1.4.2 Megaco/H.248 & MGCP
MEGACO Protocol Version 1.0, Internet RFC3525
H.248.1 Version 1 Implementors’ Guide, 13 April, 2006
H.248 Sub-series Implementors’ Guide, 13 April, 2006
ITU-T recommendation H.248.1 Version 3 (09/2005): “Gateway control protocol”
SDP : Session Description Protocol, Internet RFC 2327 & RFC 4566

v1.14
13
H.248.2 –Fax etal Package
H.248.14 –Inactivity Timer Package
Augmented BNF for Syntax Specifications: ABNF, Internet RFC 2324
DTMF support
oRFC 2833/4733 - "RTP Payload for DTMF Digits, Telephony Tones and Telephony
Signals"
oIn-band DTMF detection/generation
1.4.3 H.323
Call Handling
H.225.0 : Call signaling protocols and media stream packetization for packet-based multimedia
communication systems
H.245 : Control protocol for multimedia communication
H.235, H.450, H.460
DTMF support
RFC 2833/4733 - "RTP Payload for DTMF Digits, Telephony Tones and Telephony Signals"
In-band DTMF detection/generation
1.5 TDM Protocols
1.5.1 SS7
ISUP, MTP3, MTP2, MTP1, M3UA (RFC 3332), M2UA (RFC 3331), Relay
Variants
oITU, ANSI, Bellcore, UK, China, France Spirou, India and Russian
MTP2
oITU 88 & 92, ANSI 88 & 92, Peoples Republic of China
MTP3
oITU 88 & 92 & ETSI, ANSI 88 & 92, 96 & Telcordia (including ANSI MTP3-B), China
ISUP
oITU 88, 92 & 97, 2000, Telcordia 97, ANSI 88, 92, 95 and ETSI v2,v3
oSPIROU, China, UK, Russia, India
SCTP (RFC 2960)

v1.14
14
1.5.2 ISDN
CCITT 88, User & Network Side PRI/BRI
AT&T 4ESS User Side - PRI, Network Side - PRI
5ESS User Side - PRI/BRI, Network Side - PRI/BRI
DMS-100 User & Network Side - PRI/BRI
ETSI User & Network Side - PRI/BRI
Australian Telecom User Side - PRI/BRI and Network Side - PRI
National ISDN-1 User Side - BRI
NTT User & Network Side - PRI/BRI
National ISDN-2 User & Network Side - PRI
Q.SIG (PRI)
LAPD & TEI Management
1.6 Call Routing
Configurable and extendable XML-based dial plan and routing rules XML Dialplan can be used to
create complex routing scenarios between SIP and TDM.
Call routing based on any call parameter present in a SIP or SS7 IAM message.
Deep integration with signaling stacks
Ability to use external applications to build complex routing logic*
1.7 Media Processing & Transcoding
Wide range of codecs supported for any to any codec negotiation.
G.711
G.723.1
G.726
iLBC
G.729AB
GSM
G.722
AMR
G.722.1

v1.14
15
1.8 Echo Cancellation & VQE
Telco grade hardware based echo canceling and Voice processing
G.168-2002 with 128ms tail
Noise cancellation
DTMF Removal
DTMF Detection
FAX Detection
Automatic Gain Control
1.9 DTMF Detection and Generation
Sangoma NSG gateway supports multiple DTMF internetworking scenarios.
RFC 2833 Tone Relay
In-band
SIP INFO
Hardware and software DTMF detection and generation
1.10Management and Configuration
Sangoma NSG configuration, operation and troubleshooting are designed to be flexible.
Web GUI
Profile Sync, on the fly configuration without service interruption.
Command line interface via ssh and usb to serial
Call detail records in XML format
Detailed logs with user configurable file size and auto rotation
1.11Monitoring
SNMP v1, 2, 3
RTCP
1.12Accounting
Radius

v1.14
16
1.13Shipping Options
SKU
DESCRIPTION
SS7-NSG-AP04
Up to 4 E1/T1, ISUP to SIP, codec support, 4 signaling links, up to 12 point codes
SS7-NSG-AP08
Up to 8 E1/T1, ISUP to SIP, codec support, 8 signaling links, up to 12 point codes
SS7-NSG-AP16
Up to 16 E1/T1, ISUP to SIP, codec support, 16 signaling links, up to 12 point codes
SS7-NSG-AP32
Up to 32 E1/T1, ISUP to SIP, codec support, 32 signaling links, up to 12 point codes
1.14Support and Professional Services
Sangoma Engineers are here to support your success. Whether you need technical support and
software maintenance, training, consultation and installation services, Sangoma can help you. Please
contact your Sales representative for more information.

v1.14
17
2 NSG Product Information
2.1 NetBorder SS7 to VoIP Gateway Appliance
Fully integrated Industrial grade telco appliance running a customized OS, Netborder SS7 to VoIP
application and TDM interfaces configured and installed by Sangoma.
NSG Appliance provides a full-featured, carrier-class VoIP deployment while leveraging the flexibility
and cost effectiveness of standard computing platforms.
2.1.1 Hardware Specifications
Industrial grade telecom appliance
Size: 1U and 2U - 19'' Rackmount
Min Capacity: 4 T1/E1 (1U)
Max Capacity: 32 T1/E1 (2U)
Power: AC, DC, Redundant
AC Power Supply (Single)
o
DC Power Supply (Redundant)
oThe Input Current for -48VDC, is 12.0A (RMS).
oWith Inrush Current of 20.0A MAX.
Depth: 20''
Weight: 36lb
Full Spec on Sangoma Site

v1.14
18
2.2 NSG Shipping Box Contents
The first three tasks for installing and operating the Netborder SS7 to VOIP Gateway are
Unpack
Inspect
Power up.
Carefully inspect the NSG Appliance for any damage that might have occurred in shipment.
If damage is suspected, file a claim immediately with the carrier, keep the original packaging for
damage verification and/or returning the unit, and contact Sangoma Customer Service.
2.2.1 What is included in the box
Netborder SS7 to VoIP Appliance
oAppliance can be 1U or 2U depending on model ordered
Power Cable
oAC cable in case of AC PSU (black cable)
oDC cable in case of DC PSU (RED & Black cable)
Mounting Brackets
Quickstart user guide
2.2.2 What is not included
Appliance Rails
Appliance Rails can be purchased separately from Sangoma.
Please contact Sales for more information.

v1.14
19
2.2.3 Front Panel
Front Panel Reset/Power button is used for:
oFactory Reset
Press 1 time per second until system beeps and reboots (approx.: 10sec).
A beep will sound to indicate that system has completed factory reset
before system reboots.
oSoft Reboot
Press 1 time every 3 seconds until system reboots. (approx.: 6sec)
There will be no beep on reboot.
oPower on/off
Hold for 10 seconds
oNothing will happen if pressed once
To avoid accidental restart.
Caution: From NSG SW release 5.0
oRefer to Factory Reset section.
USB Ports can be used for Serial Console
oRefer to Serial Console section.
RAID1 SSD
oThe RAID1 is NOT Hot Plug
oNSG appliances use industrial grade SSD
oOne must power down the machine in order to change SSD/HDD
oContact Sangoma Support for part replacement.

v1.14
20
2.2.4 Rear Panel 1U
Power button
oUsed to turn off the power supply
oNot for Factory Reset
USB Ports can be used for Serial Console
oRefer to Serial Console section.
PSTN T1/E1 Interfaces
oRJ45 Connections
Primary Eth Interface (eth0): Gig Ethernet Port
oThis adapter must be plugged into the LAN
oSIP Signaling and RTP Media will flow through this device.
oWebUI identifies this device as "eth0"
Secondary Eth Interface (eth1): Gig Ethernet Port
oThis adapter is optional
oIt can be used for Monitoring and Statistics
oWebUI identifies this device as "eth1"
USB Ports
oUsed for Serial Console
oCan be used re-flash the appliance
oFuture use: active/standby redundancy*