IP Telephony
Cisco Public
Call legs are logical connections between any two telephony devices, such as gateways, routers,
Cisco CallManagers, or telephony endpoint devices.
Call legs are router-centric. When an inbound call arrives, it is processed separately until the
destination is determined. Then a second outbound call leg is established, and the inbound call
leg is switched to the outbound voice port.
4-4
End-to-End Calls
This topic explains how routers interpret call legs to establish end-to-end calls.
End-to-End Calls
IP Telephony
Cisco Public
An end-to-end voice call consists of four call legs: two from the originating router (R1) or
gateway perspective, and two from the terminating router (R2) or gateway perspective. An
inbound call leg originates when an incoming call comes into the router or gateway. An
outbound call leg originates when a call is placed from the router or gateway.
A call is segmented into call legs and a dial peer is associated with each call leg. The process
for call setup is listed below:
1. The plain old telephone service (POTS) call arrives at R1 and an inbound POTS dial peer is
matched.
2. After associating the incoming call to an inbound POTS dial peer, R1 creates an inbound
POTS call leg and assigns it a Call ID (call leg 1).
3. R1 uses the dialed string to match an outbound voice network dial peer.
4. After associating the dialed string to an outbound voice network dial peer, R1 creates an
outbound voice network call leg and assigns it a Call ID (call leg 2).
5. The voice network call request arrives at R2 and an inbound voice network dial peer is
matched.
6. After R2 associates the incoming call to an inbound voice network dial peer, R2 creates the
inbound voice network call leg and assigns it a Call ID (call leg 3). At this point, both R1
and R2 negotiate voice network capabilities and applications, if required.
Copyright 2005, Cisco Systems, IncVoice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Dialer Peers
4-5
When the originating router or gateway requests nondefault capabilities or applications, the
terminating router or gateway must match an inbound voice network dial peer that is
configured for such capabilities or applications.
7. R2 uses the dialed string to match an outbound POTS dial peer.
8. After associating the incoming call setup with an outbound POTS dial peer, R2 creates an
outbound POTS call leg, assigns it a Call ID, and completes the call (call leg 4).
4-6
IP Telephony
Cisco Public
123
dial-peer
dial-peer cor
cor custom
custom
name
name class-name
class-name
IP Telephony
4-174
Cisco Public
124
Step 1
dial-peer
dial-peer cor
cor list
list list-name
list-name
member
member class-name
class-name
IP Telephony
Cisco Public
125
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Analog
4-175
Step 2
Dial peer COR list and member commands set the capabilities of a COR list. COR list is used
in dial peers to indicate the restriction that a dial peer has as an outgoing dial peer. The order of
entering the members is not important and the list can be appended or made shorter by
removing the members.
dial-peer
dial-peer voice
voice number
number {pots
{pots || voip}
voip}
corlist
corlist {incoming
{incoming || outgoing}
outgoing} list-name
list-name
IP Telephony
4-176
Cisco Public
126
Step 3
Apply the incoming or outgoing COR list to the dial peer. The incoming COR list specifies the
capacity of dial-peer to initiate a certain series or Class of Calls. The outgoing COR list
specifies the restriction on dial peers able to place calls to a given number range or port.
ephone-dn
ephone-dn tag
tag
cor
cor {incoming
{incoming || outgoing}
outgoing} list-name
list-name
Cisco Public
127
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Analog
4-177
Step 4
Apply the incoming or outgoing COR list to an ephone-dn. The Incoming COR list specifies
the capacity of ephone-dn to initiate a certain series or Class of Calls. The outgoing COR list
specifies the restriction on the ephone-dn to be able to place calls to a given number range or
port.
4-178
name 2xxx
dial-peer cor list Executive
member 1xxx
member 2xxx
dial-peer cor list Employee
member 1xxx
ephone-dn 1
number 1000
cor incoming Employee
ephone-dn 2
number 2000
cor outgoing Executives
IP Telephony
Ephone-dn 1
Employee
Ephone-dn 2
Executive
Ext 1000
Ext 2000
Cisco Public
128
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Analog
4-179
Cisco Public
129
911
name 911
name local
name long_distance
name international
local
long_distance
name 900
international
900
Step 1 - Define the classes of restriction
IP Telephony
Step 1
4-180
Cisco Public
130
member 911
member 911
member local
member 911
member local
dial-peer cor list Sales
member 911
member international
member local
member long_distance
dial-peer cor list Executive
member 911
member local
member long_distance
member international
Step 2
Cisco Public
IP Telephony
131
The second step will be to define the COR list and its member or members. Notice that none of
the COR lists contain the member 900.
Step 3
port 1/0/0
corlist outgoing call900
Cisco Public
132
Assign the COR to the dial peers that govern PSTN access. To restrict calls to the PSTN
destinations, the outbound COR setting will be defined.
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Analog
4-181
Note
Although not shown here, the inbound COR can be set to regulate where calls arriving from
the PSTN will be allowed to connect internally.
number 1001
cor incoming Lobby
ephone-dn 2
Ephone-dn 2
COR in Employee
Ext 1002
number 1002
cor incoming Employee
ephone-dn 3
Ephone-dn 3
COR in Sales
Ext 1003
Ephone-dn 4
COR in Executive
Ext 1004
IP Telephony
Step 4
4-182
number 1003
cor incoming Sales
ephone-dn 4
number 1004
cor incoming Executive
Cisco Public
133
Assign the incoming COR to the Lobby, Employee, Sales, and Executive ephone-dns. Notice
that no ephone-dn has the ability to call 900 numbers.
IP Telephony
Ephone-dn 1
COR in Lobby
Ext 1001
Ephone-dn 2
COR in Employee
Ext 1002
Ephone-dn 3
COR in Sales
Ext 1003
Ephone-dn 4
COR in Executive
Ext 1004
Cisco Public
134
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Analog
4-183
IP Telephony
Cisco Public
When a call is placed, an edge device generates dialed digits as a way of signaling where the
call should terminate. When these digits enter a router voice port, the router must have a way to
decide whether the call can be routed, and where the call can be sent. The router does this by
looking through a list of dial peers.
A dial peer is an addressable call endpoint. The address is called a destination pattern and is
configured in every dial peer. Destination patterns can point to one telephone number only or to
a range of telephone numbers. Destination patterns use both explicit digits and wildcard
variables to define a telephone number or range of numbers.
The router uses dial peers to establish logical connections. These logical connections, known as
call legs, are established in either an inbound or outbound direction.
Dial peers define the parameters for the calls that they match; for example, if a call is
originating and terminating at the same site, and is not crossing through slow-speed WAN
links, then the call can cross the local network uncompressed and without special priority. A
call that originates locally and crosses the WAN link to a remote site may require compression
with a specific coder-decoder (codec). In addition, this call may require that voice activity
detection (VAD) be turned on, and will need to receive preferential treatment by specifying a
higher priority level.
Copyright 2005, Cisco Systems, IncVoice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Dialer Peers
4-7
POTS dial peers: Connect to a traditional telephony network, such as the public switched
telephone network (PSTN) or a PBX, or to a telephony edge device such as a telephone or
fax machine. POTS dial peers perform these functions:
Provide an address (telephone number or range of numbers) for the edge network
or device
Point to the specific voice port that connects the edge network or device
VoIP dial peers: Connect over a packet network. VoIP dial peers perform these functions:
Provide a destination address (telephone number or range of numbers) for the edge
device that is located across the network
Associate the destination address with the next-hop router or destination router,
depending on the technology used
Dial Peer
IP Telephony
Cisco Public
In the figure, the telephony device connects to the Cisco Systems voice-enabled router. The
POTS dial-peer configuration includes the telephone number of the telephony device and the
voice port to which it is attached. The router knows where to forward incoming calls for that
telephone number.
The Cisco voice-enabled router VoIP dial peer is connected to the packet network. The VoIP
dial-peer configuration includes the destination telephone number (or range of numbers) and
the next-hop or destination voice-enabled router network address.
Follow these steps to place a VoIP call:
4-8
Action
1.
Configure the source router with a compatible dial peer that specifies the recipient destination
address.
2.
Configure the recipient router with a POTS dial peer that specifies which voice port the router
uses to forward the voice call.
Copyright 2005, Cisco Systems, IncVoice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Dialer Peers
4-9
IP Telephony
Cisco Public
Before the configuration of Cisco IOS dial peers can begin, the user must have a good
understanding of where the edge devices reside, what type of connections need to be made
between these devices, and what telephone numbering scheme is applied to the devices.
Follow these steps to configure POTS dial peers:
How to Configure POTS Dial Peers
Step
Action
1.
Configure a POTS dial peer at each router or gateway where edge telephony devices connect
to the network.
2.
Use the destination-pattern command in the dial peer to configure the telephone number.
3.
Use the port command to specify the physical voice port that the POTS telephone is
connected to.
The dial-peer type will be specified as POTS because the edge device is directly connected to a
voice port and the signaling must be sent from this port to reach the device. There are two basic
parameters that need to be specified for the device: the telephone number and the voice port.
When a PBX is connecting to the voice port, a range of telephone numbers can be specified.
4-10
Copyright 2005, Cisco Systems, IncVoice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Dialer Peers
4-11
Practice Item 1:
POTS Dial-Peer Configuration
IP Telephony
Cisco Public
R1
________________________
________________________
________________________
4-12
R2
________________________
________________________
________________________
________________________
________________________
________________________
________________________
________________________
________________________
Copyright 2005, Cisco Systems, IncVoice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Dialer Peers
4-13
Practice Item 1:
POTS Dial-Peer Configuration
IP Telephony
Cisco Public
The administrator must know how to identify the far-end voice-enabled device that will
terminate the call. In a small network environment, the device may be the IP address of the
remote device. In a large environment, identifying the device may mean pointing to a Cisco
CallManager or gatekeeper for address resolution and Call Admission Control (CAC) to
complete the call.
You must follow these steps to configure VoIP dial peers:
How to Configure VoIP Dial Peers
Step
Action
1.
2.
3.
4.
Use the session target command to specify an IP address of the terminating router or
gateway.
5.
The dial peer is specified as a VoIP dial peer, which alerts the router that it must process a call
according to the various parameters that are specified in the dial peer. The dial peer must then
package it as an IP packet for transport across the network. Specified parameters may include
the codec used for compression (VAD, for example), or marking the packet for priority service.
4-14
The destination-pattern parameter configured for this dial peer is typically a range of numbers
that are reachable via the remote router or gateway.
Because this dial peer points to a device across the network, the router needs a destination IP
address to put in the IP packet. The session target parameter allows the administrator to
specify either an IP address of the terminating router or gateway, or another device; for
example, a gatekeeper or Cisco CallManager that can return an IP address of that remote
terminating device.
To determine which IP address a dial peer should point to, it is recommended that you use a
loopback address. The loopback address is always up on a router, as long as the router is
powered on and the interface is not administratively shut down. If an interface IP address is
used instead of the loopback, and that interface goes down, the call will fail even if there is an
alternate path to the router.
Copyright 2005, Cisco Systems, IncVoice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Dialer Peers
4-15
Practice Item 2:
VoIP Dial-Peer Configuration
IP Telephony
Cisco Public
11
R1
______________________
______________________
______________________
R2
______________________
______________________
______________________
4-16
IP Telephony
Cisco Public
12
The destination pattern associates a telephone number with a given dial peer. The destination
pattern also determines the dialed digits that the router collects and forwards to the remote
telephony interface, such as a PBX, Cisco CallManager, or the PSTN. You must configure a
destination pattern for each POTS and VoIP dial peer that you define on the router.
The destination pattern can indicate a complete telephone number, a partial telephone number
with wildcard digits, or it can point to a range of numbers defined in a variety of ways.
Destination-pattern options include the following:
Plus sign (+): An optional character that indicates an E.164 standard number. E.164 is the
International Telecommunication Union Telecommunication Standardization Sector (ITUT) recommendation for the international public telecommunication numbering plan. The
plus sign in front of a destination-pattern string specifies that the string must conform to
E.164.
string: A series of digits specifying the E.164 or private dial-plan telephone number. The
examples below show the use of special characters that are often found in destination
pattern strings:
An asterisk (*) and pound sign (#) appear on standard touch-tone dial pads. These
characters may need to be used when passing a call to an automated application that
requires these characters to signal the use of a special feature. For example, when
calling an interactive voice response (IVR) system that requires a code for access,
the number dialed might be 5551212888#, which would initially dial the
telephone number 5551212 and input a code of 888 followed by the pound key
to terminate the IVR input query.
Copyright 2005, Cisco Systems, IncVoice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Dialer Peers
4-17
A comma (,) inserts a one-second pause between digits. The comma can be used, for
example, where a 9 is dialed to signal a PBX that the call should be processed by
the PSTN. The 9 is followed by a comma to give the PBX time to open a call path
to the PSTN, after which the remaining digits will be played out. An example of this
string is 9,5551212.
A period (.) matches any single entered digit from 0 to 9, and is used as a wildcard.
The wildcard can be used to specify a group of numbers that may be accessible via a
single destination router, gateway, PBX, or Cisco CallManager. A pattern of 200.
allows for ten uniquely addressed devices, while a pattern of 20.. can point to 100
devices. If one site has the numbers 2000 through 2049, and another site has the
numbers 2050 through 2099, then the bracket notation would be more efficient.
When the calling party finishes entering dialed digits, there is a pause equal to the interdigit
timeout value before the router processes the call. The calling party can immediately terminate
the interdigit timeout by entering the pound character (#), which is the default termination
character. Because the default interdigit timer is set to 10 seconds, users may experience a long
call setup delay.
Note
4-18
Cisco IOS software does not check the validity of the E.164 telephone number. It accepts
any series of digits as a valid number.
5550124
55501[1-3].
Matches a seven-digit telephone number where the first five digits are 55501,
the sixth digit can be a 1, 2, or 3, and the last digit can be any valid digit.
This type of destination pattern is used when telephone number ranges are
assigned to specific sites. In this example, the destination pattern is used in a
small site that does not need more than 30 numbers assigned.
.T
Matches any telephone number that has at least one digit and can vary in
length from 1 to 32 digits total.
This destination pattern is used for a dial peer that services a variable-length
dial plan, such as local, national, and international calls. It can also be used as
a default destination pattern so that any calls that do not match a more specific
pattern will match this pattern and can be directed to an operator.
Copyright 2005, Cisco Systems, IncVoice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Dialer Peers
4-19
IP Telephony
Cisco Public
13
When a matching inbound dial peer is not found, the router resorts to the default dial peer.
Note
Default dial peers are used for inbound matches only. They are not used to match outbound
calls that do not have a dial peer configured.
4-20
There is an exception to the previous statement. Cisco voice and dial platforms, such as the
AS53xx and AS5800, require that a configured inbound dial peer be matched for incoming
POTS calls to be accepted as voice calls. If there is no inbound dial-peer match, the call is
treated and processed as a dialup (modem) call.
Dial peer 0 for inbound VoIP peers has the following configuration:
any codec
ip precedence 0
vad enabled
no rsvp support
fax-rate service
Dial peer 0 for inbound POTS peers has the following configuration:
no ivr application
You cannot change the default configuration for dial peer 0. Default dial peer 0 fails to
negotiate nondefault capabilities or services. When the default dial peer is matched on a VoIP
call, the call leg that is set up in the inbound direction uses any supported codec for voice
compression, based on the requested codec capability coming from the source router. When a
default dial peer is matched, the voice path in one direction may have different parameters than
the voice in the return direction. This may cause one side of the connection to report goodquality voice while the other side reports poor-quality voice; for example, the outbound dial
peer has VAD disabled, but the inbound call leg is matched against the default dial peer, which
has VAD enabled. In this example, VAD is on in one direction and off in the return direction.
When the default dial peer is matched on an inbound POTS call leg, there is no default IVR
application with the port. As a result, the user gets a dial tone and proceeds with dialed digits.
Copyright 2005, Cisco Systems, IncVoice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Dialer Peers
4-21
IP Telephony
Cisco Public
13
When determining how inbound dial peers are matched on a router, it is important to note
whether the inbound call leg is matched to a POTS or VoIP dial peer. Matching occurs in the
following manner:
Inbound POTS dial peers are associated with the incoming POTS call legs of the
originating router or gateway.
Inbound VoIP dial peers are associated with the incoming VoIP call legs of the terminating
router or gateway.
Three information elements sent in the call setup message are matched against four
configurable dial-peer command attributes.
4-22
Description
This is the call-destination dial string, and it is derived from the ISDN
setup message or channel associated signaling Dialed Number
Identification Service (DNIS).
This is a number string that represents the origin, and it is derived from
the ISDN setup message or channel associated signaling (CAS)
automatic number identification (ANI). The ANI is also referred to as
the calling line ID.
Voice Port
When the Cisco IOS router or gateway receives a call setup request, it makes a dial-peer match
for the incoming call. This is not digit-by-digit matching; instead, the router uses the full digit
string received in the setup request for matching against the configured dial peers.
The router or gateway matches call setup element parameters in the following order:
How the Router or Gateway Matches Inbound Dial Peers
Step
Action
1.
The router or gateway attempts to match the called number of the call setup request with the
configured incoming called-number of each dial peer.
2.
If a match is not found, the router or gateway attempts to match the calling number of the call
setup request with answer-address of each dial peer.
3.
If a match is not found, the router or gateway attempts to match the calling number of the call
setup request to the destination-pattern of each dial peer.
4.
The voice port uses the voice port number associated with the incoming call setup request to
match the inbound call leg to the configured dial peer port parameter.
5.
If multiple dial peers have the same port configured, then the router or gateway matches the
first dial peer added to the configuration.
6.
If a match is not found in the previous steps, then the default is dial peer 0.
Because call setups always include DNIS information, it is recommended that you use the
incoming called-number command for inbound dial-peer matching. Configuring incoming
called-number is useful for a company that has a central call center providing support for a
number of different products. Purchasers of each product get a unique 1-800 number to call for
support. All support calls are routed to the same trunk group destined for the call center. When
a call comes in, the computer telephony system uses the DNIS to flash the appropriate message
on the computer screen of the agent to whom the call is routed. The agent will then know how
to customize the greeting when answering the call.
The calling number ANI with answer-address is useful when you want to match calls based on
the originating calling number. For example, when a company has international customers who
require foreign-language-speaking agents to answer the call, the call can be routed to the
appropriate agent based on the country of call origin.
Copyright 2005, Cisco Systems, IncVoice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Dialer Peers
4-23
You must use the calling number ANI with destination-pattern when the dial peers are set up
for two-way calling. In a corporate environment, the head office and the remote sites must be
connected. As long as each site has a VoIP dial peer configured to point to each site, inbound
calls from the remote site will match against that dial peer.
4-24
Practice Item 3:
Matching Inbound Dial Peers
IP Telephony
Cisco Public
15
R1
_______________________
_______________________
_______________________
_______________________
_______________________
_______________________
_______________________
_______________________
_______________________
Copyright 2005, Cisco Systems, IncVoice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Dialer Peers
4-25
Cisco Public
IP Telephony
16
Action
1.
The router or gateway uses the dial peer destination-pattern command to determine how to
route the call.
2.
3.
On VoIP dial peers, the session target command forwards the call.
Use the show dialplan number string command to determine which dial peer is matched to a
specific dialed string. This command displays all matching dial peers in the order that they are
used.
5550124 is dialed, dial peers 1, 3, and 4 all match that number, but dial peer 4 places that call
because it has the most specific destination pattern.
Copyright 2005, Cisco Systems, IncVoice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Dialer Peers
4-27
Hunt-Group Commands
This topic describes hunt-group commands.
Hunt-Group Configuration
IP Telephony
Cisco Public
18
Cisco voice-enabled routers support the concept of hunt groups, sometimes called rotary
groups, in which multiple dial peers are configured with the same destination pattern. Because
the destination of each POTS dial peer is a single voice port to a telephony interface, hunt
groups help ensure that calls get through even when a specific voice port is busy. If the router is
configured to hunt, it can forward a call to another voice port when one voice port is busy.
The following is a list of hunt-group commands:
preference: Sets priority for dial peers. The destination with the lowest setting has the
highest priority.
dial-peer hunt: Changes the default selection order for hunting through dial peers.
You can also use the following command to view dial-peer hunt current settings:
4-28
show dial-peer voice summary: Shows the current settings for dial-peer hunt.
Hunt-Group Configuration
IP Telephony
Cisco Public
18
In some business environments, such as call centers or sales departments, there may be a group
of agents available to answer calls coming in to a single number. Scenario 1 may randomly
distribute the calls between all agents. Scenario 2 may send calls to the senior agents first, and
send calls to the junior agents only when all senior agents are busy. Both of these scenarios can
be serviced by configuring a hunt group with specific commands to control the hunt actions.
Follow these steps to configure hunt groups:
How to Configure Hunt Groups
Step
Action
1.
2.
3.
Use the preference command if the destination pattern of the dial peer is the same for several
dial peers.
4.
If the preference does not act as the tiebreaker, then the router picks the matching dial peer
randomly.
You must use the dial-peer hunt global configuration command to change the default selection
order of the procedure or to choose different methods for hunting through dial peers. To view
the current setting for dial-peer hunt, use the show dial-peer voice summary command.
Copyright 2005, Cisco Systems, IncVoice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Dialer Peers
4-29
If the desired action is not hunting through a range of dial peers, the huntstop command
disables dial-peer hunting on the dial peer. After you enter this command, no further hunting is
allowed if a call fails on the selected dial peer. This is useful in situations where it is
undesirable to hunt to a less-specific dial peer if the more specific call fails; for example, if a
call is destined for a particular staff member and the person is on the phone, the router searches
for any other dial peer that may match the dialed number. If there is a more generic destination
pattern in another dial peer that also matches, the call is routed to the generic destination
pattern. If this is not the desired action, then configuring the huntstop command in the more
specific dial peer will send the caller a busy signal.
You can mix POTS and VoIP dial peers when creating hunt groups. This is useful if you want
incoming calls sent over the packet network; however, if that network connectivity fails, you
want to reroute the calls back through the PBX, or through the router, to the PSTN.
By default, the router selects dial peers in a hunt group according to the following criteria, in
the order listed:
How the Router Selects Dial Peers in a Hunt Group
Step
Action
1.
2.
3.
The destination pattern that matches the greatest number of dialed digits is the first dial peer
selected by the router. For example, if one dial peer is configured with a dial string of 345.
and a second dial peer is configured with 3456789, the router selects 3456789 first because
it has the longest explicit match of the two dial peers. Without a PBX, if the line is currently in
use, the desired action is to send a call to a voice-mail system or a secretary, instead of giving
the caller a busy signal.
If the destination pattern is the same for several dial peers, you can configure the priority by
using the preference dial-peer command. You would use the preference command to
configure service for scenario 2, where the dial peers connecting to the senior agents would
have the preference 0 and the dial peers connecting to the junior agents would have the
preference 1. The lower the preference setting, the higher the priority for that dial peer to
handle the call.
If all destination patterns are equal, by default, the preference is set to 0 on all dial peers. If the
preference does not act as the tiebreaker, then a dial peer matching the called number will be
picked randomly. This configuration would service scenario 1.
4-30
Hunt-Group Configuration
IP Telephony
Cisco Public
18
Copyright 2005, Cisco Systems, IncVoice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Dialer Peers
4-31
Practice Item 4:
Configuring Hunt Groups
IP Telephony
Cisco Public
19
IP Telephony
Cisco Public
20
Use the no digit-strip command to disable the automatic digit-stripping function. This allows
the router to match digits and pass them to the telephony interface.
By default, when the terminating router matches a dial string to an outbound POTS dial peer,
the router strips off the left-justified digits that explicitly match the destination pattern. The
remaining digits, or wildcard digits, are forwarded to the telephony interface, which connects
devices such as a PBX or the PSTN.
Digit stripping is the desired action in some situations. There is no need to forward digits out of
a POTS dial peer if it is pointing to a Foreign Exchange Station (FXS) port that connects a
telephone or fax machine. If digit stripping is turned off on this type of port, the user may hear
tones after answering the call because any unconsumed and unmatched digits are passed
through the voice path after the call is answered.
In other situations, where a PBX or the PSTN is connected through the POTS dial peer, digit
stripping is not desired because these devices need additional digits to further direct the call. In
these situations, the administrator must assess the number of digits that need to be forwarded
for the remote device to correctly process the call. With a VoIP dial peer, all digits are passed
across the network to the terminating voice-enabled router.
Copyright 2005, Cisco Systems, IncVoice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Dialer Peers
4-33
Digit Collection
IP Telephony
Cisco Public
21
When a voice call enters the network, the router collects digits as follows:
How the Router Collects Digits
Step
Action
1.
The originating router collects dialed digits until it matches an outbound dial peer.
2.
The router immediately places the call and forwards the associated dial string.
3.
4-34
Destination Pattern
5550124
5550124
5550124
555.
5550124
5550124
555
555
5550124
555T
5550124
In the first row of the table, the destination pattern specifies a seven-digit string. The first digit
must be a five, and the remaining six digits can be any valid digits. All seven digits must be
entered before the destination pattern is matched.
In the second row, the destination pattern specifies a seven-digit string. The first three digits
must be 555, and the remaining four digits can be any valid digits. All seven digits must be
entered before the destination pattern is matched.
In the third row, the destination pattern specifies a three-digit string. The dialed digits must be
exactly 555. When the user begins to dial the seven-digit number, the destination pattern
matches after the first three digits are entered. The router then stops collecting digits and places
the call. If the call is set up quickly, the answering party at the other end may hear the
remaining four digits as the user finishes dialing the string. After a call is set up, any dual tone
multifrequency (DTMF) tones are sent through the voice path and played out at the other end.
In the last row, the destination pattern specifies a variable-length digit string that is at least
three digits long. The first three digits must be exactly 555, and the remaining digits can be any
valid digits. The T tells the router to continue collecting digits until the interdigit timer
expires. The router stops collecting digits when the timer expires, or when the user presses the
pound (#) key.
Copyright 2005, Cisco Systems, IncVoice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Dialer Peers
4-35
forward-digits
Dial-peer command
Controls the number of digits forwarded to the telephony interface
num-exp
Global command
Expands an extension into a full telephone number or replaces
one number with another
translation-rule
Global and dial-peer command
Digit translation rules used to manipulate the calling number digits,
or ANI, or the called number digits, or DNIS, for a voice call
IP Telephony
Cisco Public
22
Digit manipulation is the task of adding or subtracting digits from the original dialed number to
accommodate user dialing habits or gateway needs. The digits can be manipulated before
matching an inbound or outbound dial peer. The following is a list of digit manipulation
commands and their uses:
4-36
prefix: This dial-peer command adds digits to the front of the dial string before it is
forwarded to the telephony interface. This occurs after the outbound dial peer is matched,
but before digits get sent out of the telephony interface. Use the prefix command when the
dialed digits leaving the router must be changed from the dialed digits that had originally
matched the dial peer; for example, a call is dialed using a four-digit extension such as
0123, but the call needs to be routed to the PSTN, which requires ten-digit dialing. If the
four-digit extension matches the last four digits of the actual PSTN telephone number, then
you can use the prefix 902555 command to prepend the six additional digits needed for the
PSTN to route the call to 902-555-0123. After the POTS dial peer is matched with the
destination pattern of 0123, the prefix command prepends the additional digits, and the
string 9025550123 is sent out of the voice port to the PSTN.
forward-digits: This dial-peer command specifies the number of digits that must be
forwarded to the telephony interface, regardless of whether they are explicitly matched or
wildcard matched. This command occurs after the outbound dial peer is matched, but
before the digits are sent out of the telephony interface. When a specific number of digits
are configured for forwarding, the count is right justified. For example, if the POTS dial
peer has a destination pattern configured to match all extensions in the 1000 range
(destination-pattern 1), by default, only the last three digits are forwarded to the PBX
that is connected to the specified voice port. If the PBX needs all four digits to route the
call, you must use the command forward-digits 4, or forward-digits all, so that the
appropriate number of digits are forwarded. To restore the forward-digits command to its
default setting, use the default forward-digits command. Using the no forward-digits
command specifies that no digits are to be forwarded.
num-exp: The num-exp global command expands an extension into a full telephone
number or replaces one number with another. The number expansion table manipulates the
called number. This command occurs before the outbound dial peer is matched; therefore,
you must configure a dial peer with the expanded number in the destination pattern for the
call to go through. The number expansion table is useful, for example, where the PSTN
changes the dialing requirements from seven-digit dialing to ten-digit dialing. In this
scenario, you can do one of the following:
Make all the users dial all ten digits to match the new POTS dial peer that is pointing
to the PSTN.
Allow the users to continue dialing the seven-digit number as they have before, but
expand the number to include the area code before the ten-digit outbound dial peer is
matched.
Note
You must use the show num-exp command to view the configured number-expansion
table. You must use the show dialplan number number command to confirm the presence
of a valid dial peer to match the newly expanded number.
You can also use translation rules to change the numbering type for a call. For example, some
gateways may tag a number with more than 11 digits as an international number, even when the
user must dial 9 to reach an outside line. In this case, the number that is tagged as an
international number needs to be translated into a national numberwithout the 9before it is
sent to the PSTN.
As illustrated in this topic, there are numerous ways to manipulate digits at various stages of
call completion. The administrator needs to determine which command will be most suitable
and the requirements that are necessary for manipulation.
Note
To test configured translation rules, you must use the test translation command.
Copyright 2005, Cisco Systems, IncVoice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Dialer Peers
4-37
In the sample configuration using the prefix command, the device attached to port 1/0/0 needs
all seven digits to process the call. On a POTS dial peer, only wildcard-matched digits are
forwarded by default. Use the prefix command to send the prefix numbers 555 before
forwarding the four wildcard-matched digits.
The following is a sample configuration using the forward-digits command:
dial-peer voice 1 pots
destination-pattern 555....
forward-digits 7
port 1/0/0
In the sample configuration using the forward-digits command, the device attached to port
1/0/0 needs all seven digits to process the call. On a POTS dial peer, only wildcard-matched
digits are forwarded by default. The forward-digits command allows the user to specify the
total number of digits to forward.
The following is a sample configuration using the number expansion table (num-exp)
command:
num-exp 2... 5552...
dial-peer voice 1 pots
destination-pattern 5552...
port 1/1/0
In the sample configuration using the num-exp command, the extension number 2 is
expanded to 5552 before an outbound dial peer is matched; for example, the user dials 2401,
but the outbound dial peer 1 is configured to match 5552401.
The following is a sample configuration using the digit translation (translation-rule)
command:
translation-rule 5
rule 1 2401 5552401
dial-peer voice 1 pots
translate-outgoing called-number 5
In the sample configuration using the translation-rule command, the rule is defined to
translate 2401 into 5552401. The dial peer translate-outgoing called-number 5 command
notifies the router to use the globally defined translation rule 5 to translate the number before
sending the string out the port. It is applied as an outbound translation from the POTS dial peer.
4-38
The following example shows a translation rule that converts any called number that starts with
91 and is tagged as an international number into a national number without the 9 before sending
it to the PSTN.
translation-rule 20
rule 1 91 1 international national
!
!
dial-peer voice 10 pots
destination-pattern 91..........
translate-outgoing called 20
port 1/1:5
forward-digits all
Copyright 2005, Cisco Systems, IncVoice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Dialer Peers
4-39
Practice Item 5:
Digit Manipulation
IP Telephony
Cisco Public
23
R1
_________________________
_________________________
_________________________
_________________________
_________________________
_________________________
4-40
R2:
dial-peer voice 1 pots
destination-pattern 3111
port 1/0/0
R2:
dial-peer voice 101 voip
destination-pattern 2...
session target ipv4:10.1.1.1
Copyright 2005, Cisco Systems, IncVoice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Dialer Peers
4-41
4-42
Special-Purpose Connections
Connection Commands
This topic identifies different special-purpose connection commands.
Special-Purpose
Connection Commands
connection plar
Associates a voice port directly with a dial peer
connection plar-opx
Extends a PBX connection to a remote location
connection trunk
Emulates a permanent trunk connection to a PBX
connection tie-line
Emulates a temporary tie-line trunk to a PBX
IP Telephony
Cisco Public
25
You can configure voice ports to support special connection requirements. These requirements
usually reflect the needs of a specific business environment that must connect to the network in
a special way. The following is a list of available connection commands and their application:
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Special-Purpose
4-43
directly connected to the PBX. Company staff can dial an extension and reach the remote
telephone as though it were on site. The remote telephone has access to PBX services such
as voice mail and extension dialing. This functionality is most often used when onsite staff
turns into telecommuters. Many companies are cutting back on office space in expensive
locations and are setting up their staff with home offices. A PLAR-OPX connection is
configured between the office and the remote site so that the telecommuter can continue to
access all the corporate telephony services in the same manner as before. This allows the
telecommuter to dial the same extensions to reach other staff, and to have access to longdistance dialing and other voice services via the same calling codes. From the office
perspective, onsite staff can reach the telecommuter by dialing the same extension as
before. One OPX connection feature is that when a call is being attempted, the voiceenabled router or gateway that takes the call from the PBX or Cisco CallManager will not
report a call completion until the far end has answered the call. Without the OPX
configuration, the PBX or Cisco CallManager passes the call to the local gateway or router.
Then, the gateway or router routes the call to the PSTN. After the PSTN sends ringing to
the telephone, the router will report call completion back to the PBX or Cisco CallManager.
At this point, the call is completed. The problem is that if the call is not answered, there is
no way to reroute the call to the corporate voice-mail server. From the PBX or Cisco
CallManager perspective, the call is completed. When you configure the OPX, however,
the gateway or router will not report call completion unless the telephone is actually
answered.
4-44
connection trunk: The connection trunk command specifies a connection that emulates a
permanent trunk connection between two PBXs, a PBX and a local extension, or some
combination of telephony interfaces with signaling passed transparently through the packet
data network. A trunk connection remains permanent in the absence of active calls and is
established immediately after configuration. The ports on either end of the connection are
dedicated until you disable trunking for that connection. If, for some reason, the link
between the two voice ports goes down, the virtual trunk reestablishes itself after the link
comes back up. This configuration is useful when a permanent connection is desired
between two devices. In this scenario, a caller at one end of the trunk connection can pick
up the telephone and speak into it without dialing any digits or waiting for call setup. This
is analogous to the red telephone to the Kremlin that is depicted in vintage movies. With a
trunk connection, there is no digit manipulation performed by the gateway or router.
Because this is a permanent connection, digit manipulation is not necessary.
connection tie-line: The connection tie-line command specifies a connection that emulates
a temporary tie-line trunk to a PBX. Although a tie-line connection is similar to a trunk
connection, it is automatically set up for each call and torn down when the call ends.
Another difference is that digits are added to the dial string before matching an outbound
dial peer; for example, if a user were to dial extension 8000, which terminates at a remote
office, the voice port is configured with an identifying number for that remote office. If that
office ID is the number 7, then the digits that are sent to be matched against the outbound
dial peer would be 78000. This new five-digit number would be carried across the network
to the remote site. At the remote site, the number 7 can be stripped off or, if necessary,
passed to the destination device.
PLAR Connection
IP Telephony
Cisco Public
26
As demonstrated in the figure, the following actions must occur to establish a PLAR
connection:
1. A user at the remote site lifts the handset.
2. A voice port at the remote site router automatically generates digits 5600 for a dial-peer
lookup.
3. The router at the remote site matches digits 5600 to VoIP dial peer 5 and sends the setup
message with the digits 5600 to IP address 10.18.0.1 as designated in the session target
statement.
4. The router at the central site matches received digits 5600 to POTS dial peer 1 and
forwards digits 5600 out voice port 1/0:1. At the same time, it sends a call-complete setup
message to the router at the remote site because both the inbound and outbound call legs on
the central-site router were processed correctly.
5. The PBX receives digits 5600 and rings the appropriate telephone.
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Special-Purpose
4-45
PLAR-OPX Connection
IP Telephony
Cisco Public
27
As demonstrated in the figure, the following actions must occur to establish a PLAR-OPX
connection:
1. A user at the central site calls a user at a remote site using the extension 5701.
2. PBX routes the call to the central-site router port 1/0/0, which is configured for
PLAR-OPX and pointing to extension 5701.
3. The central-site router matches VoIP dial peer 10 and sends a setup message to the
corresponding IP address. In the meantime, port 1/0/0 does not respond immediately to the
PBX with a seizure or off hook indication, but waits for the remote site call setup complete
message.
4. After the remote router sends the call setup complete message, the central-site router sends
a trunk seizure indication to the PBX and opens a voice path.
4-46
Trunk Connection
IP Telephony
Cisco Public
28
As demonstrated in the figure, the following must occur to establish a trunk connection:
1. Use the connection trunk command to establish a two-way permanent connection between
two voice ports across the IP network.
2. Configure the connection trunk parameter on the voice ports connecting the two PBXs
and configure the session target for each IP address.
In the example, the router on the left is configured to set up a trunk connection from voice port
1/0:1 to a remote voice-enabled router with the IP address of 10.18.0.1 (the router on the right).
This is done by specifying the same number in the connection trunk voice port command as in
the appropriate dial peer destination-pattern command. In this example, the router on the left
uses connection trunk 55, which matches VoIP dial peer 55. The call is routed to the router on
the right, which matches the 55 in a POTS dial peer. The router on the right is also configured
to set up a trunk connection from its voice port 1/0:5 to a remote voice-enabled router with the
IP address of 10.0.0.1 (the router on the left). The router on the right uses 44 as its connection
trunk number. These trunk connections are set up when the routers power on and remain up
until the router is powered down or the ports are shut down.
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Special-Purpose
4-47
The following conditions must be met for VoIP to support virtual trunk connections:
4-48
recEive and transMit or ear and mouth (E&M) to E&M (same type)
You must not perform number expansion on the destination-pattern telephone numbers
configured for trunk connection.
Tie-Line Connections
This topic describes the use and application of tie-lines.
Tie-Line Connection
IP Telephony
Cisco Public
29
In traditional telephony networks, companies often had dedicated circuits called tie-lines
connecting two PBXs. This, in effect, allowed callers at one site to reach callers at the remote
site only through that tie-line connection. Now that the IP network is replacing the traditional
telephony connection, the two sites are logically tied together through the use of the
connection tie-line command at both sites. Callers at one site can still reach callers at the
remote site only, but the call goes over the IP network. The connection tie-line command
emulates tie-lines between PBXs.
As demonstrated in the figure, you must complete the following procedure to establish a tieline connection:
1. Use the connection tie-line command when the dial plan requires the addition of digits in
front of any digits dialed by the PBX.
2. Use the combined set of digits to route the call onto the network.
3. The tie-line port waits to collect digits from the PBX.
4. The terminating router automatically strips the tie-line digits.
In the figure, the caller on the left picks up the telephone and dials the four-digit extension,
5600. Because the voice port on the left router is configured for connection tie-line, the router
collects the four digits and prepends the tie-line digits 55 to make a six-digit number, 555600.
That number is then matched to a VoIP dial peer and sent to the appropriate IP address. After
the call reaches the far-end router, it is matched against a POTS dial peer with the destination
pattern 55.. Because POTS dial peers, by default, forward only wildcard digits, only the
four-digit extension 5600 is passed to the PBX.
Copyright 2005, Cisco Systems, Inc
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Special-Purpose
4-49
Dial Plans
IP Telephony
Cisco Public
31
Although most people are not acquainted with dial plans by name, they use them daily.
the system is scalable, easily understood by the user, and transportable between all of the
system components. The use of alternate path components reduces instances of call failure.
Finally, the numbering plan conforms to all applicable standards and formats for all of the
systems involved.
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Building a Scaable
4-51
IP Telephony
Cisco Public
32
This figure illustrates a complex voice network that consists of the components discussed in
this topic. A comprehensive and scalable numbering plan must be well-planned and wellimplemented on networks such as this. The Centrex service requires 7-digit dialing between
itself and site D; the IP network requires 7-digit dialing toward sites A, B, and C; and each of
the PBXs requires 3-digit dialing.
4-52
IP Telephony
Cisco Public
33
When designing a large-scale numbering plan, you must adhere to the following attributes:
Logic distribution: Good dial plan architecture relies on the effective distribution of the
dial plan logic among the various components. Devices that are isolated to a specific
portion of the dial plan reduce the complexity of the configuration. Each component
focuses on a specific task accomplishment. Generally, the local switch or gateway handles
details that are specific to the local point of presence (POP). Higher-level routing decisions
are passed along to the gatekeepers and PBXs. A well-designed network places the
majority of the dial plan logic at the gatekeeper devices.
Hierarchical design (scalability): You must strive to keep the majority of the dial plan
logic (routing decisions and failover) at the highest-component level. Maintaining a
hierarchical design makes the addition and deletion of number groups more manageable.
Scaling the overall network is much easier when configuration changes are made to a single
component.
Simplicity in provisioning: Keep the dial plan simple and symmetrical when designing a
network. Try to keep consistent dial plans on the network by using translation rules to
manipulate the local digit dialing patterns. These number patterns are normalized into a
standard format or pattern before the digits enter the VoIP core. Putting digits into a
standard format simplifies provisioning and dial-peer management.
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Building a Scaable
4-53
4-54
Reduction in postdial delay: Consider the effects of postdial delay in the network when
you design a large-scale dial plan. Postdial delay is the time between the last digit dialed
and the moment the phone rings at the receiving location. In the PSTN, people expect a
short postdial delay and to hear ringback within seconds. The more translations and
lookups that take place, the longer the postdial delay becomes. Overall network design,
translation rules, and alternate pathing affect postdial delay. You must strive to use these
tools most efficiently to reduce postdial delay.
Availability and fault tolerance: Consider overall network availability and call success
rate when you design a dial plan. Fault tolerance and redundancy within VoIP networks are
most important at the gatekeeper level. By using an alternate path you help provide
redundancy and fault tolerance in the network.
IP Telephony
Cisco Public
34
Simplified provisioning: Provides the ability to easily add new groups and modify existing
groups
Simplified routing: Keeps local calls local and uses a specialized number key, such as an
area code, for long-distance calls
Scalability: Adds scalability to the number plan by adding additional high-level number
groups
Management: Controls number groups from a single point in the overall network
It is not easy to design a hierarchical numbering plan. Existing numbering plans in the network
(such as proprietary PBXs, key systems, and telephony services such as Centrex), and the
necessity to conform to the PSTN at gateways, all contribute to the complexity of the design.
Translation between these systems is a difficult task. If possible, avoid retraining system users.
The goal is to design a numbering plan that has the following attributes:
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Building a Scaable
4-55
4-56
IP Telephony
Cisco Public
35
Numbering plans vary greatly throughout the world. Different countries use different number
lengths and hierarchical plans within their borders. Telephony equipment manufacturers and
service providers use nonstandard numbering. In an attempt to standardize numbering plans,
the International Telecommunication Union (ITU) developed the E.164 worldwide prefix
scheme.
Number plan integration from an internal system such as a VoIP and PBX system to the PSTN
requires careful planning. The hierarchical structure of the number plan and the problems
associated with varying number lengths in different systems make number plan integration
complex.
The challenges that you face with number plan integration include the following:
Specialized services: Services such as Centrex and their equivalents typically have 4- or
5-digit numbers. Dialing from the PSTN into a private VoIP network and then out to a
Centrex extension can also require extensive digit manipulation.
Voice mail: When a called party cannot be reached, the network may have to redirect the
call to voice mail. Since the voice-mail system can require a completely different number
plan than the endpoint telephones, translation is necessary.
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Building a Scaable
4-57
4-58
Necessity of prefixes or area codes: It can be necessary to strip or add area codes, or
prepend or replace prefixes. Rerouting calls from the IP network to the PSTN for failure
recovery can require extra digits.
International dialing consideration: Country codes and number plans vary in length
within countries. Dialing through an IP network to another country requires careful
consideration.
IP Telephony
Cisco Public
36
This figure shows a call from the PSTN destined for 1-703-555-0123. The gateway must realize
the true destination. All endpoints end with the correct digit sequence, but which is the correct
endpoint? Should the gateway append or prepend digits to the dialed number? Should it strip
and omit digits?
Different PBXs support variable-length dial plans that contain 3 to 11 digits. The length
variations present challenges when private plans merge with public number plans. Issues also
arise when no one answers a number and the call is forwarded to a voice-mail system.
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Building a Scaable
4-59
Number Normalization
IP Telephony
Cisco Public
37
There are many ways that you can enhance and extend an existing number plan to
accommodate the VoIP network; all of them require careful planning and consideration. This
lesson will discuss two of these ways: number normalization and technology prefixes.
4-60
Router D
destination-pattern 727555.
destination-pattern 703555.
port 1/0:1
no digit-strip
port 1/0:1
destination-pattern 703555.
destination-pattern 202555.
no digit-strip
port 1/0:1
destination-pattern 202555.
destination-pattern 727555.
session target ipv4:10.10.10.1
!
Another method, called technology prefixes, allows you to include special characters in the
called number. These special characters (most commonly designated as 1#, 2#, 3#, etc.) are
prepended to the called number on the outgoing VoIP dial peer. The gatekeeper then checks its
gateway technology prefix table for gateways that are registered with that particular technology
prefix. Technology prefixes also identify a type, class, or pool of gateways.
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Building a Scaable
4-61
the gatekeepers, gateways, Cisco CallManagers, PBXs, key systems, and other systems, may
need to be included in the process.
4-62
Local Calls
IP Telephony
Cisco Public
39
Local calls occur between two telephones connected to one Cisco voice-enabled router. This
type of call is handled entirely by the router and does not travel over an external network. Both
telephones are directly connected to Foreign Exchange Station (FXS) ports on the router.
Copyright 2005, Cisco Systems, Inc Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Adjusting Voice Quality
4-63
On-Net Calls
IP Telephony
Cisco Public
40
On-net calls occur between two telephones on the same data network. The calls can be routed
through one or more Cisco voice-enabled routers, but the calls remain on the same data
network. The edge telephones attach to the network through direct connections and FXS ports,
or through a PBX, which typically connects to the network via a T1 connection. IP Phones that
connect to the network via switches place on-net calls either independently or through Cisco
CallManager. The connection across the data network can be a LAN connection, as in a campus
environment, or a WAN connection, as in an enterprise environment.
4-64
Off-Net Calls
IP Telephony
Cisco Public
41
Off-net calls occur when, to gain access to the public switched telephone network (PSTN), the
user dials an access code, such as 9, from a telephone that is directly connected to a Cisco
voice-enabled router or PBX. The connection to the PSTN is a single analog connection via a
Foreign Exchange Office (FXO) port or a digital T1 or E1 connection.
Copyright 2005, Cisco Systems, Inc Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Adjusting Voice Quality
4-65
PLAR
IP Telephony
Cisco Public
42
Private line, automatic ringdown (PLAR) calls automatically connect a telephone to a second
telephone when the first telephone goes off hook. When this connection occurs, the user does
not get a dial tone because the voice-enabled port that the telephone is connected to is
preconfigured with a specific number to dial. A PLAR connection can work between any types
of signaling, including recEive and transMit (ear and mouth [E&M]), FXO, FXS, or any
combination of analog and digital interfaces.
4-66
PBX-to-PBX Calls
IP Telephony
Cisco Public
43
A PBX-to-PBX call originates at a PBX at one site and terminates at a PBX at another site
while using the network as the transport between the two locations. Many business
environments connect sites with private tie trunks. When migrating to a converged voice and
data network, this same tie-trunk connection can be emulated across the IP network. Modern
PBX connections to the network are typically digital T1 or E1 with channel associated
signaling (CAS) or PRI signaling, although PBX connections can also be analog.
Copyright 2005, Cisco Systems, Inc Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Adjusting Voice Quality
4-67
IP Telephony
Cisco Public
44
As part of an overall migration strategy, a business may replace PBXs with a Cisco
CallManager infrastructure. This infrastructure includes IP telephones that plug directly into the
IP network. Cisco CallManager performs the same call-routing functions formerly provided by
the PBX. When an IP Phone uses Cisco CallManager to place a call, Cisco CallManager
based on its configurationassesses if the call is destined for another IP Phone under its
control, or if the call must be routed through a remote Cisco CallManager for call completion.
Although the call stays on the IP network, it may be sent between zones. Every Cisco
CallManager is part of a zone. A zone is a collection of devices that are under a common
administration, usually a Cisco CallManager or gatekeeper.
4-68
IP Telephony
Cisco Public
45
When planning a resilient call-routing strategy, it may be necessary to reroute calls through a
secondary path should the primary path fail. On-net to off-net calls originate on an internal
network and are routed to an external network, usually to the PSTN. On-net to off-net callswitching functionality may be necessary when a network link is down, or if a network
becomes overloaded and unable to handle all calls presented.
Copyright 2005, Cisco Systems, Inc Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Adjusting Voice Quality
4-69
4-70
Type of Call
Example
Local calls
One staff member calls another staff member at the same office. The
call is switched between two ports on the same voice-enabled router.
On-net calls
One staff member calls another staff member at a remote office. The
call is sent from the local voice-enabled router, across the IP network,
and terminated on the remote office voice-enabled router.
Off-net calls
A staff member calls a client who is located in the same city. The call
is sent from the local voice-enabled router that acts as a gateway to
the PSTN. The call is then sent to the PSTN for call termination.
PLAR calls
PBX-to-PBX calls
One staff member calls another staff member at a remote office. The
call is sent from the local PBX, through a voice-enabled router, across
the IP network, through the remote voice-enabled router, and
terminated on the remote office PBX.
Cisco CallManager-to-Cisco
CallManager calls
One staff member calls another staff member at a remote office using
IP Phones. The call setup is handled by the Cisco CallManagers at
both locations. After the call is set up, the IP Phones generate IP
packets carrying voice between sites.
One staff member calls another staff member at a remote office while
the IP network is congested. When the originating voice-enabled
router determines that it cannot terminate the call across the IP
network, it sends the call to the PSTN with the appropriate dialed
digits to terminate the call at the remote office via the PSTN network.
FXS Ports
FXS ports connect analog edge devices. This topic identifies the parameters that are
configurable on the FXS port.
Cisco Public
46
In North America, the FXS port connection functions with default settings most of the time.
The same cannot be said for other countries and continents. Remember, FXS ports look like
switches to the edge devices that are connected to them. Therefore, the configuration of the
FXS port should emulate the switch configuration of the local PSTN.
Configuration Parameters
FXS port configuration allows you to set parameters based on the requirements of the
connection if default settings need to be altered or the parameters need to be set for fine-tuning.
You can set the following configuration parameters:
signal: Sets the signaling type for the FXS port. In most cases, the default signaling of loop
start works well. If the connected device is a PBX or a key system, the preferred signaling
is ground start. Modern PBXs and key systems do not normally use FXS ports as
connections to the network, but older systems may still have these interfaces. When
Copyright 2005, Cisco Systems, Inc Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Adjusting Voice Quality
4-71
connecting the FXS port to a PBX or key system, you must check the configuration of the
voice system and set the FXS port to match the system setting.
cptone: Configures the appropriate call-progress tone for the local region. The callprogress tone setting determines the dial tone, busy tone, and ringback tone to the
originating party.
description: Configures a description for the voice port. You must use the description
setting to describe the voice port in show command output. It is always useful to provide
some information about the usage of a port. The description could specify the type of
equipment that is connected to the FXS port.
ring frequency: Configures a specific ring frequency (in Hz) for an FXS voice port. You
must select the ring frequency that matches the connected equipment. If set incorrectly, the
attached telephone might not ring or might buzz. In addition, the ring frequency is usually
country-dependent, and you should take into account the appropriate ring frequency for
your area before you configure this command.
ring cadence: Configures the ring cadence for an FXS port. The ring cadence defines how
ringing voltage is sent to signal a call. The normal ring cadence in North America is
2 seconds of ringing followed by 4 seconds of silence. In England, normal ring cadence is a
short ring followed by a longer ring. When configured, the cptone setting automatically
sets the ring cadence to match that country. You can manually set the ring cadence if you
want to override the default country value. You may have to shut down and reactivate the
voice port before the configured value takes effect.
disconnect-ack: Configures an FXS voice port to remove line power if the equipment on
an FXS loop-start trunk disconnects first. This removal of line power is not something the
user hears, but instead is a method for electrical devices to signal that one side has ended
the call.
station id name: Provides the station name associated with the voice port. This parameter
is passed as a calling name to the remote end if the call is originated from this voice port. If
no Caller ID is received on an FXO voice port, this parameter will be used as the calling
name. Maximum string length is limited to 15.
station id number: Provides the station number that is to be used as the calling number
associated with the voice port. This parameter is optional and, if provided, will be used as
the calling number if the call is originated from this voice port. If not specified, the calling
number will be used from a reverse dial-peer search. If no Caller ID is received on an
FXO voice port, this parameter will be used as the calling number. Maximum string
length is 15.
4-72
IP Telephony
Cisco Public
47
Copyright 2005, Cisco Systems, Inc Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Adjusting Voice Quality
4-73
FXO Ports
FXO ports act like telephones and connect to central office (CO) switches or to a station port on
a PBX. This topic identifies the configuration parameters that are specific to FXO ports.
IP Telephony
Cisco Public
48
Configuration Parameters
In most instances, the FXO port connection functions with default settings. FXO port
configuration allows you to set parameters based on the requirements of the connection where
default settings need to be altered or parameters set for fine-tuning. You can set the following
configuration parameters:
4-74
signal: Sets the signaling type for the FXO port. If the FXO port is connected to the PSTN,
the default settings are adequate. If the FXO port is connected to a PBX, the signal setting
must match the PBX.
ring number: Configures the number of rings before an FXO port answers a call. This is
useful when you have other equipment available on the line to answer incoming calls. The
FXO port answers if the equipment that is online does not answer the incoming call within
the configured number of rings.
dial-type: Configures the appropriate dial type for outbound dialing. Older PBXs or key
sets may not support dual-tone multifrequency (DTMF) dialing. If you are connecting an
FXO port to this type of device, you may need to set the dial type for pulse dialing.
description: Configures a description for the voice port. Use the description setting to
describe the voice port in show command output.
IP Telephony
Cisco Public
49
Copyright 2005, Cisco Systems, Inc Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Adjusting Voice Quality
4-75
E&M Ports
E&M ports provide signaling that is used generally for switch-to-switch or switch-to-network
trunk connections. This topic identifies the configuration parameters that are specific to the
E&M port.
IP Telephony
Cisco Public
50
Configuration Parameters
Although E&M ports have default parameters, you must usually configure these parameters to
match the device that is connected to the E&M port. You can set the following configuration
parameters:
4-76
signal: Configures the signal type for E&M ports and defines the signaling that is used
when notifying a port to send dialed digits. This setting must match that of the PBX to
which the port is connected. You must shut down and reactivate the voice port before the
configured value takes effect. With Wink-Start signaling, the router listens on the M-lead to
determine when the PBX wants to place a call. When the router detects current on the Mlead, it waits for availability of digit registers and then provides a short wink on the E-lead
to signal the PBX to start sending digits. With delay-start, the router provides current on the
E-lead immediately upon seeing current on the M-lead. When current is stopped for the
digit-sending duration, the E-lead stays high until digit registers are available. With
immediate-start, the PBX simply waits a short time after raising the M-lead and then sends
the digits without a signal from the router.
operation: Configures the cabling scheme for E&M ports. The operation command affects
the voice path only. The signaling path is independent of two-wire versus four-wire
settings. If the wrong cable scheme is specified, the user may get voice traffic in one
direction only. You must verify with the PBX configuration to ensure that the settings
match. You must then shut down and reactivate the voice port for the new value to take
effect.
type: Configures the E&M interface type for a specific voice port. The type defines the
electrical characteristics for the E- and M-leads. The E- and M-leads are monitored for onhook and off-hook conditions. From a PBX perspective, when the PBX attempts to place a
call, it goes high (off hook) on the M-lead. The switch monitors the M-lead and recognizes
the request for service. If the switch attempts to pass a call to the PBX, the switch goes high
on the E-lead. The PBX monitors the E-lead and recognizes the request for service by the
switch. To ensure that the settings match, you must verify them with the PBX
configuration.
auto-cut-through: Configures the ability to enable call completion when a PBX does not
provide an M-lead response. For example, when the router is placing a call to the PBX,
even though they may have the same correct signaling configured, not all PBXs provide the
wink with the same duration or voltage. The router may not understand the PBX wink. The
auto-cut-through command allows the router to send digits to the PBX, even when the
expected wink is not detected.
description: Configures a description for the voice port. Use the description setting to
describe the voice port in show command output.
IP Telephony
Cisco Public
51
Copyright 2005, Cisco Systems, Inc Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Adjusting Voice Quality
4-77
IP Telephony
Cisco Public
52
Configuration Parameters
You can set a number of timers and timing parameters for fine-tuning the voice port. Following
are voice port configuration parameters that you can set:
4-78
timeouts initial: Configures the initial digit timeout value in seconds. This value controls
how long the dial tone is presented before the first digit is expected. This timer typically
does not need to be changed.
timeouts interdigit: Configures the number of seconds for which the system will wait for
the caller to input a subsequent digit of the dialed digits, after the caller has input the initial
digit. If the digits are coming from an automated device, and the dial plan is a variablelength dial plan, you can shorten this timer so that the call proceeds without having to wait
the full default of 10 seconds for the interdigit timer to expire.
timeouts ringing: Configures the length of time that a caller can continue ringing a
telephone when there is no answer. You can configure this setting to be less than the
default of 180 seconds so that you do not tie up the voice port when it is evident that the
call is not going to be answered.
timing digit: Configures the DTMF digit-signal duration for a specified voice port. You
can use this setting to fine-tune a connection to a device that may have trouble recognizing
dialed digits. If a user or device dials too quickly, the digit may not be recognized. By
changing the timing on the digit timer, you can provide for a shorter or longer DTMF
duration.
timing interdigit: Configures the DTMF interdigit duration for a specified voice port. You
can change this setting to accommodate faster or slower dialing characteristics.
IP Telephony
Cisco Public
53
Copyright 2005, Cisco Systems, Inc Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Adjusting Voice Quality
4-79
IP Telephony
Cisco Public
54
Configuration Parameters
When you purchase a T1 or E1 connection, make sure that your service provider gives you the
appropriate settings. Before you configure a T1 or E1 controller to support digital voice ports,
you must enter the following basic configuration parameters to bring up the interface.
framing: Selects the frame type for a T1 or E1 data line. The framing configuration differs
between T1 and E1.
Options for E1: 4-bit cyclic redundancy check (CRC4), no-CRC4, or Australia
Options for T1: alternate mark inversion (AMI) or binary 8-zero substitution
(B8ZS)
4-80
Default: line
IP Telephony
Cisco Public
55
You must create a digital voice port in the T1 or E1 controller to make the digital voice port
available for specific voice port configuration parameters. You must also assign timeslots and
signaling to the logical voice port through configuration. The first step is to create the T1 or E1
digital voice port with the ds0-group ds0-group-no timeslots timeslot-list type signal-type
command.
The ds0-group command automatically creates a logical voice port that is numbered as
slot/port:ds0-group-no.
The ds0-group-no parameter identifies the DS0 group (number from 0 to 23 for T1 and from 0
to 30 for E1). This group number is used as part of the logical voice port numbering scheme.
The timeslots command allows the user to specify which timeslots are part of the DS0 group.
The timeslot-list parameter is a single timeslot number, a single range of numbers, or multiple
ranges of numbers separated by commas.
The type command defines the emulated analog signaling method that the router uses to
connect to the PBX or PSTN. The type depends on whether the interface is T1 or E1.
After you specify a ds0-group command, the system creates a logical voice port. You must
then enter the voice-port configuration mode to configure port-specific parameters. To enter
voice-port configuration mode on a Cisco 2600 or 3600 series platform, use the voice-port
slot/port:ds0-group-no command.
To delete a DS0 group, you must first shut down the logical voice port. When the port is in
shutdown state, you can remove the DS0 group from the T1 or E1 controller with the no ds0group ds0-group-no command.
Copyright 2005, Cisco Systems, Inc Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Adjusting Voice Quality
4-81
Example: T1 Configuration
This example configures the T1 controller for ESF, B8ZS line code, and timeslots 1 through 12
with E&M Wink-Start signaling. The resulting logical voice port is 1/0:1, where 1/0 is the
module and slot number and :1 is the ds0-group-no value that was assigned during
configuration. You can configure the remaining timeslots for other signaling types or leave
them unused.
Digital-Voice Configuration
IP Telephony
4-82
Cisco Public
56
ISDN
This topic identifies ISDN configurations for voice ports.
ISDN Configuration
Global configuration
isdn switch-type
D channel configuration
isdn incoming-voice configuration
QSIG configuration
QSIG signaling
IP Telephony
Cisco Public
57
Configuration Parameters
Cisco voice-capable devices provide support for both PRI and BRI voice connections. Many
PBX vendors support either T1/E1 PRI or BRI connections. In Europe, where ISDN is more
popular, many PBX vendors support BRI connections. When designing how the PBX passes
voice to the network, you must ensure that the router supports the correct connection. The first
step in configuring ISDN capabilities for T1 or E1 PRI is to configure the T1 or E1 controller
basics. After the clock source, framing, and line code are configured, ISDN voice functionality
requires the following configuration commands:
isdn switch-type: Configures the ISDN switch type. You can enter this parameter in global
configuration mode or at the interface level. If you configure both, the interface switch type
takes precedence over the global switch type. This parameter must match the provider
ISDN switch. This setting is required for both BRI and PRI connections.
pri-group: Configures timeslots for the ISDN PRI group. T1 allows for timeslots 1 to 23,
with timeslot 24 allocated to the D channel. E1 allows for timeslots 1 to 31, with timeslot
16 allocated to the D channel. You can configure the PRI group to include all available
timeslots, or you can configure a select group of timeslots for the PRI group.
isdn incoming-voice voice: Configures the interface to send all incoming calls to the
digital signal processor (DSP) card for processing.
QSIG signaling: Configures the use of Q Signaling (QSIG) signaling on the D channel.
You typically use this setting when connecting via ISDN to a PBX. The command to
enable QSIG signaling is isdn switch-type primary-qsig for PRI and isdn switch-type
basic-qsig for BRI connections.
Copyright 2005, Cisco Systems, Inc Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Adjusting Voice Quality
4-83
ISDN Configuration
IP Telephony
4-84
Cisco Public
58
CCS Options
This topic describes how to pass proprietary signaling between two PBXs through the use of
Transparent Common Channel Signaling (T-CCS).
CCS Options
IP Telephony
Cisco Public
59
In many cases, PBXs support proprietary signaling that is used to signal supplementary services
only, such as making a light on the telephone blink when voice mail is waiting. Because the
router does not understand this proprietary signaling, the signaling must be carried
transparently across the network without interpretation. T-CCS allows the connection of two
PBXs with digital interfaces that use a proprietary or unsupported common channel signaling
(CCS) protocol. T1 and E1 traffic is transported transparently through the data network, and the
T-CCS feature preserves proprietary signaling. From the PBX standpoint, this type of
communication is accomplished through a point-to-point connection. Calls from the PBXs are
not routed, but they do follow a preconfigured route to the destination.
Configure the command ds0-group ds0-group-no timeslots timeslot-list type ext-sig in the T1
or E1 controller configuration mode. The timeslots command specifies the D channel that
carries call signaling. The type ext-sig command specifies that the signaling is coming from an
external source.
Step 2
Configure a VoIP dial peer that points to the IP address of the remote voiceenabled router that connects to the remote PBX.
Copyright 2005, Cisco Systems, Inc Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Adjusting Voice Quality
4-85
Step 3
Configure the dial peer for clear-channel codec that signals the DSP to pass the
signaling without interpretation.
The destination pattern specified in this dial peer is used to create a trunk in
Step 3. The number entered here must match the number entered in the trunk
command.
The session target specifies the IP address of the remote voice-enabled router.
Configure the dial peer to point to the IP address of the remote site voiceenabled router using the session target command.
Configure the connection trunk digits answer-mode command at the logical voice port to
create a trunk from that port through the VoIP dial peer and across the IP network to the remote
router. The digits parameter must match the destination pattern in the VoIP dial peer created in
Step 2. The answer-mode parameter specifies that the router should not attempt to initiate a
trunk connection but should wait for an incoming call before establishing the trunk.
The process for passing the signal transparently through the IP network is as follows:
Step 1
Step 2
The logical voice port that corresponds to the signaling channel is configured for
trunking, so the router looks for the dial peer that matches the trunk digits
parameter.
Step 3
The VoIP dial peer is configured for clear-channel codec and points to the IP
address of the remote router (router 2) connecting the remote PBX (PBX2).
Step 4
The remote router has a plain old telephone service (POTS) dial peer configured that
points to the logical voice port that is associated with the signaling channel of PBX2.
The signal arrives at PBX2 in its native form.
This process shows the T-CCS signaling part of the configuration only. Additional DS0 group
and dial-peer configuration is necessary for transport of the voice channels.
4-86
IP Telephony
Cisco Public
60
You can perform the following steps to verify voice port configuration:
Step 1
Pick up the handset of an attached telephony device and check for a dial tone. If
there is no dial tone, check the following:
Is the router running the correct version of Cisco IOS in order to recognize the
module?
Step 2
If you have a dial tone, check for DTMF voice band tones, such as touch-tone
detection. If the dial tone stops when you dial a digit, the voice port is probably
configured properly.
Step 3
Use the show voice port command to verify that the data configured is correct.
If you have trouble connecting a call, and you suspect that the problem is associated
with voice port configuration, you can try to resolve the problem by performing
Steps 4 through 6.
Step 4
Use the show voice port command to make sure that the port is enabled. If the port
is administratively down, use the no shutdown command. If the port was working
previously and is not working now, it is possible that the port is in a hung state. Use
the shutdown/no shutdown command sequence to reinitialize the port.
Copyright 2005, Cisco Systems, Inc Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Adjusting Voice Quality
4-87
Step 5
If you have configured E&M interfaces, make sure that the values associated with
your specific PBX setup are correct. Specifically, check for two-wire or four-wire
Wink-Start, immediate-start, or delay-start signaling types, and the E&M interface
type. These parameters need to match those set on the PBX for the interface to
communicate properly.
Step 6
You must confirm that the voice network module (VNM) is correctly installed. With
the device powered down, remove the VNM and reinsert it to verify the installation.
If the device has other slots available, try inserting the VNM into another slot to
isolate the problem. Similarly, you must move the voice interface card (VIC) to
another VIC slot to determine if the problem is with the VIC card or with the
module slot.
IP Telephony
Cisco Public
61
There are six show commands for verifying the voice port and dial-peer configuration. These
commands and their functions are shown in the figure.
4-88
Test Commands
IP Telephony
Cisco Public
62
The test commands provide the ability to analyze and troubleshoot voice ports on the Cisco
2600 and 3600 series routers. There are five test commands to force voice ports into specific
states to test the voice port configuration.
When you finish the loopback testing, be sure to enter the disable command to end the forced
loopback.
After you enter the test voice port switch fax command, you can use the show voice call
command to check whether the voice port is able to operate in fax mode.
The csim command simulates a call to any end station for testing purposes. It is most useful
when testing dial plans.
Note
Refer to the Voice Port Testing Enhancements in Cisco 2600 and 3600 Series Routers
document for further information.
Copyright 2005, Cisco Systems, Inc Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Adjusting Voice Quality
4-89
ISDN Commands
IP Telephony
Cisco Public
63
The ISDN show and debug commands in the figure are useful for viewing and troubleshooting
ISDN connections.
4-90
IP Telephony
Cisco Public
65
Voice signal power in a long-distance connection must be tightly controlled. The delivered
signal power must be high enough to be clearly understood, but not so strong that it leads to
instabilities such as echo. In the traditional telephony network, telephone companies control the
signal power levels at each analog device. Now that the IP network is carrying voice, it may be
necessary to adjust signal power on a voice interface to fine-tune the voice quality.
Most initial voice signals enter the network through a two-wire local loop. Most switches
connect to other switches through a four-wire connection. As voice travels through the network
for delivery to the remote telephone, the voice signal must be passed from the two-wire local
loop to the four-wire connection at the first switch, and from the four-wire connection at the
switch to a two-wire local loop at the remote end. If the impedance at these two-wire to fourwire connections is not matched exactly, some of the voice signal reflects back in the direction
of the source. As a result, originating callers hear their own voice reflected back. Sometimes,
the reflected signal is reflected again, causing the destination to hear the same conversation twice.
In a traditional voice network, voice can reflect back; it usually goes unnoticed, however,
because the delay is so low. In a VoIP network, echo is more noticeable because both
packetization and compression contribute to delay.
Copyright 2005, Cisco Systems, Inc Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Adjusting Voice Quality
4-91
Another problem is inconsistent volume at different points in the network. Both echo and
volume inconsistency may be caused by a voice port that is generating a signal level that is too
high or too low. You can adjust signal strength, either in the inbound direction from an edge
telephone or switch into the voice port, or in the outbound direction from the voice port to the
edge telephone or switch. Echo results from incorrect input or output levels, or from an
impedance mismatch. Although these adjustments are available on the Cisco voice equipment,
they are also adjustable on PBX equipment.
Too much input gain can cause clipped or fuzzy voice quality. If the output level is too high at
the remote router voice port, the local caller hears echo. If the local router voice port input
decibel level is too high, the remote side hears clipping. If the local router voice port input
decibel level is too low, or the remote router output level is too low, the remote-side voice can
become distorted at a very low volume and DTMF may be missed.
IP Telephony
Cisco Public
66
4-92
Analog voice routers operate best when the receive level from an analog source is set at
approximately 3 dB.
In the United States and most of Europe, the receive (transmit) level that is normally
expected for an analog telephone is approximately 9 dB. In Asian and South American
countries, receive levels are closer to 14 dB. To accommodate these differences, the
output levels to the router are set over a wide range.
Overdriving the circuit can cause analog clipping. Clipping occurs when the power level is
above available pulse code modulation (PCM) codes, and a continuous repetition of the last
PCM value is passed to the DSP.
Echo occurs when impedance mismatches reflect power back to the source.
Copyright 2005, Cisco Systems, Inc Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Adjusting Voice Quality
4-93
input-gain
output-attenuation
impedance
IP Telephony
Cisco Public
67
In an untuned network, a port configuration that delivers perceived good quality for a call
between two dial peers might deliver perceived poor quality for a call between two other
dial peers.
Voice quality adjustment is a defined, step-by-step procedure that is implemented after the
network is up and running. It is ineffective for you to begin changing the default voice port
configurations until full cross-network calls are established; a correctly implemented procedure
results in a quality compromise between various sources that the customer accepts as good
overall quality.
A variety of different factors, including input gain and output attenuation, can affect
voice quality.
A loss plan looks at the required dB levels at specific interfaces, such as an analog FXS port
connecting to a telephone, or an FXO port connecting to the PSTN. An analog voice router
works best with a receive level of 3 dB. An analog telephone in North America and Europe
works best with a receive level of 9 dB. Therefore, if the device connecting to that router
provides a different level than the expected 3 dB, then input gain can be set to equalize it to
3 dB. If the output at the other end is a telephone that expects 9 dB, then the output voice
port has to provide 6 dB output attenuation in addition to the 3 dB to send signaling to the
telephone at the expected 9 dB levels. A systemwide loss plan looks at the dB levels of the
initial input and the remote output ports and plans for the appropriate adjustments for end-toend signal levels. You must consider other equipment (including PBXs) in the system when
creating a loss plan.
4-94
Configuration Parameters
Parameters for configuring voice port voice-quality tuning are as follows:
input-gain: Configures a specific input gain, in decibels, to insert into the receiver side of
the interface. The default value for this command assumes that a standard transmission loss
plan is in effect, meaning that there must be an attenuation of 6 dB between telephones.
The standard transmission plan defines country-specific dB levels and assumes that
interfaces already provide the expected dB levels; for example, there must be attenuation of
6 dB between two telephones so that the input gain and output attenuation is 0, if the
interfaces provide the required 6 dB attenuation.
The gain of a signal to the PSTN can only be decreased. The gain of a signal coming into
the router can be increased.
output-attenuation: Configures the output attenuation value in decibels for the transmit
side. The value represents the amount of loss to be inserted at the transmit side of the
interface.
Note
Copyright 2005, Cisco Systems, Inc Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Adjusting Voice Quality
4-95
Configuration Examples
IP Telephony
Cisco Public
68
This example shows voice port tuning parameters on the E&M and FXO ports of a Cisco voiceenabled router. In the example, the PBX output is 4 dB, whereas the voice router functions
best at 3 dB. Therefore, the adjustment is made in the inbound path to the router using the
input-gain command. The impedance setting on the router needs to be changed from the
default of 600r to match the 900c impedance setting for the PBX. Because this is an E&M port,
echo cancellation is disabled. The FXO port connecting to the PSTN has an adjustment for
echo coverage that allows for longer-distance echo cancellation.
E&M voice port parameters include:
input-gain: Increases the inbound voice level by 1 dB before the voice is transmitted
across the network
4-96
echo-cancel coverage: Adjusts the cancellation coverage time to 32 ms. This allows for
cancellation of echo that has greater delay.
output-attenuation: Specifies that there is no attenuation as the signal is passed out of the
interface to the PSTN.
Echo Cancellation
Echo cancellation is configured at the voice port
level.
Echo cancellation is enabled by default.
Echo cancellation coverage adjusts the size of the
echo canceller.
Nonlinear echo cancellation shuts off any signal if
near-end speech is detected.
IP Telephony
Cisco Public
69
Echo cancellation is configured at the voice port level. It is enabled by default and its
characteristics are configurable. Echo cancellation commands are as follows:
echo-cancel enable: Enables cancellation of voice that is sent out through the interface and
received back on the same interface. Sound that is received back in this manner is
perceived by the listener as echo. Echo cancellation keeps a certain-sized sample of the
outbound voice and calculates what that same signal looks like when it returns as an echo.
Echo cancellation then attenuates the inbound signal by that amount to cancel the echo
signal. If you disable echo cancellation, it will cause the remote side of a connection to hear
echo. Because echo cancellation is an invasive process that can minimally degrade voice
quality, you should disable this command if it is not needed. There is no echo path for a
four-wire E&M interface. The echo canceller should be disabled for this interface type.
Note
This command is valid only if the echo-cancel coverage command has been configured.
echo-cancel coverage: Adjusts the coverage size of the echo canceller. This command
enables cancellation of voice that is sent out through the interface and received back on the
same interface within the configured amount of time. If the local loop (the distance from
the interface to the connected equipment that is producing the echo) is longer, the
configured value of this command should be extended.
If you configure a longer value for this command, it takes the echo canceller longer to
converge; in this case, the user may hear a slight echo when the connection is initially set
up. If the configured value for this command is too short, the user may hear some echo for
the duration of the call, because the echo canceller is not canceling the longer-delay echoes.
Copyright 2005, Cisco Systems, Inc Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Adjusting Voice Quality
4-97
There is no echo or echo cancellation on the network side; for example, the non-POTS side
of the connection.
Note
This command is valid only if the echo cancel feature has been enabled.
non-linear: The function enabled by the non-linear command is also known as residual
echo suppression. This command effectively creates a half-duplex voice path. If voice is
present on the inbound path, then there is no signal on the outbound path. This command is
associated with the echo canceller operation. The echo-cancel enable command must be
enabled for the non-linear command to take effect. Use the non-linear command to shut
off any signal if near-end speech is not detected.
Enabling the non-linear command normally improves performance; however, some users
encounter truncation of consonants at the ends of sentences when this command is enabled.
This occurs when one person is speaking and the other person starts to speak before the
first person finishes. Because the nonlinear cancellation allows speech in one direction
only, it must switch directions on the fly. This may clip the end of the sentence spoken by
the first person or the beginning of the sentence spoken by the second person.
Caution
Do not use the echo cancellation commands or adjust voice quality unless you are
experienced in doing so. Arbitrarily adjusting these parameters could adversely affect
voice quality.
ITU standard G.164 defines the performance of echo suppressors, which are the predecessors of
echo cancellation technology. G.164 also defines the disabling of echo suppressors in the
presence of 2100 Hz tones that precede low-bit-rate modems.
ITU standard G.165 defines echo cancellation and provides a number of objective tests that
ensure a minimum level of performance. These tests check convergence speed of the echo
canceller, stability of the echo canceller filter, performance of the non-linear processor, and a
limited amount of double-talk testing. The signal used to perform these tests is white noise.
Additionally, G.165 defines the disabling of echo cancellers in the presence of 2100 Hz signals
with periodic phase reversals in order to support echo-canceling modem technology (for
example, V.34), which do not work if line echo cancellation is performed in the connection.
ITU standard G.168 allows more rigorous testing and satisfies more testing requirements.
White noise is replaced with a pseudo-speech signal for the convergence tests. Most echo
cancellation algorithms use a least mean square algorithm to adapt the echo cancellation filter.
This algorithm works best with random signals, and slows down with more correlated signals
such as speech. Use of the pseudo-speech signal in testing provides a more realistic portrayal of
the echo cancellers performance in real use.
4-98
G.168 EC
Tail Coverage
Up to 32 ms
Up to 64 ms
Minimum ERL
Echo Suppression
Up to 10 seconds
12.2(11)T, 12.2(8)T5,
12.2(12), and higher
Copyright 2005, Cisco Systems, Inc Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Adjusting Voice Quality
4-99
Local-Loop Connections
IP Telephony
Cisco Public
71
A subscriber home telephone connects to the telephone company central office (CO) via an
electrical communication path called a local loop as depicted in the figure. The loop consists of
a pair of twisted wiresone is called tip, the other is called ring.
In most arrangements, the ring wire ties to the negative side of a power source, called battery,
while the tip wire connects to the ground. When the analog phone or fax goes to the off hook
state, an electrical circuit is completed and current flows around the loop. This signals the
switch that the analog phone or fax is off hook. The switch will then use a dial tone generator to
send a signal that the switch is ready to receive digits. This signal is called dial tone. This wire
pair which represents the local loop, along with all the others in your neighborhood, connects to
the CO in a cable bundle, either buried underground or strung on poles.
4-100
FXS
IP Telephony
Cisco Public
72
When analog phones or fax machines are used in an IP-based environment, they will need to
have a connection into this IP network. This connection takes the form of an FXS interface.
The FXS interface provides a direct connection to an analog telephone, a fax machine, or a
similar device. From the analog devices perspective, the FXS interface functions like a switch.
Therefore, it must supply line power, ring voltage, and dial tone.
The FXS interface contains the coder-decoder (codec), which converts the spoken analog voice
wave into a digital format for processing by the voice-enabled device.
Note
Analog phones plugged into an FXS port on the CallManager Express router cannot be
forwarded to Unity Express voice mail. If voice mail is needed on the analog phones, use
the ATA 186 or ATA 188 to connect the analog phone to the network.
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Analog and Digital
4-101
FXO
FXO
PSTN
Cisco Public
73
For standard analog connections from the CO to enter the IP network, they will need to be
terminated on an interface on a voice gateway. A Foreign Exchange Office (FXO) interface can
be used for this termination of an analog line. When a call arrives, the FXO interface will
answer the call and either present a second dial tone or be configured with a Private Line Auto
Ringdown (PLAR). For outbound calls, the FXO interface provides either pulse or dual tone
multifrequency (DTMF) digits for outbound dialing.
4-102
Tie Line
E&M
E&M
MOH
E&M interface
E&M interface
Connects two sites together with a leased connection
Allows for the use of non PSTN numbers
Used to create tie-lines
Commonly used to connect to external Music on Hold sources
2005 Cisco Systems, Inc. All rights reserved.
IP Telephony
Cisco Public
74
Special analog connections called tie lines can be leased from the carrier. These are typically
use to tie two or mores sites together with analog connections. This tie line will terminate in an
analog interface on the router so the analog communication can enter the IP network. The E&M
interface on the router is where these tie lines can be terminated. E&M signaling is also referred
to as recEive and transMit, but its origin comes from the term earth and magneto. Earth
represents the electrical ground and magneto represents the electromagnet used to generate
tone.
E&M signaling defines a trunk-circuit side and a signaling-unit side for each connection,
similar to the DCE and DTE reference type. The router is usually the trunk-circuit side and the
telco, CO, channel bank, or Cisco voice-enabled platform is the signaling-unit side.
Note
Many music on hold services provide an analog E&M interface that may be used to connect
to the CallManager Express router.
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Analog and Digital
4-103
IP Telephony
Cisco Public
75
Because the signaling occurs within each DS0, it is referred to as in band. Also, because the use
of these bits is exclusively reserved for signaling each respective voice channel, it is referred to
as CAS.
SF has a 12-frame structure and provides AB bits for signaling. ESF has a 24-frame structure
and provides ABCD bits for signaling.
Tones, such as dual tone multifrequency (DTMF) addressing or call progress, can be carried in
the audio path. However, other CAS signals must be carried via the robbed bits.
4-104
Cisco Public
76
CallManager Express can be connected to the PSTN through a CAS T1 connection. This will
provide up to 24 channels for voice. Each channel is a 64 kb DS0.
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Analog and Digital
4-105
IP Telephony
Cisco Public
77
In E1 framing and signaling, 30 of the 32 available channels, or time slots, are used for voice or
data. Framing information uses time slot 1 (channel 0), while time slot 17 (channel 16) is used
for signaling by all the other time slots. This signaling format is also known as CAS because
each bearer channel has specific bits in the 17th timeslot assigned for signaling. However, this
implementation of CAS is considered out of band because the signaling bits are not carried
within the voice channel, as is the case with T1.
Note
4-106
Cisco Public
78
CallManager Express can be connected to the PSTN and can provide up to 30 channels for
voice.
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Analog and Digital
4-107
Common-Channel Signaling
IP Telephony
Cisco Public
79
Whereas CAS uses bit time slots assigned to each specific channel, CCS uses a common
channel and protocol to setup calls for all the bearer channels. Using ISDN over E1 as an
example, the signaling protocol Q931 would use timeslot 17 to exchange call-setup messages
for any of the 30 bearer (B) channels.
Examples of CCS signaling are as follows:
4-108
Q Signaling (QSIG): Like ISDN, uses a common channel to signal all other channels.
PRI/BRI
This topic describes primary rate interface and basic rate interface and how they may be used to
support voice.
ISDN PRI/BRI
Carrier
Carrier
PRI 23B+D
BRI 2B +D
PRI/BRI
Allows for a multiple services through one connection
Well adapted for voice
64kbps channels
Q.931 on the D channel
IP Telephony
Cisco Public
80
One form of Common Channel Signaling is Integrated Services Digital Network (ISDN).
Primary rate interface (PRI) and basic rate interface (BRI) are the two ways of implementing
ISDN.
Note
Because ISDN is a digital service, the time required to setup a call is significantly less than
that of an analog call.
PRI supports 23 (for T1) or 30 (for E1) bearer (B) channels while BRI features two B channels.
Each implementation also supports a single data (D) channel used to carry signaling
information.
The following are characteristics of ISDN PRI/BRI:
Each B channel is 64 kbps, and G.711 pulse code modulation (PCM) requires 64 kbps so
this is a perfect match for voice applications.
ISDN can support standards-based voice features, such as call forwarding and standardsbased enhanced dialup capabilities, such as Group IV fax and audio channels
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Analog and Digital
4-109
4-110
ISDN BRI voice is commonly used in Europe; ISDN PRI voice is used worldwide.
Cisco Public
82
In North America, the FXS port connection functions with default settings most of the time.
The same cannot be said for other countries and continents. Remember, FXS ports look like
switches to the edge devices that are connected to them. Therefore, the configuration of the
FXS port should emulate the switch configuration of the local PSTN.
Example
For example, consider the scenario of an international company with offices in the United
States and England. The PSTN of each country provides signaling that is standard for that
country. In the United States, the PSTN provides a dial tone that is different from the tone in
England. When the telephone rings to signal an incoming call, the ring is different in the United
States. Another instance when the default configuration might be changed is when the
connection is a trunk to a PBX or key system. In that case, the FXS port must be configured to
match the settings of that device.
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Analog
4-111
Configuration Parameters
FXS port configuration allows you to set parameters based on the requirements of the
connection if default settings need to be altered or the parameters need to be set for fine-tuning.
You can set the following configuration parameters:
4-112
signal: Sets the signaling type for the FXS port. In most cases, the default signaling of
loopstart works well. If the connected device is a PBX or a key system, the preferred
signaling is ground start. Modern PBXs and key systems do not normally use FXS ports as
connections to the network, but older systems may still have these interfaces. When
connecting the FXS port to a PBX or key system, you must check the configuration of the
voice system and set the FXS port to match the system setting.
cptone: Configures the appropriate call-progress tone for the local region. The callprogress tone setting determines the dial tone, busy tone, and ringback tone to the
originating party.
description: Configures a description for the voice port. You must use the description
setting to describe the voice port in show command output. It is always useful to provide
some information about the usage of a port. The description could specify the type of
equipment that is connected to the FXS port.
ring frequency: Configures a specific ring frequency (in Hz) for an FXS voice port. You
must select the ring frequency that matches the connected equipment. If set incorrectly, the
attached telephone might not ring or might buzz. In addition, the ring frequency is usually
country-dependent, and you should take into account the appropriate ring frequency for
your area before you configure this command.
ring cadence: Configures the ring cadence for an FXS port. The ring cadence defines how
ringing voltage is sent to signal a call. The normal ring cadence in North America is
2 seconds of ringing followed by 4 seconds of silence. In England, normal ring cadence is a
short ring followed by a longer ring. When configured, the cptone setting automatically
sets the ring cadence to match that country. You can manually set the ring cadence if you
want to override the default country value. You may have to shut down and reactivate the
voice port before the configured value takes effect.
disconnect-ack: Configures an FXS voice port to remove line power if the equipment on
an FXS loop-start trunk disconnects first. This removal of line power is not something the
user hears. Instead, it is a method for electrical devices to signal that one side has ended the
call.
station id name: Provides the station name associated with the voice port. This parameter
is passed as a calling name to the remote end if the call is originated from this voice port. If
no caller ID is received on an FXO voice port, this parameter will be used as the calling
name. Maximum string length is limited to 15.
station id number: Provides the station number that is to be used as the calling number
associated with the voice port. This parameter is optional and, when it is provided, it will
be used as the calling number if the call is originated from this voice port. If not specified,
the calling number will be used from a reverse dial-peer search. If no caller ID is received
on an FXO voice port, this parameter will be used as the calling number. Maximum string
length is 15.
FXS Port
1/0/1
CMERouter(config)#voice-port 1/0/0
CMERouter(config-voiceport)#signal loop-start
CMERouter(config-voiceport)#cptone GB
CMERouter(config-voiceport)#ring cadence pattern01
CMERouter(config)#voice-port 1/0/1
CMERouter(config-voiceport)#signal loop-start
CMERouter(config-voiceport)#cptone GB
CMERouter(config-voiceport)#ring cadence pattern02
IP Telephony
Cisco Public
83
Example
The example shows how the British office is configured to enable ground-start signaling on a
Cisco 2600 or 3600 series router on FSX voice port 1/0/0. The call-progress tones are set for
Great Britain and ring cadence is set for pattern 1.
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Analog
4-113
IP Telephony
Cisco Public
84
Configuration Parameters
In most instances, the FXO port connection functions with default settings. FXO port
configuration allows you to set parameters based on the requirements of the connection where
default settings need to be altered or parameters set for fine-tuning. You can set the following
configuration parameters:
4-114
signal: Sets the signaling type for the FXO port. If the FXO port is connected to the PSTN,
the default settings are adequate. If the FXO port is connected to a PBX, the signal setting
must match the PBX.
ring number: Configures the number of rings before an FXO port answers a call. This is
useful when you have other equipment available on the line to answer incoming calls. The
FXO port answers if the equipment that is online does not answer the incoming call within
the configured number of rings.
dial-type: Configures the appropriate dial type for outbound dialing. Older PBXs or key
sets may not support dual-tone multifrequency (DTMF) dialing. If you are connecting an
FXO port to this type of device, you may need to set the dial type for pulse-dialing.
description: Configures a description for the voice port. Use the description setting to
describe the voice port in show command output.
FX0 Port
1/1/0
PSTN
CMERouter(config)#voice-port 1/1/0
CMERouter(config-voiceport)#signal ground-start
CMERouter(config-voiceport)#ring number 3
CMERouter(config-voiceport)#dial-type dtmf
CMERouter(config-voiceport)#description Connection_to_PSTN
IP Telephony
Cisco Public
85
Example
The configuration in the figure enables loop-start signaling on a Cisco 2600 or 3600 series
router on FXO voice port 1/1/0. The ring-number setting of 3 specifies that the FXO port does
not answer the call until after the third ring, and the dial type is set to DTMF.
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Analog
4-115
IP Telephony
Cisco Public
86
Configuration Parameters
Although E&M ports have default parameters, you must usually configure these parameters to
match the device that is connected to the E&M port. You can set the following configuration
parameters:
4-116
signal: Configures the signal type for E&M ports and defines the signaling that is used
when notifying a port to send dialed digits. This setting must match that of the PBX to
which the port is connected. You must shut down and reactivate the voice port before the
configured value takes effect. With wink-start signaling, the router listens on the M lead to
determine when the PBX wants to place a call. When the router detects current on the M
lead, it waits for availability of digit registers and then provides a short wink on the E lead
to signal the PBX to start sending digits. With delay-start, the router provides current on
the E lead immediately upon seeing current on the M lead. When current is stopped for the
digit sending duration, the E lead stays high until digit registers are available. With
immediate-start, the PBX simply waits a short time after raising the M lead and then sends
the digits without a signal from the router.
operation: Configures the cabling scheme for E&M ports. The operation command affects
the voice path only. The signaling path is independent of two-wire versus four-wire
settings. If the wrong cable scheme is specified, the user may get voice traffic in one
direction only. You must verify with the PBX configuration to ensure that the settings
match. You must then shut down and reactivate the voice port for the new value to take
effect.
type: Configures the E&M interface type for a specific voice port. The type defines the
electrical characteristics for the E and M leads. The E and M leads are monitored for onhook and off-hook conditions. From a PBX perspective, when the PBX attempts to place a
call, it goes high (off hook) on the M lead. The switch monitors the M lead and recognizes
the request for service. If the switch attempts to pass a call to the PBX, the switch goes high
on the E lead. The PBX monitors the E lead and recognizes the request for service by the
switch. To ensure that the settings match, you must verify them with the PBX
configuration.
auto-cut-through: Configures the ability to enable call completion when a PBX does not
provide an M-lead response. For example, when the router is placing a call to the PBX,
even though they may have the same correct signaling configured, not all PBXs provide the
wink with the same duration or voltage. The router may not understand the PBX wink. The
auto-cut-through command allows the router to send digits to the PBX, even when the
expected wink is not detected.
description: Configures a description for the voice port. Use the description setting to
describe the voice port in show command output.
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Analog
4-117
MOH
CMERouter(config)#voice-port 1/1/0
CMERouter(config-voiceport)#signal immediate
CMERouter(config-voiceport)#auto-cut-through
CMERouter(config-voiceport)#operation 4-wire
CMERouter(config-voiceport)#type 1
CMERouter(config-voiceport)#description MoH_Device
IP Telephony
Cisco Public
87
Example
The configuration in the figure enables immediate signaling with automatic cut through for an
E&M connection to a Music on Hold device. This allows an external device to provide music
on hold to the CallManager Express system. The type setting matches the E&M port setting on
the MOH device as well as the number of wires used by the operation command.
4-118
IP Telephony
Cisco Public
88
Given all the ISDN interface abbreviations such as T, S, U, S/T, and so on, what do all of these
components and reference points look like in practice?
When creating a network, connect the network termination 1 (NT1) to the wall jack with a
standard two-wire connector, then to the ISDN phone, terminal adapter, Cisco ISDN router, and
maybe a fax with a four-wire connector. The S/T interface is implemented using an eight-wire
connector (two pairs for data transmission and two pairs for providing optional power to the NT
and TE).
Caution should be taken when connecting ISDN devices, since RJ-11 and RJ-45 connectors
look similar.
The S/T reference point is:
The S/T interface defines the interface between a TE1 or TA and an NT. A maximum of eight
devices can be daisy-chained to the S/T bus.
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Analog
4-119
The U interface defines the two-wire interface between the NT1 and the ISDN cloud. The U
interface is used in the United States, while in the rest of the world uses an S/T interface.
The R interface defines the interface between the TA and an attached non-ISDN device (TE2).
In North America, the NT1 function is commonly integrated into the ISDN device (router, TA),
thus permitting a direct connection from the ISDN device to the telco jack.
An NT1 and NT2 combination device is sometimes referred to as an NTU. In most countries,
the NT1/NT2 combination is provided by the service provider (telco) and customer access is
only available at the S/T interface.
4-120
PSTN
IP Telephony
Cisco Public
89
To configure an ISDN BRI interface on a router, global and interface configuration commands
must be specified.
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Analog
4-121
isdn
isdn switch-type
switch-type switch-type
switch-type
interface
interface BRI
BRI mod/port
mod/port
isdn
isdn switch-type
switch-type switch-type
switch-type
Cisco Public
90
At the global level, the administrator must specify the ISDN service provider CO switch type.
There are several types of switches to choose from and some of these require special
parameters. Standards signaling specifics differ by region. Therefore, the switch type varies
according to its geographical location. For example, the DMS-100 and National-1 require a
service profile identifier (SPID) to be specified. This is optional on some switches (for
example, AT&T 5ESS), or not required at all.
Although the interface configuration and selection tasks apply to all routers, this topic focuses
on BRI for access routers. PRI details for Cisco routers and access servers with T1/E1
controllers are covered later in the lesson.
The interface bri interface-number command designates the interface used for ISDN on a
router acting as a TE1 device.
A router without a native BRI interface is a TE2 device. It must connect to an external ISDN
TA via a serial interface. On a TE2 router, the interface serial interface-number command
must be used.
Use the isdn switch-type command to specify the CO switch to which the router connects. For
BRI ISDN service, the possible switch types and their corresponding commands are shown in
the table here.
4-122
Description
basic-5ess
basic-dms100
basic-ni
basic-qsig
basic-net3
NET3 switch type for United Kingdom, Europe, Asia, and Australia
none
No switch defined
Note
Other switch types are available. The list of switch types can differ based on the Cisco IOS
version used.
When the isdn switch-type command is used in global configuration mode, all ISDN interfaces
on the router are configured for that switch type. Beginning with IOS Release 11.3T, the
interface configuration mode command was introduced to allow different interfaces to be
configured with different switch types. If the command is used in interface configuration mode,
only the interface that is configured assumes that switch type. The interface setting always
overrides the global setting.
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Analog
4-123
isdn
isdn spid1
spid1 spid-number
spid-number [ldn]
[ldn]
isdn
isdn spid2
spid2 spid-number
spid-number [ldn]
[ldn]
IP Telephony
Cisco Public
91
Several ISDN service providers use central office switches that require dial-in numbers called
service profile identifiers (SPIDs). The SPIDs are used to authenticate call requests that are
within contract specifications. These switches include National ISDN and DMS-100 ISDN
switches, as well as the AT&T 5ESS multipoint switch. SPIDs are used only in the United
States, and are typically not required for ISDN data communications applications. The service
provider supplies the local SPID numbers. If uncertain, contact the service provider to
determine if the SPIDs need to be configured on your access routers.
Use the isdn spid1 and isdn spid2 commands to access the ISDN network when your router
makes its call to the local ISDN exchange.
The isdn spid1 command syntax is shown for the first BRI 64-kbps channel.
4-124
Description
spid-number
ldn
If you want the SPID to be automatically detected, you can specify 0 for the spid-number
argument.
The ldn parameter allows you to associate up to three local directory numbers with each SPID.
This number must match the called-party information coming in from the ISDN switch in order
to use both B channels on most switches.
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Analog
4-125
BRI 0/1
ISDN
IP Telephony
4-126
Cisco Public
92
IP Telephony
Cisco Public
93
Configuration Parameters
You can set a number of timers and timing parameters for fine-tuning the voice port. Following
are voice port configuration parameters that you can set:
timeouts initial: Configures the initial digit timeout value in seconds. This value controls
how long the dial tone is presented before the first digit is expected. This timer typically
does not need to be changed.
timeouts interdigit: Configures the number of seconds for which the system will wait
(after the caller has input the initial digit) for the caller to input a subsequent digit of the
dialed digits. If the digits are coming from an automated device, and the dial plan is a
variable length dial plan, you can shorten this timer so that the call proceeds without having
to wait the full default of 10 seconds for the interdigit timer to expire.
timeouts ringing: Configures the length of time that a caller can continue ringing a
telephone when there is no answer. You can configure this setting to be less than the
default of 180 seconds so that you do not tie up the voice port when it is evident that the
call is not going to be answered.
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Analog
4-127
4-128
timing digit: Configures the DTMF digit-signal duration for a specified voice port. You
can use this setting to fine-tune a connection to a device that may have trouble recognizing
dialed digits. If a user or device dials too quickly, the digit may not be recognized. By
changing the timing on the digit timer you can provide for a shorter or longer DTMF
duration.
timing interdigit: Configures the DTMF interdigit duration for a specified voice port. You
can change this setting to accommodate faster or slower dialing characteristics.
CMERouter(config)#voice-port 1/0/0
CMERouter(config-voiceport)#signal loop-start
CMERouter(config-voiceport)#cptone GB
CMERouter(config-voiceport)#ring cadence pattern01
CMERouter(config-voiceport)#timeouts initial 15
CMERouter(config-voiceport)#timeouts interdigit 15
CMERouter(config-voiceport)#timeouts ringing 120
CMERouter(config-voiceport)#timing hookflash-in 500
IP Telephony
Cisco Public
94
Example
The installation in the figure is for a home for the elderly where users may need more time to
dial digits than in other residences. Another requirement is to allow the telephone to ring
unanswered for only two minutes. The configuration in the figure enables several timing
parameters on a Cisco voice-enabled router voice port 1/0/0. The initial timeout is lengthened
to 15 seconds, the interdigit timeout is lengthened to 15 seconds, and the hookflash-in timer is
set to 500 ms.
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Analog
4-129
IP Telephony
Cisco Public
95
Configuration Parameters
When you purchase a T1 or E1 connection, make sure that your service provider gives you the
appropriate settings. Before you configure a T1 or E1 controller to support digital voice ports,
you must enter the following basic configuration parameters to bring up the interface.
framing: Selects the frame type for a T1 or E1 data line. The framing configuration differs
between T1 and E1.
Options for T1: Superframe (SF) or Extended Superframe (ESF)
Options for E1: cyclic redundancy check (CRC4), no-CRC4, or Australia
Default for T1: SF
Default for E1: CRC4
4-130
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Analog
4-131
CMERouter(config-control)#
linecode
linecode {ami
{ami || b8zs}
b8zs}
linecode
linecode {ami
{ami || hdb3}
hdb3}
IP Telephony
Cisco Public
96
Use the linecode command to identify the physical layer signaling method to satisfy the ones
density requirement on the digital facility of the provider. Without a sufficient number of ones
in the digital bit stream, the switches and multiplexers in a WAN can lose their synchronization
for transmitting signals. The table shows linecode command.
linecode Command
Command
Description
ami
b8zs
hdb3
Binary 8-zero substitution (B8ZS) accommodates the ones density requirements for T1 carrier
facilities using special binary signals encoded over the digital transmission link. It allows 64
kbps (clear channel) for ISDN channels.
Settings for these two Cisco IOS software controller commands on the router must match the
framing and line-code types used at the T1/E1 WAN central office (CO) switch of the provider.
T1 configurations typically require framing esf and linecode b8zs. E1 configurations typically
require linecode hdb3.
4-132
CMERouter(config-control)#
framing
framing {sf
{sf || esf}
esf}
framing
framing {crc4
{crc4 || no-crc4
no-crc4 || australia}
australia}
IP Telephony
Cisco Public
97
Use the framing controller configuration command to select the frame type used by the PRI
service provider. The table shows framing commands you can use.
framing Command
Command
Description
sf
esf
crc4 or no-crc4
Note
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Analog
4-133
clock
clock source
source {line
{line || internal}
internal}
Cisco Public
98
You must create a digital voice port in the T1 or E1 controller to make the digital voice port
available for specific voice port configuration parameters. You must also assign timeslots and
signaling to the logical voice port through configuration. The first step is to create the T1 or E1
digital voice port with the ds0-group ds0-group-no timeslots timeslot-list type signal-type
command.
The ds0-group part of the command automatically creates a logical voice port that is numbered
as ds0-group-no. The dS0-group-no parameter identifies the DS0 group (number from 0 to 23
for T1 and from 0 to 30 for E1). This group number is used as part of the logical voice port
numbering scheme.
The timeslots part of the command allows the user to specify which timeslots are parts of the
DS0 group. The timeslot-list parameter is a single time-slot number, a single range of numbers,
or multiple ranges of numbers separated by commas.
The type part of the command defines the emulated analog signaling method that the router
uses to connect to the PBX or PSTN. The type depends on whether the interface is T1 or E1.
To delete a DS0 group, you must first shut down the logical voice port. When the port is in
shutdown state, you can remove the DS0 group from the T1 or E1 controller with the no ds0group ds0-group-no command.
Use the clock source {line | internal} command to configure the T1 and E1 clock source on
Cisco routers.
4-134
T1 1/0
PSTN
CMERouter(config)#controller T1 1/0
CMERouter(config-controller)#linecode b8zs
CMERouter(config-controller)#framing esf
CMERouter(config-controller)#ds0-group 1 timeslots 1-24 type fxo-groundstart
CMERouter(config-controller)#clock source line
CMERouter(config)#controller E1 1/0
CMERouter(config-controller)#linecode hdb3
CMERouter(config-controller)#framing crc4
CMERouter(config-controller)#ds0-group 1 timeslots 1-15 type e&m-wink-start
CMERouter(config-controller)#clock source line
IP Telephony
Cisco Public
99
Example
This example configures the T1 controller for ESF, B8ZS linecode, and timeslots 1 through 24
with FXO ground start signaling. The resulting logical voice port is 1/0:1, where 1/0 is the
module and slot number and :1 is the ds0-group-no value that was assigned during
configuration.
The E1 configuration uses linecode of HDB3, framing of CRC-4, and timeslots of 1 through 15
with E&M wink start signaling. The resulting logical voice port is 1/0:1, where the 1/0 is the
module and slot number and the :1 is the ds0-group-no value that was assigned during the
configuration
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Analog
4-135
IP Telephony
Cisco Public
100
Depending on country implementation, either the ANSI T1.601 or ITU-T I.431 standard
governs the physical layer of the PRI interface.
PRI technology is a bit simpler than BRI. The wiring is not multipoint, since there is only the
straight connection between the channel service unit/data service unit (CSU/DSU) and the PRI
interface. Multipoint refers to the ability to have multiple ISDN devices connected to the
network, all of which have access to the ISDN network. Arbitration at Layer 1 and Layer 2
allows multiple devices that need to share the ISDN network to access the network without
collisions or interruptions. Because there are no multiple devices, PRI does not require this
arbitration.
4-136
isdn
isdn switch-type
switch-type switch-type
switch-type
controller
controller {t1
{t1 || e1}
e1} {slot/port
{slot/port || unit-number}
unit-number}
isdn
isdn switch-type
switch-type switch-type
switch-type
Cisco Public
101
Use the isdn switch-type command to specify the central office PRI switch to which the router
connects. With Cisco IOS Release 11.3(3)T or later, this command is also available as a
controller command to allow different switch types to be supported on different controllers. If
configured as a global command, the specified switch type applies to all controllers, unless one
is specifically configured on a controller.
An incompatible switch selection configuration can result in failure to make ISDN calls. After
changing the switch type, you must reload the router to make the new configuration effective.
Telco isdn switch-type commands are shown in the table here.
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Analog
4-137
Description
primary-4ess
primary-5ess
primary-dms100
primary-ni
primary-ntt
primary-net5
primary-qsig
None
No switch defined
Unlike BRI operation, ISDN PRIs do not use service profile identifiers (SPIDs). Therefore,
there is no requirement to configure SPIDs, regardless of the ISDN switch type used by the
PRI.
Use the controller {t1 | e1} slot/port command in global configuration mode to identify the
controller to be configured. Use a single unit-number to identify the AS5000 Series controller.
controller {t1 | e1} Command
4-138
Command
Description
t1
e1
CMERouter(config-controller)#
pri-group
pri-group timeslots
timeslots range
range
CMERouter(config-int)#
interface
interface serial
serial slot/port:timeslot
slot/port:timeslot
IP Telephony
Cisco Public
102
The pri-group command configures the specified interface for PRI operation and specifies
which fixed timeslots (channels) are allocated on the digital facility of the provider.
pri-group Command
Command
Description
timeslots range
Example #1: If using all 30 B channels on an E1 PRI (30B+D), specify pri-group 1-31.
Example #2: If allocated only the first eight B channels (512 kbps total data bandwidth) for a
T1 PRI (23B+D), then specify pri-group 1-8,24. Note that the D channel must be specified.
Note
When provisioning a PRI line with less than 24 time slots (or 30 for E1), include the D
channel for signaling.
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Analog
4-139
Specification of the PRI group automatically creates the corresponding serial interface for the D
channel: interface serial {slot/port | unit}:{23 | 15}. This interface is used to configure the PRI
D channel. The table shows interface serial commands you can use.
interface serial Command
Command
Description
slot/port
unit
23
15
Note
4-140
PRI 0/1
ISDN
IP Telephony
Cisco Public
103
Description
controller t1 0/1
framing esf
linecode b8zs
The controller t1 0/1 command configures the T1 controller. In the example, the switch type
selected using the national ISDN standard. This example is accurate for some operations in the
United States.
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Analog
4-141
For an E1 example, the timeslot argument for the pri-group command would be 131 rather
than 124 as shown for a T1 example, and the interface command would be 0/1:15 instead of
0/1:23.
4-142
Dial Peers
What is Dial Peer?
This topic describes dial peers and their applications.
IP Telephony
Cisco Public
105
When a call is placed, an edge device generates dialed digits as a way of signaling where the
call should terminate. When these digits enter a router voice port, the router must have a way to
decide whether the call can be routed, and where the call can be sent. The router does this by
looking through a list of dial peers.
A dial peer is an addressable call endpoint. The address is called a destination pattern and is
configured in every dial peer. Destination patterns can point to one telephone number only or to
a range of telephone numbers. Destination patterns use both explicit digits and wildcard
variables to define a telephone number or range of numbers.
The router uses dial peers to establish logical connections. These logical connections, known as
call legs, are established in either an inbound or outbound direction.
Dial peers define the parameters for the calls that they match. For example, if a call is
originating and terminating at the same site, and is not crossing through slow speed WAN links,
then the call can cross the local network uncompressed and without special priority. A call that
originates locally and crosses the WAN link to a remote site may require compression with a
specific codec. In addition, this call may require that voice activity detection (VAD) be turned
on, and will need to receive preferential treatment by specifying a higher priority level.
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Analog
4-143
Plain old telephone service (POTS) dial peers: Connect to a traditional telephony
network, such as the public switched telephone network (PSTN) or a PBX, or to a
telephony edge device, such as a telephone or fax machine. POTS dial peers perform these
functions:
Provide an address (telephone number or range of numbers) for the edge network
or device
Point to the specific voice port that connects the edge network or device
Voice over IP (VoIP) dial peers: Connect over a packet network. VoIP dial peers perform
these functions:
Provide a destination address (telephone number or range of numbers) for the edge
device that is located across the network
Associate the destination address with the next hop router or destination router,
depending on the technology used
4-144
Dial Peer
IP Telephony
Cisco Public
106
In the figure, the telephony device connects to the Cisco Systems voice-enabled router POTS
dial. The POTS dial peer configuration includes the telephone number of the telephony device
and the voice port to which it is attached. The router knows where to forward incoming calls
for that telephone number.
The Cisco voice-enabled router VoIP dial peer is connected to the packet network. The VoIP
dial peer configuration includes the destination telephone number (or range of numbers) and the
next hop or destination voice-enabled router network address.
Follow the steps to place a VoIP call:
How to Place a VoIP Call
Step
Action
Configure the source router with a compatible dial peer that specifies the recipient
destination address
Configure the recipient router with a POTS dial peer that specifies which voice port
the router uses to forward the voice call
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Analog
4-145
IP Telephony
Cisco Public
107
Before the configuration of Cisco IOS dial peers can begin, the user must have a good
understanding of where the edge devices reside, what type of connections need to be made
between these devices, and what telephone numbering scheme is applied to the devices.
Follow the steps to configure POTS dial peers:
How to Configure POTS Dial Peers
Step
Action
Configure a POTS dial peer at each router or gateway where edge telephony
devices connect to the network
Use the destinationpattern command in the dial peer to configure the telephone
number
Use the port command to specify the physical voice port that the POTS telephone
is connected to.
The dial peer type will be specified as POTS because the edge device is directly connected to a
voice port and the signaling must be sent from this port to reach the device. There are two basic
parameters that need to be specified for the device: the telephone number and the voice port.
When a PBX is connecting to the voice port, a range of telephone numbers can be specified.
4-146
Example
The figure illustrates proper POTS dial peer configuration on a Cisco voice-enabled router. The
dial-peer voice 1 pots command notifies the router that dial peer 1 is a POTS dial peer with a
tag of 1. The destination-pattern 7777 command notifies the router that the attached telephony
device terminates calls destined for telephone number 7777. The port 1/0/0 command notifies
the router that the telephony device is plugged into module 1, voice interface card (VIC) slot 0,
voice port 0.
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Analog
4-147
IP Telephony
Cisco Public
108
The administrator must know how to identify the far-end voice-enabled device that will
terminate the call. In a small network environment, the device may be the IP address of the
remote device. In a large environment, the device may mean pointing to a Cisco CallManager
or gatekeeper for address resolution and call admission control (CAC) to complete the call.
You must follow these steps to configure VoIP dial peers:
How to Configure VoIP Dial Peers
Step
Action
The dial peer is specified as a VoIP dial peer, which alerts the router that it must process a call
according to the various parameters that are specified in the dial peer. The dial peer must then
package it as an IP packet for transport across the network. Specified parameters may include
the codec used compression (VAD, for example), or marking the packet for priority service.
4-148
The destination-pattern parameter configured for this dial peer is typically a range of numbers
that are reachable via the remote router or gateway.
Because this dial peer points to a device across the network, the router needs a destination IP
address to put in the IP packet. The session target parameter allows the administrator to specify
either an IP address of the terminating router or gateway, or another device; for example, a
gatekeeper or Cisco CallManager that can return an IP address of that remote terminating
device.
To determine which IP address a dial peer should point to, it is recommended that you use a
loopback address. The loopback address is always up on a router, as long as the router is
powered on and the interface is not administratively shut down. If an interface IP address is
used instead of the loopback, and that interface goes down, the call will fail even if there is an
alternate path to the router.
Example
The figure illustrates the proper VoIP dial peer configuration on a Cisco voice-enabled router.
The dial-peer voice 2 voip command notifies the router that dial peer 2 is a VoIP dial peer with
a tag of 2. The destination-pattern 8888 command notifies the router that this dial peer defines
an IP voice path across the network for telephone number 8888. The session target
ipv4:10.18.0.1 command defines the IP address of the router that is connected to the remote
telephony device.
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Analog
4-149
Destination-Pattern Options
This topic describes destination-pattern options and the applicable shortcuts.
Destination-Pattern Options
IP Telephony
Cisco Public
109
The destination pattern associates a telephone number with a given dial peer. The destination
pattern also determines the dialed digits that the router collects and forwards to the remote
telephony interface, such as a PBX, Cisco CallManager, or the PSTN. You must configure a
destination pattern for each POTS and VoIP dial peer that you define on the router.
The destination pattern can indicate a complete telephone number or a partial telephone number
with wildcard digits; it can also point to a range of numbers defined in a variety of ways.
Destination-pattern options include:
Plus (+): An optional character that indicates an E.164 standard number. E.164 is the
International Telecommunication Union Telecommunication Standardization Sector (ITUT) recommendation for the international public telecommunication numbering plan. The
plus sign in front of a destination-pattern string specifies that the string must conform to
Recommendation E.164.
String: A series of digits specifying the E.164 or private dialing-plan telephone number.
The examples below show the use of special characters that are often found in destination
patterns strings:
Asterisk (*) and pound sign (#) appear on standard touch-tone dial pads. These
characters may need to be used when passing a call to an automated application that
requires these characters to signal the use of a special feature. For example, when
4-150
calling an interactive voice response (IVR) system that requires a code for access, the
number dialed might be 5551212888#, which would initially dial the telephone
number 5551212 and input a code of 888 followed by the pound key to terminate the
IVR input query.
Comma (,) inserts a one-second pause between digits. The comma can be used, for
example, where a 9 is dialed to signal a PBX that the call should be processed by the
PSTN. The 9 is followed by a comma to give the PBX time to open a call path to the
PSTN, after which the remaining digits will be played out. An example of this string is
9,5551212.
Period (.) matches any single entered digit (this character is used as a wildcard). The
wildcard is used to specify a group of numbers that may be accessible via a single
destination router, gateway, PBX or Cisco Call Manager. Because the period
(commonly referred to as a dot), indicates a single digit of 0 to 9, this limits how
efficiently ranges of numbers are used. A pattern of 200. allows for 10 uniquely
addressed devices, where a pattern of 20.. can point to 100 devices. If one site has the
numbers 2000 through 2049, and another site has the numbers 2050 through 2099, then
the bracket notation would be more efficient.
Brackets ([ ]) indicate a range. A range is a sequence of characters that are enclosed in
the brackets. Only single numeric characters from 0 to 9 are allowed in the range. In
the previous example, the bracket notation could be used to specify exactly which
range of numbers is accessible through each dial peer. For example, the first site
pattern would be 20[0-4]., and the second site pattern would be 20[5-9]. The
bracket notation offers much more flexibility in how numbers can be assigned.
When the calling party finishes entering dialed digits, there is a pause equal to the interdigit
timeout value before the router processes the call. The calling party can immediately terminate
the interdigit timeout by entering the pound (#) character, which is the default termination
character. Because the default interdigit timer is set to 10 seconds, users may experience a long
call setup delay.
Note
Cisco IOS software does not check the validity of the E.164 telephone number; it accepts
any series of digits as a valid number.
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Analog
4-151
Example
Example: Destination-Pattern Options
Destination Pattern
5551234
555[1-3]
Matches a seven-digit telephone number where the first three digits are 555,
the fourth digit can be a 1, 2, or 3, and the last digits can be any valid digits.
This type of destination pattern is used where telephone number ranges are
assigned to specific sites. In this example, the destination pattern is used in a
small site that does not need more than thirty numbers assigned.
.T
Matches any telephone number that has at least one digit and can vary in
length from 1 to 32 digits total.
This destination pattern is used for a dial peer that services a variable-length
dial plan, such as local, national, and international calls. It can also be used as
a default destination pattern so that any calls that do not match a more specific
pattern will match this one and can be directed to an operator.
4-152
IP Telephony
Cisco Public
110
When a matching inbound dial peer is not found, the router resorts to the default dial peer.
Note
Default dial peers are used for inbound matches only. They are not used to match outbound
calls that do not have a dial peer configured.
Example
In the figure, only one-way dialing is configured. The caller at extension 7777 can call
extension 8888 because there is a VoIP dial peer configured on router 1 to route the call across
the network. There is no VoIP dial peer configured on router 2 to point calls across the network
towards router 1. Therefore, there is no dial peer on router 2 that will match the calling number
of extension 7777 on the inbound call leg. If no incoming dial peer matches the calling number,
the inbound call leg automatically matches to a default dial peer (POTS or VoIP).
Note
There is an exception to the previous statement. Cisco voice and/or dial platforms, such as
the AS53xx and AS5800, require that a configured inbound dial peer be matched for
incoming POTS calls to be accepted as voice calls. If there is no inbound dial peer match,
the call is treated and processed as a dial-up (modem) call.
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Analog
4-153
Dial peer 0 for inbound VoIP peers has the following configuration:
any codec
ip precedence 0
vad enabled
no rsvp support
fax-rate service
Dial peer 0 for inbound POTS peers has the following configuration:
no ivr application
You cannot change the default configuration for dial peer 0. Default dial peer 0 fails to
negotiate non-default capabilities or services. When the default dial peer is matched on a VoIP
call, the call leg that is set up in the inbound direction uses any supported codec for voice
compression, based on the requested codec capability coming from the source router. When a
default dial peer is matched, the voice path in one direction may have different parameters than
the voice in the return direction. This may cause one side of the connection to report goodquality voice, while the other side reports poor-quality voice. For example, the outbound dial
peer has VAD disabled, but the inbound call leg is matched against the default dial peer, which
has VAD enabled. In this example, VAD is on in one direction and off in the return direction.
When the default dial peer is matched on an inbound POTS call leg, there is no default IVR
application with the port; as a result, the user gets a dial tone and proceeds with dialed digits.
The use of a catch all dial peer that will match all calls can prevent the use of the default dial
peer and send any matches to a default location like the operator or an automated attendant
(AA).
4-154
End-to-End Calls
IP Telephony
Cisco Public
112
An end-to-end voice call consists of four call legs: two from the originating router (R1) or
gateway perspective and two from the terminating router (R2) or gateway perspective. An
inbound call leg originates when an incoming call comes into the router or gateway. An
outbound call leg originates when a call is placed from the router or gateway.
A call is segmented into call legs and a dial peer is associated with each call leg. The process
for call setup is listed below:
1. The plain old telephone service (POTS) call arrives at R1 and an inbound POTS dial peer is
matched.
2. After associating the incoming call to an inbound POTS dial peer, R1 creates an inbound
POTS call leg and assigns it a Call ID (Call Leg 1).
3. R1 uses the dialed string to match an outbound voice network dial peer.
4. After associating the dialed string to an outbound voice network dial peer, R1 creates an
outbound voice network call leg and assigns it a Call ID (Call Leg 2).
5. The voice network call request arrives at Router 2 (R2) and an inbound voice network dial
peer is matched.
Copyright 2005, Cisco Systems, Inc
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Analog
4-155
6. After R2 associates the incoming call to an inbound voice network dial peer, R2 creates the
inbound voice network call leg and assigns it a Call ID (Call Leg 3). At this point, both R1
and R2 negotiate voice network capabilities and applications, if required.
When the originating router or gateway requests non-default capabilities or applications, the
terminating router or gateway must match an inbound voice network dial peer that is
configured for such capabilities or applications.
7. R2 uses the dialed string to match an outbound POTS dial peer.
8. After associating the incoming call setup with an outbound POTS dial peer, R2 creates an
outbound POTS call leg, assigns it a Call ID, and completes the call (Call Leg 4).
4-156
answer-address
Defines the originating calling number or automatic number
identification (ANI) string
destination-pattern
Uses the calling number (originating or ANI string) to match the
incoming call leg to an inbound dial peer
port
Attempts to match the configured dial-peer port to the voice-port
associated with the incoming call (POTS dial peers only)
IP Telephony
Cisco Public
113
When determining how inbound dial peers are matched on a router, it is important to note
whether the inbound call leg is matched to a POTS or VoIP dial peer. Matching occurs in the
following manner:
Inbound POTS dial peers are associated to the incoming POTS call legs of the originating
router or gateway.
Inbound VoIP dial peers are associated to the incoming VoIP call legs of the terminating
router or gateway.
Three information elements sent in the call setup message are matched against four
configurable dial-peer command attributes.
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Analog
4-157
The three call setup information elements that are known about calls arriving at the gateway
are:
Call Setup Information Elements
Call Setup Element
Description
Voice Port
When the Cisco IOS router or gateway receives a call setup request, it makes a dial peer match
for the incoming call. This is not digit-by-digit matching; instead, the router uses the full digit
string received in the setup request for matching against the configured dial peers.
The router or gateway matches call setup element parameters in the following order:
How the Router or Gateway Matches Inbound Dial Peers
Step
Action
The router or gateway attempts to match the called number of the call setup
request with the configured incoming called-number of each dial peer
If a match is not found, the router or gateway attempts to match the calling
number of the call setup request with answer-address of each dial peer
If a match is not found, the router or gateway attempts to match the calling
number of the call setup request to the destination-pattern of each dial peer
The voice port uses the voice port number associated with the incoming call setup
request to match the inbound call leg to the configured dial peer port parameter
If multiple dial peers have the same port configured, then the router or gateway
matches the first dial peer added to the configuration
If a match is not found in the previous steps, then the default is dial-peer 0
Because call setups always include DNIS information, it is recommended that you use the
incoming called-number command for inbound dial-peer matching. Configuring incoming
called-number is useful for a company that has a central call center providing support for a
number of different products. Purchasers of each product get a unique 1-800 number to call for
support. All support calls are routed to the same trunk group destined for the call center. When
a call comes in, the computer telephony system uses the DNIS to flash the appropriate message
on the computer screen of the agent to whom the call is routed. The agent will then know how
to customize the greeting when answering the call.
The calling number ANI with answer address is useful when you want to match calls based on
the originating calling number. For example, when a company has international customers who
require foreign-language-speaking agents to answer the call, the call can be routed to the
appropriate agent based on the country of call origin.
4-158
You must use the calling number ANI with destination pattern when the dial peers are set up
for two-way calling. In a corporate environment, the head office and the remote sites must be
connected. As long as each site has a VoIP dial peer configured to point to each site, inbound
calls from the remote site will match against that dial peer.
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Analog
4-159
IP Telephony
Cisco Public
114
Action
On VoIP dial peers, the session target command forwards the call
Use the show dialplan number string command to determine which dial peer is
matched to a specific dialed string. This command displays all matching dial peers
in the order that they are used.
Example
In the figure, dial-peer 1 matches any digit string that has not matched other dial peers more
specifically. Dial-peer 2 matches any seven-digit number in the 2000 and 3000 range of
numbers starting with 555. Dial-peer 3 matches any seven-digit number in the 1000 range of
numbers starting with 555. Dial-peer 4 matches the specific number 5551234 only. When the
4-160
number 5551234 is dialed, dial-peers 1, 3, and 4 all match that number, but dial-peer 4 places
that call because it has the most specific destination pattern.
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Analog
4-161
IP Telephony
Cisco Public
115
Use the no digit-strip command to disable the automatic digit-stripping function. This allows
the router to match digits and pass them to the telephony interface.
By default, when the terminating router matches a dial string to an outbound POTS dial peer,
the router strips off the left-justified digits that explicitly match the destination pattern. The
remaining digits, or wildcard digits, are forwarded to the telephony interface, which connects
devices such as a PBX or the PSTN.
Digit stripping is the desired action in some situations. There is no need to forward digits out of
a POTS dial peer if it is pointing to an FXS port that connects a telephone or fax machine. If
digit stripping is turned off on this type of port, the user may hear tones after answering the call
because any unconsumed and unmatched digits are passed through the voice path after the call
is answered.
In other situations, where a PBX or the PSTN is connected through the POTS dial peer, digit
stripping is not desired because these devices need additional digits to further direct the call. In
this situation, the administrator must assess the number of digits that need to be forwarded for
the remote device to correctly process the call. With a VoIP dial peer, all digits are passed
across the network to the terminating voice-enabled router.
4-162
Digit Collection
IP Telephony
Cisco Public
116
Action
The originating router collects dialed digits until it matches an outbound dial peer
The router immediately places the call and forwards the associated dial string
Example
The figure demonstrates the impact that overlapping destination patterns have on the callrouting decision. In example 1, the destination pattern in dial-peer 1 is a subset of the
destination pattern in dial-peer 2. Because the router matches one digit at a time against
available dial peers, an exact match will always occur on dial-peer 1, and dial-peer 2 will never
be matched.
In example 2, the length of the destination patterns in both dial peers is the same. Dial-peer 2
has a more specific value than dial-peer 1, so it will be matched first. If the path to IP address
10.18.0.2 is unavailable, dial-peer 1 will be used.
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Analog
4-163
Destination Pattern
5551234
5551234
5551234
555.
5551234
5551234
555
555
5551234
555T
5551234
In the first row of the table, the destination pattern specifies a seven-digit string. The first digit
must be a five, and the remaining six digits can be any valid digits. All seven digits must be
entered before the destination pattern is matched.
In the second row, the destination pattern specifies a seven-digit string. The first three digits
must be 555, and the remaining four digits can be any valid digits. All seven digits must be
entered before the destination pattern is matched.
In the third row, the destination pattern specifies a three-digit string. The dialed digits must be
exactly 555. When the user begins to dial the seven-digit number, the destination pattern
matches after the first three digits are entered. The router then stops collecting digits and places
the call. If the call is set up quickly, the answering party at the other end may hear the
remaining four digits as the user finishes dialing the string. After a call is set up, any dual-tone
multifrequency (DTMF) tones are sent through the voice path and played out at the other end.
In the last row, the destination pattern specifies a variable-length digit string that is at least
three digits long. The first three digits must be exactly 555, and the remaining digits can be any
valid digits. The T tells the router to continue collecting digits until the interdigit timer
expires. The router stops collecting digits when the timer expires, or when the user presses the
pound (#) key.
4-164
forward-digits
Dial-peer command
Controls the number of digits forwarded to the telephony interface
digit translation
Global and dial-peer command
Digit translation rules are used to manipulate the calling number, or ANI,
or the called number, or DNIS, digits for a voice call
IP Telephony
Cisco Public
117
Digit manipulation is the task of adding or subtracting digits from the original dialed number to
accommodate user-dialing habits or gateway needs. The digits can be manipulated before
matching an inbound or outbound dial peer. The following is a list of digit manipulation
commands and their uses:
prefix: This dial-peer command adds digits to the front of the dial string before it is
forwarded to the telephony interface. This occurs after the outbound dial peer is matched,
but before digits get sent out of the telephony interface. Use the prefix command when the
dialed digits leaving the router must be changed from the dialed digits that had originally
matched the dial peer; for example, a call is dialed using a four-digit extension such as
1234, but the call needs to be routed to the PSTN, which requires ten digit dialing. If the
four-digit extension matches the last four digits of the actual PSTN telephone number, then
you can use the prefix command, prefix 902555, to prepend the six additional digits
needed for the PSTN to route the call to 902-555-1234. After the POTS dial peer is
matched with the destination pattern of 1234, the prefix command prepends the additional
digits, and the string 9025551234 is sent out of the voice port to the PSTN.
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Analog
4-165
forward-digits: This dial-peer command specifies the number of digits that must be
forwarded to the telephony interface, regardless of whether they are explicitly matched or
wildcard matched. This command occurs after the outbound dial peer is matched, but
before the digits are sent out of the telephony interface. When a specific number of digits
are configured for forwarding, the count is right justified. For example, if the POTS dial
peer has a destination pattern configured to match all extensions in the 1000 range
(destination-pattern 1), by default, only the last three digits are forwarded to the PBX
that is connected to the specified voice port. If the PBX needs all four digits to route the
call, you must use the command forward-digits 4, or forward-digits all, so that the
appropriate number of digits are forwarded.
Note
To restore the forward-digits command to its default setting, use the default forwarddigits command. Using the no forward-digits command specifies that no digits are to be
forwarded.
number expansion table (num-exp): This global command expands an extension into a
full telephone number or replaces one number with another. The number expansion table
manipulates the called number. This command occurs before the outbound dial peer is
matched; therefore, you must configure a dial peer with the expanded number in the
destination pattern for the call to go through. The number expansion table is useful, for
example, where the PSTN changes the dialing requirements from seven-digit dialing to tendigit dialing. In this scenario, you can do one of the following:
Make all the users dial all ten digits to match the new POTS dial peer that is pointing to
the PSTN
Allow the users to continue dialing the seven-digit number as they have before, but
expand the number to include the area code before the ten-digit outbound dial peer is
matched.
Note
4-166
You must use the show num-exp command to view the configured number-expansion
table. You must use the show dialplan number number command to confirm the presence
off a valid dial peer to match the newly expanded number.
digit translation: Digit translation is a two-step configuration process. First, the translation
rule is defined at the global level. Then, the rule is applied at the dial-peer level either as
inbound or outbound translation on either the called or calling number. Translation rules
manipulate the ANI or DNIS digits for a voice call. Translation rules convert a telephone
number into a different number before the call is matched to an inbound dial peer, or before
the outbound dial-peer forwards the call. For example, an employee may dial a five-digit
extension to reach another employee of the same company at another site. If the call is
routed through the PSTN to reach the other site, the originating gateway may use
translation rules to convert the five-digit extension into the ten-digit format that is
recognized by the central office (CO) switch.
You can also use translation rules to change the numbering type for a call. For example, some
gateways may tag a number with more than 11 digits as an international number, even when the
user must dial 9 to reach an outside line. In this case, the number that is tagged as an
international number needs to be translated into a national numberwithout the 9before it is
sent to the PSTN.
As illustrated in this topic, there are numerous ways to manipulate digits at various stages of
call completion. In many cases, several of these tools will provide a workable solution. The
administrator needs to determine which command will be most suitable and the requirements
that are necessary for manipulation.
Note
To test configured translation rules, you must use the test translation command.
Example
The following is a sample configuration using the prefix command:
dial-peer voice 1 pots
destination-pattern 555.
prefix 555
port 1/0/0
In the sample configuration using the prefix command, the device attached to port 1/0/0 needs
all seven digits to process the call. On a POTS dial peer, only wildcard-matched digits are
forwarded by default. Use the prefix command to send the prefix numbers of 555 before
forwarding the four wildcard-matched digits.
The following is a sample configuration using the forward-digits command:
dial-peer voice 1 pots
destination-pattern 555.
forward-digits 7
port 1/0/0
In the sample configuration using the forward-digits command, the device attached to port
1/0/0 needs all seven digits to process the call. On a POTS dial peer, only wildcard-matched
digits are forwarded by default. The forward-digits command allows the user to specify the
total number of digits to forward.
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Analog
4-167
The following is a sample configuration using the number expansion table command:
num-exp 2 5552
dial-peer voice 1 pots
destination-pattern 5552
port 1/1/0
In the sample configuration using the number expansion table command, the extension
number of 2 is expanded to 5552 before an outbound dial peer is matched. For example,
the user dials 2401, but the outbound dial-peer 1 is configured to match 5552401.
The following is a sample configuration using the digit translation command:
translation-rule 5
rule 1 2401 5552401
dial-peer voice 1 pots
translate-outgoing called-number 5
In the sample configuration using the translation-rule command, the rule is defined to
translate 2401 into 5552401. The dial peer translate-outgoing called-number 5 command
notifies the router to use the globally defined translation rule 5 to translate the number before
sending the string out the port. It is applied as an outbound translation from the POTS dial peer.
The following example shows a translation rule that converts any called number that starts with
91 and is tagged as an international number into a national number without the 9 before sending
it to the PSTN.
translation-rule 20
rule 1 91 1 international national
!
!
dial-peer voice 10 pots
destination-pattern 91..........
translate-outgoing called 20
port 1/1:5
forward-digits all
4-168
PLAR
This topic describes the use of PLAR connections
PLAR Connection
IP Telephony
Cisco Public
118
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Analog
4-169
3. The router at the remote site matches digits 5600 to Voice over IP (VoIP) dial peer 5 and
sends the setup message with the digits 5600 to IP address 10.18.0.1 as designated in the
session target statement.
4. The router at the central site matches received digits 5600 to plain old telephone service
(POTS) dial peer 1 and forwards digits 5600 out voice port 1/0:1. At the same time, it sends
a call-complete setup message to the router at the remote site because both the inbound and
outbound call legs on the central site router were processed correctly.
5. The PBX receives digits 5600 and rings the appropriate telephone.
4-170
Class of Restriction
Class of Restriction (COR)
This topic describes Class of Restriction (COR).
IP Telephony
Cisco Public
120
The Class of Restrictions (COR) feature provides the ability to deny certain call attempts based
on the incoming and outgoing CORs provisioned on the dial peers.
COR is used to specify which incoming dial peer can use which outgoing dial peer to make a
call. Each dial peer can be provisioned with an incoming and an outgoing COR list. The COR
command sets the dial peer COR parameter for dial peers and the directory numbers that are
created for Cisco IP phones associated with the Cisco CME router. COR functionality provides
the ability to deny certain call attempts on the basis of the incoming and outgoing class of
restrictions that are provisioned on the dial peers. This functionality provides flexibility in
network design, allows users to block calls (for example, calls to 900 numbers), and applies
different restrictions to call attempts from different originators.
If the COR applied on an incoming dial peer (for incoming calls) is a superset or equal to the
COR applied to the outgoing dial peer (for outgoing calls), the call will go through. Incoming
and outgoing are with respect to the "voice ports."
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Analog
4-171
incoming COR for the router/voice-port. Similarly, if you make a call to that FXS phone, then
it is an outgoing call and will use the outgoing COR for the voice-port.
Class of Restriction
Incoming COR
or
Outgoing COR
or
IP Telephony
Cisco Public
121
When the incoming COR list is applied to an ephone-dn or dial-peer, the members of the COR
list will be similar to keys. These keys will be used to unlock the outgoing COR list that is
applied to the ephone-dn or dial peer that matches the digits of the destination pattern. The
outgoing COR list is similar to having a lock or locks on it. In order to use the dial peer or
ephone-dn with an outgoing COR list, the incoming COR list must have all the members (keys)
that the outgoing COR list has.
The lack of an incoming COR list allows that ephone-dn or dial peer to call any other ephonedn or dial peer regardless of the outgoing COR list. This is like having a master key for all
locks. The lack of an outgoing COR list allows any ephone-dn or dial peer to complete calls to
this ephone-dn or dial peer regardless of the incoming COR setting.
4-172
Class of Restriction
COR List on Incoming
dial-peer or ephone-dn
COR List on
Outgoing dial-peer or
ephone-dn
Result
Reason
No COR
No COR
Call Succeeds
No COR
Outgoing COR
applied
Call Succeeds
No COR
Call Succeeds
Outgoing COR
applied
Call Succeeds
Outgoing COR
applied
Call cannot be
completed
IP Telephony
Cisco Public
122
By default, an incoming call leg has the highest COR priority and the outgoing COR list has the
lowest COR priority. This means that if there is no COR configuration for incoming calls on a
dial peer, then you can make a call from this dial peer (a phone attached to this dial peer) going
out of any other dial peer, irrespective of the COR configuration on that dial peer.
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Analog
4-173
IP Telephony
Cisco Public
123
dial-peer
dial-peer cor
cor custom
custom
name
name class-name
class-name
IP Telephony
4-174
Cisco Public
124
Step 1
dial-peer
dial-peer cor
cor list
list list-name
list-name
member
member class-name
class-name
IP Telephony
Cisco Public
125
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Analog
4-175
Step 2
Dial peer COR list and member commands set the capabilities of a COR list. COR list is used
in dial peers to indicate the restriction that a dial peer has as an outgoing dial peer. The order of
entering the members is not important and the list can be appended or made shorter by
removing the members.
dial-peer
dial-peer voice
voice number
number {pots
{pots || voip}
voip}
corlist
corlist {incoming
{incoming || outgoing}
outgoing} list-name
list-name
IP Telephony
4-176
Cisco Public
126
Step 3
Apply the incoming or outgoing COR list to the dial peer. The incoming COR list specifies the
capacity of dial-peer to initiate a certain series or Class of Calls. The outgoing COR list
specifies the restriction on dial peers able to place calls to a given number range or port.
ephone-dn
ephone-dn tag
tag
cor
cor {incoming
{incoming || outgoing}
outgoing} list-name
list-name
Cisco Public
127
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Analog
4-177
Step 4
Apply the incoming or outgoing COR list to an ephone-dn. The Incoming COR list specifies
the capacity of ephone-dn to initiate a certain series or Class of Calls. The outgoing COR list
specifies the restriction on the ephone-dn to be able to place calls to a given number range or
port.
4-178
name 2xxx
dial-peer cor list Executive
member 1xxx
member 2xxx
dial-peer cor list Employee
member 1xxx
ephone-dn 1
number 1000
cor incoming Employee
ephone-dn 2
number 2000
cor outgoing Executives
IP Telephony
Ephone-dn 1
Employee
Ephone-dn 2
Executive
Ext 1000
Ext 2000
Cisco Public
128
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Analog
4-179
Cisco Public
129
911
name 911
name local
name long_distance
name international
local
long_distance
name 900
international
900
Step 1 - Define the classes of restriction
IP Telephony
Step 1
4-180
Cisco Public
130
member 911
member 911
member local
member 911
member local
dial-peer cor list Sales
member 911
member international
member local
member long_distance
dial-peer cor list Executive
member 911
member local
member long_distance
member international
Step 2
Cisco Public
IP Telephony
131
The second step will be to define the COR list and its member or members. Notice that none of
the COR lists contain the member 900.
Step 3
port 1/0/0
corlist outgoing call900
Cisco Public
132
Assign the COR to the dial peers that govern PSTN access. To restrict calls to the PSTN
destinations, the outbound COR setting will be defined.
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Analog
4-181
Note
Although not shown here, the inbound COR can be set to regulate where calls arriving from
the PSTN will be allowed to connect internally.
number 1001
cor incoming Lobby
ephone-dn 2
Ephone-dn 2
COR in Employee
Ext 1002
number 1002
cor incoming Employee
ephone-dn 3
Ephone-dn 3
COR in Sales
Ext 1003
Ephone-dn 4
COR in Executive
Ext 1004
IP Telephony
Step 4
4-182
number 1003
cor incoming Sales
ephone-dn 4
number 1004
cor incoming Executive
Cisco Public
133
Assign the incoming COR to the Lobby, Employee, Sales, and Executive ephone-dns. Notice
that no ephone-dn has the ability to call 900 numbers.
IP Telephony
Ephone-dn 1
COR in Lobby
Ext 1001
Ephone-dn 2
COR in Employee
Ext 1002
Ephone-dn 3
COR in Sales
Ext 1003
Ephone-dn 4
COR in Executive
Ext 1004
Cisco Public
134
Voice Dial Plans, Configuring Voice Interfaces and Dial Peers > Configuring Analog
4-183