| Include Page |
|---|
| Transparency_Profile_Note |
|---|
| Transparency_Profile_Note |
|---|
|
| Include Page |
|---|
| IP_IGs_ServedBySeperateProcessors |
|---|
| IP_IGs_ServedBySeperateProcessors |
|---|
|
The configuration discussed in this section has been tested in the Sonus Networks lab. The goal is to show a simple working configuration that can be used as a basis for
user customization.
High Level Simple Configuration
Trunk group routing will be used to send all traffic that arrives on "Outside" trunk to "Inside" trunk, and vice versa. This allows for no additional configuration changes on the
as the operator adds more numbers to be routed.
This configuration will support G.729A on the "Outside" with G.711 on the "Inside" so transcoding will occur.
A single Address Context will be configured, so no overlapping IP address will be used.
Both "Outside" and "Inside" specific configuration data must be made. Below is a summary of the key configuration items.
| Caption |
|---|
| 0 | Table |
|---|
| 1 | Key Configuration Items |
|---|
| 3 | Key Configuration Items |
|---|
|
Configuration Item | "Outside": PEER | "Inside": CORE |
|---|
Zone
|
SIP Port and Trunk Group reside in Zone
|
SIP Port and Trunk Group reside in Zone
|
SIP Signaling Port
|
Public IP address on the SBC that far end will send messages to.
|
Private IP address on the SBC that
the feature server will send messages to
|
Packet Service Profile
|
Specify G.729A
|
Specify G.711
|
IP Signaling Profile
|
SIP Parameter settings
|
SIP Parameter settings
|
Trunk Group
|
Includes IP of where messages will arrive from. If far ends are registering
devices (phones), use 0.0.0.0 for ingress IP Prefix.
|
Includes IP of where
messages will arrive from. Will be the feature server SIP port IP address.
|
Signaling Peer
|
IP address of far end
|
IP address of feature server
|
Routing Label
|
One per trunk group
|
One per trunk group
|
Route
|
One per trunk group
|
One per trunk group
|
|
Configuration Details
Please use default values except as noted. For this example the Address Context "default" is used, since there is no over-lapped IP addressing.
The term "operator" is used to mean the Carrier, Service Provider, or Enterprise that owns the
.
To get into configuration mode from the CLI:
| Code Block |
|---|
|
admin@DFWNBS01a> configure
Entering configuration mode private |
Zones
Create four new zones, each one representing an external customer or operator equipment.
- Two are used for the Trunking configuration
- Two are used for the Access configuration.
As additional customer (non-operator) far ends are added, they can be put into a new zone. For additional operator equipment, you may use a new zone or re-use the existing one.
| Caption |
|---|
| 0 | Table |
|---|
| 1 | Zone Usage |
|---|
| 3 | Zone Types |
|---|
|
Zone | Configuration Usage | Purpose |
|---|
peer | Trunking | Traffic to/from far end carrier | core | Trunking | Traffic to/from operator trunking equipment | phones | Access | Traffic to/from phones | accesscore | Access | Traffic to/from operator feature server |
|
| Code Block |
|---|
| title | Example of Using Zone Types in CLI |
|---|
|
% set addressContext default zone peer id 2
% set addressContext default zone core id 3
% set addressContext default zone core id 3
% set addressContext default zone accesscore id |
On the SBC main screescreen, navigate to Configuration > System Provisioning > Category: Base Provisioning > Zone.
| Caption |
|---|
|
 Image Modified
|
SIP Signaling Ports
The SIP Signaling Ports live on (the IP addresses are owned by) the
. These are the IP addresses that external (non-SBC equipment) send SIP traffic to and receive SIP traffic from. For this example four new SIP Ports are created (two for Trunking and two for Access). The term "operator" is used to mean the Carrier, Service Provider, or Enterprise that owns the
.
| Caption |
|---|
|
SIP Port #/ Zone | Configuration Usage | Purpose |
|---|
1 / peer | Trunking | Traffic to/from far end carrier | 2 / core | Trunking | Traffic to/from operator trunking equipment | 3 / phones | Access | Traffic to/from phones | 4 / accesscore | Access | Traffic to/from operator feature server |
|
In the configuration examples, each SIP Signaling port is in a unique Zone. The non-
equipment (phones, operator feature server, other Carriers, operator trunking server) sends/receives SIP messages to/from the IP addresses and port configured. The default protocol allowed is UDP and port is 5060.
| Note |
|---|
|
When a SIP Port is created (IP address is assigned), the system also creates an ACL that allows connection attempts to all ports on the IP address. This means that someone could attempt to SSH to the IP address of the SIP Port. To prevent unwanted access attempts, you should manually create ACLs that specify what is allowed and what is not. See the ACL section of this document for details. |
| Code Block |
|---|
|
% set addressContext default zone peer id 2 sipSigPort 1 ipInterfaceGroupName EXTERNAL_IPIG ipAddressV4 10.35.66.189 state enabled
% set addressContext default zone core id 3 sipSigPort 2 ipInterfaceGroupName INTERNAL_IPIG ipAddressV4 192.168.75.10 state enabled
% set addressContext default zone phones id 4 sipSigPort 3 ipAddressV4 10.35.66.143 portNumber 5060 transportProtocolsAllowed sip-udp ipInterfaceGroupName EXTERNAL.IPIG
% set addressContext default zone accesscore id 5 sipSigPort 4 ipAddressV4 10.35.66.179 portNumber 5060 transportProtocolsAllowed sip-udp ipInterfaceGroupName EXTERNAL.IPIG |
On the SBC main screenscreenn, navigate to Configuration > System Provisioning > Category: Base Provisioning > Signaling Ports > Sip Sig Port.
| Caption |
|---|
|
Image Modified |
Packet Service Profile (PSP)
Packet Service Profiles control the media settings such as Codec, Packet Size, Transcoding options, and fax support on a trunk group. For example you can specify that only G.729A codec is allowed to the PHONES trunk group, while G.729A and G.711 are allowed to the ACCESSCORE trunk group. Each PSP can contain up to four Codec entries when using ERE. These Codec entries describe a codec, its packet size, and its law (A or U). Several default Codec entries are pre- configured on the system, and you can use these as an example to create your own.
| Excerpt Include |
|---|
| Supported Codecs and Transcoding |
|---|
| Supported Codecs and Transcoding |
|---|
| nopanel | true |
|---|
|
If you do not wish to use the default Codec Entries you will need to create custom Codec Entries before you can create Packet Service Profiles, since the PSP reference the Codec Entries. For example, you may want to have a PSP that specifies 20ms packet size, RFC2833 transport, allows for G.729A codec, and allows transcoding of G.711 to G.729A.
In our example two, Packet Service Profiles are created. You should create new PSPs based on the default one, instead of modifying the default one. And they should be named in such a way so that you can identify what their function is.
On the SBC main screenscreenn, go to Configuration > System Provisioning > Category: Trunk Provisioning > Packet Service Profile. The Packet Service Profile window is displayed.
| Caption |
|---|
| 0 | Figure |
|---|
| 1 | Packet Service Profile |
|---|
|
Image Modified |
Codec Entry
The Codec Entry describes one specific codec that can be offered as part of the Packet Service Profile. Several default Codec Entries are included with the
. It is recommended to name the Codec Entry in a descriptive manner, so it is easy to select during the Packet Service Profile creation or modification.
Some of the key fields of the Codec Entry include:
- Codec – the actual codec to be used
- Packet Size – the size of each RTP voice packet, in milliseconds.
- Law – Alaw, Ulaw, derived from other leg
- DTMF Relay method – should RFC2833 be used, in-band or out of band
Example 1:
Create G711u_20ms_2833_T38 entry for internal side that uses 20 ms and 2833 only.
| Code Block |
|---|
|
% set profiles media codecEntry G711u_20ms_2833_T38 codec g711 packetSize 20 law ULaw
% set profiles media codecEntry G711u_20ms_2833_T38 dtmf relay rfc2833 removeDigits enable
% set profiles media codecEntry G711u_20ms_2833_T38 fax toneTreatment faxRelayOrFallbackToG711
% set profiles media codecEntry G711u_20ms_2833_T38 modem toneTreatment fallbackToG711
% set profiles media codecEntry G711a_20ms_2833_T38 codec g711 packetSize 20 law ALaw
% set profiles media codecEntry G711a_20ms_2833_T38 dtmf relay rfc2833 removeDigits enable
% set profiles media codecEntry G711a_20ms_2833_T38 fax toneTreatment faxRelayOrFallbackToG711
% set profiles media codecEntry G711a_20ms 2833_T38 modem toneTreatment fallbackToG711 |
Example 2:
Create G711u_40ms_2833_T38, G711a_40ms_2833_T38, and G729ab_40ms_2833_T38 entries for pubic facing side, G.711u, G.711a and G.729A, all using RFC2833 and 40ms packet size.
G.711U 40ms_2833_T38:
| Code Block |
|---|
|
% set profiles media codecEntry G711u_40ms_2833_T38 codec g711 packetSize 40 law ULaw
% set profiles media codecEntry G711u_40ms_2833_T38 dtmf relay rfc2833 removeDigits enable
% set profiles media codecEntry G711u_40ms_2833_T38 fax toneTreatment faxRelayOrFallbacktoG711
% set profiles media codecEntry G711u_40ms_2833_T38 modem toneTreatment fallbackToG711
% set profiles media codecEntry G711a_40ms_2833_T38 codec g711 packetSize 40 law ALaw |
G.711a 40ms_2833_T38:
| Code Block |
|---|
|
% set profiles media codecEntry G711a_40ms_2833_T38 dtmf relay rfc2833 removeDigits enable
% set profiles media codecEntry G711a_40ms_2833_T38 fax toneTreatment faxRelayOrFallbackToG711
% set profiles media codecEntry G711a_40ms 2833_T38 modem toneTreatment fallbackToG711 |
G.729ab 40ms_2833_T38:
| Code Block |
|---|
|
% set profiles media codecEntry G729ab_40ms_2833_T38 codec g729ab packetSize 40
% set profiles media codecEntry G729ab_40ms_2833_T38 dtmf relay rfc2833 removeDigits enable
% set profiles media codecEntry G729ab_40ms_2833_T38 fax toneTreatment faxRelayOrFallbacktoG711
% set profiles media codecEntry G729ab_40ms_2833_T38 modem toneTreatment fallbackToG711 |
On the SBC main screenscreenn, navigate to Configuration > System Provisioning > Category: Call Routing > Codec Entry. The Codec Entry window is displayed.
| Caption |
|---|
|
Image Added Image Modified |
IP Signaling Profile
IP Signaling Profiles control how various SIP egress and ingress parameters are set and processed. A unique profile should be used for each type of destination. Each trunk group has an assigned IP Signaling Profile. You can see this from the EMA GUI via Configuration > System Provisioning > Category: Trunk Provisioning > Ip Signaling Profile.
| Note |
|---|
| A trunk group has both an IP Signaling Profile and an Egress IP Signaling profile. The Egress IP Signaling profile is used for the outgoing signaling (sent from the trunk group). |
| Note |
|---|
| The IP Signaling profile configured on the IP Peer will overwrite the IP Signaling profile configured on the trunk group. |
The IP Signaling Profile "DEFAULT_SIP" is available to use. If you do not wish to use the default one as is, it is recommended to create a new one and leave the DEFAULT_SIP unchanged. You should use the default values for the IP Signaling profile, except for Access configurations, do the following:
- Turn on all Common IP Attributes: Relay flags (to allow all messages to pass through SBC).
- Turn on all Common IP Attributes: Transparency for headers.
- Turn on Egress IP Attribute: Transparency
Trunk Groups
An important concept on the SBC is that all signaling and routing is based upon Trunk Groups. Even in Access configurations, a set of endpoints is represented by a trunk group. It is convention that the trunk group names are CAPATALIZED.
For the example configuration, four trunk groups are created. Two are created for the "SIP Trunking" configuration and two for the "Access" configuration.
| Caption |
|---|
|
Trunk Group Name | Configuration Usage | Purpose |
|---|
CORE | Trunking | Trunk to operator network equipment (carrier that owns the SBC) | PEER | Trunking | Trunk to far end (another carrier or PBX for example) | PHONES | Access | Trunk to the set of phones | ACCESSCORE | Access | Trunk to the operator (owner the SBC) feature server (Sonus ASX, PBX, etc.) |
|
| Code Block |
|---|
|
% set addressContext default zone core sipTrunkGroup CORE ingressIpPrefix 192.168.75.5 32
% set addressContext default zone core sipTrunkGroup CORE media mediaIpInterfaceGroupName IPIG1
% set profiles signaling ipSignalingProfile CORE_IPSP egressIpAttributes numberGlobalizationProfile NO_GLOBAL_IP
% set profiles signaling ipSignalingProfile CORE_IPSP commonIpAttributes relayFlags thirdPartyBodies enable
% set profiles signaling ipSignalingProfile CORE_IPSP commonIpAttributes transparencyFlags unknownBody enable unknownHeader enable
% set addressContext default zone core sipTrunkGroup CORE policy signaling ipSignalingProfile CORE_IPSP
% set profiles media packetServiceProfile CORE_PSP codec codecEntry1 G711-EITHER_OOB-2833 codecEntry2 G729AEITHER_OOB-2833 codecEntry3 G729AB-EITHER_OOB-2833
% set profiles media packetServiceProfile CORE_PSP packetToPacketControl codecsAllowedForTranscoding thisLeg g711a,g711u,g729,t38
% set profiles media packetServiceProfile CORE_PSP packetToPacketControl codecsAllowedForTranscoding otherLeg g711a,g711u,g729,t38
% set addressContext default zone core sipTrunkGroup CORE policy media packetServiceProfile CORE_PSP
% set addressContext default zone core sipTrunkGroup CORE state enabled mode inService |
On the SBC main screenscreenn, go to Configuration > System Provisioning > Category: Trunk Provisioning > Trunk Group > Sip Trunk Group. The Sip Trunk Group window is displayed.
| Caption |
|---|
|
Image Modified |
IP Peer
The IP Peer is the IP address of the far end device. The IP Peer is referenced in the Routing Label, and is used for outgoing calls for a particular Trunk Group.
| Note |
|---|
| If you define an IP Signaling Profile in the IP Peer (policy sub section), it will overwrite the one defined the in trunk group. |
For Access configurations, it is not necessary to have a IP Signaling Peer to the individual phones. You do need one to the feature server.
| Code Block |
|---|
|
% set addressContext default zone core ipPeer core_peer ipAddress 192.168.75.5 ipPort 5060
% set addressContext default zone peer ipPeer peer_peer ipAddress 10.35.66.187 ipPort 5060
% set addressContext default zone accesscore ipPeer accesscore_peer ipAddress 10.35.66.140 ipPort 5620 |
On the SBC main screenscreenn, navigate to Configuration > System Provisioning > Category: Trunk Provisioning > Ip Peer. The Ip Peer window is displayed.
| Caption |
|---|
|
Image Modified |
Routing Label
The Routing Label is used by the Route object to send traffic from one trunk group to the other, and vice versa. Trunk Group routing is used for this purpose.
One Routing Label is created for each Trunk Group. This Routing Label is used to send calls to that Trunk group. In the below example, the Routing Label "TO_CORE" sends calls to "CORE" trunk group. There is also a Routing Label "TO_PEER" that sends calls to "PEER" trunk group.
| Code Block |
|---|
|
% set global callRouting routingLabel TO_PEER routingLabelRoute 1 trunkGroup PEER ipPeer PEER inService inService
% set global callRouting routingLabel TO_CORE routingLabelRoute 2 trunkGroup CORE ipPeer CORE inService inService
% set global callRouting routingLabel TO_PHONES routingLabelRoute 3 trunkGroup PHONES inService inService
% set global callRouting routingLabel TO_ACCESSCORE routingLabelRoute 4 trunkGroup ACCESSCORE ipPeer ACCESSCORE inService inService |
To view the Routing workspace, select Configuration > System Provisioning > Category: Call Routing > Routing.
| Caption |
|---|
| 0 | Figure |
|---|
| 1 | Routing Label Route |
|---|
|
Image Added When Trunk Group is selected as the option for Route Type, all the Trunk Group related fields are displayed. Image Modified When IP Peer is selected as the option for Route Type, the Trunk Group related fields are hidden and the field, "Zone for TG and IP Peer" is changed to "Zone for IP Peer". This enhancement allows you to create Routing Label Routes with just an IP Peer as an option. Image Added |
For more information about configuring a Routing Label from the EMA, refer to Call Routing: System Provisioning - Routing.
Route
The Route is used to determine how call routing is done. There are different ways to implement routing (dialed number, carrier, calling number, trunk group, etc.) Trunk Group routing is used for this example configuration. It is the simplest and most straight forward way for a "pure" SBC function to be implemented. It allows the operator to add users / routable numbers without having to configure those numbers into the SBC.
For our Trunk Group routing, calls that arrive on trunk group "CORE" are sent to Routing Label "TO_PEER", which routes the call to trunk group "PEER". And in the other direction, calls that arrive on trunk group "PEER" are sent to Routing Label "TO_CORE", which routes the call to the "CORE" trunk group.
| Note |
|---|
| In the examples below "DALNBS01" is the name of the SBC being used in this document. |
| Code Block |
|---|
|
% set global callRouting route trunkGroup PEER DALNBS01 standard Sonus_NULL 1 all all ALL none Sonus_NULL routingLabel TO_CORE
% set global callRouting route trunkGroup CORE DALNBS01 standard Sonus_NULL 1 all all ALL none Sonus_NULL routingLabel TO_PEER
% set global callRouting route trunkGroup PHONES DALNBS01 standard Sonus_NULL 1 all all ALL none Sonus_NULL routingLabel TO_ACCESSCORE
% set global callRouting route trunkGroup ACCESSCORE DALNBS01 standard Sonus_NULL 1 all all ALL none Sonus_NULL routingLabel TO_PHONES
% commit |
To view the Routing workspace, select Configuration > System Provisioning > Category: Call Routing > Routing.
| Caption |
|---|
|
Routing Type: Standard Image Added Routing Type: User Name Image Added Routing Type: Relay Image Modified |
For more information on Routing Label, refer to Call Routing: System Provisioning - Routing.
Link Detection
Link Detection is only useful for HA systems (2 units).
Link detection is used to determine if the active unit needs to be failed over to the other unit. If a certain number of links (configurable) within a "link detection group" fail then a failover will occur. A link is considered failed if it loses connectivity to the router (for example if the cable is pulled or if the router port is turned down). In addition if a non-zero ping target IP address is configured, a link can be marked out of service if pings to this predefined IP address fail.
It is recommended to use 0.0.0.0 as the ping target for enterprise and simple deployments. This disables the "ping" test functionality (other link detection functionality is not affected). If you do wish to activate the system failovers using a ping target, please contact Sonus.
If you do activate the ping test functionality (configure a non-zero ping target) you need to be careful to ensure that the ping target IP will ALWAYS respond to "ping", otherwise the
detects a link failure, and could cause a failover to the other unit.
| Note |
|---|
| Before "enabling" Link Detection make sure the link lights on the are illuminated, and that the router port is up. Otherwise, right when Link Detection is enabled, a failure will be detected and the unit may fail over. |
Configuration Questionnaire
There is an extensive amount of information you need to have up front, before starting the configuration of your
. You will need to have completed the physical connectivity (Hardware Installation) and IP plan (what IP address will be assigned to each physical port) for your
. The IP Plan is generally completed using an Excel spreadsheet. This spreadsheet shows the IP address that will be allocated for each of the various interfaces in your network.
Even for a simple network, it is important to create this document for future reference. See Creating an IP Plan for details. If needed, please contact Sonus for an example spreadsheet.
Once you have installed the
hardware, the application software must be installed. As part of this installation, you will be prompted for some configuration information. This step is done from the EMA.
The steps for installing the application are described in SBC Core Installation and Upgrade Guide. As a quick summary, the information configured during this step includes (for each unit of a High Availability (HA) pair:
- System Name
- Host name
- Management IP address for management port 0
- Management IP address for management port 1
- NTP server IP address
| Note |
|---|
The BMC is not applicable to the SBC SWe platform. |
Call Processing Configuration for Simple Routing
| Caption |
|---|
| 0 | Table |
|---|
| 1 | Call Processing Configuration for Simple Routing |
|---|
|
Field | Description | Example | Your Data |
|---|
Zones | SIP Port and Trunk Group reside in Zone. Each Zone represents an external customer (endpoints).
There are also a Zone(s) used for internal (Trusted) nodes. | peer core phones
accesscore | | SIP Port on Private
(Internal) side | IP address used to send and receive SIP messages to equipment on the Private side of the network | 192.168.75.10 | Included in IP Plan | SIP Port on Public side | IP address used to send and receive SIP messages to equipment on the Public side of the network | 10.35.66.189 | Included in IP Plan | Trunk Group to Server
on Trusted Private side | | CORETG | | Trunk Groups to Server
on the Un- trusted Public side | | PEERTG | | Codec Entries | One entry for each codec that could be used. Used in the PSP (below) | G711-20-RFC2833 | | Packet Service
Profiles | Used by the Trunk Group to determine the Codecs, Packet Size, Transcoding
options. Name this so that it is easy to see which options are offered. | G711-EITHER_OOB- 2833
G729AB- EITHER_OOB-2833 | | CDR Server (SFTP server) | IP address and log in information for a downstream SFTP server that will receive CDR sent by the SBC 5000 series | | | Routing Label | One for each trunk group | TO_PEER TO_CORE | | Route | Using Trunk group routing. Trunk Group CORETG routes to Routing Label TO_PEER, and PEERTG routes to TO_CORE | 2 Routes added, one for each trunk
group that routes to the other trunk group. | |
|
CLI Script Creates Trunk Group and Routes
Key fields that will change for each trunk group added:
- NEW_TRUNK - trunk group name.
- 216.37.55.90 - ip address of far end.
- CAC call limit currently 50
- rlToNEW_TRUNK - routing label to NEW_TRUNK
- peerNEW_TRUNK - ip peer NEW_TRUNK
- Numbers that route to the pbx - 7652320276 (the below script assumes that the following are already defined):
- PBX_SIP- ipsignaling profile
- pspMediaRelay - packet service profile
- "#" = comment lines
| Code Block |
|---|
|
# Start of Scrip to add a new trunk group and routing information
# CREATE trunk group
configure
set addressContext "default" zone "zonePublicTrunking" sipTrunkGroup "NEW_TRUNK" media mediaIpInterfaceGroupName "customerPublic"
set addressContext "default" zone "zonePublicTrunking" sipTrunkGroup "NEW_TRUNK" ingressIpPrefix "216.37.55.90" "32"
set addressContext "default" zone "zonePublicTrunking" sipTrunkGroup "NEW_TRUNK" policy media packetServiceProfile "pspMediaRelay"
set addressContext "default" zone "zonePublicTrunking" sipTrunkGroup "NEW_TRUNK" policy signaling ipSignalingProfile "PBX_SIP"
set addressContext "default" zone "zonePublicTrunking" sipTrunkGroup "NEW_TRUNK" signaling methods message "reject" publish "reject" subscribe "reject" notify "reject" info "reject" register "reject" update "reject"
set addressContext "default" zone "zonePublicTrunking" sipTrunkGroup "NEW_TRUNK" cac callLimit "50"
set addressContext "default" zone "zonePublicTrunking" sipTrunkGroup "NEW_TRUNK" mode inService
set addressContext "default" zone "zonePublicTrunking" sipTrunkGroup "NEW_TRUNK" state enabled
commit
# Far end IP
set addressContext "default" zone "zonePublicTrunking" ipPeer "peerNEW_TRUNK" ipAddress "216.37.55.90" ipPort "5060"
## need to add PSP and sig profile
set addressContext default zone zonePublicTrunking ipPeer peerNEW_TRUNK policy ipSignalingProfile PBX_SIP
set addressContext default zone zonePublicTrunking ipPeer peerNEW_TRUNK policy packetServiceProfile pspMediaRelay
commit
# Numbers and routing label - do a commit after each 5 number ranges added
commit
set global callRouting routingLabel "rlToNEW_TRUNK" routingLabelRoute "1" trunkGroup "NEW_TRUNK" ipPeer "peerNEW_TRUNK" commit
set global callRouting route "none" "Sonus_NULL" "Sonus_NULL" "standard" "7652320276" "1" "all" "all" "ALL" "none" "Sonus_NULL" routingLabel "rlToNEW_TRUNK"
set global callRouting route "none" "Sonus_NULL" "Sonus_NULL" "standard" "7652320277" "1" "all" "all" "ALL" "none" "Sonus_NULL" routingLabel "rlToNEW_TRUNK"
set global callRouting routingLabel "rlToNEW_TRUNK"
commit
exit
# End of Script |