The Tenor can be used to provide FXS analog capability to the
Unable to show "metadata-from": No such page "_space_variables"
(SBC), allowing for FAX connectivity. In this article, we describe the steps necessary to deploy a Tenor as an analog device in aSBC - Lync SBA topology. The overall configuration comprises three components: the Lync Server, the Tenor, and theSBC:
In this article, G.711 voice codec is used and CNG Tone Detection is disabled: When CNG detection is disabled, theSBC lets the Calling fax machine on either side, ISDN or SIP, to send CNG. However, theSBC is actively listening for and detecting the Fax Answer message that the Answering fax machine sends because Fax pass-thru is enabled.
The following diagrams depict the signaling and media flow of the Analog End Point of LYNC in this deployment.
Outbound Fax call flow using Lync call control (signaling and media)
Inbound Fax call flow using Lync call control (signaling and media)
Related Information
In this deployment, following LYNC topology entities, PBX, and numbering plans are used:
Before running the commands above, make sure that the relevant Organizational Unit(OU) (in this example it is named Analog) exists in Active Directory. On a machine that can access the Active Directory Users and Computers snap-in, launch the Active Directory Users and Computers snap-in and verify that OU is present as shown in below screenshot:
Verify OU Is Present
Launch the Lync Management Shell and run the relevant commands to create both Analog Phone and Analog Fax Endpoints as shown in below screenshot:
Launch Lync Management Shell
Verify in Active Directory Users and Computers snap-in that relevant users are created successfully in Analog Organizational Unit as shown below:
Verify Users
Explanation of New-CsAnalogDevice
The New-CsAnalogDevice cmdlet instructs Lync to route calls from the analog device to the gateway specified in the -Gateway switch of the cmdlet; thus, ensuring that Fax calls will safely be transmitted over PSTN.
Tenor configuration
Requirements for Tenor
These instructions assume that:
The Tenor gateway is running P108-09-10 or newer software release.
The Tenor Configuration Manager is CM108-19-00 or newer.
Run the Tenor Wizard
Launch the Quintum Configuration Manager and connect to your Tenor Device
Upon connecting to the device, Configuration Wizard will run automatically
Follow the Wizard Steps and enter the relevant IP addresses, Analog Endpoint numbers..etc. as shown below
Wizard Steps
For this exercise we are using DHCP for the Tenor IP address configuration
IP Address Configuration - DHCP
Enter the DNS IP address which is used in LYNC SBA Deployment Topology
IP Address Configuration - DNS
Enter DNS IP Address
Verify that IP Address Configuration is completed as shown below
Verify IP Address Configuration
Continue the wizard steps for Dial Plan Configuration
Dial Plan Country
Progress Tone Country
Verify that Dial Plan Configuration is completed as shown below
Verify Dial Plan Configuration
Continue the wizard steps for Phone Port Configuration
Phone Port Configuration
Enter the relevant Phone Number/Extension (in this example we are using 2001 and 2002 users for the Analog phone endpoints)
Enter Phone Number/Extension - 2001
Enter Phone Number/Extension - 2002
Hit on "Save/OK" and then the "Done" buttons
Add Phone Number/Extension
Configured Phone Number/Extension
Verify that Phone Port Configuration is completed as shown below
Verify Phone Port Configuration
Continue the wizard steps for Multi Path Configuration
Enable Pass Through Calls
Add Bypass Number
Error rendering macro 'panel'
com.atlassian.renderer.v2.macro.basic.validator.MacroParameterValidationException: Border style is not a valid CSS2 border-style value
Configure Bypass Number
Verify that Multi Path Configuration is completed as shown below
Verify Multi Path Configuration
Continue the wizard steps for Line Port Configuration
Line Port Configuration
Verify that Line Port Configuration is completed as shown below
Verify Line Port Configuration
Continue the wizard steps for VoIP Routing Configuration
VoIP Routing Configuration
Enter theSBC 2000 Gateway IP address in the Primary SIP Server IP/Domain Name field and the relevant Port (5060 in this case)
Enter IP Address
Enter the SIP user information for the related 2001 and 2002 users
Enter SIP User Information - 2001
Enter SIP User Information - 2002
SIP User Configuration
Verify that VoIP Routing Configuration is completed as shown below
Verify VoIP Routing Configuration
Continue the wizard steps for Idle Channel Configuration
Idle Channel Configuration
Verify that Idle Channel Configuration is completed as shown below
Verify Idle Channel Configuration
Hit on Accept button on Configuration Summary to complete the wizard run
Complete Wizard Run
Hit OK to restart the Tenor device as shown below
Restart Tenor Device
Additional Post-wizard Settings and Configuration Verrification
Verifying the SIP Signaling Group Options
Reconnect to Tenor Device using the Configuration Manager and Verify that SIP Signaling Group is configured In General Tab as shown below
Reconnect to Tenor Device
Verify that SIP Signaling Group is configured in Advanced Tab as shown below
The Transport Type must be set to UDP.
Verify SIP Signaling Group Is Configured
Verify that the Silence Suppression parameter in the IP Routing Group is disabled
Disable Silence Suppression
Verify the Tx/Rx Gain Values in the CAS Signaling Groups
Verify the following settings in Tenor:
CAS Signaling Group
Rx Gain
Tx Gain
CAS Signaling Group - Phone:
-6
0
CAS Signaling Group - Line:
6
0
Verify Tx/Rx gain values in the CAS signaling groups - Phone
CAS Signaling Group - Phone
Verify Tx/Rx gain values in the CAS signaling groups - Line
CAS Signaling Group - Line
Creating a Route For Calls From Tenor to Lync
In Configuration Manager, right click on Number Tables in left pane and select New as shown below
Create New Number Table
Create a new Number Tables to allow Analog Endpoints to be able to make calls to LYNC endpoints as wells as to PBX endpoints as shown below
Enter Number Table Information
Create an entry in the Routing Table as shown below
Routing Table Entry
Modify the default Number Table to allow incoming calls to Tenor Device as shown below
Modify Default Number Table
Verify that "Use Routing Table" option is selected in Gateway configuration field as shown below
Select Use Routing Table
Verifying Codec Selection
Ensure that the codec settings are identical with the matching codec inSBC. Use only G.711U and/or G.711A.
Verify that Voice Codec settings are configured correctly as shown below
Verify Voice Codec - 1
Verify Voice Codec - 2
Verify Supplementary Services Enabled
Tenor supports the following supplementary services - Hold/Unhold, Unattended (Blind) Transfer, and Attended (Consultative) Transfer. These features can be enabled and configured using either a Line Circuit Routing Group (LCRG) or Trunk Circuit Routing Group (TCRG). Follow the configuration steps below:
Verify that "Detect Flash Hook Signal" option is selected in CAS Signaling Group-phone > Signaling Tab
Select Detect Flash Hook Signal
Verify that "Generate Flash Hook Signal" option is selected in CAS Signaling Group-line > Signaling Tab
Select Generate Flash Hook Signal
Verify that Call Services are selected in Line Circuit Routing Group-phone > Call Services Tab
Select Call Services
Change Fax Relay from T.38 without Fallback to G.711
Make sure that Fax Relay is set to G.711.
The codec should be either G.711U or G.711A depending on your particular environment.
Enable both, Fax Relay and Fax Modem Coding:
Fax Relay: This command configures how the Tenor signals the other end to tell the peer how to switch over to the correct protocol for a fax call. When FaxRelay is set to anything other than 0, there will be a short delay in training as the Tenor determines whether the device at the other end is a fax machine or a modem
Fax Modem Coding: Enable the Fax Modem Coding configuration option if the Tenor will be used to make modem calls (remote door/elevator control). When the Tenor is configured for modem over IP calls, FaxModemCoding allows you to select which codec will be used. When FaxRelay is set to 0 (Disabled), Modem over IP (MoIP) takes over, and all fax calls will be sent as MoIP passthrough with the codec specified by the FaxModemCoding setting. When FaxRelay is set to anything other than 0, there will be a short delay in training as the Tenor determines whether the device at the other end is a fax machine or a modem.
Change Fax Relay
Configuring the Relay of Calling Name (CNAM)
The configuration of the Calling Name (CNAM) is optional. Tenor can relay CNAM in both directions Analog to SIP and SIP to Analog.
Analog to SIP
SIP to Analog
Not send CNAM
VoIP Configuration > IP Routing Groups > IP Routing Group-default > ANI > Relay Calling Name -Disabled
Circuit Configuration > Signaling Config > CAS Signaling Groups > CAS Signaling Group-phone > Relay Calling name -Disabled
Send the CNAM
Send the CNAM of each analog line as configured in the DN Channel Map:
First add the Calling Name in the channel mapping for each channel. VoIP Configuration > DN Channel Map > Calling Name -Free text
Secondly select the global default behavior. VoIP Configuration > IP Routing Group > IP Routing Group-default > ANI > Relay Calling name -Relay CNAM in INVITE
Send the CNAM from the SIP call leg. Circuit Configuration > Signaling Config > CAS Signaling Groups > CAS Signaling Group-phone > Signaling > Relay Calling Name -Relay CNAM
Send default CNAM
Send a default CNAM for all calls regardless of the Calling Name of the originating channel. VoIP Configuration > IP Routing Group > IP Routing Group-default > ANI > Relay Calling name >Relay Default CNAM> Default Calling Name -Free text
Send a default CNAM for all calls regardless of the Calling Name of the originating channel. Circuit Configuration > Signaling Config > CAS Signaling Groups > CAS Signaling Group-phone > Signaling > Relay Calling Name >Relay Default CNAM> Default Calling Name -Free text
Sample Tenor AF Configuration File
# /*<-- System Info. Do not overwrite!
# Product: Tenor AF
# IP: 134.56.105.41
# Subnet: 255.255.255.0
# Gateway: 134.56.105.1
# Software: P108-09-10
# Serial Number: A062-208A35
# DB: DB_CMS_M15_A019_V13.0.0_080109
# Updated: WED JUN 22 22:56:23 2011
# -->*/
config
table off
VOIPNetwork 1
SIte 1
TimeServer 1
set UTCOffset 0:00
set PrimaryServerIPAddr 134.56.113.11
set SecondaryServerIPAddr 128.138.140.44
DialPlan 1
set MAXDNlength 30
set MINDNlength 1
set LongDistancePrefix ""
set CarrierPrefixPattern ""
set INTernationaLPrefix[1] ""
set DialPlanCountry 255
UserProgramDialPlan 1
PRIVateNumberingPlan 1
MasterChassis 1
set Type 6
set DBVersion "DB_CMS_M15_A019_V13.0.0_080109"
set SNMPTrapCommunity "trap community"
IVRFileServer 1
SYSLogServer 1
set id "1"
CDRServer 1
set id "1"
CDRServer 2
set id "2"
set CDRServerPort 9003
new ChannelGroup phone
ChannelGroup phone
new ChannelGroup line
ChannelGroup line
NMSServer 1
DNSHosts 1
DNSServer 1
set UseConfiguredDNSServers 1
set PrimaryServerIPAddr 172.16.250.30
set SecondaryServerIPAddr 134.56.112.12
RadiusInfo UserServer
set name "User Authentication Server"
RadiusInfo EndpointServer
set name "Endpoint Authorization Server"
RadiusInfo RoutingServer
set name "External Routing Server"
DOMain 1
set Company "Quintum"
ZOne 1
GateWay 1
set Description "Tenor AF Gateway"
set OutgoingIPRouting 1
set UseRoutingTable 1
VoiceCodec 1
set name ""
set CodecVoiceCoding 9
set CodecPayloadSize 20
set ucVar2 0
VoiceCodec 2
set name ""
set CodecVoiceCoding 8
set CodecPayloadSize 20
set ucVar2 0
CodecProfile default
CASSignalingGroup phone
set id "phone"
set SignalingType 3
set FlashhookSignal 1
set ForwardDisconnectDelay 800
set CallerIDGeneration 1
set RXGain -6
set TXGain 0
CASSignalingGroup line
set id "line"
set ORientation 0
set SignalingType 3
set FlashhookSignal 1
set ForwardDisconnectDelay 500
set CallerIDDetection 1
set RXGain 6
set TXGain 0
SIPSignalingGroup 1
set PrimarySIPServer "172.16.250.246"
set AllowOnlyProxyCalls 0
set SipPstnInterworking 1
set UserAgentHeader "Quintum/1.0.0"
change 1 lp 5060
add 5061 ua 102 pu 2001 ppw 2001 c[1] 2001
add 5062 ua 103 pu 2002 ppw 2002 c[1] 2002
H323SignalingGroup 1
TrunkCircuitRoutingGroup line
set id "line"
set EndOfDialDigit #
LineCircuitRoutingGroup phone
set id "phone"
set EndOfDialDigit #
set CallWaiting 1
set HolD 1
set UnattendedTRansfer 1
set AttendedTRansfer 1
FaxProfile 1
set FaxNominalDelay 200
IPRoutingGroup default
set EndOfDialDigit #
set MediaQOSValue b0
set SignalingQOSValue b0
ToneProfile 1
set id "1"
DNChannelMap 1
add 2001 ua 102
add 2002 ch 2 ua 103
NumberTable default
set id "default"
add 2001 op 2001
add 2002 op 2002
new NumberTable ToSBC
NumberTable ToSBC
set id "ToSBC"
add 1* op 1*
add 2* op 2*
add 6* op 6*
RoutingTable 1
add LCRG-phone ot UA-101 cdnt NT-ToSBC dmc cd
GateKeeperParam 1
EndPointAddressDirectory 1
QOSPolicy 1
RouteDirectory 1
StaticRoute 1
set id "1"
table on
ChannelGroup phone
set SignalingGroupAttached CASSignalingGroup-phone
set RoutingGroupAttached LineCircuitRoutingGroup-phone
ChannelGroup line
set SignalingGroupAttached CASSignalingGroup-line
set RoutingGroupAttached TrunkCircuitRoutingGroup-line
CodecProfile default
set VoiceCodecAttached[1] VoiceCodec-1
set VoiceCodecAttached[2] VoiceCodec-2
TrunkCircuitRoutingGroup line
LineCircuitRoutingGroup phone
IPRoutingGroup default
set CodecProfileAttached CodecProfile-default
StaticRoute 1
set IPRoutingGroupAttached IPRoutingGroup-default
# DO NOT TOUCH: Integrity Checked!
# /*<-- System Info. Do not overwrite!
# Product: Tenor AF
# IP: 10.0.0.164
# Subnet: 255.255.255.0
# Gateway: 10.0.0.1
# Software: P107-09-10
# Serial Number: A062-999999
# DB: DB_CMS_M14_A018_V12.0.0_121107
# Updated: SAT JUN 25 20:32:46 2011
# -->*/
config
table off
VOIPNetwork 1
SIte 1
TimeServer 1
set UTCOffset 0:00
set PrimaryServerIPAddr 10.0.0.10
set SecondaryServerIPAddr 10.0.2.10
DialPlan 1
set MAXDNlength 30
set MINDNlength 1
set LongDistancePrefix ""
set CarrierPrefixPattern ""
set INTernationaLPrefix[1] ""
set DialPlanCountry 255
set ProgressToneCountry 6
UserProgramDialPlan 1
IPDialPlan default
PRIVateNumberingPlan 1
MasterChassis 1
set Type 6
set DBVersion "DB_CMS_M14_A018_V12.0.0_121107"
set SNMPTrapCommunity "trap community"
IVRFileServer 1
SYSLogServer 1
set id "1"
CDRServer 1
set id "1"
CDRServer 2
set id "2"
set CDRServerPort 9003
new ChannelGroup phone
ChannelGroup phone
NMSServer 1
DNSHosts 1
DNSServer 1
set PrimaryServerIPAddr 10.0.0.10
set SecondaryServerIPAddr 10.0.2.10
RadiusInfo UserServer
set name "User Authentication Server"
RadiusInfo EndpointServer
set name "Endpoint Authorization Server"
RadiusInfo RoutingServer
set name "External Routing Server"
DOMain 1
set Company "Quintum"
ZOne 1
GateWay 1
set Description "Tenor AF Gateway"
set OutgoingIPRouting 1
NumberDirectories 1
BypassNumberDirectory 1
set id "1"
HuntLDNDirectory pub1
set id "pub1"
HuntLDNDirectory prv1
set id "prv1"
set LDNType 1
CallerIDXlationDirectory 1
set id "1"
InboundDNISXlationDirectory 1
set id "1"
HopoffNumberDirectory 1
set id "1"
VoiceCodec 1
set name "G711A"
set CodecVoiceCoding 8
set CodecPayloadSize 20
set ucVar2 0
VoiceCodec 2
set name "G711U"
set CodecVoiceCoding 9
set CodecPayloadSize 20
set ucVar2 0
CodecProfile default
CASSignalingGroup phone
set id "phone"
set SignalingType 3
set ForwardDisconnectDelay 800
set CallerIDGeneration 1
set RXGain -6
set TXGain 0
CASSignalingGroup line
set id "line"
set ORientation 0
set ForwardDisconnectDelay 500
set RXGain 6
set TXGain 0
SIPSignalingGroup 1
set PrimarySIPServer "172.23.197.30"
set AllowOnlyProxyCalls 0
set UserAgentHeader "Quintum/1.0.0"
change 1 lp 5060 pu 200829 ppw 200829 c[1] 200829
add 5061 ua 102 pu 200827 ppw 200827 c[1] 200827
H323SignalingGroup 1
TrunkCircuitRoutingGroup line
set id "line"
set EndOfDialDigit #
LineCircuitRoutingGroup phone
set id "phone"
set EndOfDialDigit #
set ModemBypass 1
FaxProfile 1
set FaxNominalDelay 200
IPRoutingGroup default
set EndOfDialDigit #
set MediaQOSValue b0
set FaxRelay 3
set SignalingQOSValue b0
ToneProfile 1
set id "1"
DNChannelMap 1
add 200829 ua 101
add 200827 ch 2 ua 102
GateKeeperParam 1
EndPointAddressDirectory 1
QOSPolicy 1
RouteDirectory 1
StaticRoute 1
set id "1"
table on
ChannelGroup phone
set SignalingGroupAttached CASSignalingGroup-phone
set RoutingGroupAttached LineCircuitRoutingGroup-phone
CodecProfile default
set VoiceCodecAttached[1] VoiceCodec-1
set VoiceCodecAttached[2] VoiceCodec-2
TrunkCircuitRoutingGroup line
set HopoffNumberDirAttached[1] HopoffNumberDirectory-1
LineCircuitRoutingGroup phone
set BypassNumberDirAttached[1] BypassNumberDirectory-1
set PUBHuntLdnDirAttached[1] HuntLDNDirectory-pub1
set PRIVHuntLdnDirAttached[1] HuntLDNDirectory-prv1
IPRoutingGroup default
set CodecProfileAttached CodecProfile-default
set IPDialPlanAttached IPDialPlan-default
StaticRoute 1
set IPRoutingGroupAttached IPRoutingGroup-default
# DO NOT TOUCH: Integrity Checked!
Sonus SBC 1000/2000 configuration
Requirements and Prerequisites
This document assumes thatSBC Lync 2010 wizard was ran prior to the configuration
Running the Lync 2010 wizard will ensure SRTP towards Lync is set to Required
Media bypass must be enabled in Lync
SIP Registrar Table
Browse toSBC 2000 WebUI > Settings Tab > SIP / Local Registrars (in left pane)
Click on Add button and add a SIP Local Registrar Entry as shown below
Add SIP Local Registrar Entry
Media List Configuration
Browse toSBC 2000 WebUI > Settings Tab > Media List (in left pane)
Click on Add button and add a Media List Entry as shown below
Make sure to have following settings are configured in Tenor Media List:
CNG
Disabled
Fax passthru
Enabled
Modem Passthru
Enabled
Silence Suppression
Enabled
Rx/Tx Gain
0
Add Media List
Translation Table
Browse toSBC 2000 WebUI > Settings Tab > Translation (in left pane)
Click on Add button and add a Translation Table with following entry as shown below
Add Translation Table
Signaling Group (uses UDP only)
Browse toSBC 2000 WebUI > Settings Tab > Signaling Groups (in left pane)
Click on Add SIP SG button and add a SIP Signaling Group for Tenor Device connectivity as shown below
Add SIP Signaling Group
Call Routing Table
Browse toSBC 2000 WebUI > Settings Tab > Call Routing Table (in left pane)
Click on SIP to ISDN Call Route Table and hit Add button to add an entry to route calls to Tenor (for those with 2xxx extension in this example)
Add Entry to Route Calls
Re-sequence the Call Route entries in this table to make sure that calls to 2xxx extensions (Analog Endpoints) will use the entry that you just created in previous step
Re-sequence Call Route Entry
Troubleshooting Techniques
Troubleshooting FAX Calls Between the Tenor and PSTN
If you are getting comm errors on the Fax machine, check the following resources for solutions:
error codes 242,346,321,344,388,283 - The first 2 settings you want to change are the error correction (ECM) and v.34 these are on by default you would want these off.
If faxes are failing, check the E1 port counters for slips and frame errors.
Screenshot of E1 Line
The frame errors and the slips counters must notbe increasing. You can check if they are increasing by resetting the counters. If the errors are increasing, the issue could be caused by one of the following:
System timing / clocking. Check the clock source (System -> System Timing) - it should be set to Network/T1/E1 port and not System/Free run. If the clock source is set to Network, but the Current Active Clock shows as Free run, click Apply and ensure that Current Active Clock is now set to Primary. This should resolve the clocking issue as long as the error counters do not increase.
If the Tenor is not configured to register with theSBC local SIP registrar and the SIP Signaling group inSBC constantly goes down, check the contents of the var_config.cfg file (from Tenor Config Manager -> Tools -> Var_config -> Edit) and delete the line specifying the transport protocol as in P108 it is obsolete.
Bad E1 cable. Replace the cable.
Faulty RJ45 jacks. Replace the cable or fix the Rj45 jacks.
Faulty RJ45 socket. Try configuring a different T1/E1 port. Visually check the pins in the E1/T1 ports for any differences.