Professional Documents
Culture Documents
IP Telephony
Express
Version 2.0
Student Guide
Text Part Numbers: 97-2192-01
97-2193-01
97-2194-01
97-2195-01
Volume 1
Table of Contents
Course Introduction 1
Overview
Learner Skills and Knowledge 1
Course Goal and Objectives 2
Course Flow Diagram
Additional References
Cisco Glossary of Terms 4
1
3
4
Describing the Cisco CallManager Express Voice Packet Handling Methods 1-65
Overview
Objectives
IP Phone Calls
Packet Forwarding, Voice Packet Priority, and RTP Stream Information 1-72
WAN Call Setup
Summary
Module Summary
References
Module Self-Check
Module Self-Check Answer Key 1-85
1-1
1-1
1-3
1-3
1-14
1-19
1-21
1-21
1-22
1-29
1-32
1-34
1-44
1-45
1-45
1-54
1-63
1-65
1-65
1-66
1-74
1-78
1-79
1-80
1-81
2-1
2-1
Overview
Objectives
Setting Up Phones in a Cisco CallManager Express System 2-138
Manual Phone Setup
Partially Automated Phone Setup 2-150
Automated Phone Setup 2-154
Optional Parameters
Rebooting Cisco CallManager Express Phones 2-163
Setup Troubleshooting Tips 2-166
Verifying Cisco CallManager Express Phone Configuration 2-171
Summary
Module Summary
2-3
2-3
2-36
2-37
2-37
2-38
2-44
2-51
2-54
2-59
2-79
2-81
2-81
2-82
2-88
2-95
2-97
2-97
2-99
2-102
2-108
2-126
2-127
2-127
2-132
2-135
2-136
2-137
2-137
2-139
2-159
2-172
2-173
References
Module Self-Check
Module Self-Check Answer Key 2-179
2-173
2-174
Volume 2
Configuring PSTN Interfaces and Voice Dial Peers 3-1
Overview
Module Objectives
3-3
3-3
3-4
3-5
3-13
3-14
Overview
Objectives
Foreign Exchange Station Port Configuration 3-17
Configuration Parameters 3-18
Foreign Exchange Office Port Configuration 3-20
Configuration Parameters 3-20
Ear and Mouth Port Configuration 3-22
Configuration Parameters 3-22
Timers and Timing
Configuration Parameters 3-24
Digital Voice Port Configuration 3-26
Configuration Parameters 3-26
Channel Associated Signaling Configuration 3-29
Common-Channel Signaling: BRI 3-31
Common-Channel Signaling: PRI 3-38
Summary
3-15
3-16
Overview
Objectives
What Is a Dial Peer?
Plain Old Telephone Service Dial Peers 3-49
Example
VoIP Dial Peers
Example
Destination-Pattern Options 3-53
Example
What Is the Default Dial Peer? 3-56
Example
Summary
3-45
3-45
3-46
Copyright
3-1
3-1
3-24
3-43
3-50
3-51
3-52
3-55
3-57
3-58
3-59
3-59
3-60
3-60
3-61
Example
Digit Collection and Consumption 3-67
Example
What Is Digit Manipulation? 3-70
Example
PLAR
Summary
Overview
Objectives
Class of Restriction
Example: Incoming and Outgoing COR Example 3-79
Steps to Configure Class of Restriction 3-81
Example: Name the COR and Lists 3-82
Example: Define the COR Lists 3-83
Example: Apply the COR to the Dial Peer 3-84
Example: Apply the COR to Ephone-dns 3-85
Example: COR Used to Restrict Access Internally Within Cisco CallManager Express 3-86
Summary
Overview
Objectives
H.450.x Series Protocols 3-92
Call Transfer Using H.450.2 3-93
Call Forwarding Using H.450.3 3-100
H.450.12
Issues and Workarounds for H.450.x Protocols 3-109
Summary
Module Summary
References
Module Self-Check
Module Self-Check Answer Key 3-122
3-66
3-68
3-72
3-74
3-76
3-77
3-77
3-78
3-90
3-91
3-91
3-106
3-116
3-117
3-117
3-118
Overview
Objectives
Call Transfer
Call Forwarding
Call Waiting
Call Park
IP Phone Display
Softkey Customization
Calling and Directory Features 4-60
Conferencing
Productivity Tools
Custom IP Phone Rings 4-78
4-1
4-2
4-3
4-3
4-4
4-14
4-25
4-27
4-27
4-28
4-35
4-41
4-44
4-47
4-55
4-65
4-68
Overview
Objectives
Ephone Hunt Groups
Dynamic Hunt Group Login and Logout 4-104
Automatic Logout of a Hunt Group 4-106
B-ACD Service
Summary
4-81
4-82
4-92
4-93
4-93
4-94
4-108
4-129
4-131
4-131
4-142
4-143
4-143
4-146
4-150
4-151
4-154
4-154
4-155
4-155
4-156
Volume 3
Configuring Cisco Unity Express Automated Attendant and Voice Mail 1
Overview
Module Objectives
Overview
Objectives
Cisco Unity Express Software Download 16
Hardware Installation
IOS Router and Cisco CallManager Express Prerequisite Configuration 28
Connecting to the CUE Module 33
Copyright
1
2
3
3
4
6
7
10
13
15
15
18
Overview
Objectives
Introduction and Tools
Gather Facts and Define Problem 254
Continue Gathering Facts 255
Consider Possibilities 255
Create and Implement the Action Plan 255
Observe Results
Repeat As Necessary 256
Document the Changes 256
Software Architecture Overview 286
36
43
73
75
75
82
84
85
99
100
109
136
144
146
147
147
148
155
166
180
188
189
189
202
214
222
243
251
253
253
254
256
296
316
317
317
318
Volume 4
Introducing IP Quality of Service 6-1
Overview
Module Objectives
6-1
6-1
Overview
Objectives
Quality of Service Defined 6-4
Converged Networks
Converged Networks Quality Issues 6-7
Lack of Bandwidth
End-to-End Delay
Example: Effects of Delay 6-12
Packet Loss
QoS Requirements
QoS Policy
QoS for Converged Networks 6-22
Example: Traffic Classification 6-23
Example: Defining QoS Policies 6-24
LAN QoS Considerations 6-25
Summary
6-3
6-3
Copyright
6-5
6-9
6-11
6-15
6-17
6-20
6-27
6-29
6-29
6-32
6-33
6-40
6-41
6-41
6-42
6-43
6-44
6-45
6-49
6-50
6-52
6-53
6-53
Overview
Objectives
AutoQoS
AutoQoS: Router Platforms 6-80
AutoQoS: Switch Platforms 6-81
AutoQoS Prerequisites
Configuring AutoQoS
Example: Configuring the AutoQoS VoIP Feature on a High-Speed Serial Interface 6-86
Example: Configuring the AutoQoS VoIP Feature on a Low-Speed Serial Interface 6-86
Example: Using the Port-Specific AutoQoS Macro 6-90
Monitoring AutoQoS
Example: show auto qos command and show auto qos interface command 6-93
Automation with Cisco AutoQoS 6-98
Summary
Overview
Relevance
Objectives
Learner Skills and Knowledge 6-101
Required Resources 6-102
Job Aids
Outline
Case Study Verification 6-102
Review Customer QoS Requirements 6-103
Company Background 6-103
Customer Situation 6-103
Identify QoS Service Class Requirements 6-105
Identify Network Locations Where QoS Mechanisms Should be Applied 6-106
Present Your Solution 6-108
Case Study Answer Key 6-109
Module Summary
References
Module Self-Check Overview 6-116
Module Self-Check Answer Key 6-118
6-56
6-60
6-62
6-70
6-73
6-75
6-75
6-76
6-83
6-85
6-92
6-99
6-101
6-101
6-101
6-102
6-102
6-113
6-114
Designing Cisco CallManager Express and Cisco Unity Express Networks 7-1
Overview
Module Objectives
viii IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
7-1
7-1
7-3
7-3
Copyright
7-26
7-27
7-27
7-38
7-39
7-39
7-40
IPTX
Course Introduction
Overview
LANs
WANs
IP Switching
IPTX
Basic Internetworking
Skills
PSTN Operations
and Technologies
PBX Essentials
IPTX v2.07
Upon completing this course, you will be able to meet these objectives:
Describe the similarities and differences between a traditional PSTN, voice networks, and
IP telephony solutions
Explain the processes and standards for voice digitization, compression, and digital
signaling as they relate to VoIP networks
Configure voice interfaces on Cisco voice-enabled equipment for connection to traditional,
nonpacketized telephony equipment
Configure the Cisco CallManager Express system from either the CLI or a GUI web
interface
Understand and configure the devices for and connections to the Cisco CallManager
Express system
Configure the call flows for POTS, VoIP, and default dial peers
Describe the fundamentals of VoIP and identify challenges and solutions regarding its
implementation
Install and configure the CUE module for voice mail services
Troubleshoot both Cisco CallManager Express and CUE
Apply QoS to the IP network with the use of the AutoQoS
Apply your knowledge of Cisco CallManager Express and CUE to deploy and design an
installation
A
M
Introducing
Cisco
CallManager
Express
Configuring
Cisco
CallManager
Express
Configuring
Additional Cisco
CallManager
Express Features
Configuring PSTN
Interfaces and
Voice Dial Peers
Configuring Cisco
Unity Express
Automated
Attendant and
Voice Mail
Configuring
Cisco Unity
Express
Automated
Attendant and
Voice Mail
Designing
Cisco
CallManager
Express and
Cisco Unity
Express
Networks
Lunch
P
M
Configuring
Cisco
CallManager
Express
Configuring PSTN
Interfaces and
Configuring Cisco
Voice Dial Peers
Unity Express
Automated
Attendant and
Configuring
Voice Mail
Additional Cisco
CallManager
Express Features
Introducing IP
Quality of
Service
Designing
Cisco
CallManager
Express and
Cisco Unity
Express
Networks
IPTX v2.011
The schedule reflects the recommended structure for this course. This structure allows enough
time for the instructor to present the course information and for you to work through the lab
activities. The exact timing of the subject materials and labs depends on the pace of your
specific class.
Additional References
This topic presents the Cisco icons and symbols used in this course, as well as information on
where to find additional technical references.
PBX
(small)
Network
Cloud,
White
Network
Cloud,
Standard
Color
Voice-Enabled
Communications
Server
PIX Firewall
(right and left)
Phone
IP Phone
PC
Si
Phone 2
ATM
Switch
Laptop
Multilayer Switch,
with Text, without Text,
and Subdued
Cisco
CallManager
Express
Generic
Softswitch
Workgroup
Web
Browser
Voice-Enabled
ATM Switch
Si
PBX/
Switch
Server
IPTX v2.012
Module 1
Module Objectives
Upon completing this module, you will be able to describe the similarities and differences
between traditional telephony and Voice over IP (VoIP). This includes being able to meet these
objectives:
Describe the key features and functionality of the Cisco CallManager Express system
Explain the differences between traditional voice and VoIP
Describe the challenges and solutions associated with VoIP delivery in LAN and WAN
Describe the Cisco CallManager Express voice packet handling methods
1-2 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Lesson 1
This lesson describes the key features and functionality of Cisco CallManager Express and
Cisco Unity Express (CUE). This includes the licensing scheme and the effect of licensing on
activation of features. Learners will be directed to the Cisco website for up-to-date information
on licensing.
Objectives
Upon completing this lesson, you will be able to explain the differences between traditional
voice and Voice over IP (VoIP). This includes being able to meet these objectives:
Define Cisco CallManager Express
Define CUE
Describe the functionality of Cisco CallManager Express and CUE
Describe licensing requirements and the effect of licensing on feature activation
Trunks
PSTN
WAN
IPTX v2.01-2
1-4 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
2800
3800
3700
2600XM
1700
IPTX v2.01-3
Cisco CallManager Express enables Ciscos large portfolio of multiservice access routers and
integrated services routers to deliver features that are similar to low-end PBX and key system
features, creating a cost-effective, highly reliable, feature-rich IP communications solution for
the small office.
Cisco CallManager Express supports a new generation of intelligent IP Phones with robust
display capabilities. End users can easily customize these Phones based on their changing
needs.
Copyright 2005, Cisco Systems, Inc. Introducing Cisco CallManager Express 1-5
IPTX v2.01-4
CUE offers local voice-mail and automated attendant capabilities for IP Phone users connected
to Cisco CallManager or Cisco CallManager Express in a small office or branch location. CUE
is fully integrated into the branch office router on either a CUE network module (NM-CUE) or
a CUE advanced integration module (AIM-CUE).
1-6 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
AIM-CUE
Cisco 3800, 3700,
2800, 2600XM,
and 2691 routers
IPTX v2.01-5
CUE is currently available on either an NM-CUE, an NM-CUE enhanced capability (NMCUE-EC), or an AIM-CUE. The network-based modules are the more scalable and powerful
modules, but they do consume the whole slot in the chassis in which they reside. The AIMCUE resides on the motherboard of the router; it conserves valuable network module slots and
expands the number of Cisco router platforms on which both voice mail and analog interfaces
may be supported, thereby lowering the cost of an entry-level system.
The storage is either a hard drive in the NM-CUE and NM-CUE-EC or a flash card in the AIMCUE. The hard drive in the NM-CUE and NM-CUE-EC is not a field replaceable unit (FRU).
The whole module must be sent back to Cisco if a hard drive failure occurs. Flash memory has
a limited lifetime and must be replaced after a certain number of writes has occurred. In a
typical environment, this will be every three to five years.
Note
The flash module is an industrial grade flash; off-the-shelf flash cannot be used.
Copyright 2005, Cisco Systems, Inc. Introducing Cisco CallManager Express 1-7
Automated Attendant
IPTX v2.01-6
Voice mail is essential in most enterprises. Voice mail enables messages to be left for
subscribers when they are busy or do not answer a call in a specified amount of time.
An automated attendant is a device that automatically answers calls with an interactive
recording and allows callers to route their call to the desired person or department by entering
the appropriate extension using their telephone keypad. Businesses can customize the greeting
by adding information such as hours and directions.
CUE supports a built-in automated attendant along with its voice-mail capabilities.
1-8 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Register
Register
IPTX v2.01-7
The Cisco CallManager Express system provides PBX-like features and functions for IP
Phones. These features are a result of the concept of a centralized point of control and
intelligence. The Cisco CallManager Express router provides all of the call control and
intelligence needed for IP Phones to place and receive calls. In a Cisco CallManager Express
deployment, the IP Phones are not capable of setting up a call by themselves. In fact, the IP
Phones are completely controlled by the Cisco CallManager Express system and are instructed
how to place and receive calls.
The IP Phones boot up and register with Cisco CallManager Express. If Cisco CallManager
Express is properly configured, calls will be able to be set up and torn down to and from the IP
Phones. The IP Phones and the Cisco CallManager Express router use Skinny Client Control
Protocol (SCCP) to communicate.
Note
Registration across a WAN is not supported. The IP Phones must be on the local LAN with
the Cisco CallManager Express router.
Copyright 2005, Cisco Systems, Inc. Introducing Cisco CallManager Express 1-9
SCCP
SCCP
RTP
Phone APhone B
RTP
IPTX v2.01-8
When a call is placed between two IP Phones that are under the control of Cisco CallManager
Express, SCCP is used to set up the call. SCCP does not go between the two IP Phones, only
between the IP Phone and the Cisco CallManager Express system. After the call is set up, RealTime Transport Protocol (RTP) is used to carry the audio stream. RTP is a common protocol
that is used to carry time-sensitive traffic, such as voice and real-time video. RTP is carried
inside a User Datagram Protocol (UDP) segment, which is then carried inside an IP packet.
This is the sequence of events for a phone call:
Step 1
Step 2
The dialed digits are sent through SCCP to Cisco CallManager Express.
Step 3
Step 4
Step 5
Phone B is answered.
Step 6
Cisco CallManager Express informs each IP Phone about the settings of the other
Phone and instructs both Phones to construct RTP connections.
Step 7
The IP Phones construct two one-way RTP connections for the voice to travel
across, one for Phone As voice to travel to B and one for Phone Bs voice to travel
to A.
Step 8
Step 9
Phone B hangs up, and an SCCP message is sent to Cisco CallManager Express.
Step 10
Cisco CallManager Express sends an SCCP message to Phone A telling it that the
call has been disconnected.
1-10 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
PSTN
IPTX v2.01-9
Cisco CallManager Express can act as the PSTN gateway as well as manage the IP Phones.
There are different types of connections to the PSTN, including digital and analog. The type of
connection depends on the density of connections that is needed, the technology that is
available in the region, the cost of the connections, and the interfaces that are present on the
router.
Copyright 2005, Cisco Systems, Inc. Introducing Cisco CallManager Express 1-11
SIP
Step 5The call is set up, and
voice flows between the CUE
and the PSTN gateway function
of the router.
PSTN
Step 2An
SCCP message
causes the IP
Phone to ring.
PSTN
Gateway
Function
1000
Cisco CallManager Express and CUE interact when Cisco CallManager Express determines
that a call needs to go either to voice mail or to the automated attendant. The slide shows a call
from the PSTN being forwarded to voice mail using the following steps:
Step 1
A call arrives from the PSTN and, based on the called number, is mapped through
the use of direct inward dialing (DID) to an internal extension of 1000.
Step 2
Cisco CallManager Express sends an SCCP message to the IP Phone and causes the
IP Phone to ring.
Step 3
Step 4
A session initiation protocol (SIP) message is sent to the CUE modules IP address
to set up a voice connection using one of the virtual voice ports.
Step 5
The CUE module has a free virtual voice port and answers the call via an SIP
message that goes back to Cisco CallManager Express. Two unidirectional RTP
streams are created between the PSTN gateway function of the router and CUE.
1-12 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
H.323
H.323
Cisco CallManager
Express Cluster
WAN
H.323
SIP
WAN
PSTN
PSTN Gateway and
IP-to-IP Gateway
Functionality
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.01-11
If one Cisco CallManager Express system needs to set up a call to an IP Phone that is under the
control of another Cisco CallManager Express system, then the H.323 protocol needs to be
used between the Cisco CallManager Express systems. This configuration allows for many
different deployments of Cisco CallManager Express to be integrated together through an IPbased WAN link.
The PSTN gateway function can be performed on the Cisco CallManager Express router or on
a separate standalone gateway. If a separate PSTN gateway is used, the additional functionality
of an IP-to-IP gateway can also be run on the router. This would enable the ability to translate
between H.323 and SIP.
Note
A local PSTN is needed for each site for, at the very least, 9-1-1 emergency calls.
Copyright 2005, Cisco Systems, Inc. Introducing Cisco CallManager Express 1-13
Licensing
This topic describes the licensing for Cisco CallManager Express and CUE.
Licensing
Licensing for Cisco CallManager Express
Capable IOS image
IPTX v2.01-12
Both Cisco CallManager Express and CUE have licensing requirements. For Cisco
CallManager Express, first a capable IOS image must be installed on the router, then the proper
feature license must be purchased. The feature license defines how many phones will be
controlled with the Cisco CallManager Express software. The various feature licenses are as
follows:
Feature License FL-CCME-SMALL (up to 24 users)
Feature License FL-CCME-36 (up to 36 users)
Feature License FL-CCME-MEDIUM (up to 48 users)
Feature License FL-CCME-72 (up to 72 users)
Feature License FL-CCME-96 (up to 96 users)
Feature License FL-CCME-120 (up to 120 users)
Feature License FL-CCME-144 (up to 144 users)
Feature License FL-CCME-168 (up to 168 users)
Feature License FL-CCME-192 (up to 192 users)
Feature License FL-CCME-240 (up to 240 users)
In addition to the feature license, each analog phone controlled by an ATA and each IP Phone
requires a seat license. The Cisco CallManager Express seat license is fully transferable to a
Cisco CallManager seat license.
There are 12 licensed user mailboxes included with the CUE module when it is ordered. If
more than 12 mailboxes are needed or desired, a new license file must be installed on the CUE
module.
1-14 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
ISR Bundles
Offer savings and ease of ordering when
compared with ordering each of the components
separately.
Have flexible base package with option to add
additional service modules to provide customer
with complete solution.
Include IOS SP Services for voice gateway
services and features.
Can be easily upgraded.
Include DSP modules to support PSTN-to-IP
connectivity.
Allow country-specific PSTN analog or digital
module to meet customer needs.
Include Cisco IP Communications features
license.
Offer flexibility to choose appropriate CUE module
for voice mail.
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.01-13
Cisco offers a broad choice of IP communications solutions for growing businesses. For
businesses with a need for secure IP data routing with full-service voice capabilities, the Cisco
CallManager Express Bundles offer an affordable entry point into Cisco IP Communications.
These turnkey communications solutions support up to 240 phones and deliver feature-rich call
processing with integrated routing and switching, as well as optional voice mail and automated
attendant.
Small businesses can expect to realize the following returns on their Cisco CallManager
Express Bundles investment:
Cost savings and productivity enhancements: The Cisco CallManager Express Bundles
are an affordable entry point into a converged IP environment that delivers cost savings and
productivity enhancements.
Investment protection: The Cisco CallManager Express Bundles are cost-effective, and
they integrate with existing legacy voice investments while allowing you to migrate to a
Cisco IP Communications system.
Ease of management: The bundle components are integrated within a single chassis,
resulting in turnkey installation and streamlined system management with a common GUI.
Growth: Designed to respond to your dynamic business needs, the Cisco CallManager
Express Bundles can be easily upgraded to support advanced voice applications and
additional users. The complete portfolio of the Cisco IP Communications Solution scales to
support up to 30,000 devices.
Support: With an excellent track record in supporting mission-critical voice applications,
Cisco and its certified partners provide full life-cycle support to deliver the Cisco
CallManager Express Bundles for a maximum return on investment.
Copyright 2005, Cisco Systems, Inc. Introducing Cisco CallManager Express 1-15
Cisco offers a range of bundles tailored to meet the needs of your business. Each bundle
includes a Cisco IP access router for secure data routing, Cisco CallManager Express software
to support IP telephony, Cisco IOS SP Services software for voice gateway services, digital
signal processor (DSP) chips for PSTN calls, and memory. CUE may be added to the bundle in
order to have voice mail and automated attendant capabilities. The base Cisco CallManager
Express Bundles are designed to meet the diverse needs of businesses worldwide.
It is necessary to add the country-specific digital or analog trunk interfaces that are required to
connect to the PSTN or host PBX. To complete the solution, add Cisco IP Phones and Cisco
Catalyst data switches that support inline power.
The various bundles include the following SKUs:
2801-CCME/K9 2801-V router, DSP resources for 8 calls, 24 Cisco CallManager
Express seats, and IOS SP Services
2811-CCME/K9 2811-V router, DSP resources for 16 calls, 36 Cisco CallManager
Express seats, and IOS SP Services
2821-CCME/K9 2821-V router, DSP resources for 32 calls, 48 Cisco CallManager
Express seats, and IOS SP Services
2851-CCME/K9 2851-V router, DSP resources for 48 calls, 96 Cisco CallManager
Express seats, and IOS SP Services
3825-CCME/K9 3825-V/K9 router, DSP resources for 64 calls, 168 Cisco CallManager
Express seats, and IOSSP Services
3845-CCME/K9 3845-V/K9 router, DSP resources for 64 calls, 240 Cisco CallManager
Express seats, and IOS SP Services
1-16 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Release Compatibility
Feature
12 Mailboxes
25 Mailboxes
50 Mailboxes
100 Mailboxes
Personal Mailboxes
12
25
50
100
General Delivery
Mailboxes
NM-CUE: Hours of
Storage
10
15
20
100
100
100
100
NM-CUE-EC: Hours of
Storage
NM-CUE: # of Ports
100
100
100
100
NM-CUE-EC: # of Ports
16
16
16
16
IPTX v2.01-14
There are four CUE license levels available on the NM-CUE and NM-CUE-EC. The hardware
associated with CUE (NM-CUE and AIM-CUE) must be purchased with an accompanying
license. Hardware and software are packaged together. Mailbox licenses are purchased
separately with the exception of the 12-mailbox license level that is included in the price of the
hardware-software bundle. Therefore, a minimum of 12 mailboxes must be ordered with each
CUE purchase.
CUE license files, such as Cisco IOS software, can be downloaded from http://cisco.com and
installed on any number of systems for which a license was purchased without change to the
file itself. When a license is purchased or when software from Cisco is used, or both, a
contractual obligation is created. The subscriber must abide by the terms spelled out in the
license agreement, including prohibitions regarding unauthorized replication of the software
and modification to the mailbox level of the license.
The capacity limitations on ports, subscribers, and mailboxes depend on whether CUE is
running on a network module or an advanced integration module and is controlled by the
license that is installed on the CUE application.
Copyright 2005, Cisco Systems, Inc. Introducing Cisco CallManager Express 1-17
12 Mailboxes
25 Mailboxes
Not Supported
14
14
14
Not Supported
4*
Not Supported
6*
Not Supported
4*
Not Supported
Not Supported
IPTX v2.01-15
There are three CUE license levels available with the AIM-CUE in the 512-MB model and
three license levels available with the AIM-CUE in the 1-GB model. The use of the 50-mailbox
license is discouraged when using the 512-MB model because of port and storage limitations.
The 50-port license is appropriate when using the 1-GB model installed in a 2800, 3700, or
3800 platform.
When the advanced integration module is located in the chassis of a 2600XM series or 2691
router, it is limited to a maximum of four simultaneous ports at any one time. This presents
some port blocking issues that may be manifested when the number of mailboxes approaches
the upper limit of 50.
1-18 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Summary
Summary
Cisco CallManagerExpress is an optional feature
of CiscoIOS software and is available on a wide
range of Cisco access routers that support
asmany as 240 phones.
Cisco CallManagerExpress provides call
processing for IP Phones using SCCP.
CUE provides voice mail and automated attendant
for the small office or branch office.
CUE is fully integrated into Cisco 2600XM, 2691,
2800, 3700, and 3800 series access routers.
Copyright 2005, Cisco Systems, Inc. Introducing Cisco CallManager Express 1-19
IPTX v2.01-16
1-20 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Lesson 2
Explaining Differences
Between Traditional Telephony
and VoIP
Overview
This lesson explains the differences between traditional voice and Voice over IP (VoIP). This
includes a discussion of traditional telephony, pulse code modulation (PCM) theory, and the
basics of voice digitization. It also includes a discussion of the various compression schemes
that are used to transport voice using less bandwidth, using coder-decoder attributes, and
encapsulating voice in IP packets. In addition, the use of compressed Real-Time Transport
Protocol (cRTP) headers, including when and when not to use them, is discussed.
Objectives
Upon completing this lesson, you will be able to explain the differences between traditional
voice and VoIP. This includes being able to meet these objectives:
Identify the components, processes, and features of traditional telephony networks that
provide end-to-end call functionality
Identify the steps for converting analog signals to digital signals and the steps for
converting digital signals to analog signals; state the purpose of the Nyquist theorem;
explain quantization
Explain voice compression and coder-decoder standards; name two types of voice
compression techniques; list three common voice compression standards and their
bandwidth requirements
Describe the functions of RTP and RTCP as they relate to a VoIP network; describe how IP
voice headers are compressed using cRTP and how header size is reduced in order to
efficiently carry voice across the network using VoIP protocols and cRTP
Traditional Telephony
This topic introduces the components of traditional telephony networks. It describes how
central office (CO) switches function and how they make switching decisions, and it explores
PBX and key telephone system functionality in environments today. The topic also discusses
the three call-signaling types: supervisory, address, and informational.
IPTX v2.01-2
A number of components must be in place for an end-to-end call to succeed. These components
are shown in the figure and include the following:
Edge devices
Local loops
Private or CO switches
Trunks
Edge Devices
The two types of edge devices that are used in a telephony network include:
Analog telephones: Analog telephones are most common in home, small business, and
small office, home office (SOHO) environments. A direct connection to the public
switched telephone network (PSTN) is usually made by using analog telephones.
Proprietary analog telephones are occasionally used in conjunction with a PBX. These
phones provide additional functions, such as speakerphone, volume control, PBX messagewaiting indicator, call on hold, and personalized ringing.
Digital telephones: Digital telephones contain hardware to convert analog voice into a
digitized stream. Larger corporate environments with PBXs generally use digital
telephones. Digital telephones are typically proprietary, that is, they work with the PBX or
key system of that vendor only.
1-22 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Local Loops
A local loop is the interface to the telephone company network. Typically, it is a single pair of
wires that carry a single conversation. A home or small business may have multiple local loops.
Private or CO Switches
The CO switch terminates the local loop and handles signaling, digit collection, call routing,
call setup, and call teardown.
A PBX switch is a privately owned switch located at the customers site. A PBX typically
interfaces with other components to provide additional services, such as voice mail.
Trunks
The primary function of a trunk is to provide the path between two switches. There are several
common trunk types, including:
Tie trunk: A dedicated circuit that connects PBXs directly
CO trunk: A direct connection between a local CO and a PBX
Interoffice trunk: A circuit that connects two local telephone company COs
Copyright 2005, Cisco Systems, Inc. Introducing Cisco CallManager Express 1-23
IPTX v2.01-3
The figure shows a typical CO switch environment. The CO switch terminates the local loop
and makes the initial call-routing decision.
The call-routing function forwards the call to one of the following:
Another end-user telephone if it is connected to the same CO
Another CO switch
A tandem switch
The CO switch enables the telephone to work with the following components:
Battery: The battery is the source of power to both the circuit and the telephone it
determines the status of the circuit. When the handset is lifted to let current flow, the
telephone company provides the source that powers the circuit and the telephone. Because
the telephone company powers the telephone from the CO, electrical power outages should
not affect the basic telephone.
Note
Some telephones, such as cordless telephones, require a supplementary power source that
the subscriber supplies. Some cordless telephones may lose function during a power
outage.
Current detector: The current detector monitors the status of a circuit by detecting
whether it is open or closed. See the table Current Flow in a Typical Telephone.
1-24 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Circuit
Current Flow
Dial tone generator: When the digit register is ready, the dial tone generator produces a
dial tone to acknowledge the request for service.
Digit register: The digit register receives the dialed digits.
Ring generator: When the switch detects a call for a specific subscriber, the ring generator
alerts the called party by sending a ring signal to that subscriber.
You must configure a PBX connection to a CO switch that matches the signaling of the CO
switch. This configuration ensures that the switch and the PBX can detect on hook, off hook,
and dialed digits coming from either direction.
CO Switching Systems
Switching systems provide three primary functions:
Call setup, routing, and teardown
Call supervision
Customer IDs and telephone numbers
CO switches switch calls between locally terminated telephones. If a call recipient is not locally
connected, the CO switch decides where to send the call based on its call-routing table. The call
then travels over a trunk to another CO or to an intermediate switch that may belong to an
inter-exchange carrier (IXC). Although intermediate switches do not provide a dial tone, they
act as hubs to connect other switches and provide interswitch call routing.
PSTN calls are traditionally circuit-switched, which guarantees end-to-end path and resources.
Therefore, as the PSTN sends a call from one switch to another, the same resource is associated
with the call until the call is terminated.
Copyright 2005, Cisco Systems, Inc. Introducing Cisco CallManager Express 1-25
What Is a PBX?
IPTX v2.01-4
A PBX is a smaller, privately owned version of the CO switches that are used by telephone
companies.
In a corporate environment, where large numbers of staff need access to each other and to the
outside, individual telephone lines are not economically viable. Most businesses have a PBX
telephone system, a key telephone system, or Centrex service. Large offices, with more than 50
telephones or handsets, choose a PBX to connect users, both in-house and to the PSTN.
PBXs come in a variety of sizes, typically from 20 to 20,000 stations. The selection of a PBX is
important to most companies because a PBX has a typical life span of seven to ten years.
All PBXs offer a standard, basic set of calling features. Optional software provides additional
capabilities.
The figure illustrates the internal components of a PBX: it connects to telephone handsets using
line cards and to the local exchange using trunk cards.
A PBX has three major components:
Terminal interface: The terminal interface provides the connection between terminals and
PBX features that reside in the control complex. Terminals can include telephone handsets,
trunks, and lines. Common PBX features include dial tone and ringing.
Switching network: The switching network provides the transmission path between
two or more terminals in a conversation, such as when two telephones within an office
communicate over the switching network.
Control complex: The control complex provides the logic, memory, and processing for
call setup, call supervision, and call disconnection.
1-26 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.01-5
Small organizations and branch offices often use a key telephone system because a PBX has
functionality and extra features that they may not require. For example, unlike the central
answering position that is required for a PBX, a key system enables small businesses to have
distributed answering from any telephone.
Today, key telephone systems are either analog or digital and are microprocessor-based. Key
systems are typically installed in offices with 30 to 40 users, but can be scaled to support more
than 100 users.
A key system has three major components:
Key service unit: A key service unit (KSU) holds the system switching components,
power, intercom, line and station cards, and system logic.
System software: System software provides the operating system and calling-feature
software.
Telephones (instruments or handsets): Telephones allow the user to choose a free line
and dial out, usually by pressing a button on the telephone.
Copyright 2005, Cisco Systems, Inc. Introducing Cisco CallManager Express 1-27
IPTX v2.01-6
Call signaling, in its most basic form, is the capacity of a user to communicate a need for
service to a network. The call-signaling process requires the ability to detect a request for
termination of service, send addressing information, and provide progress reports to the
initiating party. This functionality corresponds to the three call-signaling types: supervisory,
address, and informational.
The figure shows the three major steps in an end-to-end call. These steps include:
Step 1
Step 2
Network signaling
The switch makes a routing decision and signals the next, or terminating, switch
through the use of setup messages sent across a trunk.
Step 3
1-28 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
PCM Theory
This topic describes the process of converting analog signals to digital signals and converting
digital signals back to analog signals. The topic also describes the Nyquist theorem, which is
the basis for digital signal technology, and explains quantization and its techniques.
IPTX v2.01-7
Digitizing speech was a project first undertaken by the Bell System in the 1950s. The original
purpose of digitizing speech was to deploy more voice circuits with a smaller number of wires.
This evolved into the T1 and E1 transmission methods of today.
To convert an analog signal to a digital signal, you must perform these steps:
Note
Copyright 2005, Cisco Systems, Inc. Introducing Cisco CallManager Express 1-29
Procedure
Description
1.
Sample the analog signal regularly. The sampling rate must be two times the highest
frequency in order to produce playback that appears
neither choppy nor too smooth.
2.
3.
4.
The most commonly used method for converting analog to digital is PCM.
1-30 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Nyquist Theorem
IPTX v2.01-8
Example
Whereas the human ear can sense sounds from 20 to 20,000 Hz and speech encompasses
sounds from about 200 to 9000 Hz, the telephone channel was designed to operate at about
300 to 3400 Hz. This economical range carries enough fidelity to allow callers to identify
the party at the far end and sense their mood. Nyquist decided to extend the digitization to
4000 Hz, to capture higher-frequency sounds that the telephone channel may deliver.
Therefore, the highest frequency for voice is 4000 Hz, or 8000 samples per second, that is,
one sample every 125 microseconds.
If every sample is encoded in 8 bits, this works out to be 8000 samples a second times 8 bits per
sample. This results in a digital voice conversation requiring 64,000 bits per second. The
original digital data circuits that carried digital voice are known as DS0s and sized at 64,000
bits per second.
Copyright 2005, Cisco Systems, Inc. Introducing Cisco CallManager Express 1-31
Quantization
IPTX v2.01-9
Quantization
Quantization involves dividing the range of amplitude values that are present in an analog
signal sample into a set of discrete steps that are closest in value to the original analog signal.
Each step is assigned a unique digital code word.
The figure depicts quantization. In this example, the x-axis is time and the y-axis is the voltage
value (the PAM).
The voltage range is divided into 16 segments (0 to 7 positive and 0 to 7 negative). Starting
with segment 0, each segment has fewer steps than the previous segment, which reduces the
noise-to-signal ratio and makes it uniform. This segmentation also corresponds closely to the
logarithmic behavior of the human ear. If a noise-to-signal ratio problem exists, it is resolved
by using a logarithmic scale to convert PAM to PCM.
1-32 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Quantization Techniques
Linear
Uniform quantization
Logarithmic quantization
Compands the signal
Provides a more uniform signal-to-noise ratio
Two methods
a-law (most countries)
mu-law (Canada, United States, and Japan)
IPTX v2.01-10
Linear sampling of analog signals causes small-amplitude signals to have a higher noise-tosignal ratioand therefore poorer qualitythan larger-amplitude signals. The Bell System
developed the mu-law method of quantization, which is widely used in North America. The
International Telecommunication Union (ITU) modified the original mu-law method and
created a-law, which is used in countries outside North America.
By allowing smaller step functions at lower amplitudes rather than higher amplitudes, mu-law
and a-law provide a method of reducing the noise-to-signal method. Both mu-law and a-law
compand the signal; that is, they both compress the signal for transmission, then expand the
signal back to its original form at the other end.
Using mu-law and a-law results in a more accurate value for smaller amplitudes and uniform
signal-to-noise quantization ratio across the input range.
Both mu-law and a-law are linear approximations of a logarithmic input-output relationship.
They both generate 64-kbps bit streams using 8-bit code words to segment and quantize levels
within segments.
The difference between the original analog signal and the assigned quantization level is called
quantization error, which is the source of distortion in digital transmission systems.
Quantization error is any random disturbance or signal that interferes with the quality of the
transmission or the signal itself.
Note
For communication between a mu-law country and an a-law country, the mu-law country
must change its signaling to accommodate the a-law country.
Copyright 2005, Cisco Systems, Inc. Introducing Cisco CallManager Express 1-33
Coder-Decoder
This topic describes two types of speech-coding schemes, waveform and source coding, and
compares G.729 and G.729a compression.
Voice-Compression Techniques
Waveform algorithms
PCM
ADPCM
Source algorithms
LD-CELP
CS-ACELP
IPTX v2.01-11
1-34 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.01-12
Copyright 2005, Cisco Systems, Inc. Introducing Cisco CallManager Express 1-35
IPTX v2.01-13
Code-excited linear prediction (CELP) compression transforms analog voice signals as follows:
The input to the coder is converted from an 8-bit PCM to a 16-bit linear PCM sample.
A codebook uses feedback to continuously learn and predict the voice waveform.
A white noise generator excites the coder.
The mathematical result (recipe) is sent to the far-end decoder for synthesis and generation
of the voice waveform.
Low-delay CELP (LD-CELP) is similar to Conjugate Structure Algebraic Code Excited Linear
Prediction (CS-ACELP) (see next paragraph) except:
LD-CELP uses a smaller codebook and operates at 16 kbps to minimize look-ahead delay,
keeping it to 2 to 5 ms.
The 10-bit codeword is produced from every five speech samples from the 8-kHz input.
Four of these 10-bit codewords are called a subframe, which takes approximately 2.5 ms to
encode.
Two of these subframes are combined into a 5-ms block for transmission. CS-ACELP is a
variation of CELP that performs these functions:
Codes on 80-byte frames, which take approximately 10 ms to buffer and process.
Adds a look-ahead of 5 ms. A look-ahead is a coding mechanism that continuously
analyzes, learns, and predicts the next waveshape.
Adds noise reduction and pitch-synthesis filtering to processing requirements.
Example
The Annex B variant adds voice activity detection (VAD) in strict compliance with G.729b
standards. When this coder-decoder (codec) variant is used, VAD is not tunable for music
threshold. However, when Cisco VAD is configured, music threshold is tunable.
1-36 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.01-14
G.729, G.729 Annex A (G.729a), G.729 Annex B (G.729b), and G.729a Annex B (G.729ab)
are variations of CS-ACELP.
There is little difference between the ITU recommendations for G.729 and G.729a. All of the
platforms that support G.729 also support G.729a.
G.729 is the compression algorithm that Cisco uses for high-quality 8-kbps voice. When G.729
is properly implemented, it sounds as good as the 32-kbps ADPCM. G.729 is a highcomplexity, processor-intensive compression algorithm that monopolizes processing resources.
Although G.729a is also an 8-kbps compression, it is not as processor-intensive as G.729. It is a
medium-complexity variant of G.729 with slightly lower voice quality. The quality of G.729a
is not as high as G.729 and is more susceptible to network irregularities such as delay,
variation, and tandeming. Tandeming causes distortion that occurs when speech is coded,
decoded, then coded and decoded again, much like the distortion that occurs when a videotape
is repeatedly copied.
Copyright 2005, Cisco Systems, Inc. Introducing Cisco CallManager Express 1-37
Example
On Cisco IOS gateways, you must use the variant (G.729 or G.729a) that is related to the codec
complexity configuration on the voice card. This variant does not show up explicitly in the
Cisco IOS command-line interface (CLI) codec choice. For example, the CLI does not display
g729r8 (alpha code) as a codec option. However, if the voice card is defined as mediumcomplexity, then the g729r8 option is the G.729a codec.
G.729b is a high-complexity algorithm, and G.729ab is a medium-complexity variant of
G.729b with slightly lower voice quality. The difference between the G.729 and G.729b codecs
is that the G.729b codec provides built-in Internet Engineering Task Force (IETF) VAD and
comfort noise generation (CNG).
The following G.729 codec combinations interoperate:
G.729 and G.729a
G.729 and G.729
G.729a and G.729a
G.729b and G.729ab
G.729b and G.729b
G.729ab and G.729ab
1-38 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
This topic describes the functions of RTP and RTP Control Protocol (RTCP) as they relate to
the VoIP network. The topic also describes how IP voice headers are compressed using cRTP,
and it describes when to use cRTP.
IPTX v2.01-15
RTP provides end-to-end network transport functions intended for applications that are
transmitting real-time data, such as audio and video. The functions include payload type
identification, sequence numbering, time-stamping, and delivery monitoring.
RTP typically runs on top of User Datagram Protocol (UDP) to utilize the multiplexing and
checksum services of that protocol. Although RTP is often used for unicast sessions, it is
primarily designed for multicast sessions. In addition to defining the roles of sender and
receiver, RTP also defines the roles of translator and mixer to support the multicast
requirements.
Example
RTP is a critical component of VoIP because it enables the destination device to reorder and
retime the voice packets before they are played out to the user. An RTP header contains a time
stamp and a sequence number, which allows the receiving device to buffer and remove jitter
and latency by synchronizing the packets to play back a continuous stream of sound. RTP
uses sequence numbers to order the packets only. RTP does not request retransmission if a
packet is lost.
For more information on RTP, refer to RFC 1889.
Copyright 2005, Cisco Systems, Inc. Introducing Cisco CallManager Express 1-39
IPTX v2.01-16
RTCP monitors the quality of the data distribution and provides control information. RTCP
provides the following feedback on current network conditions:
RTCP provides a mechanism for hosts involved in an RTP session to exchange information
about monitoring and controlling the session. RTCP monitors the quality of such elements
as packet count, packet loss, delay, and inter-arrival jitter. RTCP transmits packets as a
percentage of session bandwidth, but at a specific rate of at least every 5 seconds.
The RTP standard states that the Network Time Protocol (NTP) time stamp is based on
synchronized clocks. The corresponding RTP time stamp is randomly generated and based
on data-packet sampling. Both NTP and RTP are included in RTCP packets by the sender
of the data.
RTCP provides a separate flow from RTP for transport use by UDP. When a voice stream
is assigned UDP port numbers, RTP is typically assigned an even-numbered port and
RTCP is assigned the next odd-numbered port. Each voice call has four ports assigned:
RTP plus RTCP in the transmit direction and RTP plus RTCP in the receive direction.
Example
Throughout the duration of each RTP call, the RTCP report packets are generated at least every
5 seconds. In the event of poor network conditions, a call may be disconnected because of high
packet loss. When using a packet analyzer to view packets, a network administrator can check
information in the RTCP header that includes packet count, octet count, number of packets lost,
and jitter. The RTCP header information helps in determining why calls are disconnected.
1-40 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Given the number of multiple protocols that are necessary to transport voice over an IP
network, the packet header can be large. You can use cRTP headers on a link-by-link basis to
save bandwidth.
Using cRTP compresses the IP/UDP/RTP header from 40 bytes to 2 bytes without UDP
checksums and from 40 bytes to 4 bytes with UDP checksums. RTP header compression is
especially beneficial when the RTP payload size is small, such as with compressed audio
payloads that are 20 bytes and 50 bytes.
In addition, cRTP assumes that most of the fields in the IP/UDP/RTP header do not change or
that the change is predictable. Static fields include source and destination IP addresses, source
and destination UDP port numbers, and many other fields in all three headers. The following
table illustrates the cRTP process for those fields in which the change is predictable.
cRTP
Stage
What Happens
The change is predictable. The sending side tracks the predicted change.
The predicted change is tracked. The sending side sends a hash of the header.
The receiving side predicts what the
constant change is.
An unexpected change occurs. The sending side sends the entire header without
compression.
Copyright 2005, Cisco Systems, Inc. Introducing Cisco CallManager Express 1-41
1-42 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.01-18
You must configure cRTP on a specific serial interface or subinterface if you have any of these
conditions:
Congested WAN links
Slow links (less than 2 Mbps)
Bandwidth on a WAN interface that needs to be conserved
Compression works on a link-by-link basis and must be enabled for each link that has any of
those conditions. You must enable compression on both sides of the link for proper results.
Enabling compression on both ends of a low-bandwidth serial link can greatly reduce the
network overhead if there is a significant volume of RTP traffic on that slow link.
Note
Compression adds to processing overhead. You must check resource availability on each
device prior to turning on RTP header compression.
Example
If you want the router to compress RTP packets, use the ip rtp header-compression command.
The ip rtp header-compression command defaults to active mode when it is configured.
However,this command provides a passive mode setting in instances where you want the
router to compress RTP packets only if it has received compressed RTP on that interface. When
applying to a Frame Relay interface, use the frame-relay ip rtp header-compression
command.
By default, the software supports a total of 16 RTP header compression connections on an
interface. Depending on the traffic on the interface, you can change the number of header
compression connections with the ip rtp compression-connections number command.
Note
Copyright 2005, Cisco Systems, Inc. Introducing Cisco CallManager Express 1-43
Summary
Summary
Traditional telephony networks are composed of edge devices
such as telephones, local loops, switches, and trunks.
CO switches terminate local loops and provide battery, current
detection, dial tone, ring generation, and the digit registers.
PBXs are privately owned switches that provide basic telephone
connectivity within a corporate environment and that connect to
supplementary services such as voice mail.
The three parts of the analog-to-digital conversion process are
sampling, quantization, and encoding.
The two parts of the digital-to-analog conversion process are
decoding and filtering.
Digital signal technology is based on the Nyquist theorem.
Quantization involves dividing the range of amplitude values of
an analog signal sample.
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.01-19
Summary (Cont.)
The two techniques used for voice compression are waveform
compression and source compression.
G.729 and G.729A compression algorithms are similar variations of
CS-ACELP.
The three common voice compression standards are PCM, ADPCM,
and CELP.
RTP carries packetized audio traffic over an IP network.
RTCP provides feedback on the quality of the call, including
statistics on packet loss, delay, and jitter.
RTP header compression compresses the IP/UDP/RTP header in an
RTP data packet from 40 bytes to approximately 2 to 4 bytes mostof
the time.
RTP header compression is useful if you are running VoIP over
narrowband or slow links or if you need to conserve bandwidth ona
WAN interface.
2005 Cisco Systems, Inc. All rights reserved.
1-44 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.01-20
Lesson 3
Understanding VoIP
Challenges and Solutions
Overview
This lesson discusses the challenges and solutions that are associated with Voice over IP
(VoIP) delivery in LANs and WANs. This includes a discussion on the requirements for voice
delivery in an IP network, the challenges of VoIP, bandwidth requirements, and the need for
quality of service (QoS). In order to understand the QoS issues that you will encounter, you
need to be able to calculate the amount of bandwidth that will be consumed. Several variables
that affect total bandwidth are explained, as is the method for calculating and reducing total
bandwidth.
Objectives
Upon completing this lesson, you will be able to discuss the challenges and solutions associated
with VoIP. This includes being able to meet these objectives:
Determine the best method for improving delivery of voice packets with minimal loss,
delay, and jitter, taking into account the challenges associated with implementing Voice
over IP solutions
Discuss the challenges associated with voice delivery in an IP network
List the bandwidth requirements for various codecs and data links and describe methods to
reduce bandwidth consumption
This topic lists problems associated with implementation of real-time voice traffic in a besteffort IP internetwork and discusses the causes of packet loss, end-to-end delay, and jitter delay
in an IP internetwork. The topic then describes the methods you can use to ensure consistent
delivery and throughput of voice packets in an IP internetwork, and, finally, it describes how
Real-Time Transport Protocol (RTP) ensures consistent delivery order of voice packets in an
IP internetwork.
IP Network
IP is connectionless.
IP provides multiple paths from source to
destination.
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.01-2
The traditional telephony network was originally designed to carry voice. The design of circuitswitched calls provides a guaranteed path and delay threshold between source and destination.
The IP network was originally designed to carry data. Data networks were not designed to carry
voice traffic. Although data traffic is best-effort traffic and can withstand some amount of
delay, jitter, and loss, voice traffic is real-time traffic that requires a certain QoS. In the absence
of any special QoS parameters, a voice packet is treated as just another data packet.
The user must have a well-engineered network, end to end, when running delay-sensitive
applications such as VoIP. Fine-tuning the network to adequately support VoIP involves a
series of protocols and features geared toward QoS.
1-46 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Example
In the IP network shown in the figure, voice packets that enter the network at a constant rate
can reach the intended destination by a number of routes. Because each of these routes may
have different delay characteristics, the arrival rate of the packets may vary. This condition is
called jitter.
Another effect of multiple routes is that voice packets can arrive out of order. The voiceenabled router or gateway on the far end has to re-sort the packets and adjust the interpacket
interval for a proper-sounding voice playout.
Network transmission adds corruptive effects, such as noise, delay, echo, jitter, and packet loss,
to the speech signal. VoIP is susceptible to these network behaviors, which can degrade the
voice application.
If a VoIP network is to provide the same quality that users have come to expect from traditional
telephony services, then the network must ensure that the delay in transmitting a voice packet
across the network and the associated jitter do not exceed specific thresholds.
Copyright 2005, Cisco Systems, Inc. Introducing Cisco CallManager Express 1-47
IPTX v2.01-3
In traditional telephony networks, voice has a guaranteed delay across the network through
strict bandwidth association with each voice stream. Configuring voice in a data network
environment requires network services with minimal packet loss, low delay, and minimal jitter.
Over the long term, packet loss, delay, and jitter all affect overall voice quality. These voice
quality problems are described here.
Packet loss: You can drop voice packets if the network quality is poor, if the network is
congested, or if there is too much variable delay in the network. Coder-decoder (codec)
algorithms can correct small amounts of loss, but too much loss can cause voice clipping
and skips. The chief cause of packet loss is network congestion.
Delay: End-to-end delay is the time that it takes the sending endpoint to send the packet to
the receiving endpoint. End-to-end delay consists of the following two components:
Fixed network delay: You should examine fixed network delay during the initial
design of the VoIP network. The International Telecommunication Union (ITU)
standard G.114 states that a one-way delay budget of 150 ms is acceptable for
high-quality voice. Research at Cisco Systems has shown that there is a negligible
difference in voice-quality scores between networks built with 200-ms delay budgets
and the public switched telephone network (PSTN). Examples of fixed network
delay include propagation delay of signals between the sending and receiving
endpoints, voice encoding delay, and voice packetization time for various
VoIP codecs.
1-48 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Jitter: Jitter is the variation between the expected arrival of a packet and when it is actually
received. To compensate for these delay variations between voice packets in a
conversation, VoIP endpoints use jitter buffers to turn the delay variations into a constant
value so that voice can be played out smoothly. However, buffers can fill instantaneously
because network congestion can be encountered at any time within a network. This
instantaneous buffer use can lead to a difference in delay times between packets in the
same voice stream.
Example
When a calling party says, Good morning, how are you? the effect of packet loss, end-to-end
delay, and jitter can be heard as follows:
With packet loss, the called party hears, Good mning, w are you?
With end-to-end delay, the called party hears, Good morning, how are you?
With jitter, the called party hears, Good morning, how are you?
Copyright 2005, Cisco Systems, Inc. Introducing Cisco CallManager Express 1-49
Consistent Throughput
Throughput is the amount of data transmitted
between two nodes in a given period.
Throughput is a function of bandwidth, error
performance, congestion, and other factors.
Tools for enhanced voice throughput include:
Queuing
Congestion avoidance
Header compression
RSVP
Fragmentation
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.01-4
Throughput is the actual amount of useful data that is transmitted from a source to a
destination. The amount of data that is sent from the originating end is not necessarily the same
amount of data that comes out at the destination. The data stream may be affected by error
conditions in the network; for example, bits may be corrupted in transit, leaving the packet
unusable. Packets may also be dropped during times of congestion, potentially forcing a
retransmit, using twice the amount of bandwidth for that packet.
In the traditional telephony network, guaranteed bandwidth was associated with each voice
stream. Cisco IOS software uses a number of techniques to reliably deliver real-time voice
traffic across the modern data network. These techniques, which all work together to ensure
consistent delivery and throughput of voice packets, include the following:
Queuing: Queuing is the act of holding packets so that they can be handled with a specific
priority when leaving the router interface. Queuing enables routers and switches to handle
bursts of traffic, measure network congestion, prioritize traffic, and allocate bandwidth.
Cisco routers offer several different queuing mechanisms that can be implemented based on
traffic requirements. Low latency queuing (LLQ) is one of the newest Cisco queuing
mechanisms.
Congestion avoidance: Congestion avoidance techniques monitor network traffic loads.
The goal is to anticipate and avoid congestion at common network and internetwork
bottlenecks before it becomes a problem. These techniques provide preferential treatment
in congested situations for premium-class (priority) traffic, such as voice. At the same time,
these techniques maximize network throughput and capacity use and minimize packet loss
and delay. Weighted random early detection (WRED) is one of the QoS congestion
avoidance mechanisms that is used in IOS software.
Header compression: In the IP environment, voice is carried in RTP, which is carried in
User Datagram Protocol (UDP), which is then put inside an IP packet. This constitutes
40 bytes of an RTP/UDP/IP header. This header size is large when compared with the
typical voice payload of 20 bytes. Compressed RTP (cRTP) reduces the headers to 2 bytes
in most cases, thus saving considerable bandwidth and providing for better throughput.
1-50 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Resource Reservation Protocol (RSVP): RSVP is a transport layer protocol that enables a
network to provide differentiated levels of service to specific flows of data. Unlike routing
protocols, RSVP is designed to manage flows of data rather than make decisions for each
individual datagram. Data flows consist of discrete sessions between specific source and
destination machines. Hosts use RSVP to request a QoS level from the network on behalf
of an application data stream. Routers use RSVP to deliver QoS requests to other routers
along the paths of the data stream. After an RSVP reservation is made, weighted fair
queuing (WFQ) is the mechanism that actually delivers the queue space at each device.
Voice calls in the IP environment can request RSVP service to provide guaranteed
bandwidth for a voice call in a congested environment.
Fragmentation: Fragmentation defines the maximum size for a data packet and is used in
the voice environment to prevent excessive serialization delays. Serialization delay is the
time that it takes to actually place the bits onto an interface. For example, a 1500-byte
packet takes 187 ms to leave the router over a 64-kbps link. If a best-effort data packet of
1500 bytes is sent, then real-time voice packets are queued until the large data packet is
transmitted. This delay is unacceptable for voice traffic. However, if best-effort data
packets are fragmented into smaller frames pieces, then they can be interleaved with realtime (voice) packets. In this way, both voice and data packets can be carried together on
low-speed links without causing excessive delay to the real-time voice traffic.
Copyright 2005, Cisco Systems, Inc. Introducing Cisco CallManager Express 1-51
Reordering of Packets
IPTX v2.01-5
In traditional telephony networks, voice samples are carried in an orderly manner through the
use of time-division multiplexing (TDM). Because the path is circuit-switched, the path
between the source and destination is reserved for the duration of the call. All of the voice
samples stay in order as they are transmitted across the wire. But because IP provides
connectionless transport with the possibility of multiple paths between sites, voice packets can
arrive out of order at the destination, and because voice rides in UDP IP packets, there is no
automatic reordering of packets.
RTP provides end-to-end delivery services for data that requires real-time support, such as
interactive voice and video. According to RFC 1889, the services that are provided by RTP
include payload-type identification, sequence numbering, time stamping, and delivery
monitoring.
1-52 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Example
In the figure, RTP reorders the voice packets through the use of sequence numbers before
playing them out to the user.
The table illustrates the various stages of packet reordering by RTP.
Sequencing of Packets by RTP
Stage
What Happens
Voice packets enter the network. IP assumes that packet-ordering problems exist.
RTP reorders the voice packets. The voice packets are put in order through the use of sequence
numbers.
RTP retimes the voice packets.
The voice packets are spaced according to the time stamp that
is contained in each RTP header.
The user hears the voice packets in order and with the same
timing as when the voice stream left the source.
Copyright 2005, Cisco Systems, Inc. Introducing Cisco CallManager Express 1-53
Challenges in VoIP
The traditional telephony network strives to provide the user with 99.99 percent uptime. This
corresponds to 5.25 minutes per year of downtime. Many data networks cannot make the same
claim. This topic describes methods that you can use to improve reliability and availability in
data networks.
IPTX v2.01-6
To provide telephony users the sameor close to the samelevel of service that they
experience with traditional telephony, the reliability and availability of the data network
takes on new importance.
When the data network goes down, it may not come back up for minutes or even hours. This
delay is unacceptable for telephony users because with network equipment such as voiceenabled routers, gateways, and switches for IP Phones, they find that their connectivity is
terminated. Administrators must, therefore, provide an uninterruptible power supply (UPS) to
these devices in addition to providing network availability. Previously, depending on the type
of connection they had, users received their power directly from the telephone company CO or
through a UPS that was connected to their keyswitch or PBX in the event of a power outage.
Now the network devices must have protected power in order to continue to function and
provide power to the end devices.
In traditional telephony, switches have multiple redundant connections to other switches. If
either a link or a switch becomes unavailable, the telephone company can route the call in
different ways, which is why telephone companies can claim a high availability rate.
1-54 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
High availability encompasses many areas of the network, and network reliability comes from
incorporating redundancy into the network design. In a fully redundant network, the following
components need to be duplicated:
Servers and call managers
Access layer devices, such as LAN switches
Distribution layer devices, such as routers or multilayer switches
Core layer devices, such as multilayer switches
Interconnections, such as WAN links, even through different providers
Power supplies and UPSs
In some data networks, a high level of availability and reliability is not critical enough to
warrant financing the hardware and links required to provide complete redundancy. But if voice
is layered onto the network, the required level of availability and reliability needs to be
revisited.
With the use of Cisco CallManager clusters provides a way to design redundant hardware in the
event of Cisco CallManager failure. When using gatekeepers, you can configure backup
devices as secondary gatekeepers in case the primary gatekeeper fails. When implementing
redundancy, you must also revisit the network infrastructure. Redundant devices and IOS
services, such as Hot Standby Router Protocol (HSRP), can provide high availability. For
proactive network monitoring and trouble reporting, a network management platform such as
CiscoWorks 2000 provides a high degree of responsiveness to network issues.
Copyright 2005, Cisco Systems, Inc. Introducing Cisco CallManager Express 1-55
This topic describes the bandwidth that each codec uses, and it illustrates the impact of the
codec on total bandwidth as well as the effect of voice sample size on total bandwidth. This
topic also lists overhead sizes for various Layer 2 protocols; it discusses how to use codecs,
data links, and sample size to calculate the total bandwidth required for a VoIP call; and it
describes the effect of voice activity detection (VAD) on total bandwidth.
IPTX v2.01-7
One of the most important factors for the network administrator to consider when building
voice networks is proper capacity planning. Network administrators must understand how
much bandwidth is used for each VoIP call. With a thorough understanding of VoIP bandwidth,
the network administrator can apply capacity-planning tools.
The following is a list of codecs and their associated bandwidth:
The G.711 pulse code modulation (PCM) coding scheme uses the most bandwidth. It takes
samples 8000 times per second, each of which is 8 bits in length, for a total of 64,000 bps.
The G.726 adaptive differential PCM (ADPCM) coding schemes use somewhat less
bandwidth. Although each coding scheme takes samples 8000 times per second as G.711
PCM does, it uses 4, 3, or 2 bits for each sample. The 4, 3, or 2 bits for each sample results
in total bandwidths of 32,000 (G.726r32), 24,000 (G.726r24), or 16,000 bps (G.726r16),
respectively.
The G.728 low-delay code-excited linear prediction (LD-CELP) coding scheme
compresses PCM samples using codebook technology. It uses a total bandwidth of
16,000 bps.
The G.729 and G.729a Conjugate Structure Algebraic Code Excited Linear Prediction
(CS-ACELP) coding scheme compresses PCM using advanced codebook technology. It
uses 8000 bps total bandwidth.
1-56 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
The G.723 and G.723a multipulse maximum likelihood quantization (MPMLQ) coding
schemes use a look-ahead algorithm. These compression schemes result in 6300
(G.723r63) or 5300 bps (G.723r53), respectively.
The network administrator should balance the need for voice quality against the cost of
bandwidth in the network when choosing codecs. The higher the codec bandwidth is, the higher
the cost of each call is across the network.
Copyright 2005, Cisco Systems, Inc. Introducing Cisco CallManager Express 1-57
IPTX v2.01-8
Voice sample size is a variable that can affect the total bandwidth that is used. A voice sample
is defined as the digital output from a codec digital signal processor (DSP) that is encapsulated
into a protocol data unit (PDU). Cisco uses DSPs that generate samples based on digitization of
10 ms worth of audio. Cisco voice equipment encapsulates 20 ms of audio in each PDU by
default, regardless of the codec used. You can apply an optional configuration command to the
dial peer to vary the number of samples encapsulated. When you encapsulate more samples per
PDU, total bandwidth is reduced. However, encapsulating more samples per PDU can cause
larger PDUs, which can cause variable delay and severe gaps if PDUs are dropped.
Example
Using the simple formula Bytes_per_Sample = (Sample_Size * Codec_Bandwidth) / 8, it is
possible for you to determine the number of bytes encapsulated in a PDU based on the codec
bandwidth and the sample size (20 ms is default). If we apply G.711 numbers, the formula
reveals the following:
Bytes_per_Sample = (.020 * 64,000) / 8
Bytes_per_Sample = 160
The figure illustrates various codecs and sample sizes and the number of packets that are
required for VoIP to transmit 1 second of audio. The larger the sample size is, the larger the
packet is and the fewer the encapsulated samples are that have to be sent (which reduces
bandwidth).
1-58 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Data-Link Overhead
Ethernet: 18 bytes of overhead
MLP: 6 bytes of overhead
Frame Relay Forum 12 (FRF.12): 6 bytes of
overhead
IPTX v2.01-9
Another contributing factor to bandwidth is the Layer 2 protocol that is used to transport VoIP.
Alone, VoIP carries a 40-byte IP/UDP/RTP header, assuming uncompressed RTP. Depending
on the Layer 2 protocol that is used, the overhead could grow substantially. As the Layer 2
overhead increases, the amount of bandwidth that is required to transport VoIP also increases.
The following points illustrate the Layer 2 overhead for various protocols:
Ethernet: Carries 18 bytes of overhead6 bytes for source MAC address, 6 bytes for
destination MAC address, 2 bytes for type, and 4 bytes for cyclic redundancy check (CRC)
Multilink PPP (MLP): Carries 6 bytes of overhead1 byte for flag, 1 byte for address,
2 bytes for control (or type), and 2 bytes for CRC
Frame Relay Forum 12 (FRF.12): Carries 6 bytes of overhead2 bytes for data-link
connection identifier (DLCI) header, 2 bytes for FRF.12, and 2 bytes for CRC (FRF.12 is
FRF.11 Annex C; FRF.11 is the implementation agreement for Voice over Frame Relay.)
Copyright 2005, Cisco Systems, Inc. Introducing Cisco CallManager Express 1-59
IPTX v2.01-10
Codec choice, data-link overhead, sample size, and even cRTP all have positive and negative
impacts on total bandwidth. To perform the calculations, you must have all of the contributing
factors as part of the equation:
More required bandwidth for the codec = more required total bandwidth
More overhead associated with the data link = more required total bandwidth
Larger sample size = less required total bandwidth
cRTP = significantly reduced required total bandwidth
Example
The formula Total_Bandwidth = ([Layer_2_Overhead + IP_UDP_RTP_Overhead +
Sample_Size] / Sample_Size) * Codec_Speed was used to produce the figure. For example,
assume a G.729 codec and a 20-byte sample size using Frame Relay without cRTP:
Total_Bandwidth = ([6 + 40 + 20] / 20) * 8000
Total_Bandwidth = 26,400 bps
1-60 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Effect of VAD
IPTX v2.01-11
On average, an aggregate of 24 calls or more may contain 35 percent silence. With traditional
telephony voice networks, all voice calls use 64-kbps fixed-bandwidth links regardless of how
much of the call is conversation and how much is silence. With Cisco VoIP networks, all
conversation and silence is packetized. VAD suppresses packets of silence. Instead of sending
VoIP packets of silence, VoIP gateways interleave data traffic with VoIP conversations to more
effectively use network bandwidth. VAD is enabled by default for all VoIP calls.
VAD provides a maximum of 35 percent bandwidth savings based on an average volume of
more than 24 calls.
Note
Bandwidth savings of 35 percent is an average figure and does not take into account loud
background sounds, differences in languages, and other factors.
The savings are not realized on every individual voice call or on any specific point
measurement.
Note
For the purposes of network design and bandwidth engineering, VAD should not be taken
into account, especially on links that will carry fewer than 24 voice calls simultaneously.
Various features, such as Music on Hold (MOH) and a fax function, render VAD ineffective.
When the network is engineered for the full voice call bandwidth, all savings provided by VAD
are available to data applications.
Not only does VAD reduce the silence in VoIP conversations, but it also provides comfort
noise generation (CNG). Because silence can be mistaken for a disconnected call, CNG
provides locally generated white noise so that the call appears normally connected to both
parties.
Copyright 2005, Cisco Systems, Inc. Introducing Cisco CallManager Express 1-61
Example
The figure shows examples of the VAD effect in a Frame Relay VoIP environment. In the
example using G.711 with a 160-byte payload, the bandwidth required is 82,400 bps. Turning
VAD on reduces the bandwidth utilization to 53,560 bps. This is a 35 percent savings of
bandwidth.
1-62 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Summary
Summary
This lesson presented these key points:
IPTX v2.01-12
Summary (Cont.)
VAD can lower bandwidth use as much as 35 percent.
QoS mitigates delay, jitter, and packet loss in
converged voice and data networks.
QoS supports dedicated bandwidth, improves loss
characteristics, avoids and manages network
congestion, shapes network traffic, and sets traffic
priorities across the network.
Copyright 2005, Cisco Systems, Inc. Introducing Cisco CallManager Express 1-63
IPTX v2.01-13
1-64 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Lesson 4
This lesson describes the Cisco CallManager Express voice packet handling methods. This
includes a discussion of IP phone calls, packet forwarding, priority and Real-Time Transport
Protocol (RTP) stream information, and WAN call setup.
Objectives
Upon completing this lesson, you will be able to describe the Cisco CallManager Express voice
packet handling methods. This includes being able to meet these objectives:
Describe the voice packet flow among various type of calls: calls between local IP Phones
(on-net call), calls between IP Phones and the PSTN (local calls), and calls from IP Phone
to IP Phone over a WAN (intersite calls)
Describe voice packet forwarding, voice packet priority, and RTP stream information
Describe the requirements for setting up WAN calls, including DTMF relay
IP Phone Calls
This topic describes the process and steps for setting up a local (on-net) call. It describes a call
to the public switched telephone network (PSTN) that uses Cisco CallManager Express as a
PSTN gateway; a call to the PSTN that uses a separate PSTN gateway that is not the Cisco
CallManager Express router; and a call flow that uses a WAN link to connect two IP Phones
registered to separate Cisco CallManager Express routers.
On-Net Calls
SCCP is sent between
IP Phones and Cisco
CallManager Express.
The voice connection is
carried in IP packets
between two IP Phones
and has voice samples
in an RTP segment.
There is no per-call
CPU loading on the
Cisco CallManager
Express router except
for call setup and
teardown.
Cisco CallManager
Express listens for
SCCP messages
on TCP port 2000.
SCCP
Signaling
SCCP
Signaling
RTP
RTP
10.10.0.100:1692210.10.0.101:18355
10001001
IPTX v2.01-2
The Cisco CallManager Express system provides centralized call control for IP Phones that
register with the system. This call control is achieved with Skinny Client Control Protocol
(SCCP), also referred to as skinny protocol. The IP Phone uses SCCP after bootup to register
with Cisco CallManager Express. At this point, the IP Phone cannot set up calls by itself and
must send messages to Cisco CallManager Express for even the simplest of actions. For
example, when the handset is lifted off hook, the IP Phone is instructed through an SCCP
message from the Cisco CallManager Express router to play a dial tone.
When the call is connected, the IP Phones use each others IP addresses to send the voice from
IP Phone to IP Phone. Voice traffic is very delay-sensitive and drop-sensitive and does not
withstand large jitter (variation in delay), so this voice is carried in the form of data payloads
inside RTP headers. RTP has been designed to transport real-time traffic, such as voice.
The following illustrates the steps for completing a call from one local IP Phone to another.
Step 1
An IP Phone with extension 1000 (Phone 1000) goes off hook for the 1000
extension.
Step 2
Cisco CallManager Express sends an SCCP message instructing Phone 1000 to play
a dial tone (which tells the caller that the system is ready to receive digits).
1-66 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Step 3
The user on Phone 1000 dials the digits 1-0-0-1. As each digit is pressed, an SCCP
message is sent to the Cisco CallManager Express router, which analyzes the digits.
(After the first digit, Cisco CallManager Express sends an SCCP message telling the
IP Phone to stop playing the dial tone or, in some cases, to play a second dial tone.)
Step 4
A match is found to an IP Phone with extension 1001 (Phone 1001), and an SCCP
message is sent to the Phone 1001 informing it of an incoming call. This message
contains information about who is calling and instructions to Phone 1001 to play the
ring .wav file that is selected.
Step 5
Phone 1001 rings and is answered. An SCCP message is sent to Cisco CallManager
Express that says that extension 1001 has been answered.
Step 6
Cisco CallManager Express informs the IP Phones that are involved with the call of
the IP address, port, and coder-decoder (codec) that are to be used for the call.
Step 7
The two IP Phones set up RTP connections to each other, and the voice conversation
can flow.
Step 8
Cisco CallManager Express ceases to be involved in the call until the call is
transferred or terminated.
Copyright 2005, Cisco Systems, Inc. Introducing Cisco CallManager Express 1-67
PSTN
Voice
Analog or Digital
Trunk(s)
Cisco
CallManager
Express
Voice over IP
UDP 16,384
32,768
Signaling
TCP 2000
IPTX v2.01-3
When calls are made to or from the PSTN and are coming from or destined for an IP Phone that
is under the control of Cisco CallManager Express, the RTP stream must be terminated on a
media termination point (MTP). The call must then be converted to the format that is
appropriate for the type of trunk that is going to the PSTN.
The following illustrates the steps for completing a call from one local IP Phone to a PSTN
destination with the Cisco CallManager Express router acting as the PSTN gateway:
Step 1
An IP Phone with extension 1000 goes off hook for the 1000 extension.
Step 2
Cisco CallManager Express sends an SCCP message instructing Phone 1000 to play
a dial tone (which tells the caller that the system is ready to receive digits).
Step 3
The user on Phone 1000 dials the digits of the PSTN destination. As each digit is
pressed, an SCCP message is sent to the Cisco CallManager Express router, which
analyzes the digits. (After the first digit, Cisco CallManager Express sends an SCCP
message telling the IP Phone to stop playing the dial tone or, in some cases, to play a
second dial tone.)
Step 4
A match is found to the PSTN destination, and a trunk, either analog or digital, is
seized by the Cisco CallManager Express router (which in this case is the PSTN
gateway).
Step 5
When the call is connected from the PSTN, an RTP stream is set up between the
IP Phone and the PSTN gateway. The RTP stream acts as an MTP. The voice inside
the RTP stream is converted to the format of the trunk that the voice goes across.
1-68 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
PSTN
Voice
Cisco
CallManager
Express
Analog or
Digital
Trunk(s)
PSTN
Gateway
H.323
RTP
SCCP
Signaling
IPTX v2.01-4
When calls are made to or from the PSTN that are coming from or destined for an IP Phone that
is under the control of Cisco CallManager Express, the RTP stream must be terminated on an
MTP. The following illustrates the steps for completing a call from one local IP Phone to a
PSTN destination when the Cisco CallManager Express system is not the PSTN gateway.
Step 1
An IP Phone with extension 1000 goes off hook for the 1000 extension.
Step 2
The Cisco CallManager Express system sends an SCCP message instructing Phone
1000 to play a dial tone (which tells the caller that the system is ready to receive
digits).
Step 3
The user on Phone 1000 dials the digits of the PSTN destination. As each digit is
pressed, an SCCP message is sent to the Cisco CallManager Express router, which
analyzes the digits. (After the first digit, Cisco CallManager Express sends an SCCP
message telling the IP Phone to stop playing the dial tone or, in some cases, to play a
second dial tone.)
Step 4
Step 5
Because Cisco CallManager Express does not physically terminate the trunk to the
PSTN terminated locally, it must signal the PSTN gateway to set up a connection to
the IP Phone. The call control protocol of either H.323 or session initiation protocol
(SIP) must be used to set up the call.
Step 6
On the PSTN gateway trunk, either analog or digital is used to connect to the PSTN.
Step 7
The IP Phone and the PSTN gateway set up an RTP session. The RTP stream is
converted to the format that the PSTN connection uses.
Step 8
The Cisco CallManager Express router ceases its involvement until the call is
transferred or terminated.
Copyright 2005, Cisco Systems, Inc. Introducing Cisco CallManager Express 1-69
Intersite Calls
PSTN
IP WAN
SCCP
H.323 or SIP
1000
RTP
SCCP
2000
IPTX v2.01-5
The following illustrates the steps for completing a call that starts from an IP Phone that is
under the control of one Cisco CallManager Express router and goes across a WAN link to an
IP Phone that is controlled by another Cisco CallManager Express router.
Step 1
Step 2
Cisco CallManager Express sends an SCCP message instructing Phone 1000 to play
a dial tone (which tells the caller that the system is ready to receive digits).
Step 3
The user on Phone 1000 dials the digits 2-0-0-0. As each digit is pressed, an SCCP
message is sent to the Cisco CallManager Express router, which analyzes the digits.
(After the first digit, Cisco CallManager Express sends an SCCP message telling the
IP Phone to stop playing the dial tone or, in some cases, to play a second dial tone.)
Step 4
A match is found to the dialed number, 2000, across the WAN link.
Step 5
Cisco CallManager Express uses the voice gateway function (in this case, the
Cisco CallManager Express router is the voice gateway) to set up a call to the
remote Cisco CallManager Express system. Either H.323 or SIP will be used to
set up this call.
Step 6
When the remote Cisco CallManager Express system receives the call setup message
for extension 2000, an SCCP message is sent to the IP Phone with extension 2000,
causing it to ring.
Step 7
When Phone 2000 is answered, an SCCP message goes from its Cisco CallManager
Express router to the IP Phone to which it is registered, informing the system that
the IP Phone answered the call.
Step 8
Via either H.323 or SIP, the remote Cisco CallManager Express router sends a
message that the call has been answered. The message is sent to the Cisco
CallManager Express router with which Phone 1000 is associated.
1-70 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Step 9
Note
In this case, because the Cisco CallManager Express routers are the voice gateways,
the RTP packets traverse the routers. (However, to the routers, the RTP packets are
just data.) The Cisco CallManager Express router ceases to be involved in call
control until the call is transferred or terminated.
As long at the path across the WAN link is all IP-based, the RTP header will be preserved.
Copyright 2005, Cisco Systems, Inc. Introducing Cisco CallManager Express 1-71
This topic describes the Quality of Service (QoS) markings, cost of service (CoS), and IP
precedence that the IP Phone places in voice packets at Layer 2 and Layer 3, respectively. The
topic also describes the concept of voice encapsulation.
Layer 2 CoS
Marking of 5
Layer 3 IP
Precedence
Marking of 5
IPTX v2.01-6
When voice is generated and put into IP packets on an IP Phone, both Layer 2 and Layer 3 QoS
markings are present. The Layer 2 marking is present only if the connection to the IP Phone is
an 802.1q trunk. An 802.1q trunk is the recommended configuration. The Layer 2 QoS marking
is called CoS. CoS has a range of 0 through 7, with 7 being the highest priority. When voice is
generated on the IP Phone and put into an 802.1q Ethernet header, a CoS marking of 5 is the
default. This marking allows the switch to give preferential treatment to voice frames.
There is an IP precedence marking in the Layer 3 IP header, which also has a range of 0
through 7 and also is set to 5 by default for voice that is generated on the IP Phone.
Note
Many QoS topics are covered in more detail in the module Introducing IP Quality of
Service.
1-72 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
UDP
RTP
Voice Payload
RTP
RTP headers carry voice across an IP-based network.
The RTP header is carried inside a UDP segment.
The UDP segment is carried inside IP packets.
UDP ports are randomly selected from 16,384 through 32,768.
If the whole path is Voice over IP, the RTP header will be preserved.
IPTX v2.01-7
Voice that is generated on an IP Phone is carried inside an RTP header. The RTP header is
encapsulated inside a User Datagram Protocol (UDP) segment. The UDP segment has a
randomly selected port for the current conversation, which will be in the range of 16,384
through 32,768. This UDP segment is then encapsulated inside an IP packet with an
IP precedence marking of 5. The IP packet is then put into an Ethernet frame and sent to the
attached switch. The RTP header will be unchanged as the long as the path is an all-IP-based
network.
Copyright 2005, Cisco Systems, Inc. Introducing Cisco CallManager Express 1-73
This topic explains the need for Call Admission Control (CAC) and describes what CAC is. It
also explains the need for dual tone multifrequency (DTMF) relay over a WAN.
IPTX v2.01-8
When calls are to be sent across an IP WAN link, saturation of the bandwidth is possible. When
there is not enough bandwidth, the effect on voice conversations can be significant. Packets are
dropped or queued up on the interface, which results in a significant degradation of service.
Insufficient bandwidth may be caused when voice traffic is sharing the link with other types of
data. Insufficient bandwidth may be managed through the use of QoS tools, using these tools
preference should be given to voice traffic. In addition, degradation of service results from too
much voice traffic on a link, which can cause all calls to receive poor quality.
For example, in the figure, it is assumed that there is enough bandwidth for two simultaneous
calls. If a third call is allowed to use the WAN, that third call and the other two calls will suffer
from choppy audio. The best practice is to prevent the third call from using the link.
In order to limit the number of calls across a WAN link, a CAC mechanism is needed. This
CAC mechanism can be set up to allow only a certain number of calls on a WAN link.
1-74 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.01-9
There is no need for a CAC mechanism locally between the IP Phones and Cisco CallManager
Express because all IP Phones under the control of Cisco CallManager Express must be
connected via LAN to the Cisco CallManager Express router. The much larger amount of
bandwidth on an Ethernet LAN negates the need for a CAC mechanism.
Copyright 2005, Cisco Systems, Inc. Introducing Cisco CallManager Express 1-75
IPTX v2.01-10
Over WANs, the CAC mechanism is usually implemented through an H.323 mechanism called
a gatekeeper. The gatekeeper is consulted by the voice gateway (in many cases, the Cisco
CallManager Express router) to determine if sufficient bandwidth is available for the call to be
set up. The gatekeeper, which has been configured to allow a certain amount of bandwidth to
be available for voice, responds affirmatively or negatively. If the answer is affirmative, the
voice gateway sets up the call. If the answer is negative, the voice gateway either looks for
alternate ways to get to the destination or plays a fast busy signal.
The use of a gatekeeper ensures that no more than a certain amount of bandwidth is consumed
by voice traffic on a WAN.
Tip
1-76 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.01-11
When calls are sent across a slower WAN link, low-bandwidth codecs are often used to
conserve bandwidth. These low-bandwidth codecs can have problems carrying DTMF digits.
The DTMF digits can be misinterpreted or not seen as valid tones when carried in-band with
voice. The G.729 codec is especially susceptible to these problems. The problems can show up
when voice mail is being checked and when interactive voice response (IVR) is being used.
Because of the problems arising from the use of low-bandwidth codecs, the DTMF digits
should be carried out-of-band from the voice.
The IP Phones in the Cisco CallManager Express system already use DTMF relay by using
SCCP when a digit is pressed on an IP Phone during call setup. After the call is dialed, the
DTMF relay and whether it will be used across a WAN link is defined on the voice gateway.
Note
If the G.711 codec is used everywhere, DTMF relay is not required, although implementing it
is still recommended. There is no adverse effect of implementing DTMF relay.
Copyright 2005, Cisco Systems, Inc. Introducing Cisco CallManager Express 1-77
Summary
Summary
Local calls are set up and torn down by Cisco CallManager Express,
but the RTP goes between the two IP Phones.
SCCP is used between the IP Phones and Cisco CallManager
Express.
Calls to the PSTN can use the Cisco CallManager Express router as
the gateway or as a separate router.
The PSTN gateway must act as an MTP and convert the RTP stream
to and from the format of the connection to the PSTN.
Intersite calls that use an IP WAN link between sites preserve the
RTP headers.
Voice packets originating from the voice on the IP Phones have QoS
markings at Layers 2 and 3.
CAC should be used when going across low-bandwidth WAN links.
DTMF relay should be used when low-bandwidth codecs are used
across WAN links.
2005 Cisco Systems, Inc. All rights reserved.
1-78 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.01-12
Module Summary
Module Summary
Cisco CallManagerExpress provides the small to
midsize business with an integrated solution for call
control, voice mail, and data services.
Voice may be placed as data in packets through a
process of sampling the voice, quantizing the
samples, and encoding the value as a binary
expression.
Packet loss, delay, jitter, and the required bandwidth
all must be considered when configuring VoIP.
Cisco CallManagerExpress sets up calls through the
use of protocols such as SCCP, RTP, H.323, and SIP.
IPTX v2.01-1
Copyright 2005, Cisco Systems, Inc. Introducing Cisco CallManager Express 1-79
References
For additional information, refer to these resources:
IP Communications Express Solution for the Small and Medium-Sized Office or Branch
Cisco CallManager Express with Cisco Unity Express.
http://www.cisco.com/en/US/products/sw/voicesw/ps4625/products_white_paper09186a00
80c637f.shtml.
Voice over IPPer-Call Bandwidth Consumption.
http://www.cisco.com/warp/public/788/pkt-voice-general/bwidth_consume.html#related
Cisco Systems, Inc. Voice Quality.
http://www.cisco.com/en/US/tech/tk652/tk698/tsd_technology_support_protocol_home.ht
ml
Cisco Systems, Inc. Voice Quality (Quality of Service for Voice over IP).
http://www.cisco.com/en/US/tech/tk652/tk698/technologies_white_paper09186a00800d6b
73.shtml
Cisco CallManager Express 3.2 System Administrator Guide.
http://www.cisco.com/en/US/products/sw/iosswrel/ps5207/products_feature_guide_book09
186a00803416f7.html.
1-80 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Module Self-Check
Use the questions here to review what you learned in this module. The correct answers and
solutions are found in the Module Self-Check Answer Key.
Q1) Which of the following best describes Cisco CallManager Express? (Source:
Describing Key Features of Cisco CallManager Express and CUE)
A) an optional feature of Cisco IOS software that supports up to 240 users
B) a standard feature of Cisco IOS software that supports up to 240 users
C) an optional feature of Cisco IOS software that supports up to 120 users
D) a standard feature of Cisco IOS software that supports up to 120 users
Q2) Cisco CallManager Express is available on IOS softwarebased multiservice access
routers including which three series? (Choose three.) (Source: Describing Key Features
of Cisco CallManager Express and CUE)
A) 3700 series
B) 2600 series
C) 3800 series
D) 1600 series
Q3) Which of the following best describes CUE? (Source: Describing Key Features of
Cisco CallManager Express and CUE)
A) available as a software upgrade
B) available in a network module form factor that supports up to 8 hours of voice
message storage
C) available in a network module form factor that supports up to 20 hours of voice
message storage
D) available in an advanced integration module form factor that supports up to 14
hours of voice message storage
Q4) CUE features include which of the following? (Source: Describing Key Features of
Cisco CallManager Express and CUE)
A) voice mail and automated attendant for large enterprise offices
B) two call control options: Cisco CallManager and Cisco CallManager Express
C) complete integration into Cisco 2600, 3600, and 3700 series routers
D) three form factors: software upgrade, network module, and AIM
Q5) The _____ defines how many phones will be controlled with the CallManager Express
software. (Source: Describing Key Features of Cisco CallManager Express and CUE)
A) feature license
B) specific Cisco CallManager Express
C) seat license
D) CUE license
Q6) Which mailbox license is not available for the AIM-CUE? ((Source: Describing Key
Features of Cisco CallManager Express and CUE)
A) 12
B) 25
C) 50
D) 180
Copyright 2005, Cisco Systems, Inc. Introducing Cisco CallManager Express 1-81
Q7) Cisco CallManager Express provides call processing for IP phones using _____.
(Source: Describing Key Features of Cisco CallManager Express and CUE)
A) RTP
B) H.323
C) PSTN
D) SCCP
Q8) Match the component of a telephony network with the function it performs. (Source:
Explaining Differences Between Traditional Telephony and VoIP)
A) private or CO switch
B) edge device
C) trunk
D) local loop
_____ 1. handles signaling, call routing, call setup, and call teardown
_____ 2. provides a path between two switches
_____ 3. connects to the PSTN
_____ 4. interfaces to the telephone company network
Q9) Which of these steps is optional in analog-to-digital conversion? (Source: Explaining
Differences Between Traditional Telephony and VoIP)
A) compression
B) encoding
C) quantization
D) sampling
Q10) Which two coding schemes are examples of waveform algorithms? (Choose two.)
(Source: Explaining Differences Between Traditional Telephony and VoIP)
A) PCM
B) ADPCM
C) CELP
D) LDCELP
E) CS-ACELP
Q11) To what size does cRTP compress the IP/UDP/RTP header without using UDP
checksums? (Source: Explaining Differences Between Traditional Telephony
and VoIP)
A) 2 bytes
B) 4 bytes
C) 8 bytes
D) 12 bytes
Q12) Which two factors have a minimal effect on data transmissions but negatively impact
voice transmissions? (Choose two.) (Source: Understanding VoIP Challenges and
Solutions)
A) high bandwidth
B) T1 links
C) packet loss
D) jitter
E) Layer 2 protocol
1-82 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Q13) Which two Cisco IOS QoS features are employed in the output queue of the router?
(Choose two.) (Source: Understanding VoIP Challenges and Solutions)
A) FRF.12
B) IP to ATM CoS
C) CBWFQ
D) cRTP
E) RSVP
F) WRED
Q14) Which two Cisco QoS features are deployed in a WAN? (Choose two.) (Source:
Understanding VoIP Challenges and Solutions)
A) CAR
B) DWFQ
C) MLP with LFI
D) QoS policy propagation via BGP
E) cRTP
Q15) Which coding scheme requires the least bandwidth with compressed RTP applied?
(Source: Understanding VoIP Challenges and Solutions)
A) G.711
B) G.723
C) G.726
D) G.729
Q16) In which two call scenarios do the RTP packets, after the call is set up, continue to
traverse the CallManager Express router(s) for the remainder of the call until it is
transferred or terminated? (Choose two.) (Source: Describing the Cisco CallManager
Express Voice Packet Handling Methods)
A) local (on-net) calls
B) a call to the PSTN using the Cisco CallManager Express as a PSTN gateway
C) a call to the PSTN using a separate PSTN gateway that is not the CallManager
Express router
D) a call flow using a WAN link to connect two IP Phones registered to separate
Cisco CallManager Express routers that are acting as the voice gateways
E) all of the above
Q17) In which call scenario does the voice gateway act as a media termination point (MTP)?
(Source: Describing the Cisco CallManager Express Voice Packet Handling Methods)
A) a call between an IP Phone and the PSTN (local call)
B) a call between local IP Phones (on-net call)
C) a call using a WAN link to connect two IP Phones that are registered to
separate Cisco CallManager Express routers
D) none of the above
Q18) Layer 2 marking is: (Source: Describing the Cisco CallManager Express Voice Packet
Handling Methods)
A) 802.1q
B) QoS
C) CoS
D) CAC
Copyright 2005, Cisco Systems, Inc. Introducing Cisco CallManager Express 1-83
Q19) An RTP header is encapsulated in: (Source: Describing the Cisco CallManager Express
Voice Packet Handling Methods)
A) a TCP segment
B) a UDP segment
C) either a TCP segment or a UDP segment, depending on which is supported by
the network
D) none of the above
Q20) Which call scenario is most likely to require CAC? (Source: Describing the Cisco
CallManager Express Voice Packet Handling Methods)
A) a local (on-net) call
B) a call to the PSTN using Cisco CallManager Express as a PSTN gateway
C) a call to the PSTN using a separate PSTN gateway that is not the Cisco
CallManager Express router
D) a call flow using a WAN link to connect two IP Phones that are registered to
separate Cisco CallManager Express routers that are acting as the voice
gateways
1-84 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Q2) A, B, C
Q3) D
Q4) B
Q5) A
Q6) D
Q7) D
Q8) A, C, B, D
Q9) A
Q10) A, B
Q11) A
Q12) B, C
Q13) C, F
Q14) C, E
Q15) B
Q16) B, D
Q17) A
Q18) C
Q19) B
Q20) D
Copyright 2005, Cisco Systems, Inc. Introducing Cisco CallManager Express 1-85
1-86 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Module 2
Configuring Cisco
CallManager Express
Overview
This module describes the basic functionality of Cisco CallManager Express. This includes the
configuration of specific network components and services that are necessary for the proper
functioning of Cisco CallManager Express. The module also discusses the files that are
required to run the Phones and web-based GUI.
Module Objectives
Upon completing this module, you will be able to describe the features and functionality of
Cisco CallManager Express and Cisco Unity Express (CUE). You also will be able to configure
Cisco CallManager Express to support IP Phones. This includes being able to meet these
objectives:
Describe the key features and functionality of Cisco CallManager Express
Describe the key features and functionality of CUE
Configure Cisco CallManager Express network parameters and discuss the need for and
configuration of auxiliary VLANs, DHCP, DHCP relay, and NTP
Describe the IP Phone registration process
Define ephone-dn and ephone and describe examples and types
Describe the three ways to create an initial phone setup
Describe Cisco CallManager Express files
2-2 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Lesson 1
Understanding Cisco
CallManager Express Features
and Functionality
Overview
This lesson introduces you to the key features and functionality of Cisco CallManager Express.
Objectives
Upon completing this lesson, you will be able to describe the key features and functionality of
Cisco CallManager Express. This ability includes being able to meet these objectives:
Identify the key benefits and features of Cisco CallManager Express
Describe the supported platforms and telephones for Cisco CallManager Express
Describe the supported protocols and integration options for Cisco CallManager Express
Describe Cisco CallManager Express requirements for licensing, memory, platforms,
Cisco IP Phone models, and software
Identify Cisco CallManager Express restrictions
This topic describes the key benefits and features of Cisco CallManager Express
IPTX v2.02-2
2-4 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.02-3
Cisco CallManager Express has many high-level phone, system, trunk, and voice mail features.
Phone Features
The high-level phone features for Cisco CallManager Express are as follows:
Support for single-line and multiline Cisco IP Phones (Cisco IP Phones 7902G, 7905G,
7910G+SW, 7912G, 7920, 7940G, 7960G, 7970G, and 7971G-GE)
Support for the Cisco IP Conference Station 7935 and 7936
Support for analog phones on the Cisco CallManager Express router analog voice ports and
on the Cisco Analog Telephone Adaptor (ATA) 186 and 188
Support for fax machines
XML services on Cisco IP Phones
240 Phones per system
Six line appearances per each 7960G Phone
Eight line appearances per each 7970G and 7971G-GE Phone
On-hook dialing
Local directory lookup
Speed dial and last number redial
Idle URL, which can periodically push messages onto the screen of 7940G, 7960G, or
7970G Phones
Automated attendant functionality when the 7960G Phone is combined with the Cisco IP
Phone 7914 Expansion Module
Configurable ring types
Message Waiting Indicator (MWI)
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-5
Customization of softkeys
Do Not Disturb (DND) feature to divert calls directly to voice mail
IP Phone display of DND state
Enable/disable call waiting notification per line
Monitor-line button speed dial
System Features
The high-level system features for Cisco CallManager Express are as follows:
Conferencing capabilities
Paging
Intercom
Call transfer consultative and blind
Call hold and call retrieve
Call pickup of on-hold calls
Call waiting
Tone on hold and tone on transfer for internal calls
Music on Hold (MOH) and music on transfer for external calls
MOH file on router
MOH live feed external source
Distinctive ringing internal versus external
International language support German, French, Italian, and Spanish
System speed dial option via XML service
Directory services using XML
Web-based GUI for moves, adds, and changes
GUI customization capabilities
Interactive voice response (IVR) Auto Attendant
Class of restriction to restrict calling capabilities
In-line power for IP Phones
Call transfer and call forwarding (standards-based H450.2 and H450.3)
Computer telephony integration (CTI) support with Telephony Application Programming
Interface (TAPI) Lite
Call Detail Record (CDR) generation via RADIUS
Interworking with Cisco and NetCentrex gatekeepers
Hookflash pass-through to a central office (CO) for analog phones
Date and time synchronization with Network Time Protocol (NTP)
Longest-idle hunt group
Hunt group dynamic login/logout
2-6 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Trunk Features
The high-level trunk features for Cisco CallManager Express are as follows:
Direct inward dialing (DID) and direct outward dialing (DOD)
BRI/PRI support all switch types that IOS software supports
Caller identification display and blocking, calling name display, and automatic number
identification support
Analog Foreign Exchange Office (FXO), DID
Digital trunk support T1 and E1
WAN link support Frame Relay, ATM, Multilink PPP (MLP), and digital subscriber line
(DSL)
Network calls using H.323
Dedicated trunk mapping to phone button
H.323 to session initiation protocol (SIP) call routing to Cisco Unity Express (CUE)
RFC 2833 support over SIP trunks
Transcoding
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-7
This topic describes the supported platforms and telephones of Cisco CallManager Express.
Supported Platforms
Cisco CallManager Express supports these
Cisco platforms:
IAD 243X Series (SP only)
2691
1751V
2801
1760
2811
2610XM
2821
2611XM
2851
2620XM
3725
2621XM
3745
2650XM
3825
2651XM
3845
IPTX v2.02-4
Cisco CallManager Express supports these Cisco platforms: IAD 243X Series (SP only),
1751V, 1760, 2610XM, 2611XM, 2620XM, 2621XM, 2650XM, 2651XM, 2691, 2801, 2811,
2821, 2851, 3725, 3745, 3825, and 3845.
2-8 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Maximum
Number of
Phones
24
License
FL-CCME-SMALL
36
FL-CCME-36
48
FL-CCME-MEDIUM
2691
FL-CCME-72
3825
72
96
144
192
168
3845
240
FL-CCME-240
2851
3725
3745
FL-CCME-96
FL-CCME-144
1 FL-CCME-192
FL-CCME-168
IPTX v2.02-5
Depending on the platform, Cisco CallManager Express supports up to 24, 36, 48, 72, 96,144,
168, 192 or 240 IP Phones. The licenses can be purchased and upgraded incrementally,
allowing the customer to purchase only the required number of licenses now with the ability to
grow in the future by purchasing additional licenses.
Example
ACME Company currently has an installation of 72 IP Phones, with each employee having an
IP Phone. ACME has also purchased a Cisco 3745 router because it plans to hire 38 additional
employees in the next year, for a total of 110 employees. All employees will need to have an
IP Phone. Initially, ACME purchased the feature license FL-CCME-96, which is the minimumsized license required to support 72 IP Phones. When the expansion to 110 IP Phones becomes
necessary, the feature license FL-CCME-SMALL must be purchased to add 24 IP Phones to the
Cisco CallManager Express system. The two licenses together will allow up to 120 IP Phones,
which will support the planned expansion to 110 IP Phones.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-9
IPTX v2.02-6
Cisco CallManager Express 3.2.1 requires a minimum Cisco IOS Release version of 12.3(11)T.
The IOS version must also include the IP voice feature set to include the CallManager Express
functionality. Select the highest T version that will incorporate bug fixes in that version of IOS
software. For example, Cisco IOS Release 12.3(11)T3 would be preferred to Cisco IOS Release
12.3(11)T2.
When you are using the Cisco 1700 platform, the version of IOS software that is required is
Cisco IOS Release 12.3(11)T and it must contain the VOX feature set.
2-10 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.02-7
Memory requirements for the Cisco CallManager Express router depend on the number of
IP Phones and which other applications may be configured on the router. For example, if
Network Address Translation (NAT) is also running on the router, the memory requirements
may be greater than if only Cisco CallManager Express is running on the router. The memory
that is installed in the router varies based on the hardware platform and is one factor that
determines the number of IP Phones the Cisco CallManager Express router will support.
Cisco IOS Release 12.3(11)T with Cisco CallManager Express 3.2.1
Platform
Phones
Extensions or
Directory Numbers
36 144 48/128
Minimum
Recommended
Flash/RAM
Supported Telephones
7902G7905G7910G+SW7912G
7920
7935,
7936
7971G-GE
7940G7960G
7940 + 7914,
7960 + 7914
7970G
Cisco CallManager Express supports a new generation of intelligent Cisco IP Phones, including
the 7902G, 7905G, 7910G+SW, 7912G, 7920, 7935 and 7936 (conference stations), 7940G,
7960G, 7970G, 7971G-GE, 7940G + 7914, and 7960G + 7914. Regular analog phones and fax
machines are supported through the Cisco ATA 186 and 188 or Foreign Exchange Station
(FXS) ports on the Cisco CallManager Express router. All supported telephones use Skinny
Client Control Protocol (SCCP), often referred to as skinny protocol.
2-12 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
7902G Features
Common-area phone
G.711 and G.729 codecs
Single line
No display
SCCP support
Four programmable keys
Power over Ethernet
IPTX v2.02-9
The Cisco 7902G is a single-line IP Phone with fixed feature keys. These keys provide onetouch access to the redial, transfer, conference, and voice mail features. Consistent with other
Cisco IP Phones, the Cisco 7902G also supports in-line power, which allows the Phone to
receive power over the LAN. This capability gives the network administrator centralized power
control, which translates into greater network availability. The Cisco prestandard PoE is
supported.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-13
7905G Features
Common-area phone
G.711 and G.729 codecs
Call-monitoring mode
Single line
XML application protocol
SCCP support
Power over Ethernet
IPTX v2.02-10
The Cisco 7905G provides single-line access and four interactive softkeys, which guide the
user through call features and functions via the pixel-based liquid crystal display (LCD). The
graphic capability of the display provides a rich user experience by presenting calling
information, intuitive access to features, and language localization in future firmware releases.
The Cisco prestandard PoE is supported.
This IP Phone is appropriate for a common area that does not need a switch port for a PC to
connect to, such as a lobby.
2-14 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
7910G+SW Features
Common-area phone
Call-monitoring mode
Single line
802.1q support
IPTX v2.02-11
The Cisco 7910G+SW is a basic telephone that is used primarily in common-use areas (such as
lobbies, break rooms, and hallways) that require only basic features. The Cisco 7910G+SW
includes a Cisco two-port switch, making it suitable for user applications in which basic phone
functionality and an Ethernet device such as a PC are necessary. The Cisco prestandard PoE is
supported.
The 7910G+SW provides four dedicated feature buttons: line, hold, transfer, and settings. A
cluster of six feature access keys is located above the volume control rocker switch. These
access keys support message, conference, forwarding, speed dial, and redial features.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-15
7912G Features
Four programmable keys
Single line
Lighted hold key
Call-monitoring function
G.711 and G.729 codecs
SCCP support
802.1q support
10/100 Ethernet switch port
Power over Ethernet
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.02-12
The Cisco 7912G is a basic IP Phone with an Ethernet switch port, which provides a core set of
business features. This IP Phone is basically a Cisco 7905 with a switch port. This easy-to-use,
display-based IP Phone increases productivity while minimizing user training and delivers
network and application convergence. The Cisco prestandard PoE is supported.
This IP Phone is commonly used for basic users who have a need for both a PC and an IP Phone.
2-16 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
7920 Features
802.11b
Vibrate or ring
LEAP and WEP security
Mobility
QoS
G.711 and G.729 codecs
SCCP support
IPTX v2.02-13
The Cisco 7920 is an easy-to-use IEEE 802.11b wireless IP Phone that provides comprehensive
voice communications in conjunction with Cisco CallManager Express and Cisco Aironet
1200, 1100, 350, and 340 Series of Wi-Fi (IEEE 802.11b) access points. As a key component
of the Cisco Architecture for Voice, Video and Integrated Data (AVVID) Wireless Solution,
the Cisco 7920 delivers seamless intelligent services such as security, mobility, QoS, and
management across an end-to-end Cisco network.
Note
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-17
IPTX v2.02-14
The Cisco 7935 and 7936 are IP-based, full-duplex conference stations for use on desktops.
These full-featured, hands-free stations can also be used in small- to medium-sized conference
rooms. In addition to the regular telephony keypad, the Cisco 7935 and 7936 provide three soft
keys and menu navigation keys that guide users through call features and functions.
The full-duplex design of the Cisco 7935 and 7936 offers superior voice quality, eliminating
echoes, clipped words, and reverberations, for more natural conversation. It features superior
sound quality with a digitally tuned speaker and three microphones, allowing conference
participants to move around while speaking.
Note
The Cisco IP Conference Stations 7935 and 7936 work best in small- to medium-sized
conference rooms, rather than large conference rooms.
2-18 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
7940G Features
Up to two line appearances
G.711 and G.729 codecs
10/100 Ethernet switch port
Power over Ethernet
XML application support
SCCP support
IPTX v2.02-15
7960G Features
Up to six line appearances
G.711 and G.729 codecs
10/100 Ethernet switch port
Power over Ethernet
XML application support
SCCP support
IPTX v2.02-16
The Cisco 7960G is a second-generation, full-featured IP Phone primarily for manager and
executive needs. It provides six programmable line or feature buttons and four interactive
softkeys to guide users through call features and functions. The Cisco prestandard PoE is
supported.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-19
7970G Features
Up to eight line appearances
G.711 and G.729 codecs
Color touch screen
10/100 Ethernet switch port
Power over Ethernet
External power required for
full screen brightness
XML application support
SCCP support
Stereo jack sockets
IPTX v2.02-17
The Cisco IP Phone 7970G demonstrates the latest technology and advancements in
Voice over IP (VoIP) telephony. It not only addresses the needs of the executive or major
decision-maker, but also brings network data and applications to users without PCs. This stateof-the-art IP Phone includes a backlit, high-resolution color touch-screen display (320-x-234,
12-bit display with 4096 colors) for easy access to communication information, timesaving
applications, and feature usage. It also enables customers and developers to deliver more
innovative and productivity-enhancing XML applications to the display. Access to eight
telephone lines (or a combination of lines and direct access to telephony features), a highquality hands-free speakerphone, a built-in headset connection, and both Cisco prestandard
Power over Ethernet (PoE) and IEEE 802.3af PoE are supported.
2-20 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
7971G-GE Features
Up to eight line appearances
G.711 and G.729 codecs
Color touch screen
Gigabit Ethernet switch port
Power over Ethernet
External power required for
full screen brightness
XML application support
SCCP support
Stereo jack sockets
IPTX v2.02-18
First to provide unconstrained bandwidth to desktop applications, the Cisco IP Phone 7971G-GE
delivers the latest technology and advancements in Gigabit Ethernet VoIP telephony. It not
only addresses the needs of an executive or major decision-maker, but also brings network data
and applications to users quickly with its Gigabit Ethernet port for integration with a PC or
desktop server. The features of this state-of-the-art Gigabit Ethernet IP Phone are identical to
those of the Cisco IP Phone 7970G. The 7971G-GE Phone also includes a backlit, highresolution color touch-screen display (320-x-234, 12-bit display with 4096 colors) for easy
access to communication information, timesaving applications, and feature usage. It also helps
enable customers and developers to deliver more innovative and productivity-enhancing XML
applications to the display. Offering access to eight telephone lines (or a combination of lines
and direct access to telephony features), a high-quality, hands-free speakerphone, and a built-in
headset connection, the 7971G-GE Phone can be powered through IEEE 802.3af PoE or a local
power supply. The 7971G-GE does not support Cisco prestandard PoE.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-21
Telephone Screens
IPTX v2.02-19
The Cisco 7935, 7940G, 7960G, 7970G and 7971G-GE Phones all have a large, pixel-based
LCD. The pixel-based LCD displays features such as date and time, calling party name, calling
party number, digits dialed, and feature and line status.
The four softkey buttons change based on the current state of the call. This allows for the
buttons to be used more efficiently than if they were statically assigned. These buttons can also
be invoked and customized by a third party or a custom XML-based application.
Note
2-22 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.02-20
The Cisco IP Phone 7914 Expansion Module extends the capabilities of the Cisco IP Phone
7960 with additional buttons and an LCD. This expansion module adds 14 buttons to the
existing six buttons of the Cisco IP Phone 7960, increasing the total number of buttons to 20
when you add one 7914 Expansion Module and to 34 when you add two 7914 Expansion
Modules.
The large LCD of the 7914 Expansion Module enables users to quickly and easily identify
associated buttons. Using the Settings menu of the 7960 Phone, you can adjust the contrast of
the individual LCDs for the 7960 Phone and the 7914 Phone, if necessary.
Each of the 14 buttons on the 7914 Expansion Module can be programmed as an extension
number or a speed dial key, much like the 7960 Phone. In addition, the silent ring option for
shared lines mapped to the 7914 Phone, the fast transfer capability, and the busy lamp
capability are used to provide attendant console functionality. The 7914 Expansion Module
connects to the RS.232 port on the back of the 7960 Phone; a new stand and power brick are
required.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-23
Analog connectivity
186 two analog ports
188 two analog ports plus
10/100 switch port
Fax or analog phone
SCCP required for phone
H.323v2 support
H.323 required for fax
IPTX v2.02-21
The Cisco ATA 186 and 188 connect regular analog phones and fax machines to IP-based
telephony networks. Each of the two voice ports on the Cisco ATA 186 and 188 supports
independent telephone numbers, giving you two separate lines. In addition, the internal
Ethernet switch allows for a direct connection to a 10BASE-T Ethernet network and a
100BASE-TX Ethernet network via an RJ-45 interface.
When the ATA 186 or 188 is going to be used for analog phone connectivity, it should be
configured to use SCCP. However, when the ATA 186 or 188 is being used for fax
connectivity, it must use H.323 connectivity. The two analog ports of the ATA 186 or 188 must
both use the same protocol. As a result, the device can be used as either an analog phone or a
fax machine, but not both.
Note
Analog modem connections are supported only on an FXS port local to a router and are not
supported on the Cisco ATA 186 or 188.
2-24 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Analog Phones
Fax
ATA
V
ATA
Analog
SCCP
H.323
SCCP
IPTX v2.02-22
Cisco CallManager Express can use both H.323 and SCCP to control IP Phones, analog phones,
and faxes.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-25
This topic describes the supported protocols and integration options of Cisco CallManager Express.
IPTX v2.02-23
Cisco CallManager Express software provides call processing for IP Phones using SCCP.
SCCP is the Cisco-proprietary protocol for real-time calls and conferencing over IP. This
generalized messaging set allows Cisco IP Phones to coexist in an H.323 environment. Savings
in memory size, processor power, and complexity are benefits of SCCP.
2-26 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.02-24
QoS, bandwidth management, and Call Admission Control (CAC) are not supported within the
SCCP context on Cisco CallManager Express. Complex connection paths could cause QoS
problems. Because of these factors, all IP phones must be connected locally to the Cisco
CallManager Express router.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-27
H.323 Protocol
Support for voice, video, and data
Industry standard
Complex protocol
Higher complexity than SCCP
CAC functionality
Authentication
IPTX v2.02-25
H.323 is a specification for transmitting audio, video, and data across an IP network, including
the Internet. H.323 is an extension of the International Telecommunication Union
Telecommunication Standardization Sector (ITU-T) standard H.320.
Tip
The ATA must be configured with H.323 when fax machines are connected to the analog
ports.
2-28 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
PSTN
H.323
WAN
ATA
H.323
H.323
Cisco
CallManager
Express
IPTX v2.02-26
This figure shows the H.323 protocol being used to connect the Cisco CallManager Express
routers together and to control the analog fax connected to the ATA.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-29
H.323 Gatekeeper
Cisco CallManager Express can register to an
H.323 gatekeeper, ensuring that the WAN is not
oversubscribed.
H.323
WAN
Register
1000
2095551000
Register extension number,
E.164 number, or both
Register
Gatekeeper
2000
3095552000
Register extension number,
E.164 number, or both
IPTX v2.02-27
The Cisco CallManager Express system can be configured to register an ephone-dn with
an H.323 gatekeeper. In addition, the IP Phone can have both an extension number and an
E.164 number defined, and one or both of those numbers can be registered with the H.323
gatekeeper. H.323 can also be used to allow one Cisco CallManager Express to communicate
with another Cisco CallManager Express or with voice gateways. A router separate from Cisco
CallManager Express must be used if a gatekeeper is going to be configured.
The H.323 gatekeeper can provide the following functions:
CAC over a WAN link to ensure that the WAN link is not oversubscribed
Dial plan administration, which centralizes the dial plan for intersite numbering
IP-to-IP gatewaytoprovide a network-to-network point for billing and security and for
joining two VoIP call legs together
2-30 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
SIP Protocol
Emerging standard
Vendor-specific in most cases
Higher complexity than SCCP
Authentication
Based on other well-known protocols
IPTX v2.02-28
SIP was designed as a multimedia protocol that could take advantage of the architecture and
messages found in popular Internet applications. By using a distributed architecture with URLs
for naming and ASCII text-based messages, SIP attempts to take advantage of the Internet
model and standards for building VoIP networks and applications. In addition to VoIP, SIP is
used for videoconferencing and instant messaging.
As a protocol, SIP defines only how sessions are to be set up and torn down. SIP leverages
other Internet Engineering Task Force (IETF) protocols to define other aspects of VoIP and
multimedia sessions, such as session definition protocol (SDP) for capabilities exchange, URLs
for addressing, Domain Name System (DNS) for service location, and Telephony Routing over
IP (TRIP) for call routing.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-31
SIP Connections
Cisco
CallManager
Express
H.323
Cisco
CallManager
Express
PSTN
SIP
WAN
SIP
SIP
Cisco
CallManager
Express
IPTX v2.02-29
It is possible to use SIP to connect calls between Cisco CallManager Express systems.
2-32 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.02-30
Cisco CallManager Express requires a Cisco CallManager Express feature license. This
license is based on the number of IP Phones that will be deployed. The router itself must have
an IOS release that is Cisco CallManager Expresscapable. Each IP Phone or ATA port also
requires a Cisco CallManager Express seat license, which can be purchased with the IP Phone.
You also need an account on Cisco.com in order to download Cisco CallManager Express files,
such as Phone firmware and GUI files and firmware.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-33
IPTX v2.02-31
There is a subset of TAPI version 2.1 support in Cisco CallManager Express. Cisco Java TAPI
(JTAPI) is not currently supported, which restricts the use of a Cisco IP Softphone. The newer
IP Softphone, the Cisco Communicator Softphone, is also not currently supported, although
future versions may be supported. Currently, only third-party softphones from IP Blue work
with Cisco CallManager Express.
Cisco CallManager Express supports only phones that are local to the Cisco CallManager
Express LAN and does not support remote SCCP phones that are connected across WAN links.
Media Gateway Control Protocol (MGCP) is not supported in Cisco CallManager Express.
2-34 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Not supported:
TAPI-based softphone
Multiple-user or multiple-call handling (required for ACD)
Direct media and voice handling
JTAPI
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.02-32
Cisco CallManager Express does not support TAPI v2.1Cisco CallManager Express TAPI
implements only a small subset of TAPI functionality. It does support operation of multiple
independent clients (for example, one client per phone line), but does not fully support
multiple-user or multiple-call handling, which is required for complex features such as
automatic call distribution (ACD).
Applications such as Windows Phone Dialer and Outlook Contact Dialer can use TAPI Lite
to dial, place on hold, transfer, and terminate a call on an associated line on an IP Phone. JTAPI
is not supported, nor are TAPI-based softphones. TAPI Lite allows for the control of a line
on an associated PC, but not for the termination of voice on the PC.
Note
Third-party applications can be developed to control a line that takes advantage of TAPI
Lite.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-35
Summary
Summary
Cisco CallManager Express software provides
call processing for IP Phones using SCCP.
Cisco CallManager Express supports these
Cisco platforms: IAD 243X Series, 1751V, 1760,
2600XM Series, 28XX, 37XX, and 38XX.
Cisco CallManager Express supports all
Cisco IP Phones.
Certain functionalities are not currently supported
in the Cisco CallManager Express software.
2-36 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.02-33
Lesson 2
Configuring Cisco
CallManager Express Network
Parameters
Overview
This lesson describes the Cisco CallManager Express network parameters and the steps to
configure these parameters.
Objectives
Upon completing this lesson, you will be able to configure Cisco CallManager Express network
parameters. You also will be able to discuss the need for and the configuration of voice
VLANs, DHCP, DHCP relay, Network Time Protocol (NTP), and transcoding between G.729
and G.711. This includes being able to meet these objectives:
Describe voice VLANs
Configure voice VLANs on a Cisco Catalyst switch and an EtherSwitch network module
Identify DHCP service options
Define a DHCP relay server
Configure NTP
Describe and configure transcoding between G.729 and G.711
Voice VLANs
Voice VLANs
Prevents unnecessary IP address renumbering
Simplifies QoS configurations
Separates voice and data traffic
Requires two VLANs: one for data traffic and one
for voice traffic
Requires only one drop-down Ethernet for the
Cisco CallManager Express IP Phone and the PC
that is plugged into the Phone
IPTX v2.02-2
A Cisco IP Phone can act as a three-port switch. Just like a switch, the Phone can support
trunking between itself and another switch. Thus, more than one VLAN can be supported
between the IP Phone and the access switch into which it is plugged.
The three ports of the IP Phone are the port that connects to the 10/10 Ethernet switch, the
10/100 Ethernet port into which a PC can be plugged, and an internal port from which voice
traffic originates and terminates. The 10/100 Ethernet port, which attaches to a switch, supports
the 802.1q trunking protocol. This enables two VLANs to arrive at the Phone, one for the voice
traffic and the other for the PC data traffic. The VLAN that the voice traffic goes across is
called the auxiliary VLAN, or the voice VLAN.
Note
Because the data and voice traffic are separated, they also can be monitored and managed
separately.
This solution allows you to connect two devices to the switch using only one physical port
and one Ethernet cable between the wiring closet and the IP Phone, the PC location, or
both.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-39
IP Phone + PC on same
switch ports
Recommended
171.68.249.100
171.68.249.100
171.68.249.101
10.1.1.1
Public IP addresses
171.68.249.100
Public IP addresses
10.1.1.1
171.68.249.100
IPTX v2.02-3
Cisco IP Phones require network IP addresses. Cisco makes the following recommendations for
IP addressing deployment:
Continue to use existing addressing for data devices (PCs, workstations, and so forth).
Add IP Phones using DHCP as the mechanism for obtaining addresses.
Use subnets for IP Phones if they are available in the existing address space.
Use private addressing such as the 10.0.0.0 network (see RFC 1918 for details) if subnets
are not available in the existing address space.
LANs and private IP WANs will carry these routes between both of the address spaces. The
WAN gateway to the Internet should block private addresses, which are currently blocked by
data devices.
2-40 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
This topic describes how to configure voice VLANs on the Catalyst switch and an EtherSwitch
network module.
Voice VLANs
An access port can handle two VLANs.
Native VLAN
Auxiliary, or voice, VLAN
The switch port interface is set to dot1q trunk.
Tagged 802.1q (voice VLAN)
IPTX v2.02-4
All data devices typically reside on data VLANs in the traditional switched scenario. You may
need a separate VLAN when you combine the voice network with the data network. For
configuration purposes, the Catalyst software command-line interface (CLI) refers to this new
VLAN as the voice VLAN. You can use the new voice VLAN to house nondata devices, in this
case, IP Phones. The Phones will reside in the voice VLAN if you configure the switch to
support them; data devices reside in the native VLAN (also referred to as the default VLAN) of
the switch.
With IP Phones residing in a separate VLANa voice VLANit is easier for customers to
automate the process of deploying IP Phones. The IP Phone communicates with the switch via
Cisco Discovery Protocol (CDP) when it powers up. The switch provides the Phone with the
appropriate VLAN Identifier (VLAN ID), known as the Voice VLAN ID (VVID). The VVID
is analogous to the data VLAN ID, known as the Port VLAN ID (PVID).
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-41
IPTX v2.02-5
To configure the trunk on a physical interface between the access switch port and the IP Phone,
an 802.1q trunk must be created. In addition, the native, or untagged, VLAN and the voice
VLAN must be defined.
The example shows the configuration of a Catalyst switch and an EtherSwitch network module.
IPTX v2.02-6
You can verify your voice VLAN configuration on the Catalyst switch by using the
show interface <mod/port>switchport command.
2-42 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Router Configuration
802.1q Trunk
Trunk on a Router
-
-
VLAN 12
--
-
-
--
VLAN 112
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.02-7
Routing between different VLANs requires a Layer 3 router. The router must have an interface
that is local to all of the VLANs for which it will route. The most efficient way to get multiple
VLANs to the router is to connect a trunk between the switch and the router. This configuration
is known as router on a stick.
The router will have one subinterface local to each VLAN, and only one VLAN can be
assigned per subinterface.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-43
IPTX v2.02-8
DHCP is a very common protocol and familiar to many network administrators. With DHCP,
a scope is defined per subnet and is used to hand out IP addresses, along with a subnet mask,
from a pool of available addresses. If desired, other values, like the default gateway and DNS,
can be assigned to the scope by setting option values. The default gateway option is 003, and
DNS is 006.
These option values can include values specific to an implementation and can be customized by
the administrator. Cisco IP Phones look for an option 150 from their DHCP server, which
contains the IP address of the TFTP server where the IP Phones configuration file resides. The
administrator must configure an option 150 with the IP address of the TFTP server, which, in
the case of Cisco CallManager Express, is the Cisco CallManager Express router.
DHCP can be deployed on any platform that supports customized scope options. This includes
Windows, Linux, Novell, UNIX, and other operating systems.
2-44 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.02-9
You can set up DHCP service for IP Phones by defining a single DHCP IP address pool, by
defining a separate pool for each Cisco IP Phone, or by defining a DHCP relay server.
Single DHCP IP address pool: Define a single DHCP IP address pool if the
Cisco CallManager Express router is a DHCP server and if you can use a single
shared address pool for all your DHCP clients.
Separate DHCP IP address pool for each Cisco IP Phone: Define a separate pool
for each Cisco IP Phone if the Cisco CallManager Express router is a DHCP server and
you need different settings on nonIP Phones on the same subnet.
Note
Separate DHCP scopes for individual devices should be avoided if possible because of the
added configuration complexity.
DHCP relay server: Define a DHCP relay server if the Cisco CallManager Express router
is not a DHCP server and you want to relay DHCP requests from IP Phones to a DHCP
server on a different subnet.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-45
Phone Bootup
IPTX v2.02-10
Voice VLAN discovery: Through the Layer 2 CDP, the Phone learns which VLAN
is the voice VLAN.
2-46 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.02-11
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-47
-- -
- --
IPTX v2.02-12
Commands for manual configuration are not needed for IP Phones if automated setup is used
because the setup prompts for these settings and configures a DHCP scope automatically.
However, if a DHCP scope is not configured or if the administrator wishes to manually
configure or change the settings, then these commands must be used.
The ip dhcp excluded-address start-IP end-IP command allows the administrator to exclude
static addresses within the scope range that might be statically assigned to a server or router
interface. For Cisco CallManager Express, the exclusions should include the IP address of the
routers interface that may be local to the IP Phones.
The ip dhcp pool pool-name command defines and creates a DHCP pool. After this command
has been executed, the router enters a DHCP configuration mode. The automated setup mode
creates a DHCP pool named ITS (from Cisco IOS Telephony Service, which Cisco
CallManager Express was formerly known as).
Note
Within the DHCP configuration mode under a pool, enter the network subnet subnet-mask
command to assign a range of IP addresses to be available for assignment to DHCP clients.
This will not include any exclusion previously defined. When the addresses are assigned, the
lowest available IP address is used first. In Cisco CallManager Express, this is the subnet that
the IP Phones are on.
2-48 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
--
-- -
--
IPTX v2.02-13
The command default-router IP-address sets option 003 on the DHCP scope that is being
defined. This option sends the IP address of the default gateway to the DHCP client. The
default gateway for Cisco CallManager Express is the router interface that is on the same
subnet as the IP Phones.
The optional command dns-server primary-IP [secondary-IP] allows the DNS server to be
sent in option 006 to the DHCP clients. For Cisco CallManager Express, this setting becomes
important if names are used for any of the URL values that can be assigned. Lack of a DNS
server requires use of IP addresses only.
Finally, a critical command is option option-number ip IP-address. This is the custom
option for the TFTP server. It is important that this command be configured correctly:
option 150 ip CallManagerExpress-IP. This IP address must be the IP address on the
Cisco CallManager Express router with which the IP Phones register.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-49
IPTX v2.02-14
In this sample configuration, the DHCP server has a scope defined for the IP phones. This
shows the command option 150 ip 10.90.0.1, where 10.90.0.1 is always set to the IP address
of a local interface on the Cisco CallManager Express router that is listening for the TFTP
protocol.
2-50 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
DHCP Broadcast
DHCP
Server
IPTX v2.02-15
When the DHCP server does not have a local interface on the network with the DHCP clients, a
DHCP relay server must be implemented. This is because of the broadcast nature of the DHCP
request and response process. By default, broadcasts do not traverse from one subnet on a
router to another subnet on a router. This is a basic characteristic of a router, and changing this
behavior effectively turns the router into a software bridge. The way around this is to enable
selective types of broadcast to be converted to either a unicast or a directed broadcast. This
allows the selected type of broadcast to traverse several routers to reach the destination server
or subnet.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-51
DHCP
Server
WAN
Unicast or Directed
Broadcast
DHCP Broadcast
IPTX v2.02-16
When the Cisco CallManager Express router is not the DHCP server for the IP Phones, there
is a good chance that the DHCP server is not local to the IP Phones. In this case, the Cisco
CallManager Express routeror another devicemust convert the DHCP broadcast to a
unicast or a directed broadcast. The DHCP request must also be modified to include the
originating subnet so that the appropriate scope is selected.
When the DHCP relay server is enabled on a Cisco IOS router, the configuration is done on the
interface that will be receiving the broadcast. This may or may not be the Cisco CallManager
Express router.
2-52 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
-- --
IPTX v2.02-17
The command service dhcp enables the Cisco IOS DHCP server feature on the router.
This feature is enabled by default, so this step is necessary only if it has previously been
disabled. The command that enables the selective forwarding of certain types of broadcasts
is ip helper-address ip-address. This command must be entered on the router interfaces that
have IP Phones local to them.
fa0/0
DHCP
Server
WAN
10.200.0.1
-
-
--
IPTX v2.02-18
This shows the command ip helper-address 10.200.0.1 configured on the FastEthernet 0/0
(fa0/0) interface, which is local to the IP Phone.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-53
IPTX v2.02-19
The heart of the time service is the system clock. The system clock begins to run the moment
the system starts, and it keeps track of the current date and time. The system clock can be set
from a number of sources and, in turn, can be used to distribute the current time through
various mechanisms to other systems. Some routers contain a battery-powered calendar system
that tracks the date and time across system restarts and power outages.
This calendar system is always used to initialize the system clock when the system is restarted.
It can also be considered an authoritative source of time and redistributed through NTP if no
other source is available. Furthermore, if NTP is running, the calendar can be periodically
updated from NTP, compensating for the inherent drift in the calendar time. When a router with
a system calendar is initialized, the system clock is set based on the time in its internal batterypowered calendar. On models without a calendar, the system clock is set to a predetermined
time constant.
NTP allows you to synchronize your Cisco CallManager Express router to a single clock on the
network, which is known as the clock master. Although NTP is disabled on all interfaces by
default, it is essential to Cisco CallManager Express. NTP is designed to synchronize the time
on a network of machines. NTP runs over the User Datagram Protocol (UDP) using port 123 as
both the source and destination, which in turn runs over IP. NTP version 3 (RFC 1305) is used
to synchronize timekeeping among a set of distributed time servers and clients.
2-54 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
An NTP network usually gets its time from an authoritative time source, such as a radio clock
or an atomic clock attached to a time server. NTP then distributes this time across the network.
An NTP client makes a transaction with its server over its polling interval (from 64 to
1024 seconds), which dynamically changes over time depending on the network conditions
between the NTP server and the client. No more than one NTP transaction per minute is needed
to synchronize two machines.
NTP uses the concept of a stratum to describe how many NTP hops away a machine is from an
authoritative time source. For example, a stratum 1 time server has a radio or atomic clock
directly attached to it. The stratum 1 time server then sends its time to a stratum 2 time server
through NTP, and so on. A machine that runs NTP automatically chooses the machine that has
the lowest stratum number with which it is configured to communicate using NTP as its time
source. This strategy effectively builds a self-organizing tree of NTP speakers.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-55
--
- -
- --
IPTX v2.02-20
The command clock timezone zone hours-offset sets the time zone and number of hours that
the time zone is offset from Coordinated Universal Time (UTC) (formerly Greenwich Mean
Time [GMT]). This allows the Cisco CallManager Express router to have its time zone defined.
If daylight-saving time occurs in the area where the Cisco CallManager Express system is
located, then it must be set up using the clock summer-time zone recurring [start-date enddate] command.
The command to allow the Cisco CallManager Express router to synchronize with an NTP
server is ntp server ip-address. This allows the Cisco CallManager Express router to keep the
correct time based on the time of a more authoritative source than its own system time.
The following list of common time zones and what their offsets are from GMT will help you
configure the clock commands.
Europe
GMT Greenwich Mean Time, as UTC
BST British Summer Time, as UTC + 1 hour
IST Irish Summer Time, as UTC + 1 hour
WET Western Europe Time, as UTC
WEST Western Europe Summer Time, as UTC + 1 hour
CET Central Europe Time, as UTC + 1
CEST Central Europe Summer Time, as UTC + 2
EET Eastern Europe Time, as UTC + 2
EEST Eastern Europe Summer Time, as UTC + 3
MSK Moscow Time, as UTC + 3
MSD Moscow Summer Time, as UTC + 4
2-56 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
4 hours
3 hours
ET Eastern Time, either as EST or EDT, depending on place and time of year
EST Eastern Standard Time, as UTC
5 hours
4 hours
CT Central Time, either as CST or CDT, depending on place and time of year
CST Central Standard Time, as UTC
6 hours
5 hours
7 hours
6 hours
PT Pacific Time, either as PST or PDT, depending on place and time of year
PST Pacific Standard Time, as UTC
8 hours
7 hours
9 hours
8 hours
10 hours
Australia
WST Western Standard Time, as UTC + 8 hours
CST Central Standard Time, as UTC + 9.5 hours
EST Eastern Standard/Summer Time, as UTC + 10 hours (+ 11 hours during
summer time)
For example, the command clocktimezone pst -8 would set the time zone to Pacific Standard
Time.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-57
10.1.2.3
IP Phone time comes from the
Cisco CallManagerExpress
router.
Cisco CallManagerExpress
router time synchronizes with
the NTP server.
-
- - -
- -
-
IPTX v2.02-21
This shows the Cisco CallManager Express router in the Pacific Standard time zone with
daylight-saving time turned on. The router is also set to synchronize its system time to that
of an NTP server.
2-58 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Transcoding
This topic describes how to configure transcoding between the G.711 and G.729 coderdecoders (codecs).
Transcoding
Transcoding between G.711 and G.729:
Requires hardware-based DSP farm
Assists Cisco CallManagerExpress software
ad-hoc conferencing when one or more parties
use G.729
Call transfer and forward to an endpoint where one
leg uses G.729 and the other uses G.711
A G.729 call forwarded to voice mail on the CUE
module, which only supports the G.711 codec
Sends G.711 MOH feed to a caller who is
using G.729
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.02-22
Versions of Cisco CallManager Express prior to version 3.2 supported G.729 compressed
voice calls for two-party calls only. Transcoding between G.711 and G.729 codecs requires a
hardware-based digital signal processor (DSP) farm. Cisco CallManager Express versions 3.2
and later support transcoding between G.711 and G.729 for the following features:
Ad hoc conferencing: When one or more remote conferencing parties use G.729.
Call transferring and forwarding: When one leg of a Voice over IP (VoIP)-to-VoIP
hairpin call uses G.711 and the other leg uses G.729. (A hairpin call is an incoming call that
is transferred or forwarded over the same interface from which it arrived.)
Cisco Unity Express (CUE): When an H.323 or SIP call using G.729 is forwarded to
CUE. Note that CUE supports only G.711.
Music on Hold (MOH): When the IP Phone receiving MOH is part of a system that uses
G.729 (G.711 MOH is translated to G.729). Because of compression, the MOH that is sent
using G.729 loses the fidelity that the MOH has with G.711.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-59
Transcoding (Cont.)
DSP hardware for transcoding:
IPTX v2.02-23
Transcoding is facilitated through the use of DSP chips. The DSP chips are contained on single
in-line memory modules (SIMMs) or on packet voice/data modules (PVDMs). These SIMMs
or PVDMs are then seated in the appropriate slots that are present on a network module or in
an onboard PVDM slot like those present on the Cisco 2800 Series routers and the Cisco 3800
Series routers.
Note
Deploying both the TI-549 DSP and the TI-5510 DSP in the same chassis is not
recommended.
2-60 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Transcoding (Cont.)
http://cisco.com/public/support/tac/tools.shtml
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.02-24
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-61
IPTX v2.02-25
The configuration of the High Density Voice Network Module (NM-HDV)based DSP farm is
different from the other DSP farms used by Cisco CallManager Express. The NM-HDV
requires that you configure the physical location of the DSP resource and the Skinny Client
Control Protocol (SCCP) and that you enable and set maximums of the DSP farm.
2-62 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
- -- -
IPTX v2.02-26
The NM-HDV can be used in the Cisco 2600XM, 2800, 3700, and 3800 platforms as a
conferencing resource and a transcoding resource. The NM-HDV as a DSP resource is based on
the TI-529 chip. This section shows the commands that are required to configure the use of
DSP resources in Cisco CallManager Express 3.2 or greater.
The first step to configure the NM-HDV as a DSP farm is to use the voice-card slot command
to identify the slot where the DSP farm resides. This command also enters voice port
configuration mode. After you are in voice port configuration mode, you must enter the
command dsp services dspfarm to allow the resource to be used as a DSP farm.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-63
- --
IPTX v2.02-27
Next, use the sccp local interface-type interface-number command to select the interface
that the DSP farm will use to register with the Cisco CallManager Express system. The
sccp ccm ip-address priority priority command defines the address of the Cisco CallManager
Express system on the DSP farm so that it knows where to register. Because there will be
only one Cisco CallManager Express router, set the priority to 1, which makes it the most
preferred. The sccp command needs to be entered in order to enable the SCCP processes on
the DSP farm router.
Note
The term ccm as seen in the sccp ccm command usually refers to Cisco CallManager;
however, in this case the command sccp ccm should point to the Cisco CallManager
Express router because it is the call control device.
2-64 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
- - ----
IPTX v2.02-28
The dspfarm transcoder maximum sessions number command specifies the maximum
number of transcoding sessions that the DSP farm will support. This number will depend
on the number of DSP resources present as well as the type of DSP resources. The final step
to configure the NM-HDV as a DSP resource to be used for transcoding is the dspfarm
command. This command enables the DSP farm processes on the router.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-65
10.1.1.1
G.711Capable
Only
WAN
G.711
DSP
Farm
G.729
- -- -
- -
-
-
- - ----
-
IPTX v2.02-29
In this example, an NM-HDV is installed in a router that is not the Cisco CallManager Express
router. The DSP resources are configured to be available for use in transcoding. A device
located across a low-bandwidth WAN link has been configured to use only the G.729 codec to
conserve bandwidth. This device calls a device that can use only the G.711 codec. The DSP
farm provides the transcoding under the direction of the CallManager Express system.
Note
CUE supports only the G.711 codec. This is the most common reason for needing the
transcoding DSP resources when using Cisco CallManager Express.
2-66 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
WAN
10.1.1.1
DSP
Farm
G.729
- -- -
- -
-
-
- - ----
-
IPTX v2.02-30
In this example, an NM-HDV is installed in the same chassis as the Cisco CallManager Express
router. The DSP resources are configured to be available for use in transcoding. A device
located across a low-bandwidth WAN link has been configured to use only the G.729 codec to
conserve bandwidth. This device calls a device that can use only the G.711 codec. The DSP
farm provides the transcoding under the direction of the Cisco CallManager Express system.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-67
IPTX v2.02-31
Setting up TI-5510based DSP farms using the NM-HD-1Vs, NM-HD-2Vs, and NM-HDV2s
involves enabling the DSP farms and SCCP on routers. This includes using the voice-card slot
command to define the DSP farm location, using the dsp services dspfarm command to start
the appropriate services on the router, and using the sccp local interface-type interface-number
command to define the local interface to use. The SCCP processes should be started with the
command sccp. These commands are the same as those that are used for configuring the NMHDV and were covered in detail earlier in this lesson.
2-68 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
- -
IPTX v2.02-32
The DSP farm profile declares codec usage and the maximum number of transcoding sessions
and associates SCCP with the DSP farm profile. This profile is then associated with a Cisco
CallManager Express group.
The dspfarm profile profile-identifier transcode command creates a profile and enters DSP
farm profile configuration submode. The supported codecs are then defined with the codec
codec-type command.
Note
Cisco CallManager Express is capable of controlling transcoding between the G.729 and
G.711 codecs only.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-69
----
-- -
IPTX v2.02-33
While in the DSP farm profile configuration submode, use the maximum sessions number
command to set the maximum number of simultaneous transcoding sessions that the DSP farm
allows. Finally, use theassociate application sccpcommand to associate SCCP with the DSP farm.
2-70 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
- --
--
IPTX v2.02-34
Only one Cisco CallManager Express group is required. Under the Cisco CallManager Express
group, assign a priority to an identifier, associate the group with a DSP farm profile, and set the
keepalive, switchback, and switchover parameters.
The command sccp ccm ip-address identifier identifier-number specifies the address of the
Cisco CallManager Express router and assigns an identifying number. This number is then used
in the associate ccm identifier-number priority 1 commandto associate a Cisco CallManager
Express to the Cisco CallManager Express group. A Cisco CallManager Express group is a
naming device under which data for the DSP farms is declared. The Cisco CallManager
Express group is defined by using the sccp ccm group group-number command.
Note
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-71
-- -
IPTX v2.02-35
Associate a DSP farm profile to a Cisco CallManager Express group with the command
associate profile profile-identifier register device-name. If the number of keepalive retries
should be set to something other than the default of three, use the keepaliveretries number
command.
2-72 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
G.711Capable
Only
G.711
10.1.1.1
WAN
G.729
DSP
Farm
OR
NM-HD-1V or
NM-HD-2V or
NM-HDV2
G.711Capable
Only
G.711
WAN
10.1.1.1
DSP
Farm
G.729
IPTX v2.02-36
This is an example of a router with a TI-5510based DSP resource installed. The DSP
resources are configured to be available for use in transcoding. A device located across a lowbandwidth WAN link that has been configured to use only the G.729 codec to conserve
bandwidth calls a device that can use only the G.711 codec. The DSP farm provides the
transcoding under the direction of the Cisco CallManager Express system.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-73
IPTX v2.02-37
-- -
-- - ----
--
IPTX v2.02-38
The Cisco CallManager Express router must be configured in telephony-service mode to utilize
the configured DSP farm. The steps are the same regardless of the type of DSP resource that is
configured. The maximum number of DSP farms that may register with the Cisco CallManager
Express router is set with the command sdspfarm units number. The default setting is 0. The
command sdspfarm transcode sessions number sets the maximum number of G.729 sessions
that the Cisco CallManager Express router allows. The range of the command is 0 to 128
sessions and defaults to 0. The command sdspfarm tag number device-name is to enable the
specific DSP farm to register. The number is a number from 1 to 5 and the device-name is the
name that the DSP farm will register with and is the MAC address of the SCCP client with
mtp prepended (for example, mtp00061476aef3).
2-74 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
-
--- -
--- - ----
---
-
IPTX v2.02-39
The figure shows the configuration in telephony-service mode on the Cisco CallManager
Express router that is required to enable the DSP farm to register.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-75
- - --- -
- -- -
- -- ---- -
IPTX v2.02-40
There are show commands available to verify that the DSP farms are configured and registered.
The first command, show sccp [statistics | connections], displays the SCCP configuration as
well as information about the past usage of the DSP farm. An example output follows:
- - -- - --
-
-
- - -
- ---
---
---
- ---
--- ---
--- ---
- ---
2-76 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
The command show sdspfarm units displays the configured and registered DSP farms. An
example output follows:
- -- -
- -
- -- -- --
The command show sdspfarm sessions shows the transcoding streams. An example output
follows:
CMERouter# show sdspfarm sessions
Stream-ID:1 mtp:1 10.1.1.1 18404 Local:2000 START
usage:Ip-Ip
codec: G711Ulaw64k duration:20 vad:0 peer Stream-ID:2
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-77
The variation on the previous command using show sdspfarms sessions summary displays a
more condensed view of all transcoding streams. An example output follows:
CMERouter# show sdspfarm sessions summary
max-mtps:1, max-streams:24, alloc-streams:24, act-streams:2
ID MTP State
Codec/Duration
IDLE -1
G711Ulaw64k /20ms
IDLE -1
G711Ulaw64k /20ms
START -1
START -1
IDLE -1
G711Ulaw64k /20ms
IDLE -1
G711Ulaw64k /20ms
The command show sdspfarm sessions active displays the active sessions at any one time. An
example output follows:
CMERouter# show sdspfarm sessions active
Stream-ID:1 mtp:1 10.10.10.3 18404 Local:2000 START
usage:Ip-Ip
codec:G711Ulaw64k duration:20 vad:0 peer Stream-ID:2
2-78 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Summary
Summary
Voice VLANs are used to separate voice traffic from data traffic.
Voice VLANs are configured on the interfaces of the switch into
which the IP Phone is plugged.
A single DHCP IP address pool is a large shared pool of
IP addresses.
Defining a separate pool for each Cisco IP Phone creates a
name for the DHCP server address pool and specifies IP and
MAC addresses for each name.
A DHCP relay server is defined if the Cisco CallManager
Express router is not a DHCP server and the DHCP server is not
on the same subnet as the DHCP clients.
NTP allows you to synchronize your Cisco CallManager
Express router to a single clock on the network.
DSP resources facilitate transcoding between G.729 and G.711.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-79
IPTX v2.02-41
2-80 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Lesson 3
This lesson details the process of registering IP Phones with the Cisco CallManager Express
router and the files that must be downloaded.
Objectives
Upon completing this lesson, you will be able to describe the process of registering an IP Phone
with a Cisco CallManager Express router. This includes being able to meet these objectives:
Describe IP Phone firmware files and XML configuration files
Describe how Cisco CallManager Express identifies IP Phones
Describe how IP Phones obtain XML configuration files and IP addresses
Files
This topic describes IP Phone firmware files and XML configuration files.
Firmware
XMLDefault.cnf.xml
SEPAAAABBBBCCCC.cnf.xml
XML
XML SEP
XML SEP
XML
XML
Firmware
7920
Firmware
7912
Firmware
7905
Firmware
7902
Firmware
7910
Firmware
TFTP Server
IPTX v2.02-2
Certain files are necessary to the proper operation of the IP Phone or analog device so that it
can register successfully with the Cisco CallManager Express router. These files are as follows:
Firmware: The firmware is loaded into memory on the IP Phone and will survive a reboot.
XMLDefault.cnf.xml: This extensible markup language (XML) configuration file
specifies the proper firmware, address, and port that the new Phone needs to register.
SEPAAAABBBBCCCC.cnf.xml: This XML configuration file is specific to one device
and is based on the MAC address.
2-82 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Firmware
7905
Firmware
7940
Firmware
7960
Firmware
- -
IPTX v2.02-3
All of the necessary firmware files for IP Phones are stored internally on the Cisco
CallManager Express router flash memory, so an external database or file server is not
required. During registration, IP Phones use TFTP to download firmware files from the router
flash memory. All Cisco CallManager Express configuration and language files are located in
the DRAM of the router under system:/its/. To make the firmware files available through a
TFTP server, use the command tftp-server flash:firmware-file-name. The command load
firmware-file-name is also required to associate the model of IP Phone with the appropriate
firmware file.
The following is a list of firmware files based on Cisco IP Phone model, including the Cisco
Analog Telephone Adaptor (ATA) and the Cisco 7914 Expansion Module. These files are
specific to Cisco CallManager Express 3.2.1. The files that you need will vary depending on
the version of Cisco CallManager Express that is used.
ATA 186 ATA030100SCCP040211A.zup
ATA 188 ATA030100SCCP040211A.zup
7902G CP7902010200SCCP031023A.sbin
7905G CP7905040000SCCP040701A.sbin and CP79050101SCCP030530B31.zup
7910G+SW P00403020214.bin
7912G CP7912040000SCCP040701A.sbin
7914 S00103020002.bin
7920 cmterm_7920.4.0-01-08.bin
7935 P00503010100.bin
7936 P00503010100.bin
7940G P00303020214.bin or P00305000301.sbn
7960G P00303020214.bin or P00305000301.sbn
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-83
The firmware names with .sbin extensions are signed phone loads. When a signed phone load is
installed on an IP Phone, that Phone cannot go back to an unsigned phone load. The Phone will
always have to use a signed phone load even if the Phone is used by Cisco CallManager.
2-84 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
- -
- -
-
-
IPTX v2.02-4
The 7970G and 7971G-GE are supported with Cisco CallManager Express 3.2.1 and require
five fireware files be present in flash RAM of the Cisco CallManager Express router. These
five files are listed below:
TERM70.DEFAULT.loads
TERM70.6-0-2SR1-0-5s.loads
jvm70.602ES1R6.sbn
jar70.2-8-0-104.sbn
cnu70.62-0-1-6.sbn
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-85
SEP
XML
*AAAABBBBCCCC = the
MAC address
<device>
<devicePool>
<callManagerGroup>
<members>
<member priority="0">
<callManager>
<ports>
<ethernetPhonePort>2000</ethernetPhonePort>
</ports>
<processNodeName>10.15.0.1</processNodeName>
</callManager>
</member>
</members>
</callManagerGroup>
</devicePool>
<versionStamp>{Jan 01 2002 00:00:00}</versionStamp>
<loadInformation>P00303020214</loadInformation>
- <userLocale>
<name>English_United_States</name>
<langCode>en</langCode>
</userLocale>
<networkLocale>United_States</networkLocale>
<idleTimeout>0</idleTimeout>
<authenticationURL />
<directoryURL>http://10.15.0.1/localdirectory</directoryURL>
<idleURL />
<informationURL />
<messagesURL />
<proxyServerURL />
<servicesURL />
</device>
IPTX v2.02-5
2-86 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Default
XML
<Default>
<callManagerGroup>
<members>
<member priority="0">
<callManager>
<ports>
<ethernetPhonePort>2000</ethernetPhonePort>
</ports>
<processNodeName>10.15.0.1</processNodeName>
</callManager>
</member>
</members>
</callManagerGroup>
<loadInformation6 model="IP Phone 7910">P00403020214</loadInformation6>
<loadInformation124 model="Addon 7914"></loadInformation124>
<loadInformation9 model="IP Phone 7935"></loadInformation9>
<loadInformation8 model="IP Phone 7940">P00303020214</loadInformation8>
<loadInformation7 model="IP Phone 7960">P00303020214</loadInformation7>
<loadInformation20000 model="IP Phone 7905"></loadInformation20000>
<loadInformation30008 model="IP Phone 7902"></loadInformation30008>
<loadInformation30002 model="IP Phone 7920"></loadInformation30002>
<loadInformation30019 model="IP Phone 7936"></loadInformation30019>
<loadInformation30007 model="IP Phone 7912"></loadInformation30007>
</Default>
IPTX v2.02-6
The file XMLDefault.cnf.xml is used by IP Phones and devices that do not find a more specific
SEPAAAABBBBCCCC.cnf.xml file. IP Phones that download this XML file through TFTP
learn the IP address and port of the Cisco CallManager Express router. The IP Phones also
learn the version of firmware that is required to function properly with Cisco CallManager
Express. The file is generated by the Cisco CallManager Express system when the command
create-cnf is entered in telephony-service mode.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-87
IP Phone Information
IP Phone Information
There is no 7914 in the
XMLDefault.cnf.xml file.
Default
XML
IPTX v2.02-7
The 7914 Expansion Module cannot auto-register and requires the use of the
type command under
the ephone. None of the other valid IP Phones and ATA devices in Cisco CallManager Express
require the type command; they are automatically recognized by Cisco CallManager Express.
2-88 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
This topic describes how an IP Phone obtains its XML configuration file and IP address.
FLP
Step 2 -Phone returns FLP to switch
because of a completed circuit
FLP
Step 3 -Power is applied
CDP
Needed Power
IPTX v2.02-8
The following are the steps that take place during phone bootup for all Cisco IP Phones when
using the Cisco prestandard Power over Ethernet (PoE).
Step 1
The switch sends a special tone, called a Fast Link Pulse (FLP), out the interface.
The FLP goes to the powered device, in this case, an IP Phone.
Step 2
The powered device has a physical link when there is no power between the pin on
which the FLP arrives and a pin that goes back to the switch. This creates a circuit,
and the end result is that the FLP arrives back at the switch. This will never happen
when the attached device is a non-PoE capable device, such as a PC. And if the FLP
does not make it back to the switch, no power is applied.
Step 3
Step 4
Step 5
Step 6
Through Cisco Discovery Protocol (CDP), the IP Phone tells the switch specifically
how much power it needs.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-89
DC
Step 2 25 ohms of resistance
DC
Step 3 25 ohms of resistance
detected
Step 4 Low power mode initiated (6.3W)
Step 5 Cisco IP Phone boots up
Step 6 -Amount of needed power is conveyed
through CDP from IP Phone to switch
CDP
Needed Power
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.02-9
The following are the steps that take place during phone bootup for the 7970G Phone and the
7971G-GE Phone. Power is the standards-based PoE.
Step 1
The switch constantly applies DC current to all ports that may have a powered
device attached to them.
Step 2
The powered device is connected and will have a resistance of 25 ohms if it is PoEcompliant.
Step 3
Step 4
Power is applied to the link in low power mode, which is 6.3 watts.
Step 5
Step 6
Through CDP, the IP Phone tells the switch specifically how much power it needs.
2-90 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
CDP
Voice VLAN
DHCPDISCOVER
Broadcast
DHCPOFFER
IP Address, Subnet Mask, Default
Gateway, and TFTP Server (option 150)
IPTX v2.02-10
Step 7
Through CDP, the switch informs the IP Phone of its voice VLAN (auxiliary
VLAN).
Step 8
The IP Phone initializes the IP stack and sends out a DHCPDISCOVER broadcast
requesting an IP address on the voice VLAN scope.
Note
Step 9
It is possible to hardcode the IP address, subnet mask, default gateway, DNS, and TFTP
server on the IP Phone and skip the DHCP steps. However, it is recommended that DHCP be
used in order to minimize the administrative load that is required to hardcode these settings.
The DHCP server hears the broadcast and assigns an IP address from the scope for
the voice VLAN subnet, subnet mask, default gateway, DNS (optional), and address
of the TFTP server (the Cisco CallManager Express router). All settings are then
sent back to the IP Phone in the form of a DHCPOFFER message.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-91
SEP
XML
IPTX v2.02-11
Step 10
The Phone receives the DHCPOFFER and applies the values obtained.
Step 11
One of the values carried in the DHCPOFFER message is the address of the TFTP
server. The IP Phone uses this information to make a connection to the TFTP server
and attempt to download a file by the name of SEP000F2470AA32.cnf.xml. This
file, if found, contains the information the Phone needs in order to register with
Cisco CallManager Express. This information includes the IP address, port, locale,
and firmware file that should be loaded on the IP Phone.
If the Phone has the correct firmware, it will register and get its configuration. If the
firmware is not correct, then proceed to the next step.
If no SEP XML file is found, go to Step 14.
Note
The extension numbers, speed dials, and other settings are assigned when the IP Phone
registers. They are not contained in the SEP XML file.
2-92 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.02-12
Step 12
If the firmware is out of date or different from the one that is specified, the IP Phone
goes back to the TFTP server and downloads the appropriate firmware.
Step 13
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-93
Cisco
CallManager
Express is the
TFTP server.
XML
Step 15 -The Phone will register to Cisco CallManager Express, but without
any assigned extension. No calls can be placed or received, and a SEP file will
be created on the Cisco CallManager Express router.
or
Step 15 -If automatic assignment is enabled or the phone has been configured,
then the new IP Phone registers to Cisco CallManager Express and
is given an extension number.
IPTX v2.02-13
Step 14
If no SEP XML file exists for the specific device, the device is considered new. The
new IP Phone gets a file called XMLDefault.cnf.xml from the TFTP server. The
XMLDefault.cnf.xml file specifies the IP address, port, and firmware file that the
new IP Phone needs in order to register. If the new IP Phone has the correct
firmware, it can register with Cisco CallManager Express. If it does have the correct
firmware, it will download the correct firmware and reboot.
Step 15
The Phone registers with Cisco CallManager Express using SCCP messages. If
automatic assignment is enabled, Cisco CallManager Express assigns an extension
automatically. If it is not enabled, the Phone will have no extension and will not be
able to place or receive any calls.
2-94 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Summary
Summary
The IP Phone requests the firmware, configuration,
and language files when it boots up.
The IP Phone uses TFTP-DHCP option 150 to
download during registration.
The IP Phone uses its MAC address as part of
a created file name to download firmware and
configurations and uses the obtained IP address to
register with the Cisco CallManager Express router.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-95
IPTX v2.02-14
2-96 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Lesson 4
This lesson defines ephone-dn (Ethernet phone directory number) and ephone (Ethernet phone)
and describes the different types of ephone-dns.
Objectives
Upon completing this lesson, you will be able to describe an ephone-dn and an ephone and
explain how to utilize the different types of ephone-dns. This includes being able to meet these
objectives:
Define ephone-dn and describe examples
Define ephone and describe examples
Describe different types of ephone-dns
Explain how to determine the quantity of allowable ephone-dns
IPTX v2.02-2
The Cisco CallManager Express software was created with modular and flexible configuration
in mind. The composition of the ephone and ephone-dn allows for many different types of
configurations and designs. The ephone represents the physical phone s configuration and
settings. The ephone is associated with a physical device by MAC address. This Layer 2
address is globally unique. The number of supported ephones on a Cisco CallManager Express
system depends on the licensed capacity and the router platform, and currently can be no more
than 240 ephones. Enterprises with more than 240 Phones should consider Cisco CallManager.
An ephone-dn represents a line or channel for voice to connect to the ephone. The ephone-dn
can be tied to the ephone in the configuration of the ephone. The quantity of ephone-dns that
are supported represents the maximum number of extensions that can be supported at any one
time. It is also a function of the licensed capacity and the hardware platform.
When considering the required number of ephones and ephone-dns, this information must be at
hand:
Number of simultaneous calls at each IP Phone
Quantity of directory numbers that is desired
Quantity of physical IP Phones
2-98 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Ephone-dn
Ephone-dn Features
Directory number and
extension number are
equivalent
Line and voice port are
equivalent
Sequence number, or dn-tag,
is unique (is assigned when
the ephone-dn is created)
Can have one or more
telephone numbers
associated with it
Can have one or two voice
channels
When it is initially configured,
it creates one or more
telephony system POTS dial
peers
DN1
Ephone-dn
DN1 and
DN2
Ephone-dn
DN1
DN1
Ephone-dn
IPTX v2.02-3
Ephone-dn is software that represents a line that connects a voice channel to a phone instrument
on which a user can receive and make calls. An ephone-dn has one or more extensions or
telephone numbers associated with it. An ephone-dn is equivalent to a phone line in most cases,
but not always. There are several types of ephone-dns with different characteristics.
Each ephone-dn has a unique dn-tag, or sequence number, that identifies it during
configuration. Ephone-dns are assigned to line buttons on ephones during configuration.
Because each ephone-dn represents a virtual voice port in the router, the number of ephone-dns
that you create corresponds to the number of simultaneous calls that you can have. This means
that if you want multiple calls to the same number to be answered simultaneously, you need
multiple virtual voice ports (ephone-dns) with the same destination pattern (extension or
telephone number).
Ephone-dns can be configured in various ways, including:
Primary directory number on a single-line ephone-dn
Primary and secondary directory numbers on a single-line ephone-dn
Primary directory number on a dual-line ephone-dn (only one line has active voice at any
one time)
Note
When ephone-dn are created the system will constuct traditional dial peers in the
background. These will be discussed in Module 3.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-99
Configuring an Ephone-dn
IPTX v2.02-4
An ephone-dn is created by the ephone-dn dn-tag command, which builds one virtual voice
port. The dn-tag field must contain a unique number if this is a new ephone-dn or an existing
number if a current ephone-dn is being modified. If the ephone-dn is to be assigned an
extension and assigned to a phone line, it should be able to accept two calls on the same line at
the same time. The ephone-dn should then have the keyword dual-line at the end of the
ephone-dn command. The dual-line keyword must be present in order to use an ephone-dn for
call waiting, consultative transfers, and conferencing with only one line appearance on the
Phone. An ephone-dn without the dual-line keyword is used when the ephone-dn is configured
for paging functions, intercoms, voice mail ports, or Message Waiting Indicators (MWIs).
Note
The number dn-number command assigns a primary and, optionally, a secondary number to
the ephone-dn and is entered in ephone-dn subconfiguration mode.
The keyword no-reg can be used if either the primary extension or both the primary extension
and the secondary extension should not be registered to either an H.323 gatekeeper or a session
initiation protocol (SIP) proxy server. For example, a service provider that sells Cisco
CallManager Express may not want to have the primary extension number registered because there
may be many clients with the same dial plan. The secondary number, which would most likely be
an E.164 number, would be registered with an H.323 gatekeeper. The
number dn-number
secondary dn-number no-reg primary command would be added to the configuration of the
ephone-dn to accomplish this.
2-100 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Basic Configuration
One virtual
voice port
One line or
channel
1001
IPTX v2.02-5
When an ephone-dn is configured with a single line, one virtual voice port is configured. Only
one call to or from the ephone-dn can be active because only a single line exists. If a second
call arrives while a call is active, the second call will receive whatever is the defined busy
treatment. Configuring an ephone-dn in this fashion mimics typical functionality of a keyswitch
line. An ephone-dn configured in this way lacks some of the more advanced PBX features.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-101
Ephone
Ephone Features
Software configuration of a physical phone
Assigned a unique phone-tag,or sequence
number (assigned when it is created)
Can be an IP Phone or an analog phone
attached to an ATA
Uses MAC address of the IP Phone or ATA
to tie software configuration to hardware
Hardware automatically detected for all
supported models except the ATA and 7914
Expansion Module
Can have one or more ephone-dns
associated with it
Number of line buttons varies based
on hardware
7960
Button 1 DN
Button 4 DN
Button 2 DN
Button 5 DN
MAC 000F.2470.F92A
7912
Button 1 DN
MAC 000F.2470.F92B
ATA 188
Analog 1 DN
MAC 000F.2470.F92D
Analog 2 DN
MAC 000F.2470.F92E
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.02-6
An ephone is a single instance of the software configuration of the physical instrument with
which a phone user makes and receives calls in a Cisco CallManager Express system. The
physical instrument is either a Cisco IP Phone or an analog telephone adaptor (ATA) device
that has an attached analog phone or fax.
Note
The Cisco IP Softphone and Cisco Communicator Softphone are not currently supported as
ephones. However, certain third-party vendors have a softphone that works (IP Blue).
Each ephone has a unique phone-tag, or sequence number, to identify it during configuration.
This phone-tag number must be unique and new if configuring a new ephone. If modifying an
already defined ephone, use the previously defined tag number to enter configuration mode for
that ephone. The ephone must be tied to the physical device in the ephone subconfiguration
mode. This is done by using the MAC address. The type of Phone must be defined if one or two
Cisco IP Phone 7914 Expansion Modules are present or if the device is a Cisco ATA 186 or
Cisco ATA 188. All other types of Phones can be automatically detected by the Cisco
CallManager Express system. The ephone-dns then must be assigned to the line buttons of the
ephone or Expansion Module. The number of line buttons varies with the model of IP Phone.
2-102 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Configuring an Ephone
-- --
IPTX v2.02-7
The ephone is created or modified in global configuration mode, using the ephone phone-tag
command. After the command is entered, the interface will be in ephone subconfiguration
mode, and the ephone-specific commands are entered from there. The command
mac-address mac-address is entered with 12 hex characters in groups of four separated
by a period (for example, 0000.0c12.3456). This associates the defined MAC address of the
physical device with the ephone.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-103
-
-
IPTX v2.02-8
The button button-number {separator} dn-tag command allows a line button to have an
ephone-dn assigned to it. The button number is the button on the IP Phone, starting with the top
button being 1. The dn-tag is the ephone-dn tag, or sequence number. The separator is a
single character that defines the properties of the button and the Phone s extension. Separators
include the following:
: (colon): Normal ring. For incoming calls, the Phone produces audible ringing, a flashing
icon on the Phones display, and a flashing red light on the handset. On the 7914 Expansion
Module, a flashing yellow light also accompanies incoming calls.
b: Beep but no ring. Audible ring is suppressed for incoming calls, but call-waiting beeps
are allowed. Visible cues are the same as those described for a normal ring.
f: Feature ring. Differentiates incoming calls on a special line from incoming calls on other
lines. The feature ring cadence is a triple pulse, as opposed to a single pulse for normal
internal calls and a double pulse for normal external calls.
m: Monitor mode for a shared line. A visible line status indicator shows whether the
shared line is in use. A shared line cannot be used on this Phone for incoming calls, but
can be used as a speed dial to the line it is monitoring. This will work only if the target is
in an idle state.
o: Overlay line without call waiting. Multiple ephone-dns share a single button, up to a
maximum of ten on a button. The dn-tag argument can contain up to ten individual dn-tags,
separated by commas.
c: Overlay line with call waiting. Multiple ephone-dns share a single button, up to a
maximum of ten on a button. The dn-tag argument can contain up to ten individual dn-tags,
separated by commas. This feature is available as of Cisco CallManager Express version 3.2.1.
s: Silent ring. An audible ring and the call-waiting beep are suppressed for incoming calls.
Visible cues are the same as those described for a normal ring.
The type {7940 | 7960} addon 1 7914 command sets the ephone to have either a 7940 or 7960
with either one or two 7914 Expansion Modules assigned. This command is required if using
the 7914 Expansion Module.
2-104 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
ephone 1
1001
Button 1
ephone-dn 7:
one virtual port
000F.2470.F8F8
--
IPTX v2.02-9
This example shows an ephone-dn 7 being created and assigned to ephone 1. The ephone-dn
is configured to be dual-line and is assigned to line button 1 on the IP Phone at the specified
MAC address.
Multiple Ephone-dns
1008 on Line 1
1009 on Line 2
1010 on Line 1
1011 on Line 6
Button 1
Button 2
Button 1
Button 6
1008
1008
1009
1009
1010
1010
1011
1011
IPTX v2.02-12
When there are multiple physical devices, the same number of ephones needs to be defined.
Then each ephone has one or more ephone-dns assigned to line buttons on the physical device.
The configuration for this follows.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-105
IPTX v2.02-11
This example shows the configuration of the multiple ephone-dns shown in the previous figure.
Multiple Ephone-dns
1008 on Line 1
1009 on Line 2
1010 on Line 1
1011 on Line 6
Button 1
Button 2
Button 1
Button 6
1008
1008
1009
1009
1010
1010
1011
1011
IPTX v2.02-12
In the figure, multiple ephone-dns are assigned to the ephone. The ephone-dns are assigned to
different buttons on the ephone. The configuration for this follows.
2-106 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.02-13
This example shows the configuration of the multiple ephone-dns shown in the previous figure.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-107
Type of Ephone-dns
Overview of Ephone-dns
Six types of
ephone-dns:
Single-line
Dual-line
Primary and secondary
extension on a singleor dual-line ephone-dn
Shared single-or
dual-line ephone-dn
Multiple single-or
dual-line ephone-dns
on one or more
ephones
1001
1002
1002
1004 and
1005
1006
1006
1003
1003
1003
1003
Overlay ephone-dn
on an ephone
2005 Cisco Systems, Inc. All rights reserved.
1007
IPTX v2.02-14
The ephone-dn is the basic building block of a Cisco CallManager Express system. Six
different types of ephone-dns can be combined in different ways for different call coverage
situations. Each type helps with a particular limitation or call coverage need. For example, if
you want to keep the number of ephone-dns low and provide service to a large number of
people, you might use shared ephone-dns. Or if you have a limited number of extension
numbers that you can use, but you need to handle a large number of simultaneous calls, you
might create two or more ephone-dns with the same number. Knowing how each type of
ephone-dn works and what its advantages are will help you design your system.
These are the types of ephone-dns in a Cisco CallManager Express system:
Single-line ephone-dn
Dual-line ephone-dn
Primary and secondary extension on one ephone-dn
Shared ephone-dn
Multiple ephone-dns on one ephone
Multiple ephone-dns on different ephones
Overlay ephone-dn
2-108 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Single-Line Ephone-dn
One virtual
voice port
One channel
1001
IPTX v2.02-15
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-109
Dual-Line Ephone-dn
One virtual
voice port
Two channels
1002
1002
The ephone-dn creates one virtual voice port.
The dual-line keyword indicates two voice channels for calls to
terminate on an ephone-dn extension.
This should be used on ephone-dns that need call waiting,
consultative transfer, and conferencing on one button.
This cannot be used on ephone-dns that are used for intercoms,
paging, MWI, call parking slots, and MOH feeds.
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.02-16
2-110 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
1005 and
2065559005
IPTX v2.02-17
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-111
Shared Ephone-dn
Button 1
1100 on Line 2
1007 on Line 1
1100 on Line 2
1006
1006
1006 on Line 1
Button 2
1100
Button 1
1007
1007
Button 2
1100
IPTX v2.02-18
2-112 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
-
--
--
IPTX v2.02-19
This example shows the configuration of the shared ephone-dn shown in the previous figure.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-113
Ephone 3
Button 1
Button 2
1003
1003
1003
1003
preference 0
no huntstop
preference 1
huntstop
Ephone 4
Button 2
1004
1004
preference 0
no huntstop
Ephone 5
Button 2
1004
1004
preference 1
huntstop
IPTX v2.02-20
There are two different ways to use multiple ephone-dns with the same extension number. One
way is for multiple ephone-dns to be assigned to the same ephone, but on separate line buttons.
This type of configuration is useful when more than two calls arrive at a destination and need to
be handled simultaneously. For example, if six calls at a time need to be handled, then three
dual-line ephone-dns can all be configured with the same extension number.
The other way that multiple ephone-dns with the same extension number can be configured is
on different ephones. This is used when two or more ephones need to be able to answer the
same number. This also provides some very basic hunting functionality. The characteristics of
this type of configuration are:
Two or more virtual ports have the same extension number.
It is not a shared line.
Two call connections are allowed per ephone-dn if it is a dual-line ephone-dn; one
connection is allowed if it is a single-line ephone-dn.
The preference and huntstop commands are used to configure hunting behavior.
Only one ephone rings at a time.
A call on hold is retrievable only by the ephone that first placed the call on hold.
2-114 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.02-21
Values assigned in the preference command are passed to the dial peers that are created by the
two ephone-dns. Both dial peers for the ephone-dns are matched when this extension number
is dialed. The call is connected to the ephone-dn that has the highest preference. The default
preference value is 0 (the most preferred); the lowest preference value that can be set is 10
(the least preferred).
Using the huntstop command without the channel keyword affects call hunting behavior that
relates to ephone-dns (lines or extensions). The huntstop command without the channel
keyword is the default setting on all ephone-dns. If the huntstop attribute is set, an incoming
call does not roll over (hunt) to another ephone-dn when the called ephone-dn is busy or does
not answer and a hunting strategy has been established that includes this ephone-dn. For
example, the huntstop attribute prevents hunt-on-busy from redirecting a call from a busy
Phone into a dial-peer setup with a catch-all default destination. Use the no huntstop command
under the ephone-dn to disable huntstop and allow hunting for ephone-dns.
The huntstop channel attribute works in a similar way, but it affects call hunting behavior for
the two channels of a single dual-line ephone-dn. If the huntstop channel command is used,
incoming calls do not hunt to the second channel of an ephone-dn when the first channel is
busy or does not answer. For example, an incoming call might search through the following
ephone-dns and channels:
ephone-dn 10 (channel 1)
ephone-dn 10 (channel 2)
ephone-dn 11 (channel 1)
ephone-dn 11 (channel 2)
ephone-dn 12 (channel 1)
ephone-dn 12 (channel 2)
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-115
Preference 0
1020 DN
Preference 1
1020 DN
Preference 2
no huntstop
Channel 1
no huntstop
channel
no huntstop
1020 DN
Preference 3
Busy
Channel 2
Ephone-dn 11
Busy
Channel 1
no huntstop
channel
huntstop
Ephone-dn 10
Busy
Channel 2
Ephone-dn 12
Busy
Channel 1
no huntstop
channel
Channel 2
Ephone-dn 13
Channel 1
Channel 2
Busy
IPTX v2.02-22
When the no huntstop command is used on the ephone-dn, the call rings on the first ephone-dn
and goes through any hunting defined on the two channels in a dual-line ephone-dn before
being sent to the next most-preferred ephone-dn that has a matching destination pattern. This
will continue until an ephone-dn with huntstop configured is reached or until no more dial peers
(ephone-dns) have matching destinations patterns.
2-116 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
1020 DN
no huntstop
Ephone-dn 10
huntstop channel
Preference 0
Channel 1
Channel 2
1020 DN
no huntstop
Preference 1
Busy
Ephone-dn 11
huntstop channel
Channel 1
Channel 2
1020 DN
huntstop
Preference 2
1020 DN
Preference 3
no huntstop
channel
Busy
Ephone-dn 12
Channel 1
Busy
Channel 2
Ephone-dn 13
Channel 1
Channel 2
IPTX v2.02-23
The huntstop channel attribute works in a similar way, but it affects call hunting behavior for
the two channels of a single dual-line ephone-dn. If the huntstop channel command is used,
incoming calls do not hunt to the second channel of an ephone-dn when the first channel is
busy or does not answer.
When the no huntstop channel command is used (the default), a call might ring for 10 seconds
on ephone-dn 10 (channel 1), then after 10 seconds move to ephone-dn 10 (channel 2). This is
not usually desirable in a dual-line Phone.
It is often useful to reserve the second channel of a dual-line ephone-dn for call transfer, call
waiting, or conferencing. The huntstop channel command tells the system that if the first
channel is in use or does not answer, an incoming call should hunt forward to the next ephonedn in the hunt sequence instead of to the next channel on the same ephone-dn.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-117
Ephone 3
Button 1
Button 2
1003
1003
1003
1003
preference 0
no huntstop
preference 1
huntstop
If either of the two voice channels are available, the ephone-dn that is assigned
to line button 1 is used when an incoming call is set up.
When the two voice channels on the ephone-dn are being used on line button 1,
an incoming call rolls to the ephone-dn that is assigned to line button 2.
A fifth call receives busy treatment when both voice channels onboth ephone-dns
are being used on line buttons 1 and 2.
The preference of 0 is more preferred than the preference of 1; the default is 0.
The no huntstop on the line button 1 ephone-dn allows the call to hunt to the
second ephone-dn when the first ephone-dn is busy.
The huntstop on the line button 2 ephone-dn stops the hunting behavior and
applies the busy treatment.
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.02-24
When two different ephone-dns with the same number are assigned to different buttons of the
same ephone and a call arrives, the call goes to the ephone-dn that is most preferred based on
the preference setting. If the first ephone-dn is busy or not answered, the call will go to the
second ephone-dn. Because the buttons have different ephone-dns, the calls that are connected
on these buttons are independent of one another.
The configuration for this follows.
2-118 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
-
-
--
IPTX v2.02-25
This example shows the configuration for two ephone-dns with one number on the same
ephone.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-119
Ephone 4
Button 2
1004
preference 0
no huntstop
Ephone 5
Button 2
1004
preference 1
huntstop
IPTX v2.02-26
A shared line is an ephone-dn configured on two ephones with a representation of the same
line on each ephone. This is different than two ephones having separate ephone-dns with the
same number.
A shared ephone-dn has the same call connection at all the buttons on which the shared ephone-dn
appears. If a call on a shared ephone-dn is answered on one ephone, then placed on hold, the
call can be retrieved from the second ephone on which the shared ephone-dn appears. But when
there are two separate ephone-dns with the same number, a call connection appears only on the
Phone and button at which the call is made or received. If the call is placed on hold on one
ephone, it cannot be retrieved from the other ephone that has an ephone-dn with the same
number because that is a different virtual voice port.
The configuration for this follows.
2-120 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.02-27
This example shows the configuration for two ephone-dns that have one number on
different ephones.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-121
Overlay Ephone-dn
1101 on Line 4
1101 on Line 4
Button 4
1101
Preference 0
no huntstop
Button 4
1101
Preference 1
huntstop
Button 4
1101
Preference 0
no huntstop
Button 4
1101
Preference 1
huntstop
1101 on Line 4
1101 on Line 4
Two or more ephone-dns applied to the same ephone line button
Up to ten ephone-dns per line button on the phone
In overlay set, either all ephone-dns must be single-line or all must
be dual-line
Ephone-dns usually applied on more than one phone
Allows up to ten calls (depending on the number of ephone-dns)
to the same phone number that resides on multiple ephones
Call pickup is not supported
Call placed on hold retrievable only by the phone that placed the call
on hold
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.02-28
2-122 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
The behavior of an overlay set of ephone-dns with call waiting and overlay ephone-dns without
call waiting is the same, except for the following:
Calls to numbers included in overlay ephone-dns with call waiting will cause inactive
Phones to ring and active Phones that are connected to other parties to generate auditory
call-waiting notification. The default sound is beeping, but you can configure an ephone-dn
to use a ringing sound. Visual call-waiting notification includes the blinking of handset
indicator lights and the display of caller IDs.
For example, if three of four Phones are engaged in calls to numbers from the same overlay
ephone-dn with call-waiting and another call comes in, the one inactive Phone will ring, and the
three active Phones will issue auditory and visual call-waiting notification.
Two calls to numbers in an overlay ephone-dn set can be announced. For the first call, the
Phone user will hear a ring; for the second, call-waiting notification. Subsequent calls must
wait in line, remaining invisible until one of the two original calls has ended. The callers
who are waiting in the line will hear a ringback tone.
A simple configuration in which one Phone has a call waiting enabled overlay and the
other one has a standard overlay with no call waiting follows.
-
--
--
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-123
IPTX v2.02-29
Number of Ephone-dns
max-dn Command
IPTX v2.02-30
The maximum number of ephone-dns that can be configured is based upon the hardware
platform on which the Cisco CallManager Express software is installed. The default of a newly
installed Cisco CallManager Express system is that no ephone-dns can be configured. This is
because the command max-dn is set to 0. To allow the creation of ephone-dns, use the
command max-dn ? to determine the maximum allowable number of ephone-dns the hardware
supports. Set the value within that range to comply with the licensing.
2-124 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Attempts to create an
11th ephone-dn will fail.
2005 Cisco Systems, Inc. All rights reserved.
DN
DN
DN
DN
DN
DN
DN
DN
DN
DN
IPTX v2.02-31
In this graphic, the command max-dn 10 creates ten ephone-dns. If you try to create an 11th
ephone-dn, an error message is sent to the console of the Cisco CallManager Express router.
An 11th ephone-dn will not be allowed until the maximum allowable number of ephone-dns is
increased.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-125
Summary
Summary
Ephone-dnsand ephonesare two key components in the Cisco
CallManager Express system.
An ephone-dn is a single instance of an extension (directory)
number.
An ephone is a single instance of the configuration of the physical
instrument.
There are different types of ephone-dns:
Single-line ephone-dn
Dual-line ephone-dn
Primary and secondary extension on one ephone-dn
Shared ephone-dn
Multiple ephone-dns on one ephone
Multiple ephone-dns on different ephones
Overlay ephone-dn
2005 Cisco Systems, Inc. All rights reserved.
2-126 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.02-32
Lesson 5
Objectives
Upon completing this lesson, you will be able to describe Cisco CallManager Express methods
for downloading files to IP Phones. This includes being able to meet these objectives:
Describe downloading bundled Cisco CallManager Express files
Describe downloading individual Cisco CallManager Express files
Identify Cisco CallManager Express GUI files to enable web access
Identify TSP files for TAPI integration
Describe Music on Hold and xml.template files
TFTP or
FTP server
GUI Files
Firmware
Music on Hold
IOS
IPTX v2.02-2
Cisco CallManager Express requires firmware files to be copied to the flash memory on your
router and shared using TFTP or FTP. Download Cisco CallManager Express 3.1 files to a
TFTP or FTP server that is accessible to your Cisco CallManager Express router. To move the
files from the server to the flash memory, use the copy tftp flash command or the copy ftp
flash command. You can download the files in a single bundle or individually.
When the Cisco CallManager Express router is upgraded, the new files, such as firmware, GUI
files, and Cisco IOS software, must be moved to the flash memory on the router. Other files,
such as new firmware versions and Music on Hold (MOH) files, may need to be periodically
updated.
2-128 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.02-3
A bundled file with all of the Cisco CallManager Express files can be downloaded from
Cisco.com. The Cisco CallManager Express bundle comes in either a .tar file or a .zip file.
These files can then be extracted from the FTP or TFTP server.
Tip
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-129
The extracted
cme-123-11XL.zip
file yields:
GUI Files
cme-gui-123-11XL.tar
Cisco TAPI file
CiscoIOSTSP1.3.zip
Firmware files
cmterm7920.4.0-01-08.bin
cmterm7936.3-3-5-0.bin
P00303020214.bin
P00403020214.bin
P00503010100.bin
S00103020002.bin
CP7902040000SCCP40701A.sbin
CP7905040000SCCP40701A.sbin
CP7912040000SCCP40701A.sbin
P00305000301.sbn
ATA030100SCCP040211A.zup
CP7050101SCCP030530B31.zup
B-ACD application
cme-b-acd-2.0.0.0.tar
Cisco TAPI file
CiscoIOSTSP1.3.zip
Music on Hold
music-on-hold.au
IPTX v2.02-4
The Cisco CallManager Express bundle contains all of the files that are needed to install and
configure Cisco CallManager Express. The files that are contained in the bundle are listed
in the figure.
The cme-123-11XL.zip file contains all the files needed to run the GUI web interface for
Cisco CallManager Express. These files are also needed for the GUI of Cisco Unity Express (CUE).
The music-on-hold.au file can be used to provide MOH from a file in flash memory. This can
be replaced with a custom .wav or .au file if desired.
2-130 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.02-5
These files are specific to Cisco CallManager Express version 3.2.1, and they are not
backward compatible.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-131
GUI Files
This topic identifies Cisco CallManager Express GUI files to enable web access.
GUI Files
IPTX v2.02-6
One of the individual files that can be downloaded is the .tar file that contains the GUI
web interface for Cisco CallManager Express. The CUE module GUI is also dependent on
the Cisco CallManager Express GUI.
2-132 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
xml.template
GUI files
The extracted
cme-gui-123-11XL.tar
yields:
admin_user.html
admin_user.js
CiscoLogo.gif
Delete.gif
dom.js
downarrow.gif
ephone_admin.html
logohome.gif
normal_user.html
normal_user.js
Plus.gif
sxiconad.gif
Tab.gif
telephony_service.html
uparrow.gif
xml-test.htm
IPTX v2.02-7
The contents of the GUI web interface .tar file are shown in this figure. These files need to be
present in the flash memory of the Cisco CallManager Express router.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-133
CiscoIOSTspLite1.3.exe
Readme.txt
TAPI Lite
Allows third-party software to control an IP
telephony device
Is installed on Windows PC
IPTX v2.02-8
To allow a third-party piece of software to interact with the Cisco CallManager Express system
through TAPI Lite, the files in the Cisco IOS TSP file must be installed on the same
Windows PC where the software is installed.
The content of the IOS TSP file are shown above. Run the CiscoIOSTspLite1.3.exe on the
Windows PC where the TAPI integration is being performed. This file is specific to Cisco
CallManager Express version 3.2.1 and must be upgraded on the PC when Cisco CallManager
Express is upgraded.
Note
This file does not need to reside in flash memory; it will be extracted and installed on a
Windows PC.
2-134 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Additional Files
Additional Files
music-on-hold.au
xml.template
IPTX v2.02-9
Other files that may be of interest include the file needed for MOH. This file must reside in
flash memory on the Cisco CallManager Express router and must be called music-on-hold.au.
The file, which came in the bundle or was downloaded individually, contains an audio file that
is used when a caller is placed on hold. This file can be customized.
A sample file for creating a customer administrator with a limited subset of administrative
privileges is included in the bundle or can be downloaded in an individual file that contains the
basic files. This file, xml.template, can be customized and stored in flash memory for use.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-135
Summary
Summary
Files are moved to flash memory on the Cisco
CallManager Express router using the copy
command.
Files can be downloaded individually or bundled.
The files may be compressed and may have to be
extracted.
Files that are downloaded include the basic files
for Cisco CallManagerExpress, GUI web interface,
TAPI integration, Music on Hold, and the
xml.template file.
2-136 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.02-10
Lesson 6
This lesson describes the three ways to create an initial IP Phone setup. It also discusses
optional parameters, the commands for rebooting IP Phones, setup troubleshooting, and the
steps for verifying the Cisco CallManager Express Phone configuration.
Objectives
Upon completing this lesson, you will be able to configure initial IP Phone setup and verify
Cisco CallManager Express configurations. This includes being able to meet these objectives:
Describe the three ways to create an IP Phone setup in a Cisco CallManager Express system
Perform a manual setup using the router CLI
Perform a partially automated setup using the router CLI
Perform an automated setup using the Cisco CallManager Express setup tool
Identify optional IP Phone parameters
Discuss two ways to reboot IP Phones
Describe troubleshooting tips
Describe the steps to verify Cisco CallManager Express configuration
This topic describes the three ways to create an initial IP Phone setup in a Cisco CallManager
Express system.
IPTX v2.02-2
There are three ways to set up IP Phones in Cisco CallManager Express. You can set up Phones
manually; you can use a combination of manual setup and automated setup, referred to as
partially automated; or you can use the fully automated setup.
2-138 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
This topic describes how to perform a manual Phone setup in a Cisco CallManager Express
system using the router command-line interface (CLI).
IPTX v2.02-3
The manual setup of the Cisco CallManager Express system involves using CLI. This type of
setup allows the administrator to leverage existing knowledge of Cisco IOS software and to
implement Cisco CallManager Express functions. The configuration can be viewed, backed up,
and restored through a simple text file. Manual setup can save time and effort when used for
multiple site deployments because it allows only the differences to be changed on a per-site
basis.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-139
Commands Overview
Commands that are needed to configure a basic
telephony service are as follows:
tftp-server flash:filename
telephony-service
max-ephones max-ephones
max-dn max-directory-numbers
load phone-type firmware-file
ip source-address ip-address [port port]
create cnf-files
keepalive seconds
dialplan-pattern tag pattern extension-length length extensionpattern pattern
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.02-4
The following commands must be configured in order to deploy a Cisco CallManager Express
system.
tftp-server flash:filename
telephony-service
max-ephones max-ephones
max-dn max-directory-numbers
load phone-type firmware-file
ip source-address ip-address [port port]
create cnf-files
keepalive seconds
dialplan-pattern tag pattern extension-length length extension-pattern pattern
In the addition to these commands, ephones and ephone-dns must be manually configured.
2-140 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
tftp-server Command
- -
through TFTP
- -
- -
- -
IPTX v2.02-5
The command tftp-server flash:filename allows the specified file that resides in flash memory
to be downloaded via TFTP. In Cisco CallManager Express, the firmware files need to be
configured so that they are available through TFTP. The figure shows firmware for the
7910G+SW, 7920, 7940G, and 7960G IP Phones.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-141
IPTX v2.02-6
The telephony-service command enters the telephony-service mode, from which much of the
configuration for the Cisco CallManager Express system is entered. The first two commands
that you should enter are max-ephones and max-dn. Both of these commands are set to 0,
which has the effect of not allowing any ephones or ephone-dns to be configured.
The number of ephones and ephone-dns is version and platform-specific. The number displayed
in IOS software Help is not always accurate and may reflect an artificially high number.
Consult the information provided with the Cisco CallManager Express router or on the
Cisco.com web site.
Example
This is an example of the IOS software Help that may be displaying maximums higher than
what the platform can handle.
- -
-
- -
2-142 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Firmware Association
-
7920
7920
Firmware
7910
Firmware
7910G+SW
IPTX v2.02-7
To associate a type of Cisco IP Phone with a Phone firmware file, use the load model
firmware-file command in telephony-service configuration mode. The following shows the
supported Phone models for which firmware can be loaded.
Note
No suffix should be used when using the load command for the 7910G+SW, 7940G, and
7960G models of IP Phones.
7902 Selects the firmware load file for the 7902G Phone
7905 Selects the firmware load file for the 7905G Phone
7910 Selects the IP Phone firmware load file for the 7910G+SW Phone
7912 Selects the firmware load file for the 7912G Phone
7914 Selects the IP Phone firmware load file for the 7914 Expansion Module
7920 Selects the firmware load file for the 7920 Phone
7935 Selects the IP Phone firmware load file for Conference Station 7935
7936 Selects the firmware load file for Conference Station 7936
7960-7940 Selects the IP Phone firmware load file for the 7960G and 7940G Phones
ATA Selects the firmware load file for Analog Telephone Adaptor (ATA) 186
and ATA 188
To see a list of Phone models supported by your router enter the following:
CMERouter1(config-telephony)#load?
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-143
--- --
XML
10.90.0.1
-
---
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.02-8
The Cisco CallManager Express system expects to receive Skinny Client Control Protocol
(SCCP) messages from the IP Phones concerning registrations and call control. The command
ip source-address ip-address [port port] is used to configure the local IP address and the TCP
port from which the Cisco CallManager Express system expects these messages. The port by
default is set to 2000; although this can be changed, it is unusual to do so.
Example
This is an example of the XMLDefault.cnf.xml file. Note the IP address, port, and firmware files.
-
----
2-144 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-145
SEP000F2473AB14.cnf.xml
XML
000F.2473.AB14
10.90.0.1
-
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.02-9
Use the create cnf-files command in telephony-service configuration mode to build the XML
configuration files that the IP Phones require and that are used with Cisco CallManager Express.
When this command is entered, the file XMLDefault.cnf.xml is generated with the appropriate
settings, including the firmware defined by theload command, the IP address that the new
IP Phones will be registered with, and the TCP port the SCCP messages will arrive on.
Example
This is an example of SEP000F2473AB14.cnf.xml. Note the IP address, port, locale
information, and required firmware.
-
----
2-146 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
- -
-
--
-
-
---
--
Keepalive
-
--
IPTX v2.02-10
To set the length of the time interval between successive keepalive messages from the Cisco
CallManager Express router to IP Phones, use the keepalive command in telephony-service
configuration mode. The default setting for the keepalives is 30 seconds. If the router fails to
receive three successive keepalive messages, it considers the Phone to be out of service until
the Phone reregisters.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-147
-
-
PSTN
ISDN PRI
DID numbers
assigned:
2015559000
through
2015559099
Extension
10XX
Extension
1099
-
- -
IPTX v2.02-11
Directory numbers for the Cisco IP Phones are entered in extension-number format. The
dialplan-pattern command creates a global prefix that can be used to expand the abbreviated
extension numbers into fully qualified E.164 numbers. The dial-plan pattern is also required for
registering Cisco IP Phone lines with a gatekeeper. The dialplan-pattern command can
transform an incoming call that has a full E.164 number to a Cisco IP Phone extension number.
The extension-length keyword enables the system to convert a full E.164 telephone number
back into an extension number for the purposes of caller ID display and received-call and
missed-call lists. For example, a company uses the extension number range 100 to 199 across
several sites and the extensions from 1000 to 1099 are present only on the local router. An
incoming call from 1044 arrives from the companys internal Voice over IP (VoIP) H.323
networkthe calling number for this call is displayed as 4085551044 in its full E.164 format.
By default, the numbers matching the dialplan-pattern command will be registered to an
H.323 gatekeeper if a gatekeeper is configured. Use of the no-reg keyword changes this default
behavior and prevents the numbers that match the pattern from registering with the gatekeeper.
When the called number matches the dial-plan pattern, the call is considered a local call and has
a distinctive ring that identifies the call as internal. Any call that does not match the dial-plan
pattern is considered an external call and has a ring that is different from the internal ring.
The valid dial-plan pattern with the lowest dial-plan tag number is used as a prefix to all local
Cisco IP Phones.
The number of extension-pattern characters must match the extension length that is specified in
the dialplan-pattern command.
Note
2-148 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Example
-
-
--
IPTX v2.02-12
This figure shows the configuration for a basic Cisco CallManager Express system.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-149
IPTX v2.02-13
In a partially automated setup, you dont have to configure ephones. The ephones can be
detected automatically and assigned an ephone-dn from a range of configured ephone-dns (all
ephone-dns must be the same type). This partially automated setup allows for the deployment
of many Phones without the work of configuring every Phone manually. This automatic
assignment is done through the use of the auto assign command.
2-150 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
-- - -
--
IPTX v2.02-14
To automatically assign ephone-dn tags to Cisco IP Phones as they register for service with
the Cisco CallManager Express router, use the auto assign command in telephony-service
configuration mode.
This command lets you assign ranges of ephone-dn tags according to the physical Phone type.
Multiple auto assign commands can be used to provide discontinuous ranges and to support
multiple types of IP Phones. Overlapping ephone-dn ranges may be assigned so that they map
to more than one type of Phone. If no type is specified, the values in the range are assigned to
Phones of any type, but if a specific range is assigned for a Phone type, the available ephone-dns
in that range are used first. The cfw keyword sets the call forward busy number and timeout
value on all Phones that automatically register.
The auto assign command cannot be used for the 7914 Expansion Module. Phones with one or
more expansion modules must be configured manually.
Automatically assigned ephone-dn tags must belong to normal ephone-dns and cannot belong
to paging ephone-dns, intercom ephone-dns, Music on Hold (MOH) ephone-dns, or Message
Waiting Indicator (MWI) ephone-dns. The ephone-dn tags that are automatically assigned must
have at least a primary number defined.
All the ephone-dns in a single automatic assignment set must be of the same kind (either
single-line or dual-line). Automatic assignment cannot create shared lines.
If there is not a sufficient number of available ephone-dns in the automatic assignment set,
some Phones will not receive ephone-dns.
Reversal of automatic assignment must be performed by manual CLI entry. This reversal
configuration must be followed by a reboot of the Phones that are assigned. If you use the
type keyword with this command, use the reset command to reboot the Phones. If you do not
use the type keyword with this command, use the restart command to perform a quick reboot.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-151
Note
Care should be taken when using the auto assign command because this command grants
telephony service to any IP Phone that attempts to register. If you use the auto assign
command option, make sure that your network is secure from unauthorized access by
unknown IP Phones.
2-152 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
-
--
--
--
--
IPTX v2.02-15
In this example, there are four auto assign commands with a different ephone-dn assigned
to each. Any 7920 IP Phone is assigned the lowest unassigned ephone-dn from 1 through 10.
Any 7940G IP Phone is assigned the lowest unassigned ephone-dn from 11 through 20. Any
7960G IP Phone is assigned the lowest unassigned ephone-dn from 21 through 40. And finally,
any 7920, 7940G, and 7960G IP Phone is assigned an ephone-dn from the generic range of
41 through 50 if it cannot be assigned an ephone-dn in its assigned range. This generic range,
which is not tied to any type, is also used for any other unspecified models of IP Phones.
Note
When all desired IP Phones have been automatically assigned, be sure to save the
configuration.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-153
This topic describes how to use the setup utility to perform an automated IP Phone setup in a
Cisco CallManager Express system.
IPTX v2.02-16
Automated setup is designed for the administrator who does not have a lot of experience
with Cisco IOS software and who may not feel comfortable manually configuring the
Cisco CallManager Express system. A question-and-answer interface starts the processthe
administrator only has to provide appropriate answers to the questions.
Note
Any existing configuration of the telephony service in Cisco CallManager Express must be
removed prior to starting the setup.
2-154 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
CMERouter1(config)#telephony-service setup
---Cisco IOS Telephony Services Setup --Do you want to setup DHCP service for your IP Phones? [yes/no]: y
Configuring DHCP Pool for Cisco IOS Telephony Services :
IP network for telephony-service DHCP Pool:10.90.0.0
Subnet mask for DHCP network :255.255.255.0
TFTP Server IP address (Option 150) :10.90.0.1
Default Router for DHCP Pool :10.90.0.1
Do you want to start telephony-service setup? [yes/no]: y
Configuring Cisco IOS Telephony Services :
Enter the IP source address for Cisco IOS Telephony Services :10.90.0.1
Enter the Skinny Port for Cisco IOS Telephony Services : [2000]:2000
How many IP phones do you want to configure : [0]: 10
Do you want dual-line extensions assigned to phones? [yes/no]: y
What Language do you want on IP phones :
0 English6 Dutch
1 French7 Norwegian
2 German8 Portuguese
3 Russian9 Danish
4 Spanish10 Swedish
5 Italian
[0]: 0
IPTX v2.02-17
The Cisco CallManager Express setup utility provides a question-and-answer interface that
allows you to set up an entire Cisco CallManager Express system at one time. Use the
telephony-service setup command to start the Cisco CallManager Express setup utility. If you
do not use the setup keyword, you can set up Phones one at a time using router CLI. The setup
keyword is not stored in the router NVRAM.
Note
If you attempt to use the automated setup option for a system whose telephony-service
configuration is not empty, an error message advises you to remove the existing
configuration first by using the no telephony-service command.
Prior to running the automated setup utility, configure the Cisco CallManager Express router
with Network Time Protocol (NTP) and load the appropriate firmware files into flash memory
on the Cisco CallManager Express router.
The actual configuration is created only when the entire question-and-answer dialog has been
completed. You can interrupt the process by pressing CTRL-C at any point prior to the final
question without having any configuration occur.
The first question asked by the automated setup utility deals with DHCP and whether the Cisco
CallManager Express router will be providing this service. If you enter y, you must enter the
parameters of the DHCP scope when the setup utility prompts you to do so. Entering n will
skip the configuration of DHCP. The name of the scope that is automatically created if y is
answered is ITS.
Second, the automated setup configures the telephony service. The setup utility asks if the
telephony service should be started. If you select y, when prompted to do so, the IP address
and port that Cisco CallManager Express runs on will need to be entered. The IP address that
you enter should be the address on the LAN that is local to the IP Phones. This is the address
that the Phones register with. In most cases, the port should be left to the default port of 2000.
Selecting n will stop the configuration of Cisco CallManager Express.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-155
Third, the number of Phones to be configured must be selected. Select no more than the
licensed amount. If less than the licensed amount is selected, more ephones can be manually
added later.
Fourth, you are asked if dual lines are desired. If you select y, the Phones are configured like
PBX phones; if you select n, the Phones are configured similar to a keyswitch phone.
The fifth question deals with the language of the Phones and configures the locale that will be
displayed on the IP Phone. This includes configuration of the SCCP-dictionary.xml and
phonemodel-dictionary.xml files.
2-156 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.02-18
The next part of the automated setup configures the call progress tones on the IP Phones. The
call progress tones are the sounds a caller hears. These include the dial tone, busy signal,
ringback, and reorder signal. These call progress tones vary from country to country and should
be set according to what the users are accustomed to hearing.
To continue the automated setup, enter the first of the directory numbers that will be assigned.
The directory numbers are assigned in sequential order.
If direct inward dial (DID) needs to be set up, enter yes when prompted. DID numbers are
used when the connection to the public switched telephone network (PSTN) is able to pass the
dialed number. In order for this to happen, the connection should be the ISDN. If the
connections are Foreign Exchange Office (FXO), then a private line, automatic ringdown
(PLAR) on the analog trunk must be set up instead. This configuration must be done
manually it is not included in the automated setup. Setting up DID can be very simple,
especially if there is a relationship between the PSTN number and the internal directory number
(for example, if 209 555-9009 maps to 1009). If there is no common relationship between the
PSTN number and the internal directory number, then manual setup is required (for example, if
209 555-9009 maps to 7691).
The next question asks if calls should be forwarded to a voice message service. Assuming that
there is a voice mail system, the pilot point number must be entered. This sets forward no
answer and forward busy to the pilot point number for all Phones created. The timeout value
for forward no answer also needs to be set; 18 seconds is the default. This value is in seconds
rather than number of rings because the different ring lengths can vary by as much as 2 seconds.
The final question in the setup utility asks if any of the information that was entered needs to be
changed. If you enter y, the setup starts over. If you enter n, the changes are committed to
the running-config.
One more step is required because the configuration is not saved automatically at the end of the
automated setup. Use the copy running-config startup-config command to save your setup
configuration.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-157
- -
- -
-
-
---
--
- -
-
-
-
IPTX v2.02-19
This figure shows the results of an automated setup. Note that the automated setup assumes that
there is only one ephone-dn per ephone.
Note
ITS was the original name of Cisco CallManager Express and still appears in some
configurations.
2-158 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Optional Parameters
Locale Parameters
Language of Phone
display
Locale for call
progress tones and
cadences
Danish
Italian
Spanish
Swedish
Dutch
Norwegian
French
Portuguese
English
German
Russian
Japanese
IPTX v2.02-20
The Cisco CallManager Express system can be customized to some degree with the local
language on the IP Phone, call progress indicators, and cadence. This customization allows
users to hear and interact with the system using the language and audible cues that are familiar
to them.
The format in which the Phone displays the date and time can be modified to the format that is
typical for the location of the installation.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-159
IPTX v2.02-21
On the Cisco IP Phone 7940G and the Cisco IP Phone 7960G, the language that is displayed
and the call progress tones and cadences can be set to one of several ISO-3166 codes that
indicate specific languages and geographic regions.
Note
The 7920 IP Phone supports English, French, German, and Spanish, and this setting is
made on the handset. The user-locale and network-locale commands have no effect on
the 7920 IP Phone.
To see which language codes are supported by the user-locale command on your device, enter
the following command:
CMERouter(config-telephony)#user-locale ?
The following is a list of typical language codes supported:
DE Germany
DK Denmark
ES Spain
FR France
IT Italy
NL Netherlands
NO Norway
PT Portugal
RU Russian Federation
SE Sweden
2-160 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
US United States
JA Japan
To see which language codes are supported by the network-locale command on your device,
enter the following command:
CMERouter(config-telephony)#network-locale ?
The following is a list of typical language codes supported:
AT Austria
CA Canada
CH Switzerland
DE Germany
DK Denmark
ES Spain
FR France
GB United Kingdom
IT Italy
JA Japan
NL Netherlands
NO Norway
PT Portugal
RU Russian Federation
SE Sweden
US United States
Note
Changes to the language or call progress tones require that the Cisco IP Phone be reset.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-161
IPTX v2.02-22
On the Cisco IP Phone 7940G and the Cisco IP Phone 7960G, the date and time format can be
set on a systemwide basis for all IP Phones.
To see which date formats are supported on your device, enter the following command:
CMERouter(config-telephony)#date-format ?
The following is a list of typical date formats supported:
dd-mm-yy Sets date to dd-mm-yy format
mm-dd-yy Sets date to mm-dd-yy format
yy-dd-mm Sets date to yy-dd-mm format
yy-mm-dd Sets date to yy-mm-dd format
To see which time formats are supported on your device, enter the following command:
CMERouter(config-telephony)#time-format ?
The following is a list of typical time formats supported:
12 Sets time to 12-hour (a.m./p.m.) format
24 Sets time to 24-hour format
2-162 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
restart Command
Hard reboot
Soft reboot
IPTX v2.02-23
After you update information for one or more Phones associated with a Cisco CallManager
Express router, the Phone or Phones must be rebooted. There are two commands for rebooting:
reset and restart. The reset command performs a hard reboot that is similar to a power-off,
power-on sequence. It reboots the Phone and contacts the DHCP server and TFTP server to
update from their information as well. The restart command performs a soft reboot by simply
rebooting the Phone without contacting the DHCP and TFTP servers. The reset command takes
significantly longer to process than the restart command when you are updating multiple
Phones, but it must be used after updating firmware, user locale, network locale, or URL
parameters. For simple button, line, or speed dial changes, you can use the restart command.
Use the reset command in ephone configuration mode to perform a complete reboot of a single
IP Phone. This command has the same effect as a reset command in telephony-service mode
that is used to reset one Phone or all Phones.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-163
- --
-
IPTX v2.02-24
To perform a complete reboot of one or all Phones associated with a Cisco CallManager
Express router, use the reset command in telephony-service configuration mode.
When using the reset command from telephony-service mode, the default time interval
of 15 seconds is recommended for an eight- to ten-Phone office so that the Phones do not
attempt to access TFTP server resources simultaneously. This value should be increased
for larger networks.
When you use the reset sequence-all command, the router waits for one Phone to complete its
reset and reregister before starting to reset the next Phone. The delay provided by this
command prevents multiple Phones from attempting to access the TFTP server simultaneously
and therefore failing to reset properly. Each reset operation can take several minutes when you
use this command. There is a reset timeout of 4 minutes, after which the router stops waiting
for the currently registering Phone to complete registration and starts to reset the next Phone.
If the router configuration is changed so that the XML configuration files for the Phones
are modified (changes are made to user locale, network locale, or Phone firmware), then
whenever the reset all or restart all command is used, the router automatically executes
the reset sequence-all command instead. The reset sequence-all command resets the
Phones one at a time in order to prevent multiple Phones from trying to contact the TFTP
server simultaneously. This one-at-a-time sequencing can take a long time if there are many
Phones. To avoid this automatic behavior, use the reset all time-interval command or the
restart all time-interval command and set a time interval that is not equal to the 15-second
default time interval (for example, set a time interval of 14 seconds). If a reset sequence-all
command has been started in error, use the reset cancel command to interrupt and cancel the
sequence of resets.
To perform a complete reboot of a single Phone associated with a Cisco CallManager Express
router, use the reset command in ephone configuration mode.
2-164 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
- --
IPTX v2.02-25
The restart command causes the system to quickly perform a Phone reset in which only the
button template, lines, and speed dial numbers are updated. This command is much faster than
the reset command because the Phone does not access the DHCP or TFTP server. For updates
related to Phone firmware, user locale, network locale, or URL parameters, use the reset
command.
To restart a single Phone, use the restart command with the mac-address argument or use it in
ephone configuration mode.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-165
IPTX v2.02-26
With the automated setup, there are many places to check if problems are encountered. Some of
the more useful places to check and tools to use include the following:
Verify IP addressing: Use the Settings button to check the configuration on the IP Phone.
Verify the files in flash memory: Check and verify that the correct firmware files are
present in flash memory.
Debug the TFTP server: Make sure the firmware and XML files are being served
correctly.
Verify the Phones firmware installation: Use the debug ephone register command to
verify which firmware is being installed.
Verify locale is correct: Use the telephony-service tftp-bindings command to view the
files being served up by the TFTP server.
Verify phone setup: Use the show ephone command to view the status of the ephones and
whether they are registered correctly.
Review configuration: Use the show running-config command to verify the ephone-dn
configuration.
2-166 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Verifying IP Addressing
Use the Settings button and select Network
Configuration.
Verify that the IP address and subnet mask are
correct.
Verify that the TFTP server is the Cisco
CallManager Express router.
Verify that the default gateway is correct.
IPTX v2.02-27
To verify that the DHCP server is handing out the correct information to the IP Phones, use the
Settings button, then select Network Configuration. Scroll through the settings and verify the
IP address, subnet mask, default gateway, and location of the defined TFTP server. The TFTP
server must be the Cisco CallManager Express router.
- -
IPTX v2.02-28
The show flash command displays the contents of flash memory. The flash memory must
contain the firmware files that are necessary for the models of IP Phones that are deployed.
Many other files may be here as well, depending on other configurations.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-167
--
--
--
--
--- -
- ---
--- -
- ---
IPTX v2.02-30
The debug tftp events command enables the administrator to view output regarding files that
are served up by the TFTP server. The administrator can view files, including firmware, that
are specific to Cisco CallManager Express to see if out-of-date or unsupported files are being
used. The administrator can also view the XML files for configured IP Phones, the XML files
for new IP Phones, and locale files.
If the firmware ends with a .bin extension, then the file is unsigned. If the firmware ends with a
.sbin extension, then the file is signed. If the .sbin extension is used, the IP Phone permanently
requires signed firmware loads and cannot use unsigned firmware loads.
2-168 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.02-31
Verify the correct Phone firmware installation by setting registration debugging with
the debug ephone register command. Then reset the Phones and look at the Skinny
StationAlarmMessage displayed during Phone reregistration. The Load=parameter should
appear in the display, followed by an abbreviated version name that corresponds to the correct
firmware file name.
- - - ---
- --- -
- --- -
- ---
- ------ - --
- ----- - --
- ----- - --
- ----- - --
- ----- - --
- --- -
- --- -
IPTX v2.02-32
Use the show telephony-service tftp-bindings command to ensure that the locale-specific
files are correct.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-169
-
-
- --
-
-
- --
-
IPTX v2.02-33
Enter the show ephone command to verify the Cisco IP Phone setup after the Phones have
registered with the Cisco CallManager Express router.
2-170 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
--
IPTX v2.02-29
Use the show running-config command to verify the configuration. The primary area of
interest for Cisco CallManager Express functionality is the telephony-service section, the
TFTP configuration, the ephones, and the ephone-dns.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-171
Summary
Summary
Cisco CallManager Express requires firmware files
to be copied to the flash memory on the router and
shared using TFTP.
There are three ways to create a Phone setup in
Cisco CallManager Express: manual, partially
automated, and automated.
After changing the configuration of an IP Phone,
you must reboot the IP Phone for the changes to
take effect.
When troubleshooting, there are many show and
debug commands available.
2005 Cisco Systems, Inc. All rights reserved.
2-172 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.02-34
Module Summary
Module Summary
This module defines the Cisco CallManager Express platforms,
licensing, and supported Phone models.
The network configuration and services that are required by Cisco
CallManager Express include proper switch configuration, DHCP,
and NTP.
Transcoding resources need to be configured when a mismatch in
supported codecs is encountered.
This module describes the bootupand registration processes that
occur in the IP Phone when registering to Cisco CallManager Express.
The Cisco CallManager Express system can be configured in various
ways by using ephones and ephone-dns in different ways.
This module describes the files that are needed in order to install and
manage the Cisco CallManager Express system and the forms in which
the files can be downloaded.
The Cisco CallManagerExpress system can be deployed in three ways:
automated, partially automated, and manually.
2004 Cisco Systems, Inc. All rights reserved.
IPTX v2.02-1
References
For additional information, refer to the following resources:
Cisco Systems, Inc. Cisco CallManager Express data sheet.
http://cisco.com/en/US/products/ps5855/products_data_sheet0900aecd8016c267.html
Configuring DHCP.
http://www.cisco.com/univercd/cc/td/doc/product/software/ios122/122cgcr/fipr_c/ipcprt1/1
cfdhcp.htm#xtocid0.
Performing Basic System Management.
http://www.cisco.com/univercd/cc/td/doc/product/software/ios122/122cgcr/ffun_c/fcfprt3/f
cf012.htm#1001075.
Cisco CallManager Express 3.2: Setting Up a Cisco CallManager Express System .
http://cisco.com/en/US/partner/products/sw/iosswrel/ps5207/products_feature_guide_chapt
er09186a00802d253f.html.
Public Domain. NTP: The Network Time Protocol. http://ntp.org.
Cisco CallManager Express 3.2.1:Transcoding between G.729 and G.711.
http://cisco.com/en/US/partner/products/sw/iosswrel/ps5207/products_feature_guide_chapt
er09186a00802d255d.html
Cisco CallManager Express 3.2.1: Setting up Phones.
http://cisco.com/en/US/products/sw/iosswrel/ps5207/products_feature_guide_chapter09186
a00802b8f6a.html.
Cisco Systems, Inc. Voice Software Downloads.
http://www.cisco.com/kobayashi/sw-center/sw-voice.shtml.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-173
Module Self-Check
Use the questions here to review what you learned in this module. The correct answers and
solutions are found in the Module Self-Check Answer Key.
Q1) Which of the following are three key features of Cisco CallManager Express? (Choose
three.) (Source: Understanding Cisco CallManager Express Features and Functionality)
A) Built-in Auto Attendant with CUE
B) Interoperable with Cisco CallManager 3.3
C) Supports HTML applications on the IP Phones
D) Licensing can be upgraded to SRST
E) Reduces TCO by converging voice, video, and data onto a common network
F) GUI or CLI administration
Q2) CAC functionality is part of which Cisco CallManager Express
supported protocol?
(Source: Understanding Cisco CallManager Express Features and Functionality)
A) cRTP
B) H.323
C) SCCP
D) H.320
Q3) Which three Cisco IP Phones are supported by Cisco CallManager Express? (Choose
three.) (Source: Understanding Cisco CallManager Express Features and Functionality)
A) ATA 188
B) 7920
C) 7970G
D) 7960G
Q4) Which of the following is one of the recommendations that Cisco makes for IP
addressing deployment? (Source: Configuring Cisco CallManager Express Network
Parameters)
A) Statically apply IP addresses to IP Phones to ensure stability.
B) Apply public IP addresses to IP Phones so that they can be reached from
the PSTN.
C) Add IP Phones with DHCP as the mechanism for obtaining addressees.
D) Deploy IP Phones on the same subnet as data devices.
Q5) The most efficient way to get multiple VLANs to the router is: (Source: Configuring
Cisco CallManager Express Network Parameters)
A) by using a high-speed Layer 2 switch
B) by connecting a trunk directly between the IP Phone and the router
C) by using the configuration known as
router on a stick
D) not possible with VLANs connected to IP Phones
2-174 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Q6) Set up DHCP service for IP Phones by defining a DHCP relay server if: (Source:
Configuring Cisco CallManager Express Network Parameters)
A) the Cisco CallManager Express router is a DHCP server and you need different
settings on nonIP Phones on the same subnet
B) the Cisco CallManager Express router is a DHCP server and if you can use a
single shared address pool for all your DHCP clients
C) the Cisco CallManager Express router is not a DHCP server and you want to
relay DHCP requests from IP Phones to a DHCP server on a different subnet
D) none of the above
Q7) router(dhcp-config)#
host ip-address subnet-mask is a command that: (Source:
Configuring Cisco CallManager Express Network Parameters)
A) creates a scope of the entire subnet with the specified IP address in it
B) is followed by assigning a host with a specific MAC address defined by the
client-identifier MAC-address command
C) statically assigns an IP address to a host that would otherwise get it
dynamically
D) none of the above
Q8) A DHCP relay server needs to be implemented: (Source: Configuring Cisco
CallManager Express Network Parameters)
A) when the DHCP server does not have a local interface on the network with the
DHCP clients
B) because the DHCP request and response process is not broadcast
C) to relay the IP Phone
s proprietary DHCP request type to the standard DHCP
request type understood by the Cisco IOS software
D) when an IP Phone, a data device, and a DHCP server all reside on the same
subnet
Q9) NTP runs over: (Source: Configuring Cisco CallManager Express Network Parameters)
A) TCP port 123
B) UDP port 123
C) TCP port 213
D) UDP port 213
Q10) During registration, IP Phones download firmware files from the router flash memory
using: (Source: Understanding the IP Phone Registration Process)
A) HTTP
B) DHCP
C) FTP
D) TFTP
Q11) The use of the type command under the ephone phone-type is required to register for:
(Source: Understanding the IP Phone Registration Process)
A) the 7914 Expansion Module
B) all valid IP Phones other than the 7914 Expansion Module
C) all ATA devices other than the 7914 Expansion Module
D) no phones or devices because the ephone can determine any of them
automatically through the Cisco CallManager Express system
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-175
Q12) What is the first step in the process of an IP Phone s obtaining its XML configuration
file and IP address? (Source: Understanding the IP Phone Registration Process)
A) The switch applies power to the line.
B) The powered device has a physical link when there is no power between the
pin that the FLP arrives on and a pin that goes back to the switch. This creates
a circuit, and the end result is that the FLP arrives back at the switch. This
never happens when the device attached is not a powered device, like a PC. As
a result, if the FLP does not make it back to the switch, no power is applied.
C) The switch sends a special tone called an FLP out the interface, and this FLP
goes to the powered device, which in this case is an IP Phone.
D) The switch applies power to the line.
Q13) An ephone-dn is created by which command that builds one virtual voice port?
(Source: Defining Ephone-dn and Ephone)
A) router(config-ephone-dn)#
ephone-dn dn-tag
B) router(config-ephone-dn)#
number dn-number
C) router(config)#
ephone-dn dn-tag
D) router(config)#
ephone-dn dn-number
Q14) The first command to create or modify an ephone is: (Source: Defining Ephone-dn and
Ephone)
A) router(config-ephone)#
ephone phone-tag
B)
ephone phone-tag from ephone subconfiguration mode
C)
ephone phone-tag from global configuration mode
D) none of the above
Q15) Which of the following are types of ephone-dns that can be found in a Cisco
CallManager Express system? (Source: Defining Ephone-dn and Ephone)
A) single-line ephone-dn
B) primary and secondary extension on one ephone-dn
C) shared ephone-dn
D) multiple ephone-dns on one ephone
E) overlay ephone-dn
F) all of the above
Q16) Cisco CallManager Express firmware files that are copied to the flash memory on your
router are shared using which of the following two? (Choose two.) (Source: Describing
Cisco CallManager Express Files)
A) HTTP
B) TCP
C) FTP
D) TFTP
E) CDP
Q17) Which file bundle contains all the files that are needed to run the GUI web interface for
Cisco CallManager Express and Cisco Unity Express? (Source: Describing Cisco
CallManager Express Files)
A) CiscoIOSTSP.zip
B) cme-b-acd-2.0.0.0.tar
C) cme-gui-123-11XL.tar
D) xml.template
2-176 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Q18) Which file bundle contains all the files that are needed to allow a third-party piece of
software to interact with the Cisco CallManager Express system through TAPI Lite?
(Source: Describing Cisco CallManager Express Files)
A) CiscoIOSTSP.zip
B) cme-b-acd-2.0.0.0.tar
C) cme-gui-123-11XL.tar
D) xml.template
Q19) A sample file for creating a customer administrator with a limited subset of
administrative privileges is: (Source: Describing Cisco CallManager Express Files)
A) music-on-hold.au
B) cme-gui-123-11XL.tar
C) xml.template
D) none of the above
Q20) Before configuring the telephony service, the maximum number of ephone-dns and
ephones supported by the service is: (Source: Understanding Initial Phone Setup)
A) 0
B) 100
C) 288
D) unlimited
Q21) To perform an automated Phone setup in a Cisco CallManager Express system, use the
command: (Source: Understanding Initial Phone Setup)
A) router(config)#
telephony-service setup
B) router(config-telephony-service)#
telephony-service setup
C) router(config)#
auto assign start-dn to stop-dn
D) router(config-telephony-service)#
auto assign start-dn to stop-dn
Q22) Automatically assigned ephone-dn tags can belong to the following ephone-dns:
(Source: Understanding Initial Phone Setup)
A) paging ephone-dns
B) intercom ephone-dns
C) MOH ephone-dns
D) MWI ephone-dns
E) normal ephone-dns
Q23) On which phone is the language setting made on the handset rather than by using the
user-locale and network-locale IOS commands? (Source: Understanding Initial Phone
Setup)
A) Cisco IP Phone 7920
B) Cisco IP Phone 7940G
C) Cisco IP Phone 7960G
D) none of the above
Q24) The command to perform a hard reboot, similar to a power-off, power-on sequence, is:
(Source: Understanding Initial Phone Setup)
A)
restart
B)
reset
C) either
restart or reset
D) none of the above
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-177
Q25) To verify that the DHCP server is handing out the correct information to the IP Phones,
use the: (Source: Understanding Initial Phone Setup)
A)
show running-config command
B)
show flash command
C)
debug ephone register command
D) Settings button, then, from the menu that appears, select the Network
Configuration settings
Q26) To verify the Cisco CallManager Express configuration, use the: (Source:
Understanding Initial Phone Setup)
A)
show running-config command
B)
show flash command
C)
debug ephone register command
D) Settings button, then, from the menu that appears, select the Network
Configuration settings
2-178 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco CallManager Express 2-179
2-180 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Module 3
Cisco voice devices must support a wide variety of connection types. This module describes the
function and basic configuration of various analog and digital voice connections. Information
on how to fine-tune voice ports with port-specific configurations is presented. Dial peers and
class of restriction (COR) are discussed. The use of digit manipulation and special-purpose
connections is covered, along with Ciscos implementation of telephony supplementary
services.
Module Objectives
Upon completing this module, you will be able to configure analog voice interfaces, digital
voice interfaces, and dial peers to set up Voice over IP (VoIP) communications.
Describe the different types of analog and digital interfaces and signaling types supported
by Cisco CallManager Express
Configure analog and digital voice interfaces and discuss voice port applications, FXS,
FXO, E&M, BRI timers and timing, digital voice ports, CAS, and CCS/PRI
Describe dial peers and configuration tasks
Describe how call legs relate to inbound and outbound dial peers by defining all the steps in
the call setup process and the proper use of digit manipulation
Describe the application and configuration of class of restriction
Describe call transfer and forwarding using H.450.x series
3-2 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Lesson 1
Interfacing Cisco CallManager Express with traditional analog telephony devices requires an
understanding of the various interfaces used in the industry. When additional port density and
features are required, a digital connection can be used. This lesson describes the various analog
and digital interfaces that can be used with Cisco CallManager Express. It also explores analog
and digital signaling between Cisco CallManager Express and the central office (CO), as well
as the various forms of connection. The choice of digital connection can vary based upon
carrier, and not all services may be available in all areas.
Objectives
Upon completing this lesson, you will be able to identify and describe the different digital
interfaces and signaling types supported by Cisco CallManager Express. This includes being
able to meet these objectives:
Identify the components of local-loop connections
Describe FXS, FXO, and E&M interfaces
State the uses and types of CAS systems that are used for T1
State the uses and types of CAS systems that are used for E1
State the uses and types of common channel signaling systems
Describe what PRI and BRI are and how they can be used
Local-Loop Connections
This topic describes the parts of a traditional telephony local-loop connection between a
telephone subscriber and the telephone company.
Local-Loop Connections
IPTX v2.03-3
3-4 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
This topic defines the three analog interfaces that can be installed in a voice gateway: Foreign
Exchange Station (FXS), Foreign Exchange Office (FXO), and ear and mouth (E&M). It also
discusses how each of these interfaces is used.
FXS Interface
FXS
FXS
FXS
Connects directly to analog phones or faxes
Used to provision local service
Provides power, call progress tones, and dial tone
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.03-4
When analog phones or fax machines are used in an IP-based environment, they must 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 Cisco CallManager Express router cannot
be forwarded to Cisco Unity Express voice mail. If voice mail is needed on the analog
phones, use the Cisco 186 Analog Telephone Adaptor (ATA) or the Cisco 188 ATA to
connect the analog phone to the network.
Copyright 2005, Cisco Systems, Inc. Configuring PSTN Interfaces and Voice Dial Peers 3-5
FXO Interface
FXO
PSTN
FXO
IPTX v2.03-5
In order for standard analog connections from the CO to enter the IP network, they must be
terminated on an interface on a voice gateway. An FXO interface can be used for this. When a
call arrives, the FXO interface answers the call and either presents a second dial tone or is
configured with a private line, automatic ringdown (PLAR). For outbound calls, the FXO
interface provides either pulse digits or dual tone multifrequency (DTMF) digits for outbound
dialing.
3-6 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
E&M Interface
E&M
E&M
Tie-Line
E&M
MOH
IPTX v2.03-6
Special analog connections called tie-lines can be leased from the carrier. These are typically
used to tie together two or mores sites that have analog connections. This tie-line terminates in
an analog interface on the router so that 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; it 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 types. The router is usually the trunk-circuit side, and
the telephone company (telco), a CO, a channel bank, or a Cisco voice-enabled platform is the
signaling-unit side.
Note
Many Music on Hold services provide an analog E&M interface that can be used to connect
to the Cisco CallManager Express router.
Copyright 2005, Cisco Systems, Inc. Configuring PSTN Interfaces and Voice Dial Peers 3-7
This topic describes channel associated signaling (CAS) and its uses with T1 transmission.
IPTX v2.03-7
Because the signaling occurs within each DS0, it is referred to as in-band. And because the use
of these bits is reserved exclusively for signaling each respective voice channel, it is referred to
as CAS.
Super Frame (SF) has a 12-frame structure and provides A&B bit signaling. Extended
Superframe (ESF) has a 24-frame structure and provides ABCD signaling.
Tones, such as DTMF addressing or call progress, can be carried in the audio path. However,
other CAS signals must be carried via the robbed bits. These robbed bits are the least
significant bits in the audio channel.
3-8 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Characteristics of a CAS T1
CAS T1
PSTN
IPTX v2.03-8
Cisco CallManager Express can be connected to the public switched telephone network (PSTN)
through a CAS T1 connection. This provides up to 24 channels for voice. Each channel is a 64kbps DS0.
Copyright 2005, Cisco Systems, Inc. Configuring PSTN Interfaces and Voice Dial Peers 3-9
IPTX v2.03-9
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), whereas 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 time slot that are 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
3-10 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Characteristics of a CAS E1
CAS E1
PSTN
IPTX v2.03-10
Cisco CallManager Express can be connected to the PSTN and can provide up to 30 channels
for voice.
Copyright 2005, Cisco Systems, Inc. Configuring PSTN Interfaces and Voice Dial Peers 3-11
Common-Channel Signaling
IPTX v2.03-11
Whereas CAS uses bit time slots assigned to each specific channel, CCS uses a common
channel and protocol to set up calls for all the bearer channels. For example, when using ISDN
over E1, the signaling protocol Q.931 uses time slot 17 to exchange call-setup messages for any
of the 30 bearer (B) channels.
Examples of CCS are as follows:
Proprietary implementations: Some PBX vendors choose to implement a proprietary
CCS protocol between their PBXs for T1 and E1. In this implementation, Cisco devices are
configured for Transparent Common Channel Signaling (T-CCS) because they do not
understand proprietary signaling information and must simply transport the signaling,
without modification or interpretation.
ISDN: Uses Q.931 signaling protocol in a common channel to signal all other channels.
Digital Private Network Signaling System (DPNSS): An open standard developed by
British Telecom for implementation by any vendor who chooses to use it. DPNSS also uses
a common channel to signal all other channels.
Q Signaling (QSIG): Like ISDN, QSIG uses a common channel to signal all other
channels.
3-12 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
This topic describes PRI and BRI and how they can be used to support voice.
PRI 23B+D
Carrier
BRI 2B+D
IPTX v2.03-12
ISDN is one form of CCS. PRI and BRI are the two ways of implementing ISDN.
Note
Because ISDN is a digital service, the time required to set up a call is significantly less than
that of an analog call.
PRI supports 23 (for T1) or 30 (for E1) B channels, whereas BRI features two B channels. Each
implementation also supports a single data (D) channel that is used to carry signaling
information.
The following are characteristics of ISDN PRI and BRI:
ISDN channels can carry data, voice, or video.
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.
The D channel in BRI is 16 kbps and in PRI is 64 kbps.
ISDN has a built-in call-control protocol known as International Telecommunication Union
Telecommunication Standardization Sector (ITU-T) Q.931 that runs on the D channel.
ISDN can support standards-based voice features, such as call forwarding, and standardsbased enhanced dialup capabilities, such as Group IV fax and audio channels.
ISDN can carry vendor-specific PBX features.
ISDN BRI voice is commonly used in Europe; ISDN PRI voice is used worldwide.
Copyright 2005, Cisco Systems, Inc. Configuring PSTN Interfaces and Voice Dial Peers 3-13
Summary
Summary
Analog interfaces can be used to connect analog
devices and to connect to the PSTN.
Cisco CallManager Express can use T1 circuits to
convey voice.
Cisco CallManager Express can use E1 circuits to
convey voice.
Examples of CCS are proprietary implementations,
ISDN, DPNSS, and QSIG.
ISDN can be implemented in two different ways:
BRI and PRI.
3-14 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.03-13
Lesson 2
The connections to analog devicesthe PSTN and WAN links between sitesmay take either
an analog or a digital form. The analog interfaces that are commonly found include the FXS,
the FXO, and the E&M interfaces. The FXS is used to connect analog devices like phones and
fax machines. The FXO interfaces are typically used for traditional analog connections to the
PSTN. E&M analog connections are typically used for connections to the PSTN and may be
used for analog tie-line connections to another site or to connect a Music on Hold (MOH)
system.
The digital connections include both CAS and CCS digital connections. The CAS connection
has signaling in-band. This means that the voice and the signaling travel together on the same
circuit. CCS links use out-of-band signaling. The most common form of CCS is the ISDN
services. There are two main offerings in ISDN: BRI and PRI.
To connect to an ISDN network, you must use the correct router interface. BRI requires
specific commands to enable ISDN. ISDN BRI is typically used for remote access at small
branch sites with lower bandwidth requirements. PRI is typically used by larger central sites
with higher bandwidth requirements to aggregate multiple BRIs. Internet service providers also
use ISDN PRI to support large numbers of plain old telephone service (POTS) (analog modem)
and ISDN BRI calls.
Objectives
Upon completing this lesson, you will be able to configure analog and digital voice interfaces.
This discussion includes voice port applications, FXS, FXO, E&M, BRI timers and timing,
digital voice ports, CAS, CCS: BRI, and CCS: PRI. This includes being able to meet these
objectives:
Set the configuration parameters for FXS voice ports
Set the configuration parameters for FXO voice ports
Set the configuration parameters for E&M voice ports
Set timers and timing requirements on ports to adjust the time allowed for specific
functions
Set the configuration parameters for digital voice ports
Set the configuration parameters for CAS voice ports
Set the configuration for BRI voice ports
Set the configuration parameters for PRI voice ports
3-16 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
FXS ports connect analog edge devices. This topic identifies the parameters that are
configurable on the FXS port.
signal
cptone
description
ring frequency
ring cadence
disconnect-ack
busyout
station id name
station id number
IPTX v2.03-3
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.
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. And when the telephone rings to signal an incoming call, the ring in the United States
is different from the ring in England. 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.
Copyright 2005, Cisco Systems, Inc. Configuring PSTN Interfaces and Voice Dial Peers 3-17
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
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 can 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-specific. 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.
busyout: Configures the ability to busy out an analog port.
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. When it is provided, it is used as
the calling number if the call is originated from this voice port. If not specified, the calling
number is used from a reverse dial-peer search. If no caller ID is received on an FXO voice
port, this parameter is used as the calling number. Maximum string length is 15.
3-18 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
FXS Port
1/0/1
- -
- -
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.03-4
Example
Revisit the scenario of an international company with offices in the United States and England.
The figure 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
England and the ring cadence is set for pattern 1.
Copyright 2005, Cisco Systems, Inc. Configuring PSTN Interfaces and Voice Dial Peers 3-19
FXO ports act like telephones and connect to CO switches or to a station port on a PBX. This
topic identifies the configuration parameters that are specific to FXO ports.
IPTX v2.03-5
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 when
default settings need to be altered or parameters set for fine-tuning. You can set the following
configuration parameters:
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 other equipment 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 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.
3-20 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
PSTN
- -
-
IPTX v2.03-6
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. The dial type is set to DTMF.
Copyright 2005, Cisco Systems, Inc. Configuring PSTN Interfaces and Voice Dial Peers 3-21
E&M ports provide signaling that is generally used for switch-to-switch or switch-to-network
trunk connections. This topic identifies the configuration parameters that are specific to the
E&M port.
IPTX v2.03-7
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:
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, 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
duration of the digit sending, 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, 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 match the settings of the device on the other end of the line. You
must then shut down and reactivate the voice port for the new value to take effect.
3-22 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
type: Configures the E&M interface type for a specific voice port. The type defines the
electrical characteristics for the E-lead and the M-lead. The E-lead and the M-lead are
monitored for on-hook 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 Mlead 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.
MOH
-
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.03-8
Example
The configuration in the figure enables immediate signaling with automatic cut-through for an
E&M connection to an MOH device. This allows an external device to provide music on hold
to the Cisco 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.
Copyright 2005, Cisco Systems, Inc. Configuring PSTN Interfaces and Voice Dial Peers 3-23
This topic identifies the timing requirements and adjustments that are applicable to voice
interfaces. Under normal use, these timers do not need adjusting. When ports are connected to a
device that does not properly respond to dialed digits or hookflash or when the connected
device provides automated dialing, these timers can be configured to allow more or less time
for a specific function.
IPTX v2.03-9
Configuration Parameters
You can set a number of timers and timing parameters to fine-tune 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 that the system waits for the next
digit after the caller has input the initial digit. 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.
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 a shorter or longer DTMF duration.
3-24 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
timing interdigit: Configures the DTMF interdigit duration for a specified voice port. You
can change this setting to accommodate faster or slower dialing characteristics.
timing hookflash-in and hookflash-out: Configures the maximum duration (in
milliseconds) of a hookflash indication. Hookflash is an indication by a caller that the caller
wishes to do something specific with the call, such as transfer the call or place the call on
hold. For hookflash-in, the FXS interface processes the indication as on hook if the
hookflash lasts longer than the specified limit. If you set the value too low, the hookflash
may be interpreted as a hang-up. If you set the value too high, the handset has to be left
hung up for a longer period to clear the call. For hookflash-out, the setting specifies the
duration (in milliseconds) of the hookflash indication that the gateway generates outbound.
You can configure this to match the requirements of the connected device.
- -
-
-
-
-
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.03-10
Example
The installation in the figure is for a facility for elderly residents. Users in such a facility may
need more time to dial digits than is typical. They may also want 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.
Copyright 2005, Cisco Systems, Inc. Configuring PSTN Interfaces and Voice Dial Peers 3-25
This topic identifies the configuration parameters that are specific to T1 and E1 digital
voice ports.
IPTX v2.03-11
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: alternate mark inversion (AMI) or binary 8-zero substitution
(B8ZS)
Default: line
3-26 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.03-12
Use the linecode command to identify the physical layer signaling method to satisfy the 1s
density requirement on the digital facility of the provider. Without a sufficient number of 1s in
the digital bit stream, the switches and multiplexers in a WAN can lose their synchronization
for transmitting signals. The table shows the linecode command.
linecode Command
Command
Description
ami
b8zs
hdb3
B8ZS accommodates the 1s 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 CO switch of the provider.
T1 configurations typically require the framing esf command and the linecode b8zs command.
E1 configurations typically require the linecode hdb3 command.
Copyright 2005, Cisco Systems, Inc. Configuring PSTN Interfaces and Voice Dial Peers 3-27
- -
IPTX v2.03-13
Use the framing command to select the frame type used by the PRI service provider. The table
shows framing controller configuration commands that you can use.
framing Command
Command
Description
sf
esf
crc4 or no-crc4
Note
3-28 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
- - -- --
-
- -
- - -- -
-
IPTX v2.03-14
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 time slots 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 (numbered 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 time slots 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.
Copyright 2005, Cisco Systems, Inc. Configuring PSTN Interfaces and Voice Dial Peers 3-29
PSTN
-
- -- -
-
- -- -
-
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.03-15
This example configures the T1 controller for ESF, B8ZS line code, and time slots 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 a line code of HDB3, framing of CRC4, and time slots of 1 through
15 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 the
configuration.
3-30 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
This topic identifies the most common components and reference points of ISDN BRI, and it
provides an overview of configuration commands required to successfully configure an ISDN
BRI connection, including an overview of the isdn spid command. And finally, because you
may have to configure the Layer 2 B channel encapsulation protocol and authentication when
configuring ISDN BRI, this topic shows you how to do that.
IPTX v2.03-16
There are many 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 (NT-1) 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
network terminal [NT] and the terminal endpoint [TE]).
Caution should be taken when connecting ISDN devices, since RJ-11 and RJ-45 connectors
look similar.
The S/T reference point is:
Four-wire interface
Point-to-point and multipoint (passive bus), as shown in the figure
Covered by ITU-T I.430 physical layer specification for BRI interface, and American
National Standards Institute (ANSI) T1.601 standard for the United States
The S/T interface defines the interface between a TE1 or a terminal adapter and a network
terminal. A maximum of eight devices can be daisy-chained to the S/T bus.
Copyright 2005, Cisco Systems, Inc. Configuring PSTN Interfaces and Voice Dial Peers 3-31
The U interface defines the two-wire interface between the NT-1 and the ISDN cloud. The U
interface is used in the United States; the rest of the world uses an S/T interface.
The R interface defines the interface between the terminal adapter and an attached non-ISDN
device (TE2).
In North America, the NT-1 function is commonly integrated into the ISDN device (router,
terminal adapter), thus permitting a direct connection from the ISDN device to the telco jack.
An NT-1 and NT-2 combination device is sometimes referred to as an NTU. In most countries,
the NT-1/NT-2 combination is provided by the service provider (telco), and customer access is
only available at the S/T interface.
3-32 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
PSTN
IPTX v2.03-17
To configure an ISDN BRI interface on a router, global and interface configuration commands
must be specified.
Global configuration tasks include:
Select the switch type that matches the ISDN provider switch at the CO.
Set destination details. Indicate static routes from the router to other ISDN
destinations.
Specify the traffic criteria that initiate an ISDN call to the appropriate destination.
Interface configuration tasks include the following:
Select the ISDN BRI port and configure an IP address and subnet mask.
Although the interface automatically inherits the global switch-type setting, some
configurations may require a specific switch type to be configured on an interface.
Configure optional features, including length of time for the ISDN carrier to wait
before responding to the call and seconds of idle time before the router times out and
drops the call.
Copyright 2005, Cisco Systems, Inc. Configuring PSTN Interfaces and Voice Dial Peers 3-33
- - -
- - -
IPTX v2.03-18
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 ISDN-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.
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
terminal adapter via a serial interface. On a TE2 router, the interface serial interface-number
command must be used.
3-34 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
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
this table.
isdn switch-type Commands
Command
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
software 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.
Copyright 2005, Cisco Systems, Inc. Configuring PSTN Interfaces and Voice Dial Peers 3-35
- - -
- - -
IPTX v2.03-19
Several ISDN service providers use CO switches that require SPIDs. 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 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 table shows the isdn spid1 command syntax for the first BRI 64-kbps channel.
isdn spid1 and isdn spid2 Commands
Commands
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
for both B channels to be used on most switches.
3-36 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
PSTN
- - --
- -
- -
Copyright 2005, Cisco Systems, Inc. Configuring PSTN Interfaces and Voice Dial Peers 3-37
IPTX v2.03-20
This topic identifies the most common components and reference points of ISDN PRI. It also
shows how to use global and interface configuration commands to configure ISDN PRI and
provides an overview of the isdn switch-type command. In addition, the topic lists and
explains the commands required to configure the ISDN PRI channels and D channel.
IPTX v2.03-21
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 technology. The wiring is not multipoint, which 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. But because
there are no multiple devices in PRI, it does not require this arbitration. There is only the
straight connection between the channel service unit/data service unit (CSU/DSU) and the PRI
interface.
3-38 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
- - -
- - -
Use the isdn switch-type command to specify the CO 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 this table.
isdn switch-type Command
Command
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 SPIDs. Therefore, there is no requirement to
configure SPIDs, regardless of the ISDN switch type used by the PRI.
Copyright 2005, Cisco Systems, Inc. Configuring PSTN Interfaces and Voice Dial Peers 3-39
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
Command
Description
t1
e1
slot/port or unit-number Specifies the physical slot/port location or unit number of the
controller
--
- --
IPTX v2.03-23
The pri-group command configures the specified interface for PRI operation and specifies
which fixed time slots (channels) are allocated on the digital facility of the provider.
pri-group Command
Command
Description
timeslots range
The range of time slots allocated to this PRI. For T1, use
values in the range of 1 to 24, and for E1, use values
from 1 to 31. The speed of the PRI is the aggregate of
the channels assigned.
Note
When provisioning a PRI line with less than 24 time slots (or 30 for E1), include the D
channel for signaling.
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
Copyright 2005, Cisco Systems, Inc. Configuring PSTN Interfaces and Voice Dial Peers 3-41
PSTN
- -
--
-
-
-
IPTX v2.03-24
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
that is selected is the national ISDN standard. This example is accurate for some operations in
the United States.
For an E1 example, the time slot 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.
3-42 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Summary
Summary
Configurable parameters on FXS ports include signal,
cptone, description, ring frequency, ring cadence,
disconnect-ack, busyout, station id name, and station id
number.
Configurable parameters on FXO ports include signal, ring
number, dial-type, description, and supervisory disconnect.
Configurable parameters on E&M ports include signal,
operation, type, auto-cut-through, and description.
Configurable timer and timing parameters define initial digit
and interdigit timing, digit and interdigit duration, as well as
ringing time.
Digital voice ports are created with the ds0-group command in
the T1/E1 controller.
IPTX v2.03-25
Summary (Cont.)
ISDN can be implemented in two different ways: BRI and PRI.
In most countries, customer access to BRI is available at the S/T
interface.
Enabling ISDN BRI requires global configuration and interface
configuration commands.
Some ISDN switches require the configuration of SPID numbers.
A T1 controller configuration must include the framing type and line
coding.
ISDN PRI configuration requires that the pri-group command specify
the time slots that are used for voice and signaling.
ISDN PRI does not require SPIDs.
The ISDN PRI D channel and B channel are configured separately
from the controller using the interface serialcommand.
ISDN PRI requires that a T1 (or E1) controller be configured.
2005 Cisco Systems, Inc. All rights reserved.
Copyright 2005, Cisco Systems, Inc. Configuring PSTN Interfaces and Voice Dial Peers 3-43
IPTX v2.03-26
3-44 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Lesson 3
This lesson describes voice dial peers, digit manipulation, the matching of calls to dial peers,
and COR.
Objectives
Upon completing this lesson, you will be able to describe dial peers and configuration tasks.
This includes being able to meet these objectives:
Describe dial peers and their application
Configure plain old telephone service dial peers
Configure VoIP dial peers
Describe destination-pattern options and the applicable shortcuts
Describe the default dial peer
IPTX v2.03-3
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 it will need to receive preferential treatment by specifying a higher priority level.
3-46 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Copyright 2005, Cisco Systems, Inc. Configuring PSTN Interfaces and Voice Dial Peers 3-47
Dial Peer
IPTX v2.03-4
In the figure, the telephony device connects to the Cisco Systems voice-enabled router POTS
dial peer. 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 in this table to place a VoIP call:
How to Place a VoIP Call
Step
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.
3-48 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.03-5
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 in this table 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
3 Use the
port command to specify the physical voice port that the POTS
telephone is connected to.
The dial peer type is 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.
Copyright 2005, Cisco Systems, Inc. Configuring PSTN Interfaces and Voice Dial Peers 3-49
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.
3-50 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.03-6
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 another router or
gatekeeper for address resolution and Call Admission Control (CAC) to complete the call.
You must follow the steps in this table to configure VoIP dial peers:
How to Configure VoIP Dial Peers
Step
Action
4 Use the
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 to be used, whether to use RTP header compression, whether to use VAD, and may
also include marking the packet for priority service.
Copyright 2005, Cisco Systems, Inc. Configuring PSTN Interfaces and Voice Dial Peers 3-51
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 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 fails 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.
3-52 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Destination-Pattern Options
Destination-Pattern Options
IPTX v2.03-7
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, Cisco CallManager Express router,
IOS router, 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 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
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, Inc. Configuring PSTN Interfaces and Voice Dial Peers 3-53
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 CallManager Express router. 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, whereas 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.
Looking at 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[59]. The bracket notation offers much more flexibility in how numbers can be
assigned.
T: An optional control character indicating that the destination-pattern value is a
variable-length dial string. In cases where callers may be dialing local, national, or
international numbers, the destination pattern must provide for a variable-length dial plan.
If a particular voice gateway has access to the PSTN for local calls and access to a
transatlantic connection for international calls, then calls being routed to that gateway will
have a varying number of dialed digits. A single dial peer with a destination pattern of .T
could support the different call types. The interdigit timeout determines when a string of
dialed digits is complete. The router continues to collect digits until there is an interdigit
pause longer than the configured value, which by default is 10 seconds.
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.
3-54 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Example
Example: Destination-Pattern Options
Destination Pattern
Copyright 2005, Cisco Systems, Inc. Configuring PSTN Interfaces and Voice Dial Peers 3-55
IPTX v2.03-8
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.
3-56 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
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
toward 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 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.
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 parameters that are
different from the voice in the return direction. This may cause one side of the connection to
report good-quality 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 matches 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.
Copyright 2005, Cisco Systems, Inc. Configuring PSTN Interfaces and Voice Dial Peers 3-57
Summary
Summary
A dial peer is an addressable endpoint.
Cisco voice-enabled routers support POTS dial peers and VoIP dial
peers.
Basic POTS dial-peer configuration consists of defining the dial
peer with a tag number and POTS designation, defining the
destination pattern, and defining the voice port to which the device
is connected.
Basic VoIP dial-peer configuration consists of defining the dial peer
with a tag number and VoIP designation, defining the destination
pattern, and defining the remote voice-enabled router through the
session target command.
The destination-pattern on a dial peer can utilize wildcards to
simplify configuration.
The default dial-peer is used when no match in the configured dial
peers is found.
2005 Cisco Systems, Inc. All rights reserved.
3-58 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.03-9
Lesson 4
This lesson describes call flows, digit manipulation, digit collection, and digit consumption as
they relate to inbound and outbound dial peers.
Objectives
Upon completing this lesson, you will be able to define what call legs are, describe how call
legs relate to inbound and outbound dial peers by defining all the steps in the call setup process,
and describe the proper use of digit manipulation. This includes being able to meet these
objectives:
Describe call legs and their relationships to other components
Describe how call legs are interpreted by routers to establish end-to-end calls
Describe how the router matches inbound dial peers
Describe how the router matches outbound dial peers
Describe how the router and attached telephony equipment collect and consume digits and
how to apply digit consumption to the dial peer
Describe digit manipulation and the commands that are used to connect to a specified
destination
Describe how the network establishes private line automatic ringdown
This topic describes call legs and their relationship to other components.
IPTX v2.03-3
Call legs are logical connections between any two telephony devices, such as gateways, routers,
Cisco CallManager Express routers, 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 call leg is established that is outbound, and the
inbound call leg is switched to the outbound voice port.
Example
The connections are made when you configure dial peers on each interface. An end-to-end call
consists of four call legs: two from the source router perspective (as shown in the figure), and
two from the destination router perspective. To complete an end-to-end call from either side
and send voice packets back and forth, you must configure all four dial peers.
Dial peers are used only to set up calls. When the call is established, dial peers are no
longer used.
3-60 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
End-to-End Calls
This topic explains how routers interpret call legs to establish end-to-end calls.
End-to-End Calls
IPTX v2.03-4
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 goes 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 as follows:
1. The 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 with 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 with 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, Inc. Configuring PSTN Interfaces and Voice Dial Peers 3-61
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).
3-62 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
This topic describes how the router matches inbound dial peers.
IPTX v2.03-5
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.
Copyright 2005, Cisco Systems, Inc. Configuring PSTN Interfaces and Voice Dial Peers 3-63
The three call setup information elements that are known about calls arriving at the gateway
are:
Call Setup Information Elements
Call Setup Element
Description
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.
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 the 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 the incoming
called-number command is useful for a company that has a central call center that provides
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 that is 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 then knows how to customize the greeting when answering the call.
Configuring the calling number ANI with the answer-address command 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.
You must configure the calling number ANI with the destination-pattern command 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 match against that dial peer.
3-64 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
This topic describes how the router matches outbound dial peers.
IPTX v2.03-6
Action
3 Use the
Copyright 2005, Cisco Systems, Inc. Configuring PSTN Interfaces and Voice Dial Peers 3-65
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
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.
3-66 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
This topic describes how the router collects and consumes digits and applies them to the dial
peer statements.
IPTX v2.03-7
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, when 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.
Copyright 2005, Cisco Systems, Inc. Configuring PSTN Interfaces and Voice Dial Peers 3-67
Digit Collection
IPTX v2.03-8
The table describes the steps that take place when a voice call enters the network.
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 The router collects no additional dialed digits.
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 always occurs on dial peer 1, and dial peer 2 is never
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 is matched first. If the path to IP address
10.18.0.2 is unavailable, dial-peer 1 is used.
3-68 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Destination Pattern
5551234
. 5551234
In the first row of the table, the destination pattern specifies a seven-digit string. The first digit
must be a 5, 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 DTMF
tones are sent through the voice path and played 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, Inc. Configuring PSTN Interfaces and Voice Dial Peers 3-69
This topic describes digit manipulation and the commands that are used to connect to a
specified destination.
IPTX v2.03-9
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 9025551234. 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.
3-70 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
forward-digits: This dial-peer command specifies the number of digits that must be
forwarded to the telephony interface, 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 is
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 (destinationpattern 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 is 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.
num-exp (number expansion table): 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 in order for the call to go through. The number expansion table is useful,
for example, when 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 commandto confirm the presence
of 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 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.
Copyright 2005, Cisco Systems, Inc. Configuring PSTN Interfaces and Voice Dial Peers 3-71
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 provide a workable solution. The
administrator needs to determine which command is most suitable and what the requirements
are 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:
-
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:
-
-
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 command:
-
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:
-
-
3-72 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
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 that is tagged as an international number into a national number without the 9 before
sending it to the PSTN.
-
-
-
-
Copyright 2005, Cisco Systems, Inc. Configuring PSTN Interfaces and Voice Dial Peers 3-73
PLAR
PLAR Connection
IPTX v2.03-10
PLAR is an auto-dial mechanism that permanently associates a voice port with a far-end
voice port, allowing call completion to a specific telephone number or PBX. When the
calling telephone goes off hook, a predefined network dial peer is automatically matched,
which sets up a call to the destination telephone or PBX. The caller does not hear a dial
tone and does not have to dial a number. PLAR connections are widely used in the business
world. One common use is to connect stockbrokers with trading floors. Timing is critical
when dealing with stock transactions; the amount of time it may take to dial a number and
get a connection can be costly in some cases. Another common use is in the travel sector,
directly connecting travelers with services. At places like airports, the traveler often sees
display boards advertising taxi companies, car rental companies and local hotels. These
displays often have telephones that will connect the traveler directly with the service of
choice; the device is preconfigured with the telephone number of the desired service. One
obvious difference between these telephones and a normal telephone is that they do not
have a dial pad.
As shown 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.
3-74 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
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.
Copyright 2005, Cisco Systems, Inc. Configuring PSTN Interfaces and Voice Dial Peers 3-75
Summary
Summary
A call is segmented into call legs with a dial peer
associated with each call leg.
A call legis a logical connection between two gateways or
routers or between a gateway or router and a telephony
endpoint.
An end-to-end call comprises four call legs: two from the
voice router perspective and two from the destination
router perspective.
If no matching inbound dial peer is configured for a call,
the default dial peer is used.
Inbound dial-peer matching uses incoming called-number,
answer-address, destination pattern, and portin that
orderto match inbound dial peers.
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.03-11
Summary (Cont.)
Outbound dial-peer matching uses the longest number
match in the destination pattern to match an outbound
dial peer.
On POTS dial peers, only wildcard-matched digits are
forwarded by default.
The prefix and forward-digits commands define how digits
are sent out to the voice port.
The num-exp and translation-rule commands define how
one number is replaced with another number.
The connection plar command permanently associates a
voice port with a specific telephone number. The voice
port does not present a dial tone, but automatically
generates the configured number.
2005 Cisco Systems, Inc. All rights reserved.
3-76 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.03-12
Lesson 5
Understanding Class of
Restriction
Overview
This lesson describes class of restriction and how it can be used to restrict access to PSTN
destinations as well as destinations local to CallManager Express.
Objectives
Upon completing this lesson, you will be able to describe class of restriction (COR) and
configure COR on the CallManager Express router. This includes being able to meet these
objectives:
Describe class of restriction
Describe steps to configure class of restriction
Describe a typical deployment
Class of Restriction
This topic describes COR
Features of COR
COR provides a way to deny certain calls based upon the
incoming and outgoing settings on dial peers and ephonedns.
Each dial peer and ephone-dncan have one incoming COR
and one outgoing COR.
COR can be used to control access to dialabledestinations
that are internal to the enterprise or external to the
enterprise.
The incoming COR list indicates the capacity of the dial peer
to initiate certain classes of calls.
The outgoing COR list indicates the capacity required for an
incoming dial peer to deliver a call via this outgoing dial peer.
IPTX v2.03-3
COR 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 for the directory numbers that are
created for Cisco IP Phones associated with the Cisco CallManager Express 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 that is applied on an incoming dial peer (for incoming calls) is a superset or is equal
to the COR applied to the outgoing dial peer (for outgoing calls), the call goes through.
Incoming and outgoing, as referred to here, are with respect to the voice ports.
3-78 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
oror
The incoming COR is like having one or more keys.
The lack of an incoming COR is like having a master key
that can unlock all locks.
The outgoing COR is like a lock or locks.
The lack of an outgoing COR is like having no lock.
IPTX v2.03-4
When the incoming COR list is applied to an ephone-dn or a dial peer, the members of the
COR list are similar to keys. These keys are 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.
Copyright 2005, Cisco Systems, Inc. Configuring PSTN Interfaces and Voice Dial Peers 3-79
Result
Reason
COR is not applied
No COR
No COR
Call succeeds
No COR
Outgoing COR
applied
Call succeeds
Incoming COR
applied
No COR
Call succeeds
Outgoing COR
applied
Call succeeds
Outgoing COR
applied
Call cannot be
completed
TncomingCOR list is
not a superset of
outgoing COR list
Incoming COR
applied is a
superset of
outgoing COR
Incoming COR
applied not a
superset of
outgoing COR
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.03-5
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 any other dial peer, regardless of the COR configuration on that dial peer.
3-80 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Configuration COR
Step 1 Configure the class of restriction names.
Step 2 Configure the class of restriction lists and
members.
Step 3 Assign the COR list to the dial peers.
Step 4 -Assign the COR to the ephone-dns.
Copyright 2005, Cisco Systems, Inc. Configuring PSTN Interfaces and Voice Dial Peers 3-81
IPTX v2.03-6
--
Step 1
IPTX v2.03-7
Before relating a COR to a dial peer, it needs to be named. This is important because
the COR list needs to refer to these names to apply the COR to dial peers and
ephone-dns. Multiple names can be added to represent various COR criteria. The
dial-peer cor custom and name commands define the COR functionality. Possible
names are call1900, call527, and call9. Up to 64 COR names can be defined
under the dial peer cor custom command. This means that a configuration cannot
have more than 64 COR names and that a COR list is limited to 64 members.
3-82 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
- -
--
Step 2
IPTX v2.03-8
Dial peer COR list and member commands set the capabilities of a COR list. A 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.
Copyright 2005, Cisco Systems, Inc. Configuring PSTN Interfaces and Voice Dial Peers 3-83
Step 3
IPTX v2.03-9
Apply the incoming or outgoing COR list to the dial peer. The incoming COR list
specifies the capacity of the dial peer to initiate a certain series or class of calls. The
outgoing COR list specifies the destinations to which the dial peer will be able to
place calls.
3-84 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Step 4
IPTX v2.03-10
Apply the incoming or outgoing COR list to an ephone-dn. The incoming COR list
specifies the capacity of an ephone-dn to initiate a certain series or class of calls.
The outgoing COR list specifies the ability on the ephone-dn to be able to place calls
to a given number range.
Copyright 2005, Cisco Systems, Inc. Configuring PSTN Interfaces and Voice Dial Peers 3-85
Example: COR
-
-
-
Ephone-dn 1
Employee
Ephone-dn 2
Executive
Ext 1000
Ext 2000
IPTX v2.03-11
3-86 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
911
local
long_distance
international
900
Step 1
Copyright 2005, Cisco Systems, Inc. Configuring PSTN Interfaces and Voice Dial Peers 3-87
IPTX v2.03-13
-
-
-
-
-
-
Step 2
The second step is to define the COR list and its member or members. Notice that
none of the COR lists contain the member 900.
-
-
-
-
-
-
-
-
-
Step 3
Note
IPTX v2.03-15
Assign the COR to the dial peers that govern PSTN access. To restrict calls to the
PSTN destinations, the outbound COR setting is defined.
Although not shown here, the inbound COR can be set to regulate where calls that arrive
from the PSTN are allowed to connect internally.
3-88 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Ephone-dn 3
COR in Sales
Ext 1003
Ephone-dn 4
COR in Executive
Ext 1004
IPTX v2.03-16
Step 4
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.
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
IPTX v2.03-17
The result of the configuration is that the lobby phone is only one able to place 911 calls to the
PSTN and internal destinations. The employee phone can only call 911, local seven-digit
numbers on the PSTN, and internal destinations. The sales phone can call 911, local seven-digit
numbers, long distance with 11 digits on the PSTN, and internal destinations. The executive
phone can call 911, local, long distance, international on the PSTN, and internal destinations.
No one can call 900 numbers on the PSTN.
Copyright 2005, Cisco Systems, Inc. Configuring PSTN Interfaces and Voice Dial Peers 3-89
Summary
Summary
A dial peer is an addressable endpoint.
Cisco voice-enabled routers support POTS dial peers and VoIP dial
peers.
Basic POTS dial-peer configuration consists of defining the dial peer
with a tag number and POTS designation, defining the destination
pattern, and defining the voice port to which the device is connected.
Basic VoIP dial-peer configuration consists of defining the dial peer
with a tag number and VoIP designation, defining the destination
pattern, and defining the remote voice-enabled router through the
session target command.
The destination-pattern on a dial peer can utilize wildcards to simplify
configuration.
The default dial peer is used when no match in the configured dial peers
is found.
Class of restrictions can be used to control the allowable destinations
for either an incoming or outgoing call.
2005 Cisco Systems, Inc. All rights reserved.
3-90 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.03-18
Lesson 6
This lesson discusses the supported protocols in Cisco CallManager Express 3.2.1. Those
protocols are: H.450.2, which is used for transfers; H.450.3, which is used for forwarding calls;
and H.450.12, which is used to detect if a remote device supports these protocols.
Objectives
Upon completing this lesson, you will be able to describe call transfer and forwarding using
H.450.x series. This includes being able to meet these objectives:
Describe the different protocols in the H.450.x series
Describe H.450.2 call transfer and H.450.3 call forwarding implementation
Describe H.450.2 and H.450.3 deployment issues and possible workarounds
This topic describes the H.450.x protocols supported in Cisco CallManager Express 3.2.1.
H.450.7 MWI
H.450.8 Name
Identification
H.450.9 Callback
H.450.10 Camp On
H.450.11 Barge
*H.450.12 Capabilities
IPTX v2.03-3
If you work with VoIP networks, ensuring compatibility between all of the equipment is a
constant challenge. Even basic call connections can be challenging because of the variety of
standards-based signaling protocolsH.323, session initiation protocol (SIP), Media Gateway
Control Protocol (MGCP), H.248, and so onand the varying vendor implementations. With
supplementary services, interoperability is even more of an issue.
The ITU currently defines 12 recommendations (H.450.1, H.450.2, H.450.3, and soon through
H.450.12) for supporting various supplementary services in an H.323 network. Cisco
CallManager Express 3.2.1 currently supports these three protocols of the 12 in the H.450.x
series:
H.450.2call transfers
H.450.3call forwarding
H.450.12detection of H.450.x series protocols on a remote device
3-92 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
This topic describes the H.450.2 protocol, which is used for call transfers.
H.450.2 Transfer
B
A calls B.
A
A
A
C
B
B commits transfer. B
requests and receives an
H.450.2 consultation-ID
from C.
As call to C is successful. A
and C disconnect calls to B.
B
A
B
A
B
A
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.03-4
A calls B.
Step 2
Step 3
Step 4
Step 5
Step 6
Copyright 2005, Cisco Systems, Inc. Configuring PSTN Interfaces and Voice Dial Peers 3-93
IPTX v2.03-5
When connecting a Cisco CallManager Express system to another Cisco CallManager Express
system or to a voice gateway, the use of H.450.2 is very desirable because of the following
reasons:
Path optimizationThe final path of the data that contains the voice is optimal and does
not have to traverse through the device that performed the transfer.
Flexible settingsThe settings, like codec, VAD, and others, can change from the original
destination to the transferred destination.
ScalableBecause the device that transferred the call is no longer involved in either the
data path or the signaling, the H.450.2 protocol is very scalable, and there is no limit to
how many times the call can be transferred.
3-94 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.03-6
When H.450.2 is used in the network, all Cisco CallManager Express systems and voice
gateways involved in the voice path must support the H.450.2 protocol. If this is not configured
or supported on all systems and other mechanisms are not employed, then the symptoms
transfers will fail and the caller will be hung up on. The workaround for this problem is to use a
hairpin connection, which can cause latency and bandwidth inefficiencies.
Copyright 2005, Cisco Systems, Inc. Configuring PSTN Interfaces and Voice Dial Peers 3-95
--
--
H.450.2 Commands
Command
Description
Example:
-
--
Example:
-
--
Example:
--
3-96 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
--- -
-
Copyright 2005, Cisco Systems, Inc. Configuring PSTN Interfaces and Voice Dial Peers 3-97
IPTX v2.03-8
Description
---
-
-
Example:
Router(config-telephonyservice)#
transfer-system full-consult
-
-
Example:
Router(config-telephonyservice)#
transfer-pattern .T
3-98 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.03-9
This example shows H.450.2 being enabled on the Cisco CallManager Express router for calls
that are transferred to the system through the use of the supplementary-service h.450.2
command. This is enabled by default, so the only reason to use this command is if H.450.2 has
been previously disabled. The supplementary-service h.450.2 command on the dial peer will
override the systemwide setting and disable H.450.2 for that single dial peer.
To enable the use of H.450.2 for call transfers initiated in the Cisco CallManager Express
system, the command transfer-system must be used with either the full-consult or full-blind
keyword. By default, a proprietary non-H.450.2 blind transfer is used until this is entered. For
transfers to be enabled for nonephone-dn destinations in Cisco CallManager Express, the
transfer-pattern command must be entered.
Note
Without the transfer-pattern command, only transfers from one ephone-dn to another will
work. By default, external destinations are not valid transfer targets.
Copyright 2005, Cisco Systems, Inc. Configuring PSTN Interfaces and Voice Dial Peers 3-99
H.450.3 Forwarding
A calls B.
B
A
C
B wants to forward As
call to C.
B
A
B
A
B
A
C
B
A calls C.
As call to C is
successful. A
disconnects call
attempt to B.
A calls B.
Step 2
Step 3
Step 4
A calls C.
Step 5
Step 6
3-100 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.03-10
H.450.3 Advantages
The final A-to-C call path is optimal, with no hair-pin
media or control path, for example:
New York calls Los Angeles and is forwarded to
London. Final call is direct from New York to London
(not via Los Angeles).
Call parameters for A-B and A-C can be different
(e.g., different codecs).
After forwarding is done, all resources at B are
released; H.450.3 is very scalable.
There is no H.450.3 limit to the number of times a call
can be forwarded.
IPTX v2.03-11
When connecting a Cisco CallManager Express system to another Cisco CallManager Express
system or to a voice gateway, the use of H.450.3 is very desirable because of the following
reasons:
Path optimizationThe final path of the data that contains the voice is optimal and does
not have to traverse through the device that performed the transfer.
Flexible settingsThe settings, like codec, VAD, and others, can change from the initial
destination to the forwarded destination.
ScalableBecause the device that forwards the call is not involved in either the data path
or the signaling, the H.450.3 protocol is very scalable, and there is no limit to how many
times the call can be forwarded.
Copyright 2005, Cisco Systems, Inc. Configuring PSTN Interfaces and Voice Dial Peers 3-101
H.450.3 Disadvantages
All voice gateway routers in the network must
support H.450.3.
Calls may drop if participating endpoints do not
support H.450.3.
IPTX v2.03-12
The main disadvantage of using H.450.3 is that all Cisco CallManager Express routers and
voice gateways that are involved in the voice path must have the protocol enabled and must
support the H.450.3 protocol. A hairpin must be used if H.450.3 cannot be enabled on all voice
gateways, which can cause inefficient use of bandwidth and increased latency and call setup
problems.
3-102 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
--
--
H.450.3 Commands
Command
Description
Example:
-
--
Example:
-
--
Example:
--
Copyright 2005, Cisco Systems, Inc. Configuring PSTN Interfaces and Voice Dial Peers 3-103
IPTX v2.03-14
Description
Example:
3-104 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.03-15
This example shows H.450.3 being enabled on the Cisco CallManager Express router for calls
that are forwarded to the system through the use of the supplementary-service h.450.3
command. This is enabled by default, so the only reason to use this command is if H.450.3 has
been previously disabled. The supplementary-service h.450.3 command on the dial peer will
override the systemwide setting and disable H.450.3 for that single dial peer.
To enable the use of H.450.3 for call forwarding initiated in the Cisco CallManager Express
system, the command call-forward pattern must be used to define any nonephone-dn
destinations that a call can be forwarded to.
Copyright 2005, Cisco Systems, Inc. Configuring PSTN Interfaces and Voice Dial Peers 3-105
H.450.12
H.450.12 Capabilities
Cisco CallManager Express 3.1 adds H.450.12 support.
H.450.12 provides a supplementary services indication capabilities
exchange.
H.450.12 allows dynamic auto detection of
non-H.450.x-capable endpoints.
H.450.12 indications are provided on Setup, Proceeding, Alerting
and Connect messages.
H.450.12 allows the Cisco CallManager Express 3.1 system to
explicitly detect if H.450.2 and H.450.3 are supported on a
call-by-call basis.
If H.450.2 and H.450.3 is not supported, Cisco CallManager Express
3.1 can fall back to providing hairpin VoIP-to-VoIP call routing
(for H.323).
Previous versions of Cisco CallManager Express support H.450.2
and H.450.3 but not H.450.12.
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.03-16
The H.450.12 call capabilities standard provides a means to advertise and discover H.450.2 and
H.450.3 capabilities in voice gateway endpoints on a call-by-call basis. When H.450.12 is
enabled, H.450.2 and H.450.3 services are disabled for call transfers and call forwarding unless
a positive H.450.12 indication is received from all the other VoIP endpoints that are involved in
the call. If a positive H.450.12 indication is received, the router uses the H.450.2 standard for
call transfers and the H.450.3 standard for call forwarding. If a positive H.450.12 indication is
not received, the router uses the alternative method that you have configured for call transfers
and forwards, either hairpin call routing or an H.450 tandem gateway.
Note
Cisco CallManager Express 3.0 does not provide H.450.12 indications for calls even though
it supports theH.450.2 and H.450.3 standards.
3-106 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Using H.450.12
When you turn on the H.450.12 service, H.450.2
and H.450.3 are disabled unless a positive H.450.12
indication is received from all the other VoIP
endpoints involved in the call.
H.450.12 is turned off by default to minimize risk of
compatibility issues with third-party H.323
systems.
IPTX v2.03-17
H.450.12 capabilities are disabled by default to minimize the risk of compatibility issues with
other types of H.323 systems. This optional task allows you to enable H.450.12 capabilities
globally or by individual dial peer.
Copyright 2005, Cisco Systems, Inc. Configuring PSTN Interfaces and Voice Dial Peers 3-107
H.450.12 Commands
-- -
IPTX v2.03-18
When all Cisco CallManager Express systems are running version 3.2.1, the command
supplementary-service h.450.12 may be used to enable the H.450.12 protocol. This allows the
Cisco CallManager Express systems to detect on a call-by-call basis if the devices that are
involved with a transfer or forward support H.450.x protocols.
The supplementary-service h450.12 command with the advertise-only keyword is intended
for use on Cisco CallManager Express 3.2.1 systems that are mixed in a network with Cisco
CallManager Express 3.0 systems. This scenario is usually found when you are upgrading a
network from Cisco CallManager Express 3.0 to Cisco CallManager Express 3.2.1. When you
use the advertise-only keyword, the Cisco CallManager Express 3.2.1 router sends out
H.450.12 indications for the benefit of remote VoIP endpoints, but does not require H.450.12
responses and has H.450.2 and H.450.3 enabled for all calls (the default). When in advertiseonly mode, Cisco CallManager Express 3.2.1 is still able to automatically detect Cisco
CallManager systems.
3-108 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
This topic describes the issues and workarounds commonly found in Cisco CallManager
Express deployments.
IPTX v2.03-19
Copyright 2005, Cisco Systems, Inc. Configuring PSTN Interfaces and Voice Dial Peers 3-109
Detecting CallManager
CallManager does not support H.450.2, H.450.3,
or H.450.12.
A proprietary detection mechanism is used.
CallManager sends a nonstandard identifier in
most of its H.225 messages. This tells you that
H.450.x can not be supported for the call.
This is useful if you have both CallManager and
older Cisco CallManager Express 3.0 systems
in the same network and, therefore, cannot use
H.450.12.
IPTX v2.03-20
Cisco CallManager does not support the H.450.x protocols. This lack of support can be
detected through a proprietary mechanism. This mechanism is an H.225 message within the
H.332 protocol suite. The presence of this nonstandard message is enough to inform the Cisco
CallManager Express router not to use H.450.x protocols with this device. As a result, a VoIPto-VoIP gateway must be configured to allow the transfer and forwarding of calls between the
Cisco CallManager and Cisco CallManager Express systems.
3-110 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.03-21
Copyright 2005, Cisco Systems, Inc. Configuring PSTN Interfaces and Voice Dial Peers 3-111
IPTX v2.03-22
Description
Example:
-
-
Example:
-
-
3-112 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
CallManager
CallManager
Express
Express A
A
Non-H.450
Gateway
CallManager
CallManager
Express
Express B
B
Step 2 -Transfer
or forward to 3000
IP WAN
Step 3 Call is hairpinned
and connected to 3000
3000
3000
-
-
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.03-23
In this example, the following steps are happening in the call flow:
Step 1
Step 2
Step 3
The call is transferred or forwarded through the use of a hairpin on the Cisco
CallManager Express router B (the ability to perform the hairpin must be enabled on
B).
Notice that the bandwidth between Cisco CallManager Express router B and the WAN cloud is
double the amount that is used for a single call. In addition, the latency of the WAN to Cisco
CallManager Express router B is also cumulative. Both of these issues must be taken into
account when deciding to use this workaround.
Copyright 2005, Cisco Systems, Inc. Configuring PSTN Interfaces and Voice Dial Peers 3-113
IPTX v2.03-24
The auto-detection of Cisco CallManager is still supported in this mode through a proprietary
H.225 message identifier.
3-114 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.03-25
Copyright 2005, Cisco Systems, Inc. Configuring PSTN Interfaces and Voice Dial Peers 3-115
Summary
Summary
H.450.2 is used to efficiently transfer calls from one H.450.2 device to
another.
H.450.3 is used to forward calls efficiently from one H.450.3 device to
another.
H.450.12 is used to detect whether a device supports H.450.2 or H.450.3.
Cisco CallManager Express 3.1 supports H.450.2, H.450.3, and H.450.12.
H.450.2 transfer and H.450.3 forward are enabled by default for transferred
and forwarded calls that arrive at Cisco CallManager Express3.1.
Support for initiating an H.450.2 transfer or H.450.3 forward must be enabled
on the Cisco CallManager Express router.
When H.450.x protocols are disabled or not supported, a VoIP-to-VoIP
hairpin may be used. This ability is disabled by default.
CallManager, which does not support H.450.x protocols, can be
automatically detected by Cisco CallManager Express .
When upgrading Cisco CME 3.0 to 3.1, enable H.450.12 with advertise-only
mode until all the Cisco CallManager Expressrouters have been
upgraded to 3.1.
2005 Cisco Systems, Inc. All rights reserved.
3-116 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.03-26
Module Summary
Module Summary
This module defined how to configure voice interfaces, dial peers, and VoIP
communications.
As a result of completing this module, learners should have an
understanding of the types of analog interfaces that are supported in Cisco
CallManagerExpress.
As a result of completing this module, learners should have an
understanding of the types of digital interfaces that are supported in Cisco
CallManagerExpress.
In addition, learners should be able to configure voice interfaces with IOS
commands.
Learners should have an understanding of dial peers and how theyare
configured.
Learners should understand how digits are matched to dial peers and how
digits can be manipulated.
As a result of completing this module, the learner should have an
understanding of the H.450.x protocols and the issues that may be
encountered when using the H.450.x protocols.
2004 Cisco Systems, Inc. All rights reserved.
IPTX v2.03-1
This module dealt with the supported analog and digital voice interfaces that can be used by
Cisco CallManager Express. Analog interfaces can be used for analog phones, faxes, or analog
trunks. Digital connections can be used for digital trunks and are typically used in situations
that require a higher density of connections.
The concept of a dial peer and how they are configured was also covered in this module. The
dial peer is an essential part of the configuration of Cisco CallManager Express, and it is
important to understand how restrictions and manipulation of digits can be applied to it.
The H.450.2 protocol for call transfer was discussed, and the configuration of this protocol was
explained. The H.450.3 protocol for call forwarding was also covered in detail, and the
configuration explained. Finally, the H.450.12 protocol, which is new to Cisco CallManager
Express 3.1, was explained, and various deployment scenarios were covered.
References
For additional information, refer to these resources:
Call Routing/Dial Plans: Understanding Inbound and Outbound Dial Peers on Cisco IOS
Platforms.
http://cisco.com/en/US/partner/tech/tk652/tk90/technologies_tech_note09186a0080147524.
shtml.
Call Routing/Dial Plans: Configuring Class of Restriction (COR).
http://cisco.com/en/US/partner/tech/tk652/tk90/technologies_configuration_example09186
a008019d649.shtml.
Copyright 2005, Cisco Systems, Inc. Configuring PSTN Interfaces and Voice Dial Peers 3-117
Module Self-Check
Use the questions here to review what you learned in this module. The correct answers and
solutions are found in the Module Self-Check Answer Key.
Q1) In most local-loop connections, to what does the ring wire tie? (Source: Identifying
Differences Between Analog and Digital Voice Interfaces)
A) battery
B) ground
C) telephone
D) switch
Q2) What are the three different types of local-loop signaling? (Choose three.) (Source:
Identifying Differences Between Analog and Digital Voice Interfaces)
A) address signaling
B) coding signaling
C) control signaling
D) informational signaling
E) remote signaling
F) supervisory signaling
Q3) Which call progress indicator is used to let you know that the telephone company is
working on completing the call? (Source: Identifying Differences Between Analog and
Digital Voice Interfaces)
A) busy
B) confirmation tone
C) dial tone
D) ringback
Q4) How many bits long is a T1 frame? (Source: Identifying Differences Between Analog
and Digital Voice Interfaces)
A) 128
B) 164
C) 192
D) 193
Q5) What are the two major frame formats for a T1? (Choose two.) (Source: Identifying
Differences Between Analog and Digital Voice Interfaces)
A) SF
B) CRC4
C) ESF
D) ESC4
Q6) In E1 framing, how many channels are available for voice or data? (Source: Identifying
Differences Between Analog and Digital Voice Interfaces)
A) 29
B) 30
C) 31
D) 32
3-118 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Q7) Which type of voice port application automatically dials with prespecified digits?
(Source: Configuring Analog and Digital Voice Interfaces)
A) local call
B) on-net
C) off-net
D) PLAR
Q8) Which type of voice port application makes a call within the same city? (Source:
Configuring Analog and Digital Voice Interfaces)
A) local call
B) on-net
C) off-net
D) PLAR
Q9) Which of the following is not an FXS configuration parameter? (Source: Configuring
Analog and Digital Voice Interfaces)
A) signal
B) cptone
C) busyout
D) ring cadence
E) ring number
F) ring frequency
Q10) What command parameter sets an FXO port to answer after a certain number of rings?
(Source: Configuring Analog and Digital Voice Interfaces)
A) loop number
B) ring number
C) dial number
D) answer number
Q11) What two types of dial peers do Cisco routers support? (Choose two.) (Source:
Describing Dial-peers)
A) local
B) POTS
C) VoIP
D) WAN
Q12) When configuring POTS dial peers, which command is used to define the telephone
number? (Source: Describing Dial-peers)
A)
B)
C)
D)
dial number
ring number
session-pattern
destination-pattern
Q13) When configuring VoIP, which command is used to specify the gateway or destination
router? (Source: Describing Dial-peers)
A)
B)
C)
D)
session target
router-IP
gateway-address
IP-address
Copyright 2005, Cisco Systems, Inc. Configuring PSTN Interfaces and Voice Dial Peers 3-119
Q14) You must specify a destination pattern for each dial peer you configure. (Source:
Describing Dial-peers)
A) true
B) false
Q15) When an end-to-end call is established, how many inbound call legs are associated with
the call? (Source: Understanding Call Setup and Digit Manipulation)
A) 1
B) 2
C) 3
D) 4
Q16) What is the default dial-peer configuration for inbound POTS peers? (Source:
Understanding Call Setup and Digit Manipulation)
A) any codec
B) no IVR application
C) VAD-enabled
D) no RSVP support
E) IP precedence 0
Q17) What happens if there is no matching dial peer for an outbound call? (Source:
Understanding Call Setup and Digit Manipulation)
A) The default dial peer is used.
B) Dial peer 0 is used.
C) The POTS dial peer is used.
D) None of the above.
Q18) After the router strips off the left-justified digits, what are the remaining digits called?
(Source: Understanding Call Setup and Digit Manipulation)
A) leftover digits
B) wildcard digits
C) right-justified digits
D) one of the above
Q19) Call Manager Express 3.1 currently supports which three of the following H.450 series
protocols? (Choose three.) (Source: Describing ITU Supplementary Services)
A) H.450.2
B) H.450.3
C) H.450.11
D) H.450.12
Q20) Which of the H.450x series protocols defines transfers? (Source: Describing ITU
Supplementary Services)
A) H.450.2
B) H.450.3
C) H.450.11
D) H.450.12
3-120 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Q21) In order for a transfer to be successful, at least one Cisco Call Manager Express or
gateway must be configured for H.450.2. (Source: Describing ITU Supplementary
Services)
A) true
B) false
Q22) What must be used if a device does not support H.450.3 protocol? (Source: Describing
ITU Supplementary Services)
A) bobby pin
B) hairpin
C) banana clip
D) hairspray
Copyright 2005, Cisco Systems, Inc. Configuring PSTN Interfaces and Voice Dial Peers 3-121
Q2) A, D, F
Q3) B
Q4) D
Q5) A, C
Q6) B
Q7) D
Q8) C
Q9) E
Q10) B
Q11) B, C
Q12) D
Q13) A
Q14) A
Q15) D
Q16) D
Q17) B
Q18) B
Q19) A, B, D
Q20) A
Q21) B
Q22) B
3-122 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Module 4
This module discusses topics dealing with describing, defining, and configuring additional
features for a basic Cisco CallManager Express system.
Many of the features that are presented are necessary for successful deployment of Cisco
CallManager Express. These features include ways for a system administrator, customer
administrator, and user to interact with Cisco CallManager Express in a web-based GUI.
Critical features that need to be configured in many installations include the Auto Attendant,
Music on Hold (MOH), call transfer, and call forwarding features. Optional features include
paging groups, intercom functions, and customizing the rings of the Phones.
The Cisco CallManager Express system provides basic call center functions through a special
script that can be loaded onto the Cisco CallManager Express system. This script provides call
treatment and basic queuing functions.
In certain installations, integration between the IP Phone and software on the PC may be
desired. Integrating the two is possible through a Telephony Application Programming
Interface (TAPI), which can be installed on the PC and which allows the PC to interact with
the Cisco CallManager Express system.
Network management features provide a way for the administrator to monitor, configure, and
collect information regarding the Cisco CallManager Express environment.
Module Objectives
Upon completing this module, you will be able to configure additional Cisco CallManager
Express features. This includes being able to meet these objectives:
Describe and configure Cisco CallManager Express GUI features
Describe and configure IP Phone features
Describe the features that provide basic ACD functionality
Describe TAPI Lite support for Cisco CallManager Express
Describe the setup utility, syslog messages, and billing support
4-2 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Lesson 1
Configuring Cisco
CallManager Express
GUI Features
Overview
This lesson defines how to set up, configure, and use the Cisco CallManager Express GUI and
the three different access levels.
Objectives
Upon completing this lesson, you will be able to describe and configure Cisco CallManager
Express GUI features. This includes being able to meet these objectives:
Identify the three user classes for the GUI
Identify the tasks for setting up the GUI
Describe how to access the GUI on the Cisco CallManager Express router
Describe and configure administrative user classes
User Classes
This topic describes the three user classes for the Cisco CallManager Express HTTP-based
GUI access.
IPTX v2.04-2
The Cisco CallManager Express GUI provides a web-based interface to manage most
systemwide and Phone-based features. In particular, the GUI facilitates the routine additions
and changes associated with employee turnover, allowing these changes to be performed by
nontechnical staff.
The GUI provides three levels of access to support the following user classes:
System administrator: Able to configure all systemwide and Phone-based features. This
person is familiar with Cisco IOS software and Voice over IP (VoIP) network
configuration.
Customer administrator: Able to perform routine Phone additions and changes without
having access to systemwide features. This person does not have to be trained in Cisco IOS
software.
Phone users: Able to program a small set of features on their own Phone and search the
Cisco CallManager Express directory.
Note
The system administrator account must initially be configured through the command-line
interface (CLI).
4-4 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.04-3
By default, the system administrator and the customer administrator have the same level of
access. The customer administrator can be customized to have a subset of the choices in the
menus. The choices in the drop-down menus are:
Configure: settings that deal with ephones, ephone-dns, and system settings
Voice Mail: settings that deal with voice mail settings and integrations
Administration: functions that involve backup and restore, saving changes, and reloading
the router
Reports: running and viewing various reports
Help: links to version information and the Help file
Note
The system administrator username and password can be changed from within the system
administrator GUI.
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-5
IPTX v2.04-4
The Phone user web-based GUI looks similar to the system administrator web-based GUI and
customer administrator web-based GUI. Phone users can make some basic changes to the
configuration of their Phones and can look up entries in the Cisco CallManager Express
directory. The three drop-down menus available to Phone users include very limited options:
Configure: limited settings for the users associated Phone
Search: search of the Cisco CallManager Express directory
Help: links to version information and the Help file for users
4-6 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.04-5
The Cisco CallManager Express GUI uses HTTP to transfer information from the Cisco
CallManager Express router to the PC of an administrator or Phone user. The router must be
configured as an HTTP server and must have the proper web files locally in flash to serve up
to the browser. In addition, an initial system administrator username and password must be
defined from the router CLI. Customer administrators and Phone users can be added from
the Cisco CallManager Express router using CLI commands or from a PC using GUI web
pages. The GUI web page functions that are for customer administrators can be restricted and
customized with support in Cisco CallManager Express for extensible markup language (XML)
cascading style sheets (files with a .css suffix).
Note
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-7
IPTX v2.04-6
The HTTP server on the Cisco CallManager Express router is disabled by default. In order to
enable it, enter the ip http server command from global configuration mode. This starts the
HTTP service, but does not define where the files are located that will be served up. To configure the
location of the files to be served up by the web server, enter the command ip http path flash:
from global configuration mode. Authentication is set to use the enable password by default. It
is recommended that authentication be configured to use an authentication, authorization, and
accounting (AAA) server or a local username and password pair. The ip http authentication
command is used to configure the authentication method that is desired.
4-8 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Description
Example:
-
-
Example:
-
-
Example:
Customer administrators and Phone users
cannot bring about any changes with this
command.
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-9
-- - -- - -
-
IPTX v2.04-7
To configure the system administrator credentials, enter the telephony-service command from
global configuration mode. Then, from the telephony-service configuration mode, enter the
web admin system name username password string command. This defines an initial
username and password in order for the system administrator to access the GUI. After you have
created this account you can log in to the GUI. While in the GUI as the system administrator,
you can define the customer administrator and Phone users. Alternatively, you can use the
router CLI to create the customer administrator and Phone user credentials.
If the 0 option is used, then the password will not be encrypted and will be clearly visible in the
configuration. If the password is set with the 5 option, then the password will be displayed as a
Message Digest 5 (MD5) hash.
Note
4-10 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Purpose
- -
Example:
-
-- -
-- - -
-
Example:
-
-- -
Note
The secret 5 keyword pair is used in the output of show commands when encrypted
passwords are displayed, and it indicates that the password that follows is encrypted.
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-11
IPTX v2.04-8
By default, ephone-dns can be created only through the CLI of the Cisco CallManager Express
router. The ability to add ephone-dns through the web-based GUI can be enabled if desired. To
enable this functionality, use the dn-webedit command.
Similarly, the ability to set the system time of the Cisco CallManager Express router in the
web-based GUI is not available by default and must be enabled. This is the setting that
configures the time that appears on the display of the IP Phones. To enable the setting of time
in the web-based GUI, use the time-webedit command.
These settings provide a way for the nontechnical administrator to create new ephone-dns and
to modify the time through the web-based GUI instead of using the CLI, which the
nontechnical administrator may not be comfortable with.
4-12 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Webedit Commands
Command
Description
Example:
Example:
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-13
IPTX v2.04-9
To access the administrative web site to make changes, use the URL
http://router_ipaddr/ccme.html in your IE 6.0 browser. When prompted for credentials, use the
administrative credentials previously defined in the CLI. Based on the credentials that are
presented to the Cisco CallManager Express router, the router displays the appropriate web
page for the system administrator, customer administrator or Phone user.
4-14 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.04-10
In the Cisco CallManager Express system, there is a system administrator that has full control
of the system. It may be desirable to create another customized level of access to the system by
configuring what is known as a customer administrator. This customer administrator can have a
subset of the full level of access enjoyed by the default system administrator. The end result is
the existence of two levels of administrators, the system administrator with full access and the
customer administrator with a defined subset of the system administrators full access.
Creating and defining the level of access for the customer administrator to log in to the Cisco
CallManager Express web-based GUI is a two-step process. The first step is to create the XML
file that defines the level of access to objects in the Cisco CallManager Express web-based
GUI. The second step is to create the user credentials that the customer administrator will use.
This can be done by using either the CLI or the system administrator web-based GUI.
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-15
IPTX v2.04-11
The xml.template file is included in both the .tar and .zip files with which Cisco CallManager
Express was installed. First open the xml.template file with a text editor. Next delete either
Hide or Show, as well as the pipe symbol and the brackets, leaving only Hide or Show
remaining, whichever level of access is desired for that object. Save the file with a name that
has significance and an .xml extension, then upload this file to the flash of the Cisco
CallManager Express router. The file is loaded into RAM from flash.
4-16 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Action
1.
Open a copy of the xml.template file. The xml.template file is included in both the
.tar file and the .zip file that the Cisco
CallManager Express files came in.
2.
3.
Example:
Notes
-
Upload the XML file to flash memory on the
Cisco CallManager Express router.
4.
-
Load the template from flash to RAM on the
Cisco CallManager Express router.
5.
Example
Changing a line in the xml.template file controls the ability to add a new Phone from within the
Cisco CallManager Express web-based GUI.
<AddPhone> [Hide | Show] </AddPhone> becomes <AddPhone> Hide </AddPhone> and
prevents the customer administrator from adding a Phone through the web-based GUI.
- -
- -
-
--
- -
-- --
IPTX v2.04-12
This is an example of the xml.template that comes with Cisco CallManager Express 3.1. Notice
[Hide | Show]. This needs to be edited to leave only the desired action.
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-17
- -
- -
-
- -
- -
-
IPTX v2.04-13
This sample XML file shows the proper syntax for an edited XML file. Notice that this
XML file allows the customer administrator to add and delete a Phone but not an extension.
After the desired changes to access have been made, save the file (step 3) and put it on an
FTP or a TFTP server with which the Cisco CallManager Express router can communicate.
Next, in step 4, use the copy ftp flash or copy tftp flash command to move the file to
flash on the Cisco CallManager Express router. And finally, step 5 uses the command
web customize load filename from telephony-service mode to load the file into RAM on the
Cisco CallManager Express router. Any syntax errors that exist cause this step to fail, which
causes the Cisco CallManager Express router to output a syslog message.
Web Customize Load Command
Command
Description
Example:
-
-
4-18 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Modified XML
template applied
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.04-14
This figure shows the results of the previous XML configuration file. The difference in access
to the web-based GUI is a direct result of the <Extension> section in the previous figure.
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-19
IPTX v2.04-15
4-20 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.04-16
Only one set of customer administrator credentials may be defined. Any subsequent
changes overwrite the initial configuration.
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-21
- - -- -
IPTX v2.04-17
Only one set of customer administrator credentials may be defined. Any subsequent
changes overwrite the initial configuration.
Description
- -
Example:
-
- -
-- - -
-
Example:
-
- -
--
4-22 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.04-18
IPTX v2.04-19
To set Phone user credentials from the Phone user web pages, go to the Configure drop-down
menu and choose Phones. Either add a new Phone or change an existing Phone by selecting it.
Scroll to the bottom of the page, and in the Login Account area, define the username and
password. Click the Change button to commit the changes.
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-23
- - -- --
IPTX v2.04-20
To configure the Phone user credentials for a Phone using the CLI, enter the ephone
subconfiguration mode by entering the ephone phonetag command from global configuration
mode. Next enter the username username password password command. This is used by the
Phone users to log in to the web-based GUI and for any Telephony Application Programming
Interface (TAPI) Lite connections.
Note
Command
Description
- -
- -
Example:
- - --
--
Example:
-
--
4-24 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Summary
Summary
There are three levels of access to the web-based GUI:
system administrator, customer administrator, and
Phone user.
The GUI is not enabled by default and requires the
HTTP server and credentials to be enabled.
To access the web-based GUI, use the URL
http://router_ipaddr/ccme.html.
The system administrator must be configured from
the CLI.
The customer administrator can be set up from the GUI
or the CLI and can be customized.
The Phone user can be set up from the GUI or the CLI.
2005 Cisco Systems, Inc. All rights reserved.
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-25
IPTX v2.04-21
4-26 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Lesson 2
This lesson defines additional features that can be installed and configured to enhance a basic
Cisco CallManager Express installation.
Objectives
Upon completing this lesson, you will be able to describe and configure IP Phone features. This
includes being able to meet these objectives:
Describe and configure call transfer options
Describe and configure the call forwarding feature
Describe and configure the call waiting properties of an ephone-dn
Describe and configure the call park properties of an ephone-dn
Describe and configure the IP Phone display
Describe and configure the softkey button layout
Describe and configure the calling and directory features
Describe and configure conferencing
Describe and configure the productivity tools
Describe and configure interdigit timeout and ringing timeout
Describe and configure MOH from an audio file and from a live feed
Call Transfer
IPTX v2.04-3
Transferring a caller to another directory number is a very common occurrence. The person on
the IP Phone can initiate a transfer by using the functions that are displayed on the IP Phone
display. To transfer a caller, the user can initiate the transfer by pressing the Trnsfer softkey
button and dialing the number to which the call will be transferred.
Depending on the configuration deployed on the Cisco CallManager Express system, the call is
either blindly transferred or transferred with a consultation first. A blind transfer occurs when
the transferor transfers the call without knowing if the extension that the call was transferred to
will answer the call. In a consultative transfer, the transferor is connected to the transferee,
then, if satisfied, finalizes the transfer that connects the caller to the transferee.
4-28 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.04-4
Call transfer is a function that can be configured in various ways, depending on the supported
protocols. These call transfer commands include systemwide settings that can be overridden
with Phone-specific settings. The Phone-specific settings can be overridden by settings on the
transfer pattern.
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-29
--- -
-
----
IPTX v2.04-5
Transfer System
To specify the systemwide call transfer method for IP Phone extensions that use the
International Telecommunication Union Telecommunication Standardization Sector (ITU-T)
H.450.2 standard, use the command transfer-system in telephony-service configuration mode.
To disable the call transfer method, use the no form of this command.
When call transfer is selected using the full-blind keyword, the call is transferred without
consultation using the H.450.2 standard. When a call is transferred using the blind keyword
(the default), the call is blindly transferred using a single line and a Cisco-proprietary method.
When the full-consult keyword is used, the call is transferred with consultation using the
H.450.2 standard. The local-consult keyword uses consultation with local calls and blindly
transfers nonlocal calls. The local-consult keyword uses a proprietary transfer mechanism and
is not commonly used.
Note
Cisco CallManager Express 3.1 provides full call-transfer and call-forwarding interoperability
with call processing systems on the network that support H.450.2, H.450.3, and H.450.12
standards. For call processing systems that do not support H.450 standards, Cisco
CallManager Express 3.1 provides Voice over IP (VoIP) to-VoIP hairpin call routing without
requiring the use of the special Toolkit Command Language (Tcl) script that was needed in
earlier releases of Cisco CallManager Express.
4-30 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Description
---
-
-
Example:
-
--- -
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-31
- -
- -
IPTX v2.04-6
Transfer Mode
To specify the type of call transfer for an individual IP Phone extension that uses the
ITU-T H.450.2 standard, use the command transfer-mode in ephone-dn configuration
mode. To remove this specification, use the no form of this command.
The transfer-mode command specifies the type of call transfer for an individual Cisco IP Phone
extension that is using the ITU-T H.450.2 protocol. It allows you to override the default
transfer-system setting (full-consult or full-blind) for that ephone-dn extension. For example,
in a Cisco CallManager Express network that is set up for consultative transfer, a specific
extension with an automated attendant that automatically transfers incoming calls to specific
extension numbers can be set to use blind transfer because automated attendants do not use
consultative transfer.
Transfer Mode Command
Command
Description
- -
Example:
4-32 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
- -
--
IPTX v2.04-7
Transfer Pattern
To allow the transfer of telephone calls from Cisco CallManager Express IP Phones to nonlocal
destinations, use the command transfer-pattern in telephony-service configuration mode. To
disable these transfers, use the no form of this command.
The transfer-pattern command allows you to transfer calls to destinations other than local
IP Phones. This includes nonIP phones and external destinations. A call is then established
between the transferred party and the new recipient. By default, all Cisco IP Phone extension
numbers are allowed as transfer targets. The default is that all transfers are consultative in
nature. The optional blind keyword forces calls that are transferred to numbers that match the
transfer pattern to be executed as blind or full-blind transfers, overriding any settings made
using the transfer-system and transfer-mode commands. When defining transfers to nonlocal
numbers, it is important to note that transfer-pattern digit matching is performed before
translation-rule operations. Therefore, you should specify in this command the digits that are
actually entered by Phone users before they are translated.
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-33
Description
- -
Example:
-
-
4-34 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Call Forwarding
This topic describes the Cisco CallManager Express call forwarding commands.
IPTX v2.04-8
There are various call forwarding settings that govern the behaviors of the forwarding of calls.
Call forwarding may occur when the destination is busy, when the Phone rings but no one
answers, or when the Phone user wants all calls to be forwarded to another destination. On a
users Phone, the ring no answer forward setting is usually set by the administrator to go to the
voice mailbox of that user. However, this is not always the case. For example, extensions may
be set to forward on ring no answer to another extension, constructing a hunt group like
environment.
The setting to forward all calls can be configured on the IP Phone by the user. For example, a
user may go on vacation and want all calls to be handled by another employee. This common
situation occurs in many deployments.
To set all calls to forward, press the CFwdAll softkey button on the Phone and enter the
number to which all calls are to be forwarded, then press the pound (#) key to tell the system
you have finished. The forward all destination is displayed on the bottom of the IP Phone
screen. To remove the forward all, press the CFwdAll softkey button again. This turns off the
forward all. The user or administrator can also use the web-based GUI of Cisco CallManager
Express to configure the call forwarding options.
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-35
IPTX v2.04-9
From the Phone user web interface, the user is able to configure a line on the Phone to forward
all, forward busy, and forward no answer. Users can configure only the Phone on which they
have credentials defined.
4-36 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.04-10
There are five call forwarding commands that can be configured from the command-line
interface (CLI) of the Cisco CallManager Express router. These commands are:
call-forward all (CLI, GUI, Phone)
call-forward busy (CLI, GUI)
call-forward noan (CLI, GUI)
call-forward max-length (CLI)
call-forward pattern (CLI)
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-37
--
Purpose
Example:
-
Example:
-
-Example:
4-38 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.04-12
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-39
Description
Example:
Example:
4-40 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Call Waiting
This topic describes the Cisco CallManager Express call waiting commands.
Call Waiting
Call waiting customization on the ephone-dn:
Call waiting can be disabled.
A ring notification for call waiting can be
configured instead of a beep notification.
IPTX v2.04-13
For Cisco CallManager Express 3.2 and later, call waiting beeps can be switched on or off for
individual ephone-dns. You can choose to enable or disable the call waiting beeps that are
generated from and accepted by an ephone-dn.
For call waiting notification in Cisco CallManager Express 3.2.1 and later, you can use either a
standard call waiting beep sound through the handset or a short ring.
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-41
IPTX v2.04-14
Call waiting beeps are enabled by default. The command for disabling the beep generation on
an ephone-dn is no call-waiting beep generate. The command for disabling an ephone from
accepting call waiting beeps is no call-waiting beep accept.
If the beep generation of an ephone-dn is disabled, the source ephone-dn does not generate call
waiting beeps to the destination ephone-dn. If the beep acceptance of an ephone-dn is disabled,
that ephone-dn does not play the call waiting beep for the active call.
4-42 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.04-15
You can set up a ring instead of the standard call waiting beep through the configuration of an
ephone-dn. The default is for ephone-dns to accept call interruptions, such as call waiting, and
to issue a beeping sound for notification. To use a ring sound, you must ensure that your
ephone-dns accept call waiting.
After you have ensured that the ephone-dn accepts call waiting, you can configure it to use a
ringing notification with the command call-waiting ring.
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-43
Call Park
This topic describes the Cisco CallManager Express call park commands.
Call Park
User can park
a call at a park
ephone-dn by
pressing the
Park softkey
button
IPTX v2.04-16
Call park allows a Phone user to place a call on hold on a special ephone-dn. This ephone-dn is
used as a temporary parking spot from which the call can be retrieved by anyone on the system.
In contrast, a call that is placed on hold using the Hold button or Hold softkey can be retrieved
only from the extension that placed the call on hold. The special ephone-dn at which a call is
parked is known as a call-park slot. A call-park slot is a floating extension, or ephone-dn, that is
not bound to a physical phone.
Multiple call-park slots can be created with the same extension number. This allows more than
one call to be parked for a particular department or group of people at a known extension
number. For example, at a hardware store, calls for the plumbing department can be parked at
extension 101, calls for lighting can be parked at 102, and so forth. Everyone in the plumbing
department knows that calls that are parked at 101 are for them. When multiple calls are parked
at the same call-park slot number, they are picked up in the order in which they were parked;
that is, the call that has been parked the longest is the first call to be picked up from that callpark slot number.
After at least one call-park slot has been defined and Phones have been restarted, Phone users
are able to park calls using the Park softkey. Phone users who attempt to park a call at a busy
call-park slot hear a busy tone. A Phone user who parks a call can retrieve that call using the
PickUp softkey and the asterisk (*). Phone users other than the one who parked the call can
retrieve the call by pressing the PickUp softkey and the extension number of the call-park slot
that is available on their Phone displays.
Note
In addition to using the Park softkey, the call can be parked by transferring it to the number
of the call-park slot directly.
4-44 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
- -- -
IPTX v2.04-17
Each call-park slot occupies one ephone-dn. During configuration, any number of ephone-dns
can be designated as call-park slots using the park-slot command. The total number of callpark slots plus the normal extensions cannot exceed the maximum number of allowable
ephone-dns for a system. After an administrator defines at least one call-park slot and restarts
the Phones, the Park softkey is displayed on all the IP Phones that are able to display softkeys.
Each call-park slot can hold one call at a time, so the number of simultaneous calls that can be
parked is equal to the number of slots that have been created in the Cisco CallManager Express
system.
To create a call-park slot that is reserved for use by one extension, assign that slot a number
whose last two digits are the same as the last two digits of the extension. When an extension
starts to park a call, the system searches for a call-park slot that has the same final two digits as
the extension; if no such call-park slot exists, the system chooses an available call-park slot.
A reminder ring can be sent to the extension that parked the call. This can be configured by
using the timeout keyword with the park-slot command. The reminder ring is sent only to the
extension that parked the call unless the notify keyword is also used. The notify keyword is
used to specify an additional extension number to receive a reminder ring. When an additional
extension number is specified, the Phone user at that extension can retrieve a call from this slot
by pressing the PickUp softkey and the asterisk (*). If the timeout keyword is not used with
this command, no reminder ring is sent to the extension that parked the call.
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-45
Description
- -
-
Example:
4-46 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IP Phone Display
IP Phone Display
The following features of the IP Phone
display can be customized:
IP Phone header bar
System text message
System display message (idle URL)
IPTX v2.04-18
The display of the IP Phone can be customized to reflect the needs and identity of the enterprise
that is deploying the Cisco CallManager Express system and Phones.
Normally, the IP Phone header bar, or top line, of a Cisco IP Phone 7940G or 7960G replicates
the text that appears next to the first line button. The header bar can, however, contain a userdefinable message instead of the extension number. For example, the header bar can be used to
display a name or the full E.164 number of the Phone. If no description is specified, the header
bar replicates the extension number that appears next to the first button on the Phone.
The system text message replaces the default Cisco CallManager Express message toward
the bottom of the Phone. There is room for about 30 characters to be displayed. The message
appears when the Phone is idle. This occurs under one of the following three conditions:
A busy Phone goes on hook
The Phone receives a keepalive
The Phone restarts
The system display message feature allows you to specify a file to display on 7940G and
7960G Phones when they are not in use. You can use this feature to provide the Phone display
with a system message that is refreshed at configurable intervals, similar to how the system text
message feature provides a message. The difference between the two is that the system text
message feature displays a single line of text at the bottom of the Phone display, whereas the
system display message feature can use the entire display area and can contain graphic images.
The system display message feature requires a back-end web server to serve up the browser
page to the Phone display because the Cisco CallManager Express system only provisions the
URL. The system display message can also provide softkeys for the Phone and thereby take
input from the Phone user for interactive services.
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-47
IP Phone
Header Bar
System Display
Message
IPTX v2.04-19
This graphic shows the different areas on the display of a Phone controlled by Cisco
CallManager Express. These features can be customized for the current implementation.
4-48 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
- -
IPTX v2.04-20
Use the ephone-dn dn-tag command to enter the ephone-dn configuration mode. Next, use the
description command to change the header bar of an IP Phone. A common use of this
command is to enter the direct inward dial (DID) number (if there is one) of the first line. This
allows users to easily see the number that someone on the public switched telephone network
(PSTN) could dial in order to call them on that Phone. However, any text or numbers could be
displayed here.
To create a text identifier instead of a phone-number display for an extension on an IP Phone
console, use the label command.
Note
The Phone must be reset to have any changes to the header bar appear.
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-49
Description
Example:
- -
Example:
Example:
4-50 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
-- -- --
--
IPTX v2.04-21
The system message command allows a message to be displayed on all Phones in the
Cisco CallManager Express system. This message can be alphanumeric text only, and the
message size that is allowed varies based on the Phone model. A common use of this command
is to display the name of the company on all of the Phones.
The url idle command allows the functionality of the system message command to extend to
more than just a text message. The url idle command allows the Cisco CallManager Express
router to point all of the Phones to a URL that resides on a back-end web server. This web
server can then provide content in the form of text, graphics, and interactive applications that
appear on the IP Phones after a definable period of inactivity. These applications are written
using XML. For more information, go to http://www.cisco.com/go/developersupport.
Note
Because the Cisco CallManager Express router asks for credentials, it should not be the
web server that serves the idle URL.
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-51
Description:
- -- --
Example:
-
-- -- - -Example:
-
-
4-52 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
--
IPTX v2.04-22
The Cisco IP Phones 7940G and 7960G have customized function buttons that show the phone
call status and activities on the display panels. These customized function buttons also invoke
programmable services that are not related to calls. There are two buttons that are commonly
modified to link to programmable URLs. This allows the administrator to override any default
settings that may be assigned to the function buttons. The Messages button and the Information
button should not be customized and the Settings button cannot be customized.
Specific URLs are provisioned on the Cisco IP Phone to populate these buttons. The URLs
point to XML-based web pages formatted with XML tags that the Phone understands and uses.
When a function button is pressed, the Phone uses the configured URL to access the
appropriate XML web page for instructions. The web page sends instructions to the Phone to
display information on the screen to be navigated. Options can be selected and information
entered by using softkeys and the scroll button.
The Cisco IP Phones 7940G and 7960G can support four URLs in association with the four
programmable feature buttons on an IP Phone. The four feature buttons on an IP Phone are
configured using the url command keywords. The Settings button cannot be modified.
Operation of these services is determined by the IP Phone capabilities and the content of the
referenced URL.
Note
The Cisco CallManager Express router should not be the web server that serves the URL for
customized function buttons.
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-53
URL Commands
Command
Description
--- --
Example:
-
--- You can disable the local directory by entering the
url directories none command. You must reset
the Cisco IP Phones before the url command can
take effect.
4-54 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Softkey Customization
Softkey Customization
IPTX v2.04-23
For Cisco CallManager Express version 3.2 and later, you can disable and enable IP Phone
softkeys and change the order in which they appear in the displays of individual ephones. This
feature is available on the Cisco IP Phones 7905G, 7912G, 7940G, 7960G, 7970G, and
7971G-GE.
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-55
IPTX v2.04-24
Up to five softkey templates can be created. Each template can include softkey settings for all
or some of the four call states:
Alerting: when the remote point is being notified of an incoming call and the status of the
remote point is being relayed to the caller as either ringback or busy. The softkey options
and their default order in this calling state are as follows:
Acct: Short for
Callback: Requests callback notification when a busy called line becomes free.
Endcall: Ends the current call.
Connected: when the connection to a remote point has been established. The softkey
options and their default order in this calling state are as follows:
Acct: Short for
Confrn: Short for
Idle: before a call is made and after a call is complete. The softkey options and their default
order in this calling state are as follows:
Cfwdall: Short for
Dnd: Short for
4-56 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.04-25
The command ephone-template creates and defines the number of the softkey template. Under
the ephone template the softkey alerting command may be used to change the order of or
delete softkeys that will appear when the Phone is ringing.
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-57
- -
-
IPTX v2.04-26
The command softkey connected allows the softkeys to be modified when a call is currently
connected. The softkey idle command allows the softkeys to be modified when the handset is
on hook and no calls are taking place.
- -
IPTX v2.04-27
The command softkey seized is used to modify the order of or delete softkeys when the handset
is off hook and either a dial tone is being played or digits are being entered on the keypad.
4-58 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Example: SoftkeyCustomization
Default softkey
buttons during
connected state
IPTX v2.04-28
This figure shows the default softkeys during the connected state.
- -
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.04-29
This example shows the connected state with an ephone template applied that changes the order
of the softkeys and how they are displayed.
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-59
The directory
can be
accessed by
pressing the
Directory
button.
IPTX v2.04-30
When a user does not know the number of another subscriber or of a commonly used external
number, the corporate directory on the Cisco CallManager Express system can be accessed to
look up the number for you and connect you to it.
The directory of the Cisco CallManager Express is built and stored on the router from the
configuration. By default, Phone users can access the directory by pressing the Directory button
and selecting the local directory. They can be connected by pressing the Dial softkey when the
number they want is highlighted.
4-60 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.04-31
The Phone user can also access the directory through the Phone user web-based GUI.
IPTX v2.04-32
To add a user to the directory of Cisco CallManager Express, the name field under the
properties of the ephone-dn must be defined. The first and last names should be entered in the
same order that the Cisco CallManager Express is set to use.
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-61
IPTX v2.04-33
The system administrator can also add entries to the directory that represent destinations that
are not IP Phones controlled by the Cisco CallManager Express system. If allowed, the
customer administrator can also configure these options.
The directory may have up to 100 entries added with a maximum digit length of 32 each. The
number of characters in the name is limited to a maximum of 24.
Note
This can be used to enter numbers for another site in the company that is not part of this
Cisco CallManager Express installation.
4-62 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Directory Commands
Directory order and entry
-
-- --
IPTX v2.04-34
The system administrator can configure the order by which the names are listed in the Cisco
CallManager Express directory. The directory command is used to set the systemwide setting
for this. The default is first name first. Entries that represent non IP Phones controlled by Cisco
CallManager Express are entered into the directory from the CLI using the directory entry
command. This can also be done by using the GUI.
The name command is how an identity is associated with the ephone-dn in Cisco CallManager
Express. Enter the name in the same order that was defined using the directory command.
These names will appear in the Cisco CallManager Express directory.
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-63
Directory Commands
Command
Description
--
--
Example:
-
--
Example:
-
Example:
Example:
4-64 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Conferencing
This topic describes conferencing and the commands required for configuration.
Conferencing
Step 3Cisco
CallManagerExpress
sends the mixed
audio result out to the
earpieces of all
attendees of the
conference.
IPTX v2.04-35
Cisco CallManager Express supports three-party conferencing for local and on-net calls. This
feature supports conversion between G.711 mu-law and a-law and between G.711 and G.729.
The maximum number of simultaneous conferences is platform-specific.
For Cisco CallManager Express version 3.2 and later, a person who initiates a conference call
and hangs up can either keep the remaining parties connected or disconnect them.
Note
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-65
Conferencing Configuration
IPTX v2.04-36
4-66 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
-
---
-
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.04-37
The figure shows conferencing that has been configured on the Cisco CallManager Express
router.
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-67
Productivity Tools
Productivity Tools
Productivity tools for Cisco CallManager
Express include:
Flash softkey for hookflash functionality
Intercom
Paging
IPTX v2.04-38
There are various tools that can aid productivity and give needed functionality to many
deployments.
4-68 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.04-39
Certain PSTN services, such as three-way calling and call waiting, require hookflash
intervention from a Phone user. A new softkey labeled Flash has been introduced to provide
this functionality on FXO lines attached to the Cisco CallManager Express system. The Flash
softkey is enabled by using the fxo hook-flash command. Once Flash has been enabled and a
reboot of the IP Phone has been performed, the softkey is available to provide hookflash
functionality during all calls except for local IP Phone toIP Phone calls.
Note
The hookflash-controlled services can be activated only if they are supported by the PSTN
connection that is involved in the call. The availability of the Flash softkey does not
guarantee that hookflash-based services are actually accessible to the Phone user.
Description
Example:
-
-
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-69
Intercom
---
--
---
---
--
--
IPTX v2.04-40
Many deployments want intercoms. The intercom is commonly used between executives and
administrative assistants. Although this is not the only situation in which an intercom is used, it
is the most common.
Cisco CallManager Express supports intercom functionality for one-way and press-to-answer
voice connections using a dedicated pair of intercom ephone-dns on two Phones that speed-dial
each other. When an intercom speed dial button is pressed, a call is speed-dialed to the ephonedn that is the other half of the dedicated pair. The called ephone-dn automatically answers the
call in speakerphone mode with mute activated. This provides a one-way voice path from the
initiator to the recipient.
A beep is sounded when the call is auto-answered to alert the recipient to the incoming call. To
respond to the intercom call and open a two-way voice path, the recipient deactivates the mute
function by taking one of the following actions:
On a multibutton Phone, pressing the Mute button
On a Cisco IP Phone 7910G+SW, lifting the handset
Intercom lines cannot be used in shared-line configurations. If an ephone-dn is configured for
intercom operation, it must be associated with one IP Phone only. The intercom attribute causes
an IP Phone line (ephone-dn) to operate as an auto-dial line for outbound calls and as an autoanswer-with-mute line for inbound calls. The figure shows an intercom between an
administrative assistant and a manager.
Any user can dial the intercom if the number of the intercom can be dialed with the keys that
are present on the Phones. In order to configure an intercom line that cannot be dialed, you can
assign the intercom ephone-dn a dialing string with an alphabetic character of A, B, C, or D. No
one can dial the alphabetic character from a normal phone, but the Phone at the other end of the
intercom can be configured to dial the alphabetic character number through the Cisco
CallManager Express router. For example, intercom ephone-dns can be assigned numbers with
alphabetic characters so that only the receptionist can call managers on their intercom line, and
only managers can call the receptionist on the receptionists intercom line.
4-70 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Note
An intercom requires configuration of two ephone-dns, one for each Phone that makes up
the intercom pair.
Intercom Command
-
-
IPTX v2.04-41
The intercom command is used under the ephone-dn configuration mode; it is used to
configure one half of the intercom pair. There must be another ephone-dn with the intercom
command on it. Then this ephone-dn must be assigned to a line button using the button
command. The IP Phone must be restarted to accept the changes.
Intercom Command
Command
Description
-
- ]
Example:
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-71
Paging Function
One-way voice path
Unicast or multicast
Single group or combined groups
IPTX v2.04-42
Audio paging provides a one-way voice path to the Phones that have been designated to receive
paging. It does not have a press-to-answer option as the intercom feature does. Pages are
commonly used for locating people who are away from their desk, for emergency situations
such as a fire drill, for overhead pages, and other situations.
The paging mechanism supports audio distribution using IP multicast, replicated unicast, and a
mixture of both (multicast is used where possible, and unicast is used for specific Phones that
cannot be reached using multicast).
Paging groups can be configured for a single group or for a combined group. Several paging
groups can be specified in a Cisco CallManager Express system, and two or more paging
groups can be joined into a combined group.
A paging group is created using a dummy ephone-dn, known as the paging ephone-dn, which
can be associated with any number of local IP Phones. The paging ephone-dn can be dialed
from anywhere, including from an on-net location.
When a caller dials the paging number (ephone-dn), each idle IP Phone that has been
configured with the paging number automatically answers using its speakerphone mode.
Displays on the Phones that answer the page show the caller ID that has been set using the
name command under the paging ephone-dn. When the caller finishes speaking and hangs up,
the Phones return to their idle state.
4-72 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
--
--
ephone 1
paging Group 4
Phone dials 4444
ephone 2
paging Group 4
IPTX v2.04-43
The paging feature defines an ephone-dn that sends one-way voice through a unicast or
multicast mechanism to a single group of idle Cisco IP Phones that have been associated
with the paging ephone-dn tag. In this example, when a caller dials 4444, both ephone 1
and ephone 2 receive a page on the speaker of the IP Phone.
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-73
Assign the
paging
extension to
the Phone
IPTX v2.04-44
Paging groups can be set up through the GUI by adding a new paging extension and assigning
it to one or more Phones in the Cisco CallManager Express system.
Note
4-74 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
---
IPTX v2.04-45
To configure a paging directory number, first create the ephone-dn with the command ephonedn tag. Next, use the command paging to configure the ephone-dn as a paging extension. The
paging ephone-dn can then be assigned to the target ephones. By default, the paging command
uses unicast for the pages, and this limits the number of target Phones to ten. If the paging ip
ip_multicast address port udp-port is used, then the page uses multicast and can go out to more
than ten Phones. The configurable range of multicast addresses is 225.0.0.0 through
239.255.255.255.
The use of multicast for paging allows many ephones to receive the same page without generating
a separate stream of traffic for each ephone. In fact, all of the IP Phones in the paging group can
use the same stream, thereby conserving bandwidth, increasing the scalability of the page, and
reducing overhead on the Cisco CallManager Express router.
Note
This assignment to one or more target ephones is done through the use of the paging-dn
command in the ephone configuration mode for one or more ephones. The configuration of
the paging ephone-dn determines whether a page uses a multicast or a unicast mechanism.
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-75
Description
---
Example of unicast:
Example of multicast:
Example:
Ephone1
Paging Group 10
Ephone2
Paging Group 10
Ephone3
Paging Group 20
Ephone4
Paging Group 20
IPTX v2.04-46
By configuring the ability to page combined groups in addition to single groups, Phone users
are provided with the flexibility to page a small local paging group, such as paging two Phones
in a technical support department, or to page a combined set of several paging groups, such as
paging a group that consists of technical support and sales phones.
4-76 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.04-47
The paging-group command is configured under a paging ephone-dn. This allows multiple
paging groups to be combined into larger groups. A common use of this is a systemwide
emergency page.
Combined Paging Group Command
Command
Description
Example:
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-77
IPTX v2.04-48
One of the unique features that can be enabled when IP Phones are used is the ability of the
administrator to make custom rings available for the Phone users. Although this is not a critical
feature, it is a commonly requested feature.
The IP Phone rings can be customized by creating your own pulse code modulation (PCM)
audio files and constructing a custom RingList.xml file.
Cisco IP Phones ship with two default ring types that are implemented in hardware: Chirp1 and
Chirp2. Cisco CallManager Express supports custom ring sounds that are implemented in
software as PCM files. The XML file RingList.xml, which describes the ring list options
available at your site, is needed on the flash of the Cisco CallManager Express router.
The following procedure applies only to creating custom phone rings for the Cisco IP Phone
7940G and 7960G models.
Step 1
Create a PCM file for each custom ring (one ring per file). The PCM files for the
rings must meet the following requirements for proper playback on Cisco IP Phones:
Step 3
Use TFTP to download the new PCM files and XML file to the flash of the Cisco
CallManager Express router.
Step 4
Use the tftp-server command to allow access to the files, for example:
- --
- -
Step 5
Reboot the IP Phones. When IP Phones are rebooted, the IP Phones get the files and
show the ring types in the Ring Type Option list under the Settings button.
The RingList.xml file defines an XML object that contains a list of phone ring types. Each ring
type contains a pointer to the PCM file that is used for that ring type and to the text that will be
displayed on the Ring Type menu of the Cisco IP Phone for that ring. The
CiscoIPPhoneRingList XML object uses the following simple tag set to describe the
information:
<CiscoIPPhoneRingList>
<Ring>
<DisplayName/>
<FileName/>
</Ring>
</CiscoIPPhoneRingList>
In the above definition:
<Ring> contains two fields, DisplayName and FileName, that are required for each phone ring
type. Up to 50 rings can be listed.
DisplayName defines the name of the custom ring for the associated PCM file that will be
displayed on the Ring Type menu of the Cisco IP Phone.
FileName specifies the name of the PCM file for the custom ring to associate with
DisplayName.
The DisplayName and FileName fields must not exceed 25 characters.
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-79
Configuring too many custom rings may cause the Cisco CallManager Express router to
hang or crash.
4-80 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Timer Settings
Timer Settings
- --
- --
IPTX v2.04-49
Description
- --
Example:
-
-
- -Example:
-
-
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-81
Music on Hold
Music on Hold
MOH can be derived from two sources:
Audio file in .wav or .au format
Live audio source via a feed
IPTX v2.04-50
MOH is an audio stream that is played to PSTN and VoIP G.711 callers who are placed on hold
by Phones in a Cisco CallManager Express system. This audio stream is intended to reassure
callers that they are still connected to their call. MOH is not played to local Cisco CallManager
Express Phones that are on hold with other Cisco CallManager Express Phones. These parties
hear a periodic repeating tone instead.
The audio stream that is used for MOH can come from one of two sources: an audio file or a
live feed. If both are configured concurrently on the Cisco CallManager Express router, the
router seeks the live feed first. If the live feed is found, it displaces the audio file source. If the
live feed is not found or fails at any time, the router falls back to the audio file source that was
specified for MOH during configuration.
If the MOH audio stream is also identified as a multicast source, the Cisco CallManager
Express router additionally transmits the stream on the physical IP interfaces of the Cisco
CallManager Express router that is specified during configuration. This permits external
devices to have access to the MOH stream.
An MOH audio stream from an audio file is supplied from a .wav or .au file that is held in
router flash memory. An MOH audio stream from a live feed is supplied from a standard linelevel audio connection that is directly connected to the router through an FXO or ear and mouth
(E&M) analog voice port. The live-feed feature is typically used to connect to a CD jukebox
player. Only one live MOH feed is supported per system.
Caution
4-82 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Phone on Hold
Flash:
MyMohfile.wav
Unicastor Multicast
-
-
Phone on Hold
IPTX v2.04-51
This figure shows a file named MyMoHfile.wav in flash of the Cisco CallManager Express
router. The file is configured to be used for MOH by entering the moh MyMoHfile.wav
command in telephony-service mode. It is currently configured to use the multicast address of
239.23.4.10 for transmission of the MOH.
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-83
- --
---
IPTX v2.04-52
The command moh filename enables MOH from .au and .wav format music files. MOH is
played for G.711 callers and on-net VoIP and PSTN callers who are on hold in a Cisco
CallManager Express system. Local callers within a Cisco CallManager Express system hear a
repeating tone while they are on hold. Audio files that are used for MOH must be copied to the
Cisco CallManager Express router flash memory. An MOH file can be in .au or .wav file
format; however, the file format must contain 8-bit 8-kHz data in a-law or mu-law data format.
To replace or modify the audio file that is currently specified, you must first disable the MOH
capability using the no moh command. The following example shows file1 being replaced with
file2:
Router(config-telephony-service)# moh file1
Router(config-telephony-service)# no moh
Router(config-telephony-service)# moh file2
If a second file is specified without first removing the original file, the MOH mechanism stops
working and may require a router reboot to clear the problem.
Note
4-84 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Description
Example:
-
- --
--
-
Example:
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-85
E&M portfour-wire,
immediate start,
auto-cut-through
Unicastor Multicast
E&M Port
1/1/1
-
-
2005 Cisco Systems, Inc. All rights reserved.
Phone on Hold
IPTX v2.04-53
To configure MOH from a live feed, a voice port and dial peer for the call are established.
A dummy ephone-dn is also created. The dummy ephone-dn must have a Phone or extension
number assigned to it so that it can make and receive calls, but the number is never assigned
to a physical Phone. The recommended interface for live-feed MOH is an analog E&M port
because it requires the minimum number of external components. You connect a line-level
audio feed (standard audio jack) directly to pins 3 and 6 of an E&M RJ-45 connector.
The E&M voice interface card (VIC) has a built-in audio transformer that provides appropriate
electrical isolation for the external audio source. (An audio connection on an E&M port does
not require loop-current.) The signal immediate and auto-cut-through commands disable
E&M signaling on this voice port. A digital signal processor (DSP) on the E&M port generates
a G.711 audio packet stream.
If you are using an FXO voice port instead of an E&M port for live-feed MOH, connect the
MOH source to the FXO voice port. This connection requires an external adaptor to supply
normal telephone company battery voltage with the correct polarity to the tip and ring leads of
the FXO port. The adaptor must also provide transformer-based isolation between the external
audio source and the tip and ring leads of the FXO port.
Music from a live feed is continuously fed into the MOH playout buffer instead of being read
from a flash file, so there is typically a 2-second delay. An outbound call to an MOH live-feed
source is attempted every 30 seconds until the connection is made by the directory number that
has been configured for MOH. If the live-feed source is shut down for any reason, the flash
memory source automatically activates. A live-feed MOH connection is established as an
automatically connected voice call that is made by the Cisco CallManager Express MOH
system itself or by an external source directly calling in to the live-feed MOH port.
Note
MOH is not supported for use in the basic automatic call distribution (B-ACD) script.
4-86 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
If the MOH arrives on an analog port, that FXO or E&M port must be configured. The
command input gain allows the volume of the feed to be tuned up or down on either an FXO
or E&M port. E&M ports require additional configuration. One of these E&M commands is
auto-cut-through, which allows the connection to the feed to be set up even though the source
of the feed will not provide an M-lead response.
Commands for Configuring MOH from a Live Source
Command
Description
Example:
Example:
Example:
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-87
IPTX v2.04-55
The E&M port that MOH arrives on must be configured in four-wire mode. This is done by
entering the operation 4-wire command. E&M ports also need to be configured to proceed
with connecting the call by seizing the line and sending dual tone multifrequency (DTMF)
digits without waiting for any signal from the other side of the connection. This is done with
the command signal immediate.
Commands for Configuring MOH from a Live Source
Command
Description
Example:
-
-
Example:
4-88 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
- -
A dial peer is needed to connect the physical E&M or FXO port to the destination pattern that
will be used to connect to the MOH feed. This is created with the dial-peer voice tag pots
command. The physical voice port that is used is associated with the port command, and the
telephone number that is used is defined by the destination-pattern command.
Commands for Configuring MOH from a Live Source
Command
Description
Example:
Example:
- -
Example:
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-89
Creates an ephone-dn
IPTX v2.04-57
An ephone-dn must be configured with the ephone-dn command. Next, the number of the
source of the MOH feed must be configured with the number command. This configures a
valid extension number for this ephone-dn instance. This number is not assigned to any phone;
it is only used to make and receive calls that contain an audio stream to be used for MOH. The
ephone-dn needs the moh command to use the specified live-feed audio stream as MOH for a
Cisco CallManager Express system. The connection for the live-feed audio stream is
established as an automatically connected voice call. If the out-call keyword is used, the type
of connection can include VoIP calls if voice activity detection (VAD) is disabled. The typical
operation is for the MOH ephone-dn to establish a call to a local router E&M port.
If the out-call keyword is used, an outbound call to the MOH live-feed source is attempted
every 30 seconds until the call is connected to the ephone-dn (extension) that has been
configured for MOH. Note that this ephone-dn is not associated with any physical phone.
If the moh command under the ephone-dn mode is used without any keywords or arguments,
the ephone-dn accepts an incoming call and uses the audio stream from the call as the source
for the MOH stream, displacing any audio stream that is available from a flash file. To accept
an incoming call, the ephone-dn must have an extension or phone number configured for it. A
typical use would be for an external H.323-based server device to call the ephone-dn to deliver
an audio stream to the Cisco CallManager Express system. Normally, only a single ephone-dn
would be configured like this. If there is more than one ephone configured to accept incoming
calls for MOH, the first ephone-dn that is successfully connected to a call (incoming or
outgoing) is the MOH source for the system.
4-90 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Description
Example:
Example:
]
Example:
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-91
Summary
Summary
Call transfer settings can be applied to the system or to the IPPhone.
Call forwarding can be set up for all calls and for busy and ring no answer
situations.
Call waiting can be customized to use the standard beep or a ring or can be
disabled altogether.
Call park may be configured so that a call may be retrieved fromany phone.
The IP Phone display can be customized through labeling the line
in the header, setting an idle text message, or setting an idle URL
to run.
The softkeybuttons on the IP Phone may be customized for the idle, seized,
alerting, and connected states.
The directory can be used to look up Phone users and also to place calls to those
users.
Conferencing settings can be configured so that the originator, when
disconnecting, can either end the conference or let the conference continue.
Productivity tools like hookflash, intercom, and paging add functionality.
Phone rings and timers associated with placing a call can be customized.
MOH is a common feature, critical in most installations, and cancome from a live
feed or a prerecorded sound file.
4-92 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.04-58
Lesson 3
This lesson defines the basic automatic call distribution (ACD) features of Cisco CallManager
Express and how to configure those features.
Objectives
Upon completing this lesson, you will be able to describe the basic ACD features that are
possible within Cisco CallManager Express. This includes the ability to do the following:
Describe and configure ephone hunt groups
Describe and configure logging in to and out of a hunt group through the use of the DND
softkey
Describe and configure the automated logout of an ephone-dn from a hunt group
Describe and configure basic ACD functionality through the use of the B-ACD TCL script
IPTX v2.04-2
Ephone hunt groups provide the ability to direct incoming calls for a specific number
(the ephone hunt-group pilot number) to a defined group of ephone-dns. Incoming calls
are redirected based upon sequential, peer, or longest idle selection criteria.
At the end of hunt groups, a last resort behavior can be defined. This can be either an
ephone-dn or the pilot number for another ephone hunt group.
4-94 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
- -
IPTX v2.04-3
Use the command ephone-hunt to define one of 20 possible hunt groups in Cisco CallManager
Express version 3.2.1 and the method for selecting the destination to which an inbound call will
be sent. The pilot command can be used to define up to two numbers that will activate the hunt
group. To define the set of ephone-dns, use the list command. Up to ten ephone-dns can be put
into the hunt group, and a minimum of two is required.
In a sequential ephone hunt group, ephone-dns ring left to right in the order in which they were
listed when the hunt group was defined. The first number to ring is always the left-most number
in the list.
In a peer ephone hunt group, the first ephone-dn to ring is the number to the right of the
ephone-dn that last rang. Ringing proceeds in a circular manner, left to right, for the number of
hops that was specified when the ephone hunt group was defined.
In a longest-idle hunt group, the first ephone-dn to ring is the number that has been idle for the
longest period of time.
Note
A maximum of ten hunt groups is supported in Cisco CallManager Express version 3.2.
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-95
--
IPTX v2.04-4
At the end of the hunt group, if no ephone-dn that is defined in the list has answered the call,
the incoming call is directed to the destination that is defined by the final command. This
destination can be the pilot number of another hunt group or the number of an ephone-dn.
The timeout command sets the amount of time, in seconds, that an incoming call can ring a
member of the hunt group before hopping to the next target in the hunt group. This is done in
ephone-hunt configuration mode and applies only to a specific hunt group.
Note
Call forwarding settings are ignored for calls that originate from the hunt group.
4-96 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
- -
Specifies that the pilot number for the hunt group will not
register to the H.323 gatekeeper or SIP proxy server
IPTX v2.04-5
To set the preference order for the ephone-dn that is associated with the pilot number of a
Cisco CallManager Express ephone hunt group, use the preference command in ephone-hunt
configuration mode.
To specify that the pilot number for a Cisco CallManager Express peer ephone hunt group
should not register with an H.323 gatekeeper or session initiation protocol (SIP) proxy server,
use the no-reg command in ephone-hunt configuration mode. To return to the default of
registering the pilot number with an H.323 gatekeeper, use the no form of this command.
Note
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-97
IPTX v2.04-6
A redirect, or hop, is the number of times that a call can be sent to the next ephone-dn. The first hop
is considered the movement of the call from the first ephone-dn to the second ephone-dn as defined
in the list command. The last hop always ends at the number configured in the
final command.
The number of maximum hops is configurable from 5 to 20 using the max-redirect number
command. The default is 5. If the maximum number of hops is reached, the call is dropped.
The command max-redirect number sets the maximum number of hops globally. In some
ephone-hunt configurations, the hops command can be used to limit the number of hops within
a specific peer hunt group.
Note
4-98 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
1007
1005
Second choice if
busy or no answer:
go to next
1002
Third choice if
busy or no answer:
go to next
1003
Fourth choice if
busy or no answer:
go to destination
defined by final
command
Final
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.04-7
Sequential hunt groups will use a selection process starting at the left-hand side of the list
command. In this example, the list command has ephone-dns listed in the following order:
1007, 1005, 1002, and 1003. The first call goes to the ephone-dn with extension 1007 if
available. If the timeout expires or 1007 is busy, the call hops to 1005 if it is available. If
ephone-dn 1005 is busy or is not answered within the timeout value, the call hops to 1002 if it
is available. Assuming 1002 is busy or not answered within the timeout value, the call hops to
1003 if available. If 1003 is busy or not answered within the timeout value, the call hops to
whatever destination is defined using the final command. If at any time the max-redirect
setting is exceeded, the call is dropped.
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-99
-
-
IPTX v2.04-8
This figure shows the configuration for the example that was described on the previous page.
4-100 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
1002
1001
1000
1003
Round Robin
Selection
Final
IPTX v2.04-9
In a peer ephone hunt group, the first ephone-dn to ring is the number to the right of the
ephone-dn that last rang. Ringing proceeds in a round robin, or circular, manner from left to
right for the number of hops that was specified when the ephone hunt group was defined.
In this figure, the list command has been configured so that the ephone-dns are defined in the
following order: 1002, 1001, 1000, 1003.
The first incoming call goes to the ephone-dn with extension 1002 if available. Assuming that
ephone-dn 1002 answers the first call, the second call goes to 1001 if available. If 1001 is busy
or the timeout expires, the second call hops to 1000, the next ephone-dn in the list. This
continues until an ephone-dn in the hunt group answers the second call or the hop command
parameter is exceeded and the call uses the destination defined by the final command. If at any
time the max-redirect setting is exceeded, the call is dropped.
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-101
-
-
IPTX v2.04-10
This figure shows the configuration for the example that was described on the previous page.
2nd
1st
3rd
The next call will go to
extension 1002 because it has
the longest idle time.
The second call will go to
extension 1001 and the third
will go to 1003.
1000 is active.
1001
1002
1003
IPTX v2.04-11
The longest idle method for distributing calls to hunt group members uses the idle time of
each member to determine where to send the next incoming call. If the ephone that has been
idle the longest does not answer or is busy, the call hops to the ephone with the second-longest
idle time, and so on. If no members of the hunt group are available, then the destination that is
configured with the final command is used. If the max-redirect setting is exceeded at any time,
then the call is dropped.
4-102 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
-
-
-
IPTX v2.04-12
This figure shows the configuration for the example that is described on the previous page.
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-103
Alerting
IPTX v2.04-13
A member of a hunt group can log in to or log out of all ephone-dns by toggling the Do Not
Disturb (DND) softkey button on the IP Phone. When the hunt group member is in the DND
state, the specific ephone-dn is not considered for any hunt groups that it belongs to. When the
DND softkey is used to remove the DND state, this puts the ephone-dn back into consideration
for any hunt groups that it belongs to.
Note
4-104 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.04-14
To allow Phone buttons that are configured with the feature-ring option to ring when their
Phones are in DND mode, use the no dnd feature-ring command in ephone configuration
mode. To stop the ringing of calls to feature-ring ephone-dns when an IP Phone is in DND
mode, remove the no dnd feature-ring command from the ephone configuration by entering
dnd feature-ring. DND is supported only on Cisco IP Phones that have softkeys, and the
minimum version of Cisco CallManager Express that is required is version 3.2.1.
Note
Although the opposite might seem more intuitive, no dnd feature-ring is the command
that allows the line to ring while the Phone is in the DND state, and the dnd feature-ring
command suppresses rings to Phones that are in the DND state.
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-105
This topic describes how the Cisco CallManager Express system can be configured to
automatically log out an ephone-dn after an attempt to connect to the hunt group member
has not been answered.
IPTX v2.04-15
For Cisco CallManager Express version 3.2.1 and later, an ephone-dn of an ephone hunt group
can be logged out automatically after a call to the ephone-dn is unanswered. A call is considered
unanswered if it rings longer than the period of time configured in the timeout command in
ephone-hunt configuration mode. After an ephone-dn has been logged out, the Phone that is
assigned to it displays the DND indicator.
4-106 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.04-16
Use the command auto logout in the ephone-hunt configuration mode to enable Cisco
CallManager Express to automatically log out a hunt group member if a call from the hunt
group is unanswered.
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-107
B-ACD Service
This topic describes the basic automatic call distribution (B-ACD) service and what it provides.
B-ACD Service
Provides automated attendant and call queuing
functions if no agent is available
Has tools for collecting and obtaining call
statistics
Requires two scripts, one for the automated
attendant function and the other the call queuing
function
Uses Cisco Systems TCL scripts
IPTX v2.04-17
Cisco CallManager Express 3.2.1 and later can provide an automated attendant function and a
call queuing function. These functions are enabled through the use of two Toolkit Command
Language (TCL) scripts. The two functions together provide what is known as the B-ACD service.
The automated attendant function can answer incoming calls and present a basic menu of up
to four options. Commonly presented options include enabling the caller to go directly to an
extension by entering the extension number and to go directly to an operator by pressing 0.
Of the four available options presented in the automated attendant menu, three can point to the
pilot number of an ephone hunt group. The automated function is enabled through
configuration of the automated attendant TCL script.
If a member of the hunt group is unavailable, the second function of the B-ACD service, call
queuing, activates. Call queuing allows calls to be placed in a queue in the order of their arrival.
Then, as members of the hunt group become available, the calls are serviced based on their
order in the queue. The call queuing function is enabled through configuration of the call
queuing TCL script.
4-108 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.04-18
Setting up the B-ACD service requires the configuration of both the automated attendant and
call queuing TCL scripts. In addition to configuring various parameters in the scripts within
Cisco CallManager Express, the dial peers must be configured. This configuration involves
associating an application with the dial peer so that when an outside call arrives and matches
the dial peer, the appropriate automated attendant functions are activated.
The default welcome greeting likely will not be sufficient for most installations of the B-ACD
service. The welcome greeting as well as the other prompts within the service can be customized
to fit specific environments.
By default, the Cisco CallManager Express system does not collect statistics such as average
wait time and calls handled by the hunt group and member. The system must be configured to
collect these and other statistics relevant to the B-ACD service.
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-109
IPTX v2.04-19
The B-ACD automated attendant TCL script must be downloaded from the Cisco.com website,
then loaded into flash using the archive command on the Cisco CallManager Express router.
The needed files are all contained in the file cme-b-acd-2.0.0.0.tar. The command call
application voice application-name flash:tcl-filename is used to define the name of the
automated attendant application as it is referenced in the Cisco IOS configuration, as well as
the name and location of the TCL script in the routers flash RAM to use.
The language of the dynamic prompts that are used by the automated attendant application is
specified with the command call application voice application-name language digit languagecode. The digit parameter can be any number from 0 through 9 and identifies the language that
the audio files are in. The language code parameter can be set to any of the following:
en English
sp Spanish
ch Mandarin
aa all
Note
The default automated attendant prompts are in English only and will need to be customized
for another language
The category and location of the audio files that are used by the application are defined by the
command call application voice application-name set-location language-code category
location. The language code parameter can be set to any of the following:
en English
sp Spanish
ch Mandarin
aa all
4-110 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
The category parameter is a numeric value from 0 through 4, with 0 representing all categories.
For example, audio files representing the days and months could be category 1, audio files
representing units of currency could be category 2, and audio files representing units of time
seconds, minutes, and hourscould be category 3.
The location parameter defines the location of the audio files. Valid locations include local
flash, HTTP servers, FTP servers, TFTP servers, and Real Time Streaming Protocol (RTSP)
servers.
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-111
IPTX v2.04-20
When configuring the automated attendant script, the pilot number is defined by using the
command call application voice application-name aa-pilot pilot-number. The pilot number
is the number that activates the B-ACD service when it is dialed by outside callers.
The number of menu items that point to ephone hunt groups is defined by the command
call application voice application-name number-of-hunt-groups number. This setting can
be from 1 to 3. The default is 3.
The automated attendant script must be associated to the call queue script so that they can work
together. To set up this association, use the command call application voice application-name
service-name call-queue-script-name. For call-queue-script-name, enter the name of the call
queue application as referenced by the IOS configuration, not the name of the TCL script.
4-112 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
-
--
--
IPTX v2.04-21
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-113
--
IPTX v2.04-22
In order to set the maximum time that a call can remain in a queue, use the command
call application voice application-name max-time-call-retry seconds. When a call in a
queue reaches this setting, the call will be disconnected. The range of valid settings is from
0 to 3600 seconds. The default is 600 seconds (10 minutes).
The command call application voice application-name voice-mail number sets the B-ACD
voice-mail pilot number.
To set the number of times that calls can attempt to redial voice mail if all ports are busy, use
the call application voice application-name max-time-vm-retry number command.
4-114 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
-
-
-
-
-
- -
IPTX v2.04-23
This figure shows a configuration of the B-ACD automated attendant TCL script when the
automated attendant application is named AutoAtt.
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-115
IPTX v2.04-24
To associate call queuing with the automated attendant, the call queuing script must be
associated with the name of the automated attendant application. To do this, use the command
call application voice application-name aa-name aa-script-name. For example, if the name of
the call queuing application is Queuing and the name of the automated attendant application is
AutoAtt, then this command would be configured like this: call application voice Queuing aaname AutoAtt.
The command call application voice application-name number-of-hunt-groups number
specifies the number of hunt groups that can be associated with the call queuing function. This
command defines how many queues the call queuing function will manage. The range is 1 to 3.
The default is 3.
To associate the pilot number of an ephone hunt group to a menu option, use the command call
application voice application-name aa-huntmenunumber pilot-number. Repeat this command
for each menu option that will be presented to the caller, up to the maximum of three.
4-116 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.04-25
The command call application voice application-name queue-len number is used to set the
maximum number of calls that are allowed in the queue of each hunt group.
For troubleshooting and to obtain debugging information, you must enable the collection of call
queuing data by using the command call application voice application-name queue-managerdebugs 1. This command enables debugging, but it does not start the debug. Use a value of 0 to
disable the collection of debugging information.
Note
To start the debug, use the command debug voip ivr script.
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-117
-
-
IPTX v2.04-26
This figure shows a configuration of the B-ACD call queuing TCL script when the call queuing
application is named Queuing.
4-118 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
-
---
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.04-27
For the B-ACD service to function, the automated attendant application must be associated
with one or more dial peers. To set up this configuration, use the command application
application-name in dial-peer configuration mode for each dial peer that is to be associated
with the automated attendant application. The dial peers can be Voice over IP (VoIP) or plain
old telephone service (POTS). In the figure, the automated attendant application called AutoAtt
will activate when outside calls arrive at either the POTS or the VoIP dial peer.
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-119
IPTX v2.04-28
The Cisco CallManager Express B-ACD service uses seven audio files. You can rerecord these
audio files to customize them. However, you cannot change the names of the files and you
cannot determine when the files are played to callers. These seven files must then be loaded
into the flash of the CallManager Express router that is running the B-ACD script.
4-120 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
The following is a list of the seven files and their default messages:
Default B-ACD Audio Files
File Name
Message
en_bacd_welcome.au
en_bacd_options_menu.au
en_bacd_disconnect.au
We are unable to take your call at this time. Please try again at a
later time. Thank you for calling. Includes a 4-second pause after the
message.
en_bacd_invalidoption.au
You have entered an invalid option. Please try again. Includes a 1second pause after the message.
en_bacd_enter_dest.au
Please enter the extension number you want to reach. Includes a 5second pause after the message.
en_bacd_allagentsbusy.au
Each of the menu options listed in the en_bacd_options_menu.au file must provide callers with
a number that can pressed. For example, if the following is the automated attendant and call
queuing configuration:
call application queue number-of-hunt-groups 3
call application queue aa-hunt1 1111
call application queue aa-hunt2 2222
call application aa dial-by-extension-option 3
Then the en_bacd_options_menu.au could be recorded to say the following:
Welcome to Company X.
Press 1 to reach department 1. (System dials pilot number 1111.)
Press 2 to reach department 2. (System dials pilot number 2222.)
If you know your partys extension, press 3. (Permits caller to dial an extension directly.)
The Cisco CallManager Express B-ACD prompts require a G.711 audio file (.au) format with
8-bit, mu-law, and 8-kHz encoding. Cisco recommends the following audio tools or others of
similar quality:
Adobe Audition for Microsoft Windows by Adobe Systems Inc. (formerly Cool Edit, by
Syntrillium Software Corp.)
AudioTool for Solaris by Sun Microsystems Inc.
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-121
IPTX v2.04-29
This figure shows a typical call to the pilot number of the B-ACD service.
IPTX v2.04-30
In order to report on the operation of the B-ACD service, the collection of B-ACD statistics
must be enabled. The statistics can then be displayed using show commands. In addition,
the statistics can be periodically written to a TFTP server, from which an administrator or
third-party applications can access the information.
4-122 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
---
---
IPTX v2.04-31
To enable the collection of call statistics, the command statistics collect must be entered under
all relevant hunt groups. The figure shows statistic collection being enabled for ephone hunt
group 1.
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-123
- - --- - - --- - -
IPTX v2.04-32
The command show ephone-hunt displays the collected statistics of a hunt group.
The following output is an example of what might be displayed by the show ephone-hunt
statistics last 2 hours command:
-
-
-
-
- --
- - --
--
- --
--
---
- -
--
- --
- -
--
- --
4-124 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
- -
--
- --
---
- -
- - -
-
- --
- - --
-
--
-
- -
-
-
---
- -
- - -
-
- --
- - --
-
--
-
- -
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-125
--
-
IPTX v2.04-33
The commands that govern the automated writing of call statistics to a TFTP server are listed
on this page.
The command hunt-group report url prefix tftp://url-address/directory-name is used to
define the location to which the files will be written and the starting prefix of the name of the
file or files.
Note
The files that are referenced must exist and be able to be written to.
The command hunt-group report url suffix from-number to to-number is used to define a
numeric suffix that must be present on the end of files on the TFTP server. The from-number
must be either 0 or 1 and the to-number can be from 1 through 200.
The combination of the two hunt-group report url commands determines the names of the
files that must be present on the TFTP server. The prefix determines the start of the filename
and the suffix determines the numeric values that reside on the end. The extension of the file is
not mandated by these commands.
To set the hourly interval at which B-ACD statistics will be collected and written to files, use
the command hunt-group report every number hours. The range is from 1 through 84 hours.
4-126 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
To delay data collection for one to ten hours, use the command hunt-group report delay
number hours. Data collection delay might be desirable because calls are counted when they
end. For example, a call is connected from 1:35 p.m. to 3:30 p.m. If the data collection interval
is set to 1 (every hour with no delay), TFTP will write the 1 p.m. to 2 p.m. statistics at 2 p.m.
However, at 2 p.m., the 1:35 p.m. call is still active, so it will not appear in the TFTP report.
When the call finishes at 3:30 p.m., it will then be counted as occurring from 1 p.m. to 2 p.m.
The show hunt-group command will report this, but TFTP will have already sent out its report
for the 1 p.m. to 2 p.m. time slot. To include the 1:35 p.m. call in the TFTP file, the huntgroup report delay number hours command could be used to delay TFTP statistics reporting
for an extra two hours so that the 1 p.m. to 2 p.m. report will be written at 4 p.m. instead of 2
p.m.
Note
The file that is written is a comma separated values (CSV) file and is not user-friendly. There
are third-party applications that can decode the output.
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-127
10.10.0.99
-
-
At 19:00, statistics have been collected for 40 minutes; no statistics have been
sent because it is less than the configured 3 hours.
At 20:00, statistics have been collected for 1:40 hours; no statistics have been
sent because it is less than the configured 3 hours.
At 21:00, statistics have been collected for 2:40 hours; no statistics have been
sent because it is less than the configured 3 hours.
At 22:00, statistics have been collected for 3:40 hours; however, because of the
delay command, the statistics will not be written to a file until 23:00.
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.04-34
This example sets up the hunt-group report mechanism to use TFTP to send call statistics every
three hours to the files data000 through data200 that are located on the TFTP server at IP
address 10.10.0.99 under a directory that is named dirdata1. A delay of one hour has been
configured.
Before the statistics can be written to a file, statistics collection has to take place for at least
three hours. In addition, a one-hour delay has been inserted. The following is a chronology of
events that take place under the configured parameters if statistics collection begins at 18:20:
At 19:00, statistics collection has been active for 40 minutes; no statistics are written to the
file because it is less than the configured three hours.
At 20:00, statistics collection has been active for one hour and 40 minutes; no statistics are
written to the file because it is less than the configured three hours.
At 21:00, statistics collection has been active for two hours and 40 minutes; no statistics are
written to the file because it is less than the configured three hours.
At 22:00, statistics collection has been active for three hours and 40 minutes; sufficient
time has passed, but because of the configured one-hour delay, the statistics will not be
written to a file on the TFTP server until 23:00.
4-128 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Summary
Summary
Ephone hunt groups contain members.
The hunt group member can be selected based upon a
sequential, peer, or longest idle criteria.
Members can log in to or log out of a hunt group by using the
DND softkey button.
If a member of a hunt group does not answer the call, the
Cisco CallManagerExpress system can be configured to log
out the member automatically.
The B-ACD service is composed of automated attendant and
call queuing functions.
The B-ACD service can be customized to fit the needs of the
deployment.
Statistics concerning B-ACD service calls can be gathered
and written to a file on a TFTP server.
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-129
IPTX v2.04-35
4-130 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Lesson 4
This lesson defines the productivity tool called the Cisco IOS Telephony Service Provider
(TSP) and how it can be used to interact with Cisco IP Phones.
Objectives
Upon completing this lesson, you will be able to describe Telephony Application Programming
Interface (TAPI) Lite support for Cisco CallManager Express. This includes being able to
meet these objectives:
Describe Cisco IOS TSP functions and software features
Describe tasks to download and set up Cisco IOS TSP
Describe how to view the TAPI integration status of IP Phones
Identify the steps for modifying and removing a TSP configuration on the PC
Describe the function of and tasks needed to configure an integration of Cisco CallManager
Express and Microsoft CRM
This topic describes functions and features of the Cisco IOS TSP.
IPTX v2.04-2
Cisco CallManager Express provides an interface that enables simple one-to-one remote
control of a Cisco IP Phone by an associated PC that is running the Cisco IOS TSP. This
interface is intended to support only basic TAPI services and to enable screen popups of caller
IDs for incoming calls. It also supports simple outgoing call placement using one-click
address bookstyle speed dialing from the PC application.
The Cisco IOS TSP software package works as an interface between the TAPI that is running
on Microsoft Windows and the Cisco CallManager Express router. This software can provide
the following functionality:
Communicates with the TAPI using the TSP interface (TSPI)
Implements a required set of application program interfaces (APIs) and works with TAPI
Enables other TAPI-based applications to provide call control to the Cisco IP Phones that
are connected to the Cisco CallManager Express router
Cisco IOS TSP software increases personal productivity by enabling call handling management
from a PC without the user having to pick up a Phone handset or dial numbers on the Phone keypad.
4-132 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
This software does not add full TAPI support for multiple users or for the multiple call
handling that is required to implement such complex features as automatic call distribution
(ACD) and IP Contact Center (IPCC).
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-133
IPTX v2.04-3
Ensure that there is network connectivity between the PC and the Cisco CallManager Express
router. To verify network connectivity, enter the ping ip-address command on the PC,
specifying the IP address of the Cisco CallManager Express router.
Install CiscoIOSTSP1.3.zip by running the setup program that was downloaded. This program
installs the following dynamic link library (DLL) files in the system directory of the PC:
CiscoIOSTSP.tsp
CiscoIOSTUISP.dll
LogTrace.dll
Note
After the DLL files are installed, the Cisco IOS TSP configuration dialog box appears before
the installation is complete.
4-134 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.04-4
When this configuration dialog box appears, the user must enter information into the
required fields.
Step 1
Step 2
Enter the IP address and port number of the Cisco CallManager Express router.
Step 3
The Synchronous Message Timeout response from the Cisco CallManager Express
router may be set (the default is 3 seconds).
Step 4
If you are using a headset, check the Using Headset check box.
Step 5
Check the Trace check box to enable tracing for troubleshooting purposes. It is best
to use the trace feature only temporarily because the trace function slows down the
TAPI application.
When prompted, restart the PC. Once the PC has rebooted, a third-party application may be
implemented to control the Phone and interact with the Cisco IOS TSP.
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-135
This topic describes how to view the Cisco IOS TSP configuration on the router.
- -
- -- -
- --
--
IPTX v2.04-5
After the installation of the Cisco IOS TSP is completed and the PC is rebooted, the status
of the TAPI integration can be verified by using the show ephone tapiclients command
from privileged executive mode. The MAC address and ephone are displayed as well as
the credentials used to register with the Cisco CallManager Express router. The status of
the Phone is also shown.
4-136 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
This topic describes how to modify the Cisco IOS TSP configuration on the PC.
IPTX v2.04-6
To modify a TSP configuration, click the Phone and Modem option from the
PC Control Panel. (Note: The name of this option may vary, depending on the
operating system.)
Step 2
Click the Advanced tab in the Phone and Modem Options dialog box. Cisco IOS
Telephony Service Provider is in the Providers list.
Step 3
Step 4
Make the changes that are desired in the Cisco IOS Telephony Service Provider
dialog box.
Step 5
Restart TAPI applications and restart the PC if prompted to do so. After changing
the username, password, and IP address or port of the Cisco IOS TSP, close all the
TAPI applications for the changes to take affect. If any services that depend on the
TSPsuch as Remote Access Connection Managerare running, restart the system
for the changes to take affect. There might be a prompt to reboot the system.
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-137
IPTX v2.04-8
To remove the Cisco IOS TSP from the PC, follow these steps:
Step 1
Click the Phone and Modem option from the PC Control Panel. (Note: The name of
this option may vary, depending on the operating system.)
Step 2
Click the Advanced tab in the Phone and Modem Options dialog box. Cisco IOS
Telephony Service Provider is in the Providers list.
Step 3
4-138 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
This topic describes the integration of Cisco CallManager Express and the Microsoft Business
Solution Customer Relationship Management (Microsoft CRM) product.
IPTX v2.04-9
One of the most compelling applications that can be integrated with Cisco CallManager
Express through the use of the Cisco IOS TSP is the Microsoft CRM. An integrated CRM
solution enables the company to more efficiently and effectively address customer needs and,
by doing so, build profitable customer relationships.
The Cisco CRM Communications Connector (CCC), which was developed with technical
information and feedback from Microsoft, allows the quick and easy integration of Microsoft
CRM and Cisco CallManager Express with no additional hardware required. Additionally, the
full line of Cisco IP Phones is supported, from the entry-level Cisco IP Phone 7902G to the
advanced Cisco IP Phone 7970G. The Cisco CCC uses Microsoft Outlook or IE as the primary
client for managing tasks and contacts.
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-139
IPTX v2.04-10
The Cisco CCC empowers small- to medium-sized businesses and branch offices to fully tap
the potential of both Microsoft and Cisco to provide a complete CRM solution.
4-140 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.04-11
In order for the integration of Cisco CallManager Express and Microsoft CRM to be complete,
three pieces of software need to be installed. The Cisco CCC server installation file needs to be
installed on the Microsoft CRM server. The other two files need to be installed on the PC of the
CRM client. The Cisco IOS TSP needs to be installed first, then the Cisco CCC client software
can be installed. Supported client PC operating systems include the following:
Window 98 Second Edition
Windows 2000 Server
Windows 2000 Professional
Windows XP Professional
Windows XP Home
The client PC must also meet the following minimum requirements:
Microsoft .NET framework 1.1
IE 5.5 with service pack 2 for web interface
Tip
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-141
Summary
Summary
The Cisco IOS TSP enables a PC to have a
one-to-one relationship with a Phone.
A Phone can be controlled through the PC.
To install the Cisco IOS TSP, the username and
port must be collected prior to installation.
The status of an IP Phone TAPI integration may be
viewed on the Cisco CallManagerExpress router.
After installation, modifying the Cisco IOS TSP is
accomplished through the Control Panel under
Phone and Modem Options.
4-142 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.04-12
Lesson 5
Describing Network
Management for Cisco
CallManager Express
Overview
This lesson defines network management features that can be used to monitor, maintain, and
configure the Cisco CallManager Express system.
Objectives
Upon completing this lesson, you will be able to describe setup utility, syslog, and billing. This
includes being able to meet these objectives:
Describe and configure syslog
Describe billing support
Describe CDRs
Describe the Cisco CNS configuration engine
This topic describes Cisco CallManager Express syslog messages and Management
Information Bases (MIBs).
IPTX v2.04-2
One of the additional network management features that Cisco CallManager Express supports
is the type 6 syslog messages for IP Phone registration and unregistration. These syslog
messages help the central network management systems manage Cisco CallManager Express
and IP Phones. These messages usually go to a remote syslog server for long-term collection
and analysis.
5-144 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.04-3
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 5-145
Billing Support
Billing Support
Billing support is through the use of an
account code field in the CDRs.
The account code field is added through the use of
the Acct softkey during the call alerting or
connected state.
The account code field can be used by a RADIUS
server or customer billing server.
The account code is added into the Cisco-VOICEDIAL-CONTROL-MIB.
IPTX v2.04-4
An account code field can be placed into the CDRs, which can then be used by a
RADIUS server or customer billing server for billing processes. The Acct softkey is
added to the Cisco IP Phones 7940G and 7960G so that users can enter account codes
from an IP Phone during call alerting or connected state. This account code is also added
into the Cisco-VOICE-DIAL-CONTROL-MIB.
5-146 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 5-147
IPTX v2.04-5
5-148 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.04-6
To enter an account number with the CDR for this call, select the softkey button named more.
On the next screen, select the Acct softkey button, either during call setup or in the connected
state. This places the call on hold until the account code has been entered. With the call on
hold, enter the account number followed by the pound (#) key to tell the system not to wait for
the interdigit timeout. The call is reconnected, and the account code is inserted into the CDR.
Tip
For partner applications that may use the billing information, see the following URL:
http://forums.cisco.com/eforum/servlet/IPCApps?page=Application_Search
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 5-149
CDR
CDR
The call history log is enabled by default on
Cisco CallManager Express and allows CDRs
to be displayed in the GUI.
Use dial-control-mib to log call history to the buffer
Use the logging command to send the call history to
an external syslogserver
-
--
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.04-7
CDRs are created by default in the Cisco CallManager Express system, and these records
contain the starts, stops, attempts, failures, and other information regarding all the calls in the
system. These records can be sent to a syslog server.
5-150 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
CNS
Cisco CallManager Express Auto-Provisioning
with CNS Configuration Engine
CNS Configuration
Engine
HTTP
HTTP
WAN
Cisco
CallManager
Express
Cisco
CallManager
Express
IPTX v2.04-8
The Cisco Networking Services (CNS) Configuration Engine is a secure network product that
supports the activation of customer premises equipment (CPE)based network services through
centralized template-based configuration management. The CNS Configuration Engine
provides a scalable infrastructure for managing the large-scale deployment of Cisco Systems
devices. It takes full advantage of the CNS Intelligent Agent technology of Cisco IOS software
and can manage as many as 5000 Cisco CPE products, including Cisco CallManager Express
and Cisco switches.
Using Secure Socket Layer (SSL) to interface with Cisco IOS software devices, the CNS
Configuration Engine provides an end-to-end zero-touch deployment solution for the entire
portfolio of Cisco IOS CPE products. The CNS Configuration Engine offers a programmatic
interface to the operations support systems of the customer using the CNS Software
Development Kit.
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 5-151
- - -- - --
-
IPTX v2.04-9
To set up the Cisco CallManager Express router to get its configuration from the CNS
Configuration Engine, some minimal configuration is required. This configuration includes
assigning a MAC address that will be matched to a CNS Event ID and a CNS Config ID on the
CNS Configuration Engine. The IP address of the CNS Configuration Engine server is
specified with the cns config command, and this address must be reachable by the router.
IPTX v2.04-10
The device that is configured is entered into the CNS Configuration Engine server and is
defined by a MAC address. A template or file can then be assigned to configure the device
upon initialization.
5-152 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
The template can be manually added or uploaded from a text file.Unique variables
such as hostnames, passwords, and extension numbers can also be set for
individual Cisco CallManager Express routers.
The template is defined in XML format. The XML parser that is built into Cisco IOS
software interprets and applies configuration to the Cisco CallManager Express
router.
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.04-11
The template that is used with a device can be customized in the Configuration Engine, then
assigned to the device. This is implemented through the use of an XML format that allows for
unique values to be assigned per device, which lets one template be used for multiple devices.
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 5-153
Summary
Summary
There are syslog messages that deal with
registrations of Phones.
The MIBs that are supported provide a way to
collect CDRs, call legs, dial peers, and information
about the system.
Account numbers that are inserted in the CDRs
and MIBsprovide a mechanism by which billing
functions can be performed.
CNS provides a way to bulk-manage and provision
many Cisco CallManager Express systems.
IPTX v2.04-13
Reference
For additional information, refer to Cisco CallManager Express 3.2.1 System Administrators
Guide: Overview at
http://cisco.com/en/US/products/sw/iosswrel/ps5207/products_feature_guide_chapter09186a00
802d2476.html
5-154 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Module Summary
This topic summarizes the key points that are discussed in this module.
Module Summary
This module defines additional features that can be
installed and configured to enhance a basic Cisco
CallManager Express installation.
This module defines how to install, monitor, and
customize the call center features of the B-ACD
service.
This module defines how to install, modify, and
remove the TAPI software.
This module defines the various management
features of Cisco CallManagerExpress.
IPTX v2.04-1
Reference
For additional information, refer to these resources:
Cisco CallManager Express 3.2: Overview.
http://cisco.com/en/US/products/sw/iosswrel/ps5207/products_feature_guide_chapter09186
a00802d2476.html.
Cisco CallManager Express 3.2: Configuring Cisco CME PhoneFeatures .
http://cisco.com/en/US/products/sw/iosswrel/ps5207/products_feature_guide_chapter09186
a00802d241a.html.
Cisco CallManager Express 3.2: Configuring an Attendant for Primary Call Coverage .
http://cisco.com/en/US/products/sw/iosswrel/ps5207/products_feature_guide_chapter09186
a00802d23d1.html.
Cisco IOS TCL IVR and VoiceXML Application Guide:Configuring Audio File Properties
for TCL IVR and VoiceXML Applications.
http://www.cisco.com/univercd/cc/td/doc/product/software/ios122/122newft/122t/122t11/iv
rapp/ivrapp03.htm.
Cisco CallManager Express 3.2: Configuring Productivity Tools.
http://www.cisco.com/en/US/partner/products/sw/iosswrel/ps5207/products_feature_guide
_chapter09186a00802d2544.html.
Cisco CallManager Express 3.2 System Administrators Guide: Overview.
http://cisco.com/en/US/products/sw/iosswrel/ps5207/products_feature_guide_chapter09186
a00802d2476.html.
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-155
Module Self-Check
Use the questions here to review what you learned in this module. The correct answers and
solutions are found in the Module Self-Check Answer Key.
Q1) What are the three different levels of access to the web-based interface in Cisco
CallManager Express? (Choose three.) (Source: Configuring Cisco CallManager
Express GUI Features)
A) custom administrator
B) system administrator
C) Phone user
D) root administrator
E) end user
F) customer administrator
Q2) Which answer best describes the steps required to configure the web-based GUI?
(Source: Configuring Cisco CallManager Express GUI Features)
A) Enable the administrative credentials by setting the enable password on the
Cisco CallManager Express router.
B) Load the proper files into the web directory on the Microsoft IIS server, then
set credentials on the Cisco CallManager Express router.
C) Load the proper files in flash, enable the HTTP server to use flash, and
configure administrative credentials on the Cisco CallManager Express router.
D) Load the HTTP server on the Cisco CallManager Express router, then use the
enable password as credentials.
E) Enable the telephony service on the Cisco CallManager Express router with a
virtual directory to the Apache web server, then configure a valid username
and password on the web server.
Q3) Which of the following best describes access to the GUI web pages? (Source:
Configuring Cisco CallManager Express GUI Features)
A) The system administrator and customer administrator use the ccme.html page,
whereas the Phone users use the ccmeuser.html.
B) All levels of access use the same page URL.
C) The system administrator uses ccme.html, the customer administrator uses
ccmecustomer.html, and the Phone user uses the ccmeuser.html.
D) The GUI is only for the customer administrator and the Phone user.
Q4) Which command is used to load and parse an XML file to customize the customer
administrator web pages? (Source: Configuring Cisco CallManager Express GUI
Features)
A)
B)
C)
D)
4-156 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Q5) Which three of the following describes the xml.template file? (Choose three.) (Source:
Configuring Cisco CallManager Express GUI Features)
A) It is the template that can be used to construct a customized customer
administrator.
B) It can be used to customize the Phone user web page.
C) It is modified with a text editor.
D) It cannot be used without editing.
Q6) Which two of the following describe how a Phone user
s credentials can be
configured? (Choose two.) (Source: Configuring Cisco CallManager Express
GUI Features)
A) From the GUI, select the user drop-down menu and configure the username
password pair.
B) Select
Phone in the GUI menu and define a username and password.
C) From the CLI under the ephone, define the username and password.
D) From the CLI in the telephony-service mode, enter a username and password.
Q7) Which answer best describes the transfer commands? (Source: Configuring Phone
Features)
transfer system command overrides the transfer mode command, which
overrides the transfer pattern command.
B) The
transfer command is used only when the Phones do not support the
H.450.2 protocol.
C) The
transfer commands are for Phones that support the H.450.3 protocol.
D) The
transfer pattern command overrides the transfer mode and transfer
system commands.
A) The
Q8) Which answer best describes the blind option with the
(Source: Configuring Phone Features)
call-forward max-length
Q11) Select three different ways to customize the display of the IP Phone. (Choose three.)
(Source: Configuring Phone Features)
A) IP Phone header bar
B) system text message
C) system idle URL
D) system display message
Q12) The ability to have a graphic displayed on the screen during idle period is configured
through which command? (Source: Configuring Phone Features)
A) Router(config-ephone-dn)#
descriptionhttp://10.1.1.1/logo/logo.htmltimeout 10
B) Router(config-ephone-dn)#
system message http://10.1.1.1/logo/logo.html
timeout 10
C) Router(config-telephony-service)#
system display
http://10.1.1.1/logo/logo.html timeout 10
D) Router(config-telephony-service)#
url idle http://10.1.1.1/logo/logo.html
timeout 10
Q13) Select the three statements that are correct regarding the Cisco CallManager Express
directory. (Choose three.) (Source: Configuring Phone Features)
A) can be accessed through the Phone user web page
B) can be accessed through the 7940G and 7960G IP Phones
C) can be customized to display either the first name first or the first name last
D) is stored in an LDAP directory, like Active Directory or DC Directory
E) can be configured with information regarding the physical location of the user
Q14) To configure an entry that does not directly map to an ephone, which command would
be used? (Source: Configuring Phone Features)
A) (config-telephony-service)#
B) (config-telephony-service)#
C) (config-telephony-service)#
D) (config-telephony-service)#
E) (config-telephony-service)#
nameJohn Smith
directory entry nameJohn Smith
directory nameJohn Smith
directory entry7 2065671234 name John Smith
nameSmith John
Q15) When is the Flash softkey button on a Cisco IP Phone used? (Source: Configuring
Phone Features)
A) for call waiting when another IP Phone in the Cisco CallManager Express
system calls
B) to take a screenshot of the Phone
s display and save it in flash of the
Cisco CallManager Express router
C) to enable hookflash functionality when communicating across FXO ports
to the CO
D) to enable hookflash functionality when communicating across FXS ports to
analog devices
E) to view the contents of flash on the Cisco CallManager Express router, which
will show the rings that are available
4-158 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Q16) Which statement best describes the difference between an intercom and a paging
group? (Source: Configuring Phone Features)
A) The intercom opens a one-way audio conversation with the target muted to
start; by removing the mute, a two-way audio conversation is started, whereas
the paging group is always one-way audio to the speakerphone.
B) The intercom is simply a paging group with only one target.
C) A paging group is supported only through an analog overhead speaker system,
whereas the intercom is implemented on the IP Phone speaker.
D) The intercom always opens a two-way conversation, whereas the paging can be
either one-way or two-way, depending on configuration.
Q17) Paging can be transmitted to the target Phones through which two of the following?
(Choose two.) (Source: Configuring Phone Features)
A) unicast to the IP of the Phone
B) multicast to the 224.0.0.0
224.255.255.255 range
C) multicast to the 225.0.0.0
239.255.255.255 range
D) broadcast to the 255.255.255.255 address
E) special address of 256.0.0.0
F) multicast range of 224.0.0.0
239.255.255.255
Q18) Based on the following scenario, select the best solution: (Source: Configuring
Phone Features)
A customer has Cisco CallManager Express. There are two departments within the
company: sales and customer support. The company wishes to have the ability to page
a salesperson or customer support representative independent of each other. However,
the company also wishes to have the ability to page both sales and customer support
buildingwide for emergency purposes.
A) Configure three paging groups: sales, support, and emergency. On the sales
ephones, use the paging-dn command twice: once for the sales paging group
and once for the emergency paging group. On the support Phone, set two
paging groups: one for the support paging group and one for the emergency
paging group.
B) Configure three paging groups: sales, support, and emergency. On the sales
ephones, use the paging command twice: once for the sales paging group and
once for the emergency paging group. On the support Phone, set two paging
groups: one for the support paging group and one for the emergency paging
group.
C) Configure three paging groups: sales, support, and emergency. For the
emergency ephone-dn, use the paging-group command to have both the sales
and support paging groups under it. On the sales ephones, use the paging-dn
command once for the sales paging group. On the support Phone, set the
support paging group.
D) Configure three paging groups: sales, support, and emergency. For the
emergency ephone-dn, use the page-group command to have both the sales
and support paging groups under it. On the sales ephones, use the paging
command once for the sales paging group. On the support Phone, set the
support paging group.
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-159
Q19) Which steps are required to customize the rings on Cisco CallManager Express
controlled IP Phones beyond the two default rings? (Source: Configuring Phone
Features)
A) Create one or more .raw PCM ring files, load the ring file to flash on the
Cisco CallManager Express router, reboot the Phones, and select the new ring
on the Phone.
B) Create one or more .raw PCM ring files, construct a RingList.xml file, upload
both the rings and the RingList.xml to flash on the Cisco CallManager Express
router, configure the TFTP server to serve up the files, reboot the IP Phones,
and select the ring on the Phone.
C) Create one or more .mp3 ring files, load the ring file to flash on the
Cisco CallManager Express router, reboot the Phones, and select the new ring
on the Phone.
D) Create one or more .raw PCM ring files, construct a RingList.xml file, upload
both the rings and the RingList.xml to flash on the Cisco CallManager Express
router, configure the FTP server to serve up the files, reboot the IP Phones, and
select the ring on the Phone.
E) Create an .mp3 less than 2 seconds long, upload the ring to flash, and reload
the router and the Phone.
Q20) Which three statements are correct regarding MOH? (Choose three.) (Source:
Configuring Phone Features)
A) MOH can come from up to five different files stored in flash.
B) MOH files can be in .au, .wav, or .mp3 format.
C) MOH can be unicast or multicast.
D) MOH can come from a live audio source via an E&M interface.
E) MOH can come from a live audio source via an FXO interface.
Q21) Which is the valid command to enable MOH from a file in flash? (Source: Configuring
Phone Features)
A) (config)#
mohMozart.wav
B) (config-telephony-service)#
mohMozart.wav
C) (config)#
moh ip multicast224.0.0.1 Mozart.wav
D) (config-telephony-service)#
moh ip multicast225.0.0.1 Mozart.wav
E) (config)#
multicast225.0.0.1mohMozart.wav
F) (config-telephony-service)#
multicast224.0.0.1mohMozart.wav
Q22) Which definition best describes the Cisco IOS TSP? (Source: Defining TAPI Support
for Cisco CallManager Express)
A) a limited implementation of TAPI
B) a full implementation of TAPI
C) the same TAPI that is used in Call Centers that provides for multiple line
appearances
D) installed on the Cisco CallManager Express router and runs in RAM of
the router
4-160 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Q23) Which three items of information are needed during the installation of the Cisco IOS
TSP? (Choose three.) (Source: Defining TAPI Support for Cisco CallManager Express)
A) the IP address of the Cisco CallManager Express router
B) the port number of the Cisco CallManager Express service on the router
C) the enable password of the Cisco CallManager Express router so that
configuration changes can be applied
D) username and password that match the Phone user
s credentials
Q24) After the initial installation, how is access to the configuration of the Cisco IOS TSP
achieved? (Source: Defining TAPI Support for Cisco CallManager Express)
A) through the Control Panel of Windows
B) through the Control Panel of Windows, then in the Phones and Modem Options
section
C) by going to c:\program files\cisco\setup.exe
D) from the CLI of the Cisco CallManager Express router, which will use Java to
push the changes to the PC
Q25) Which steps are necessary for uninstalling the TSP? (Source: Defining TAPI Support
for Cisco CallManager Express)
A) Run the uninstall.exe in the path where installed, then delete the .dll files in the
system32 file.
B) Remove the TSP from the Phone and Modem Options section of the Control
Panel, then uninstall it using Add or Remove Programs in the Control Panel.
C) Delete the Cisco folder under the program files directory.
D) From the softphone, select
Add or Remove Components, which starts the
installation screen, then select Remove when prompted and reboot the PC.
Q26) Which of the following statements best describe the setup utility in Cisco CallManager
Express? (Source: Describing Network Management for Cisco CallManager Express)
A) inserts Phones automatically in the Cisco CallManager Express router without
having to define the phone numbers
B) allows the Cisco CallManager Express to auto-discover the devices that are
available and to configure them with Cisco best practices
C) a macro of questions, invoked and answered from the system administrator
web pages, that is used to do the initial configuration of a Cisco CallManager
Express router
D) a macro of questions, invoked and answered from the command line
environment, that is used to do the initial configuration of a Cisco CallManager
Express router
Q27) Logging messages specific for IP Phones in Cisco CallManager Express are what type?
(Source: Describing Network Management for Cisco CallManager Express)
A) 4
B) 5
C) 6
D) 7
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-161
Q28) Which three types of information specific to a Cisco CallManager Express installation
can the MIBs contain? (Choose three.) (Source: Describing Network Management for
Cisco CallManager Express)
A) CDRs
B) call leg information
C) billing information
D) user credentials
Q29) Which MIB stores the billing information that is entered by the Acct softkey button?
(Source: Describing Network Management for Cisco CallManager Express)
A) Cisco-DIAL-CONTROL-MIB
B) Cisco-VOICE-CONTROL-MIB
C) Cisco-VOICE-IF-MIB
D) not stored in any MIB stored on a RADIUS server
Q30) Which best describes an ephone hunt group? (Source: Understanding Call Center
Features)
A) a group of ephones on which the top line will ring on all members when a call
arrives at the pilot number
B) a group of ephone-dns that will all ring when a call arrives
C) a group of ephones that will ring in a specified order until the call is answered
D) a group of ephone-dns associated with a pilot number
Q31) Which command globally limits the number of times that a call can be redirected from
one ephone-dn to another to 12? (Source: Understanding Call Center Features)
A) (config-telephony-service)#
max-redirect 12
B) (config-telephony-service)#
hops 12
C) (config-ephone-hunt)#
max-redirect 12
D) (config-ephone-hunt)#
hops 12
E) (config)#
redirect-limit 12
F) (config-telephony-service)#
redirect-limit 12
Q32) What are the three ways that an ephone hunt group can select which member to send an
incoming call to? (Choose three.) (Source: Understanding Call Center Features)
A) round robin
B) peer
C) incremental
D) sequential
E) longest idle
F) longest wait
Q33) Pressing the DND softkey button results in which of the following? (Source:
Understanding Call Center Features)
A) The ephone is placed in standby mode and no calls can be received.
B) The ephone-dn is placed into the busyout state for outside calls but is available
to inside callers.
C) The ephone-dn is removed from any hunt group memberships.
D) The ephone is removed from any hunt group memberships.
4-162 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Q34) Which of the following is provided by the B-ACD service? (Understanding Call Center
Features)
A) The Cisco Unity Express provides automated attendant functions and can have
a custom script made to provide the call queuing.
B) Two TCL scripts provide the automated attendant and call queuing functions
that make up the B-ACD service.
C) The B-ACD TCL script and the automated attendant function of Cisco Unity
Express work together to provide the B-ACD service.
D) The B-ACD service is provided by an IPCC Express Windows-based server.
Q35) Which best describes the format for customized audio prompts? (Source:
Understanding Call Center Features)
A) G.711, 32-bit, mu-law, 8 kHz, and wave file format
B) G.711, 16-bit, mu-law, 8 kHz, and wave file format
C) G.711, 16-bit, mu-law, 8 kHz, and .au file format
D) G.711, 8-bit, mu-law, 8 kHz, and wave file format
E) G.711, 8-bit, mu-law, 8 kHz, and .au file format
Q36) Which three of the following are required to write statistics to a file? (Choose three.)
(Understanding Call Center Features)
A) Nothing is required; the statistics will be written to flash automatically.
B) Statistics must be enabled on the ephone hunt group.
C) Statistics must be enabled in the telephony service.
D) The URL of an FTP server must have read/write permissions set.
E) The URL of a TFTP server must have read/write permissions set.
F) A windows share must have read/write permissions set.
G) A prefix and a suffix must be defined.
Copyright 2005, Cisco Systems, Inc. Configuring Additional Cisco CallManager Express Features 4-163
4-164 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Module 5
Cisco Unity Express (CUE) is an essential component of both the Cisco CallManager and
Cisco CallManager Express solutions. In a Cisco CallManager environment, CUE provides
local storage and processing of voice mail and automated attendant services for the branch
office, thereby alleviating WAN bandwidth and quality of service (QoS) concerns.
The combination of Cisco CallManager Express and CUE provides a solution that enables
small and medium businesses and branch offices to deliver voice, data, and telephony services
integrated on a single, router-based platform. CUE users can easily and conveniently manage
their voice messages and greetings with intuitive telephone prompts and a straightforward GUI
that allows for ease in administration.
In this module, you will learn how to install CUE, integrate the CUE module with Cisco
CallManager Express, and upgrade the software and licenses. You will be introduced to
automated attendant and voice mail features, and you will learn how to configure and
customize the automated attendant script. Customization of automated attendant scripts is
accomplished via the CUE editor.
The web-based GUI of CUE is tightly integrated with the Cisco CallManager Express web
interface and can be used to configure users, mailboxes, groups, and prompts within the CUE
system. Each of these tasks can also be accomplished from the command-line interface (CLI),
which is very useful for scripting purposes. The CLI is required for some tasks, such as
upgrading and reinstalling the CUE system.
Module Objectives
Upon completing this module, you will be able to install and upgrade CUE; configure CUE
Auto Attendant, users, groups, and voice mail; and troubleshoot.
Describe the key features and functionality of CUE
Describe the requirements and tasks for installing and upgrading CUE
Describe the components and tasks for configuring CUE Auto Attendant
Configure users and groups
Describe the components and tasks for configuring voice mail
Describe the CUE troubleshooting guideline and tools
5-2 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Lesson 1
This lesson describes the features and functions of Cisco Unity Express (CUE).
Objectives
Upon completing this lesson, you will be able to describe the key features and functionality of
CUE. This includes being able to meet these objectives:
Describe voice mail features
Describe CUE Auto Attendant features
Describe management features
Describe system functionality features
IPTX v2.05-3
CUE voice mail is a feature-rich voice mail system designed for the small- to medium-sized
enterprise. CUE provides flexibility and the choice between two form factors. You can choose
the capacity, performance, and price point that meet the specific site requirements. In addition
to the form factor, the storage capacity of both the CUE network module (NM-CUE) and the
CUE advanced integration module (AIM-CUE), 100 hours and 14 hours, respectively, may be
customized on a per-user basis as defined by the system administrator. Alternatively, the
storage capacity can be left at the factory default settings.
One of the useful features in CUE is a complete, yet concise Telephony User Interface (TUI)
tutorial that takes the user through a step-by-step setup of the mailbox. This minimizes the need
for administrator intervention or assistance, saving both time and money. This tutorial runs for
both personal mailboxes and General Delivery Mailboxes (GDMs).
GDMs allow voice mail storage that any designated team member can retrieve. This enables
quicker responses to caller messages, resulting in greater customer satisfaction.
Users can choose from standard and alternate greetings to communicate special messages,
such as telling callers about an extended absence or vacation. Users can also record their
own greetings.
Of course, commonly used voice mail featuressuch as replying to, forwarding, and
saving messages; message tagging for privacy or urgency; alternate greetings; pausing,
fast forwarding, and rewinding; and envelope informationare provided for optimal
management of messages. This set of typical features allows new CUE users to get started
quickly and with little training.
5-4 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Within the mailbox, there are features for the caller as well. One of them is the ability to zero
out of the mailbox (press 0) to go to the operator. (The destination for zeroing out of a user s
mailbox can be modified and set on a mailbox-by-mailbox basis.) In addition, the caller can
review the message just recorded and rerecord it. The caller can also mark the message as
urgent or private.
In addition, the system has features that are common in voice mail systems in general, such as
Message Waiting Indicator (MWI) functionality and a mailbox full notification that informs
the user that the mailbox has reached its defined capacity.
When multiple CUE systems are present, they may exchange messages through a standardsbased protocol called Voice Profile for Internet Messaging (VPIM). This allows a message to
be recorded on one system and tranferred to another CUE system.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-5
IPTX v2.05-4
The CUE Auto Attendant is a built-in feature that simplifies self-service for callers by allowing
them to quickly reach the right person without the assistance of an operator 24 hours per day,
seven days per week. The default CUE Auto Attendant gives callers the choice of either dialing
by name or dialing by extension and the option to return to an operator whenever greater
assistance is needed. The CUE Auto Attendant also provides time of day and day of week call
treatment so that the right message is always communicated and available to the caller. This
default Auto Attendant can be replaced by a customized version that can be constructed in a
GUI tool called the CUE Auto Attendant Editor. (CUE AA Editor)
The CUE AA Editor is a Windows GUI-based visual scripting tool that gives administrators a
simple way to create multiple customized Auto Attendant flows. The CUE AA Editor allows
for dragging and dropping of prebuilt steps into a treelike structure. This makes the operation of
building a custom Auto Attendant straightforward and intuitive. The scripts can then be
installed and applied to the CUE system. Multiple Auto Attendant scripts can be active and
running at the same time in CUE.
The greeting management system (GMS) is a custom phone-based interface that allows the
recording of new greetings for use in Auto Attendant. These are added through the CUE GMS
either via the TUI or an offline .wav file recording tool.
The system administrator can record an alternate Auto Attendant greeting for use in case of an
emergency or other unexpected short-term event, such as a snow day. The alternate Auto
Attendant greeting works much like the alternate voice mail greeting. It prompts the system
administrator to either activate or deactivate the greeting based on its current status.
5-6 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Management Features
IPTX v2.05-5
Both the system administrator and the end user can use the TUI to perform CUE management.
The system administrator can use the TUI by dialing the pilot number of the GMS. This allows
the administrator to record, review, and delete prompts that may be used in the Auto Attendant.
The system administrator can also use the TUI to record an emergency alternate greeting, then
activate it or deactivate it as desired.
End users reach the TUI by accessing their voice mail. Through a tutorial, end users can use the
TUI to set up their mailbox, to record a personalized greeting, and to record the spoken name
that callers hear. End users can also record an alternate greeting, which can then be activated or
deactivated through the TUI.
Many of these tasks can also be performed from a web browser in a GUI or from the commandline interface (CLI) of the CUE module.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-7
IPTX v2.05-6
The CUE system can be managed through either a web-based GUI that is integrated with Cisco
CallManager Express or through the CLI on the CUE module. The GUI is feature-rich and
allows an administrator to manage the following:
Logging in and out: Administrators must provide credentials to enter the GUI or the CLI.
Resetting passwords and PINs: Passwords and PINs can be reset from the CLI or the GUI.
Configuring Auto Attendant: Installation and configuration changes can be done through
the GUI or the CLI.
Configuring voice mail: Voice mail configuration can be set through the GUI or the CLI.
Configuring users and groups: Users and groups can be set up and administered through
the GUI or the CLI.
Backing up and restoring: Backing up and restoring the configuration can be done
through the GUI or the CLI.
Saving configuration: Saving the configuration can be done through the GUI or the CLI
Reloading the system: Reloading the system can be done through the GUI or the CLI.
There is an IOS softwarelike CLI that gives the administrator full administrative abilities to
set up, deploy, manage, and troubleshoot the CUE system. Troubleshooting the CUE system is
done only through the CLI. Full troubleshooting tools are present in the GUI and must be used
in the CLI.
Remote management of the CUE module can be accomplished through the CLI or the GUI.
Access the CLI by first using Telnet to connect to the host router for the CUE module, then
start a session across the backplane of the router to the CUE module. To use the GUI remotely,
open IE 6.0 (or greater) and go to the URL for the CUE module.
5-8 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.05-7
Network Administration
Site C
Site A
Site B
IP
IPTX v2.05-8
An administrator can be sitting anywhere on the network and access the CUE system through
either the CLI or the GUI.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-9
System Functionality
IPTX v2.05-9
Some tasks can only be done through the CLI. These include the following:
Installing and upgrading software and licensing
Monitoring CPU and memory usage
Troubleshooting syslog files and trace files
5-10 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Language Support
GUI and CLI are in English only.
The Cisco CallManager Express language
setting controls the Phone display.
The CUE language setting affects Auto
Attendant and TUI prompts.
CUE release 2.1 supports English, French,
German, and Italian.
Additional language support for CUE is planned.
CUE language
setting controls
TUI and Auto
Attendant only.
2005 Cisco Systems, Inc. All rights reserved.
Cisco CallManager
Express language
setting controls
Phone display only.
IPTX v2.05-10
The Cisco CallManager Express language setting controls the Phone display, whereas the CUE
language setting controls the Auto Attendant and TUI prompts. CUE currently supports English
only. This will change in an upcoming release when CUE will support the same languages as
Cisco CallManager Express.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-11
IPTX v2.05-11
The CUE module has a CLI environment that may be used to perform all configuration tasks.
This allows for bulk provisioning task to be performed. In addition, when the CUE module is
integrated with Cisco CallManager Express, all users may be imported from the GUI.
SNMP is supported, but only very basic MIBS are currently present that may be used for
hardware inventory and identification only. There are currently no application-specific MIBs.
5-12 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Summary
Summary
The CUE system is a feature-rich application
that provides all the expected features of a
voice mail system.
The built-in Auto Attendant can be customized
using the CUEAA Editor.
The CUE system can be managed through a webbased GUI or the CLI.
CUE includes many functions for configuring,
monitoring, and administering the system.
IPTX v2.05-12
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-13
5-14 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Lesson 2
This lesson defines the files that are needed in order to install and upgrade Cisco Unity Express
(CUE), the required hardware, the installation process, and the Cisco CallManager Express
router configuration that is required prior to installation. The lesson then explains how to
initialize the CUE module and how to perform an initial configuration. And finally, information
on running the CUE initialization wizard is presented.
Objectives
Upon completing this lesson, you will be able to describe the requirements and perform the
tasks for CUE installation and initialization. This includes being able to meet these objectives:
Describe CUE software files
Describe hardware requirements
Perform the prerequisite configuration of the Cisco IOS router and Cisco CallManager
Express
Describe how to connect to the CUE module
Describe how to restore the factory defaults to a CUE module
Describe the show commands that are useful for viewing the status of the CUE module
Perform the initial configuration steps
Configure the CUE initialization wizard
Describe different ways to restart
Describe the steps for upgrading the version of CUE and the licensed capacity
Enterprise
IP
Branch
Offices
IPTX v2.05-3
CUE comes preinstalled from the factory on the CUE network module (NM-CUE), the NMCUE enhanced capacity (NM-CUE-EC), and the CUE advanced integration module (AIMCUE). However, a method does exist for reinstalling the software. This same method is also
used for upgrading the version of CUE software and upgrading licensed capacity. This is
accomplished by obtaining the appropriate files, either CUE software or licensing, from Cisco
Connection Online or a CD set and putting the files on an FTP or TFTP server that is accessible
to the CUE module. After the files are on the FTP or TFTP server, you can begin the
reinstallation or upgrade process.
5-16 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Installation utilities
cue-installer.2.1.1
Language files
cue-vm-lang-pack.2.1.1. pkg
cue-vm-de_DE-lang-pack.2.1.1.prt1
cue-vm-en_US-lang-pack.2.1.1.prt1
cue-vm-es_ES-lang-pack.2.1.1.prt1
cue-vm-fr_FR-lang-pack.2.1.1.prt1
cue-vm-ga-IE-lang-pack.2.1.1.prt1
IPTX v2.05-4
The file cue-installer.2.1.1 and a license file must be present on the TFTP server in order to run
the installation. All of the other files must be served up by the FTP server. Although the TFTP
server and the FTP server do not have to be the same computer, for administrative reasons it is
recommended that they are. The license files can be obtained from Cisco Connection Online.
Note
The license file that is installed must be for either a Cisco CallManager Express integration
or a Cisco CallManager integration. A hybrid approach is not supported. A license file for a
Cisco CallManager integration would have a name similar to cue-vm-50license.1.1.1.ccm.pkg.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-17
Hardware Installation
IPTX v2.05-5
In an integration of Cisco CallManager Express with CUE, the CUE module is usually installed
in the same chassis as the Cisco CallManager Express router, although this is not required. The
minimum version of IOS software needed to support the module depends on which type of
module is used. For the NM-CUE-EC, IOS Release 12.3(14)T1 or later is the minimum version
software that is required. For the NM-CUE, the minimum version of software that is required is
IOS Release 12.3(4)T or later. For the AIM-CUE, the minimum version of software that is
required is IOS Release 12.3(7)T or later. If the show version command does not display 1
cisco service engine, verify the version of software that is installed.
5-18 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.05-6
The NM-CUE-EC can be installed in a Cisco 2600XM, 2691, 2800 Series, 3700 Series, and
3800 Series router. This module uses a hard drive to store the configuration and as a repository
for voice mails. This hard drive cannot be replaced in the field; if it were to fail, the entire
module would have to be sent to Cisco Systems.
Hot swapping is supported on the Cisco 3745 and 3845 routers, although the module must still
be shut down prior to removal. This online insertion and removal (OIR) of the NM-CUE-EC is
a function of the 3745 and 3845 routers, not of the module. Hot swapping is not supported in
the Cisco 2600XM, 2691, 3725, or 3825 routers.
The NM-CUE-EC can scale up to 100 mailboxes and 16 sessions at any one time. The number
of mailboxes supported by this module will increase in future versions.
Note
Proper shutdown of the CUE module before a planned power shutdown is advised to
prevent file corruption issues.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-19
IPTX v2.05-7
The NM-CUE-EC has two LEDs on the front panel: PWR and EN. If the PWR LED is green,
then the module is seated correctly and receiving power from the protocol control information
(PCI) bus. If the EN LED is green, the module is recognized by the IOS software. An EN LED
that is not green could mean that a version of IOS software is being used that does not support
the CUE module.
Note
In addition to the two LEDs, there is a FastEthernet port. This port is disabled and not used.
The flash slot is also nonfunctional and cannot be used.
5-20 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.05-8
The NM-CUE-EC is actually an Intel-based server that runs Linux. The Linux operating system
is neither accessible nor configurable. The NM-CUE-EC runs a 500-MHz Pentium III CPU
with 512 MB of synchronous dynamic RAM (SDRAM). This allows the CPU of the host router
to be unaffected by activities that occur in the CUE system. The hard drive is preinstalled with
an operating system and the CUE application. The module currently uses a 20-GB Integrated
Drive Electronics (IDE) hard drive, although this may change in the future. This hard drive is
where the configuration and voice mailboxes reside.
The NM-CUE-EC is hardened and secure, with no shell access, no back doors, and an operating
system that is totally locked down. All access to the command-line interface (CLI) of the CUE
module is through a back-to-back console connection across the backplane of the IOS router.
The service-module service-engine mod/port command is used to connect to the CUE module.
Because the FastEthernet interface on the front of the NM-CUE-EC is disabled, communication
with Cisco CallManager Express and subscribers is through a virtual Ethernet port on the
backplane of the router on which the module is installed. This back-to-back Ethernet port is
accessed through the use of Router Blade Configuration Protocol (RBCP). This port needs to be
on the same subnet as the service engine in the Cisco CallManager Express router. Console
access is also accessed across the backplane of the router.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-21
IPTX v2.05-9
The NM-CUE can be installed in a Cisco 2600XM, 2691, 2800 Series, 3700 Series, and 3800
Series router. This module uses a hard drive for storage of the configuration and as a repository
for voice mails. This hard drive is not able to be replaced in the field; if it were to fail, the entire
module would have to be sent to Cisco.
Hot swapping is supported on the Cisco 3745 and 3845 routers, although the module must still
be shut down prior to removal. This OIR of the NM-CUE is a function of the 3745 and 3845,
not of the module. Hot swapping is not supported in the Cisco 2600XM, 2691, or 3725 routers.
This module can scale up to 100 mailboxes and eight sessions at any one time.
Note
Proper shutdown of the CUE module before a planned power shutdown is advised to
prevent file corruption issues.
5-22 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.05-10
The NM-CUE has two LEDs on the front panel: PWR and EN. If the PWR LED is green, then
the module is seated correctly and receiving power. If the EN LED is green, the module is
recognized by the IOS software. An EN LED that is not green could mean that a version of IOS
software is being used that does not support the CUE module.
Note
In addition to the two LEDs, there is a FastEthernet port. This port is disabled and not used.
The flash slot is also nonfunctional and cannot be used.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-23
IPTX v2.05-8
The NM-CUE is an Intel-based server that runs Linux. The Linux operating system is neither
accessible nor configurable. The NM-CUE runs a 500-MHz Pentium III CPU with 512 MB of
SDRAM. This allows the CPU of the host router to be unaffected by activities that occur in the
CUE system. The hard drive is preinstalled with an operating system and the CUE application.
The module currently uses a 20-GB IDE hard drive, although this may change at some point.
This hard drive is where the configuration and voice mailboxes reside.
The NM-CUE is hardened and secure, with no shell access, no back doors, and an operating
system that is totally locked down. All access to the CLI of the CUE module is through a backto-back console connection across the backplane of the IOS router. The service-module
service-engine mod/port command is used to connect to the NM-CUE.
Because the FastEthernet interface on the front of the NM-CUE is disabled, communication
with Cisco CallManager Express and subscribers is through a virtual Ethernet port on the
backplane of the router in which the module is installed. This back-to-back Ethernet port is
accomplished using RBCP. This port needs to be on the same subnet as the service engine in
the Cisco CallManager Express router. Console access is also accomplished across the
backplane of the router.
5-24 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
AIM-CUE Overview
Makes 2600XM a viable platform for Cisco IDS Voice Gateways,
Cisco CallManagerExpress, and CUE
Communicates with router across backplane
Requires IOS Release 12.3 (7)T to recognize hardware
Four or six sessions, depending on the host hardware
12, 25, or 50 mailboxes
1-GB flash card is an FRU
Cannot put AIM-CUE in
3745 router slot 0must use
slot 1 instead
IPTX v2.05-12
The AIM-CUE requires a minimum of CUE version 1.1 and IOS Release 12.3(7)T or later.
This AIM-CUE is an internal card that can be installed in the chassis of a supported router.
Like the NM-CUE, all communication with Cisco CallManager Express and subscribers is
accomplished across the backplane through the virtual Ethernet interface. The AIM-CUE
differs from the NM-CUE in that it does not have a hard drive. Instead, the AIM-CUE uses an
industrial-quality 1-GB flash card for storing the configuration and voice mailboxes. Flash
memory is limited in the number of times that writes can be made to a piece of memory; as a
result, the card has a limited lifetime and may have to be replaced after three to five years of
average use. There is a page in the web-based GUI to track the usage of the flash card. The card
is field replaceable unit (FRU).
The AIM-CUE is intended for smaller installations than those for which the NM-CUE is
intended. It scales up to 50 ports and either four or six sessions, depending on the chassis in
which the module is installed. This makes the 2600XM platform a viable platform for running
Cisco CallManager Express and Cisco Unity Express. The number of sessions is limited by the
speed of the CPU, and in installations with 50 mailboxes, the amount of storage and the fourport maximum can be limiting.
Caution
In the Cisco 3745 router, install the AIM-CUE in slot 1 only. Installation in slot 0 can result in
damage to the module.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-25
AIM-CUE Parameters
AIM-CUE Implementation
IPTX v2.05-13
The AIM-CUE runs a Linux-based operating system based on the Intel Celeron 300-MHz CPU.
When the AIM-CUE is installed in a Cisco 2800 Series, 3700 Series, or 3800 Series router, the
maximum number of ports is six.
When the AIM-CUE is installed in the Cisco 2600XM Series or 2691 router, the CPU runs at
half the speed because of power limitations on the AIM-CUE port. This results in the number
of supported ports being limited to four. Another consequence is significantly longer bootup
times for the AIM-CUE.
The AIM-CUE has 256 MB of SDRAM and 1 GB of flash to store the operating system,
configuration, and voice mails. The 1-GB model allows for 14 hours of storage.
Connecting to the AIM-CUE is accomplished from the CLI of the host IOS router by using the
command service-module service-engine mod/port from privileged EXEC mode.
5-26 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
-
-
-
- -
-
- -
- -- - -
--
-
- -
-
- -
-
- - -
IPTX v2.05-14
The installation of the CUE module can be checked on the router by using the show version
command. In the output, cisco service engine should be present. If it is not present, ensure
that the CUE module is installed, that it is seated properly, and that the IOS release supports the
module.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-27
This topic describes the prerequisite configuration necessary on the Cisco CallManager Express
router and the router that hosts the CUE module.
IPTX v2.05-15
The router that is hosting the CUE module requires some configuration prior to installation of
the module. This includes performing some basic tasks in the IOS software as well as some
Cisco CallManager Express tasks. The Cisco CallManager Express router and the CUE host
router may be separate devices or the same device.
The tasks to perform in the IOS software of the CUE host router include:
Setting up routing and IP addressing on the service module and the interface service engine
The Cisco CallManager Express router configuration tasks include:
Installing the files needed to run the web-based GUI (the same files that are used for the
Cisco CallManager Express GUI)
Configuring a session initiation protocol (SIP) dial peer for connecting calls to the voice
mail and automated attendant features of CUE
Setting up the router if it is the Network Time Protocol (NTP) server
5-28 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
--
--
Same Subnet
-
- --
-
-
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.05-16
After the CUE module is successfully installed in the chassis of the router, it still requires some
configuration to function properly. The interface service engine needs to have an IP address
that is on the same subnet as the service module. These two IP addresses represent the two ends
of the virtual Ethernet connection across the backplane.
The IP address of the service engine may be statically assigned to the interface, but this
necessitates the creation of a new subnet with two hosts on it. This subnet will need to appear in
all the routing tables so that the module is reachable. The IP unnumbered command can be
used to save a subnet and is the recommeded solution. Also, a default gateway must be
assigned to the service module.
If DHCP is used, then the IP addresses that are assigned to the service engine as well as any
other statically configured interfaces must be excluded so that IP addresses are not duplicated.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-29
IPTX v2.05-17
Cisco CallManager Express uses SIP to communicate with the CUE module. SIP is a protocol
that is used to set up and tear down calls. In this case, it is used to set up the connection
whenever someone calls the automated attendant or a mailbox. The settings on the SIP dial peer
need to be very specific and include the command session protocol sipv2. This command
instructs the router to use the SIP protocol with this dial-peer destination.
The command dtmf-relay sip-notify instructs the dial peer to take all dual tone multifrequency
(DTMF) digits that are pressed and send them out-of-band as an SIP notify message, rather
than in-band in Real-Time Transport Protocol (RTP) packets. Another command that is used is
the coded g711ulaw command. This command sets the coder-decoder (codec) to G.711, which
is the only codec supported in CUE.
The no vad command is used to disable voice activity detection (VAD). VAD is a mechanism
that suppresses packets when no detectable voice is traversing the RTP stream. It provides a
way to reduce the amount of bandwidth that is consumed by typical two-way voice
conversations. VAD should be disabled for communication with CUE.
5-30 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.05-18
On the Cisco CallManager Express router, two ephone-dns should be configured for the
Message Waiting Indicator (MWI) functions. The number that is assigned to each MWI
ephone-dn with the command number number must have a certain format in order to function
properly with CUE. The defined number will be composed of a numeric value and a string of
periods. The numeric portion should be the same length as the dial plan for the installation and
should not overlap on existing ephone-dns. The string of periods must be equal to the length of
extensions in the dial plan. For example, if the installation uses five digits then the numeric
string must be followed by a string of five periods.
Note
The number of digits used for extension numbers must be consistent on all end devices.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-31
-
- --
-
-
-
-
--- -
---
-
2005 Cisco Systems, Inc. All rights reserved.
Router IP address
CUE hardware
IP addressing
HTTP server
configuration
Static route into CUE
SIP dial peer to route
calls into CUE
The figure shows the recommended configuration on the Cisco CallManager Express router,
with the following:
IP addressing of the interface service engine and the service module on the same subnet
A static route to get to the service module IP address
An SIP dial peer
An MWI on ephone-dn (Cisco CallManager Express integrations only)
An MWI off ephone-dn (Cisco CallManager Express integrations only)
The IOS router requires certain prerequisite configurations, including IP addressing on the
service engine as well as a default gateway. A host route to the service module is also needed
so that the router knows where the CUE module is located. The CUE module is seen by Cisco
CallManager Express as a separate device even though it shares the same chassis.
To use flash as the location of the Cisco CallManager Express GUI files, which is needed for
the GUI of CUE, the HTTP server must also be configured on the IOS router.
An SIP dial peer must be configured so that the Cisco CallManager Express router is able to
communicate across the backplane to the CUE module. The SIP dial peer must be hardcoded to
G.711, with no VAD, and DTMF relay through the SIP notify message must be turned on.
The MWI configuration that is required on Cisco CallManager Express must have a period
character to represent each digit in the dial plan. For example, in the figure, there are four
periods at the end of the MWI on ephone-dn and the MWI off ephone-dn. These four periods
represent a four-digit dial plan.
5-32 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
This topic describes the startup of the CUE module and how to connect to the module.
IPTX v2.05-20
In order for the CUE module to have power, the host router in which the module is installed
must be powered on. After the CUE module receives power, it goes through its bootup
procedure. Because the CUE application is Linux-based, the bootup process loads the Linux
operating system, then loads the CUE application that runs on top of the operating system. The
bootup time of the module may be longer than the bootup time of the host router.
Note
OIR of the NM-CUE and NM-CUE-EC is supported by the Cisco 3745 and 3845 routers. The
modules should always be shutdown before removal from the router.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-33
- - -
--- - --
- -
-
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.05-21
To connect to the CUE module, use the command service-module service-engine module/port
session. This opens a back-to-back terminal connection over the backplane to the CUE module.
It is important to secure the Telnet access to the router, and thereby the CUE module, because
all access to the CUE module is through the router. To disconnect from the CUE module and
go back to the CLI of the host router, enter exit from the CUE module.
Note
For remote access, telnet to the host router, then session to the CUE module.
5-34 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
This topic describes how to restore factory defaults for the CUE module.
--
-
-
-
- -
-- - - - -
-
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.05-22
To restore factory defaults on the CUE module, use the command restore factory default
while the module is off-line. This allows you to redo the initial configuration and to rerun the
initialization wizard.
Caution
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-35
Initial Configuration
This topic describes the initial configuration process that can be performed on a CUE module.
This process can be run on a CUE module that is new, going through a reinstallation, or being
reconfigured after restoration of factory defaults.
Initial Configuration
- --
- -
- - --
-
- --
--
- --
- -
- -
Starts the
configuration of
the CUE module
IPTX v2.05-23
The overwrite of the storage proceeds the installation of the operating system and application.
At the end, you are asked if you wish to start the initial configuration.
5-36 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
- -- - -
- - -
- - -
- - - -
--- - --- - -
--
-
--
- -
- - - - -
- - -
- -
- -
Choice to ignore
previous
configuration
IPTX v2.05-24
This output appears if any configuration was present before this installation process. You are
asked whether you would like to restore the previous configuration. These settings include the
hostname, domain name, Domain Name System (DNS) server, NTP server, and time zone.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-37
- - -- - -
--- -- -
- -- -
-
-
- - -
---
Determines if DNS is
used by CUE
IPTX v2.05-25
After an installation or upgrade, the system automatically starts a utility that configures some
basic settings of the CUE system. The information that you must provide includes:
hostname
DNS server address
NTP server address
time zone
administrator credentials
5-38 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
The NTP server is defined and the continent and are country set.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-39
- -
- --
- -
-
--
---
--
---
CUE prompt
IPTX v2.05-28
The default administrative credentials are defined at the end of the initial configuration menus.
After you enter all the requested information, the system prompt appears and you can begin
configuration from the CLI. You can also start the initialization wizard by logging into the
GUI of the CUE module.
- - -
IPTX v2.05-29
To verify success after a software version upgrade, use the show software packages command
to view the packages that were installed.
5-40 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
- - -
IPTX v2.05-30
To verify which versions of the software packages were installed, use the show software
version command.
- - -
- -- -
--
-
- -
-
-
- -
-
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.05-31
After a license upgrade, use the show software license command to verify success. This
command allows you to see the number of ports, recording capacity, General Delivery
Mailboxes (GDMs), and the number of mailboxes that are currently installed.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-41
--
--
-
IPTX v2.05-32
To view any current calls to the CUE module, use the command show ccn call application all.
This is a good command to run prior to taking the CUE system off-line.
5-42 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
This topic describes CUE initialization wizard and the steps required to complete it.
IPTX v2.05-33
In order to run the initialization wizard, the administrator must connect to the GUI web page of
the CUE module. This is done by using the IP address of the CUE module. The address of the
CUE module must be reachable and may be tested through the use of pings. The initialization
wizard will start the first time the GUI is accessed after installation.
Note
The URL is not the same address as the Cisco CallManager Express router.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-43
IPTX v2.05-34
The initialization wizard starts with a login page. The credentials that need to be used are
the same as the administrator credentials defined at the CLI of the CUE module during the
postinstallation steps.
You can bypass the initialization wizard on the next screen, the entry page.
5-44 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
The wizard can be skipped and the system configured from the
CLI instead of the GUI.
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.05-35
After the CUE credentials have been entered, the administrator is presented with the option to
view the current settings, run the initialization wizard, skip the wizard and use the CLI to
configure, or logoff and run the wizard later.
Note
If the wizard is skipped, then the initial configuration must be completed from the CLI and
Cisco CallManager Express will not synchronize with CUE. In this case, all users must be
re-created in CUE manually.
The initialization wizard consists of five steps, which begin after the screen in this figure.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-45
IPTX v2.05-36
The Cisco CallManager Express credentials must be established already because they
cannot be defined here.
5-46 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Click here to
create
mailboxes for
all these users.
IPTX v2.05-37
The users that are imported are a result of the usernames configured on the ephones in
Cisco CallManager Express.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-47
IPTX v2.05-38
Passwords and PINs that are randomly generated by the system appear at the end of the
wizard and are visible to the administrator in the GUI after the wizard is run. When the
password or PIN is reset by the end user, the administrator is no longer able to view the
password or PIN. The administrator is able to reset them.
5-48 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.05-39
Caution
The Voice Mail Number field, Auto Attendant Access Number field, and Administration via
Telephone Number field must contain different values. If they do not, then a user who tries
to call the operator while in the voice mail system is directed back to the voice mail system
or the GMS. Also, an outside caller trying to get to the operator is connected to the voice
mail system or the GMS.
IPTX v2.05-40
Step 5: Commit
The fifth step of the initialization wizard consists of two confirmation pages that should be
reviewed for errors. The first of the two pages summarizes much of the configuration that was
entered during the wizard.
Note
At this point, no changes have been committed to the configuration or database. If any
changes are needed, simply click the Back button to correct the setting.
5-50 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.05-41
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-51
-- -
-
- -
-
-- --
-- --
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.05-42
If the CUE module needs to be restarted, there are three ways to do this:
Web-based GUI: Log in to the administrative web site and choose Administration >
Control Panel.
CLI of the host router: From the host router, use the command service-module serviceengine module/port reload from privilege EXEC mode.
CLI of the CUE module: From the CUE module, use the reload command from privilege
EXEC mode.
Caution
5-52 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
CUE Upgrade
Upgrade steps:
Load the new software and license files on the TFTP or FTP server.
Backup the configuration voice mails to an FTP server.
Use the software install cleancommand to perform a reinstallation or upgrade
of the CUE application that reformats the hard drive.
A full backup and restore are required to preserve the configuration and
voice mails.
Select language.
Perform the initial configuration.
Run initialization wizard.
Upgrading the licensed capacity does not reformat the hard drive.
Use the software install upgradecommand to perform an incremental upgrade
(point release) without reformatting the hard drive.
A full backup is still recommended.
No language, selection is possible .
Restore the configuration and voice mails from the backup set onthe FTP
server if the software install cleancommand was used.
Reload the CUE module.
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.05-43
Performing an upgrade of the software version and the licensed capacity of CUE is a multistep
process. The following is a summary of these steps:
Load files: The correct software files, license files, or both must be on a TFTP or an FTP
server that is reachable by the CUE system.
Backup: The system must be backed up to an FTP server.
Upgrade: Upgrade the CUE software using either a reinstall or an incremental upgrade.
Restore: Restore the system from the backup file on the FTP server if a reinstall was
performed.
Reload: CUE must be reloaded.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-53
IPTX v2.05-44
The software upgrade procedure in CUE is either a reinstall or an incremental upgrade. If only
the software level will change during an upgrade and the capacity (number of mailboxes) of the
system remains unchanged, then no action with regard to license installation needs to be taken.
The existing license survives a software change.
In CUE, a clean software reinstallation overwrites all software information on the hard drive
(NM-CUE, NM-CUE-EC) or flash (AIM-CUE), so no configuration or message data survives a
software installation or upgrade. It is therefore imperative to do a system backup before the
upgrade is started.
For example, if the capacity of the system is changed from a 12-mailbox system to a 25mailbox system, then a new license file must be installed. Assuming only the license
installation is being upgraded and the software level is not changing, then the hard drive or
flash contents survive and the system is operational after the license installation.
Note
It is always good practice to do a backup before any installation, even though it may not be
required. Performing a backup is recommended before a license installation.
A downgrade is defined as going backward in either software release (for example, from
release 2.1.2 to release 2.0.1.) or license level (for example, 25 mailboxes to 12 mailboxes)
while maintaining the system configuration and data on the disk. Downgrading the version of
CUE software is done by performing a clean installation . Certain releases of CUE support
downgrading to the previous version assuming that the previous upgrade was an incremental
upgrade.
Caution
Downgrading of the licensed capacity is not supported and can cause unpredictable results.
5-54 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Backup
IP Network
Restore
IPTX v2.05-45
In order to perform a backup or a restoration, an FTP server must be present and available to
the CUE module. Both the configuration and the messages can be backed up over the network
to the FTP server. The CUE module must have both read permission and write permission to
the FTP directory. When a restoration is necessary (such as during an upgrade of CUE), the
backup sets can be downloaded from the server using FTP. In order to perform either a backup
or a restoration, the CUE module must be put into an off-line state. While in the off-line state,
CUE is not available to subscribers.
Caution
When the CUE module is taken off-line, any subscribers and callers in the automated
attendant are cut off without warning.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-55
Specify the location and path to where the backup will be written.
Specify the username and password used as credentials.
The username must have write permissions on the directory.
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.05-46
Configure the URL of the FTP server and the credentials where the backup and restore
functions will take place. Choose Administration > Backup/Restore > Configuration from
the GUI.
5-56 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.05-47
A backup can be performed either from the GUI or from the CLI. To perform a backup from
the GUI, choose Administration > Backup/Restore > Trigger Backup and select the name of
the backup and what is to be backed up. For upgrading the software version, be sure to select
both the configurations and the data that is to be backed up.
Click Start Backup to start the operation. This operation causes all calls to be dropped and the
system to go off-line. The backup file that is created is stored on an FTP server. Flash and other
types of media cannot be used for backup and restoration.
It is advised to use the show ccn call application all command prior to triggering the backup to
determine if any active calls are currently ongoing.
Note
While off-line, no calls to the automated attendant or to voice mail will work.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-57
The amount of time the backup takes will depend upon the
bandwidth and the size of the backup set.
When the backup is completed, bring the system back online.
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.05-48
After starting the backup, the GUI continues to function. A progress bar is displayed that shows
the number of bytes that were transferred. The amount of time that is required to complete the
backup is mainly a function of how many minutes of voice mail are present on the CUE system
because this makes up the bulk of the data.
When the backup is complete, the administrator must bring the system back online. This does
not happen automatically, and it cannot be automated from the GUI.
5-58 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
- -
-
-
-
- --
-- -
-
---
IPTX v2.05-49
If error messages occur while using a script to back up the CUE system from the CLI, there
may not be an administrator to view the errors.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-59
Upgrading CUE:
Clean Install 2.x to 2.x
TFTP Server
and FTP Server
IP
From the CLI of CUE, enter thesoftware install
clean command to specify the package to
install.
cue-installer.2.1.1
cue-vm.2.1.1.pkg
cue-vm.2.1.1.prt1
cue-vm-xx-license.2.1.1.cme.pkg
IPTX v2.05-50
To perform a clean reinstallation of CUE version 2.x, use the installer that is built into the
application. The command to perform a clean installation is software install clean url url.
Upgrading CUE:
Clean Install 2.x to 2.x (Cont.)
- -
- - -- -
- -
- -
-
-
-
-
-
-
-
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.05-51
The clean installation process will perform a reformatting of the hard drive and all previous
configuration and voice mail data will be lost. In order to preserve the configuration and voice
mails, a full backup needs to be performed before the clean install, and a full restore needs to be
performed after the clean install.
5-60 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Upgrading CUE:
Clean Install 2.x to 2.x (Cont.)
-
-
-
-
- - --
- -
IPTX v2.05-52
The language that is installed must be selected through this installation process. After the
language is selected, the module performs the reformatting and the reinstallation, then will
reboot itself. After the reboot is finished, the module comes up and prompts for the initial
configuration.
Upgrading CUE:
Incremental Upgrade 2.x to 2.x
TFTP Server
and FTP Server
IP
From the CLI of CUE, enter thesoftware install
upgrade command to specify the package to
install.
cue-installer.2.1.1
cue-vm.2.1.1.pkg
cue-vm.2.1.1.prt1
cue-vm-xx-license.2.1.1.cme.pkg
IPTX v2.05-53
For point releases in CUE version 2.x, an incremental upgrade may be performed. This does
not perform a hard drive reformat, so no configuration or voice mails are lost. Use the
command software install upgrade url url to initialize the process.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-61
Upgrading CUE:
Incremental Install 2.x to 2.x (Cont.)
- -
- - -- -
-
- -
IPTX v2.05-54
Even though the configuration and voice mails are not deleted during an incremental upgrade,
performing a full backup prior to the upgrade is recommended.
5-62 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Upgrading CUE:
1.x to 2.x
TFTP Server
and FTP Server
IP
From the CLI of CUE, enter boot loader mode
by restarting the CUE module, and enter ***
within 10 seconds of being prompted for it.
cue-installer.2.1.1
cue-vm.2.1.1.pkg
cue-vm.2.1.1.prt1
cue-vm-xx-license.2.1.1.cme.pkg
IPTX v2.05-55
To upgrade a 1.x version of CUE software to a 2.x version, use the following process. Reload
CUE from the CLI of the CUE module. While CUE is reloading, a lot of output is sent to the
screen. In order to upgrade or reinstall, *** must be entered within 10 seconds of seeing the
prompt Please enter '***' to change boot configuration. After *** is entered, the CUE
module loads a very basic interface called boot loader mode. In the boot loader mode, a
network profile must be configured with the config command. The profile must contain an
IP address, a subnet mask, a default gateway, the location of the TFTP server that contains an
installer file, and the name of the installer file. This profile is then invoked by the boot helper
command. The installer environment loads across the network via TFTP. During this phase,
there is a lot of output to the console. When the prompt reads se-ip-address-installer>, the
process is complete and installation of the CUE system software, upgraded license file, or both
may begin.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-63
Upgrading CUE:
1.x to 2.x (Cont.)
-
- - -
-
- -
--
-- --
-- --
Boot loader
- -
-
2005 Cisco Systems, Inc. All rights reserved.
prompt is
where install instructions
are given.
IPTX v2.05-56
The above output shows the process to upgrade a 1.x version of CUE to a 2.x version. In order
to initialize the boot loader, the CUE module must be restarted and given a sequence of keys
that interrupt the normal boot process. To reboot the CUE module, enter the reload command.
To enter boot loader mode, enter *** when prompted. This starts the boot loader. It looks
similar to the normal bootup of the CUE module. The prompt isServiceEngine boot-loader>
if correctly booted. The boot loader must then be configured with a basic network configuration
as well as with the location of the installer file or license file.
Note
There will be large amounts of output, and the boot loader can take several minutes to
initialize.
After you are in boot loader mode, verify the connectivity to the TFTP server where the
cue-installer.2.1.1 file is located.
5-64 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Upgrading CUE:
1.x to 2.x (Cont.)
-
--
-
-
-
-
-
-
Boot helper
initialized the loading
of the installer
package.
IPTX v2.05-57
Because the boot loader must go across the network, a profile that contains an IP address, a
subnet mask, a default gateway, the address of the TFTP server, and an installer file name must
be configured. The Ethernet interface must remain at the default of internal, and the default
boot should be disk.
After the configuration is complete, initiate the loading of the installer by using the command
boot helper. This uses the configuration information that was entered to load the installer. This
takes some time, and a large amount of output is generated to the console. When the installer
has been loaded across the network, a reboot occurs automatically, and the prompt changes.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-65
Upgrading CUE:
1.x to 2.x (Cont.)
TFTP Server
and FTP Server
IP
cue-installer.2.1.1
cue-vm.2.1.1.pkg
cue-vm.2.1.1.prt1
cue-vm-xx-license.2.1.1.cme.pkg
cue-vm-en_US-lang-pack.2.1.1.pkg
IPTX v2.05-58
When you are in the installer mode, you will see commands instructing you to load a package
across the network. To avoid repeating this process twice, load the license package first, then
load the software package.
Caution
5-66 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Upgrading CUE:
1.x to 2.x (Cont.)
- --
- -
- -
-
-- -
- -
-
-
-
IPTX v2.05-59
Select 1 Install software and define the name of the package to install, the URL of the
FTP server, and login credentials.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-67
Upgrading CUE:
1.x to 2.x (Cont.)
TFTP Server
and FTP Server
IP
Select the language or languages to
install.
cue-installer.2.1.1
cue-vm.2.1.1.pkg
cue-vm.2.1.1.prt1
cue-vm-xx-license.2.1.1.cme.pkg
cue-vm-en_US-lang-pack.2.1.1.pkg
IPTX v2.05-60
Select a language to install on the CUE module. The software installation will then proceed.
When the software package is loaded, the hard disk is overwritten and a fresh copy of the
software is installed.
Caution
The reimaging process may take many minutes, depending on the storage media. The
flash-based AIM-CUE may take significantly longer than the hard drive based NM-CUE
and NM-CUE-EC.
5-68 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Upgrading CUE:
1.x to 2.x (Cont.)
-
-
-
-
Selects English to be
installed on the CUE
installation
IPTX v2.05-61
The language page appears next and allows the user to select up to two different languages
from the supported list. CUE version 2.1 currently supports English US, French France,
German Germany, and Spanish Spain.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-69
Upgrading CUE:
1.x to 2.x (Cont.)
-
-
-
-
Done selecting
languages
- - --
IPTX v2.05-62
When the language has been selected, a * will appear next to that language in the menu.
Enter x to exit the language menu.
The CUE system reboots itself, then prompts the installer to perform the initial configuration of
the CUE module. A hostname, domain name, DNS server address, NTP server address, and
time zone are defined during the initial configuration. The CUE module loads the new software
image and the CUE prompt appears.
5-70 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Select the backup entry that the restore should use. Click the
Start Restore button to initiate the process.
Reload the module.
IPTX v2.05-63
To restore the data and configuration after an upgrade of the software, either the GUI or the
CLI can be used.
The GUI web page can be reached by choosing
Administration > Backup/Restore > Start Restore
.
From here, the backup to be restored can be selected as well as what to restore: the configuration,
the data, or both. If multiple backup sets exist, only one may be selected to restore.
As is necessary when performing a backup, the system must go off-line to perform a restoration
from backup. This should not be a problem with an upgrade. At the end of the restoration, a
prompt allows the administrator to set the system to go back online.
Note
The amount of time that is required to restore the data depends on the amount of data. The
data that contains the voice mails usually takes the longest.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-71
-
-
--
-
IPTX v2.05-64
The restoration can be performed from the CLI as well. The first command that must be
entered viewed using the show backup history command. The backup ID is needed to
activate the backup.
---
-
IPTX v2.05-65
After the backup ID is known, the restore id backupID category [all | configuration | data]
command can be entered. This initializes the restore operation. Upon completion, the CUE
system must be reloaded.
5-72 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Summary
Summary
Performing an upgrade or reinstallation may require
a TFTP server, an FTP server, and files downloaded
from CCO.
Two form factors exist for the CUE module:
an NM-CUE and an AIM-CUE.
Prior to installation, the Cisco CallManager Express
router will require configuration.
The installation or upgrade process involves
loading an installer file, then installing either the
license file or the application from an FTP server.
After installation of the application, a setup utility
will run to set basic parameters.
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.05-66
Summary (Cont.)
Prior to installation, the Cisco CallManager Express
router will require configuration.
The CUE module starts automatically and can be
reloaded in various ways.
The CUE initialization wizard is run only after an
installation of software.
The CUE initialization wizard is a macro that sets
commonly used settings on the CUE.
To upgrade an installation, backup the CUE, install
the newer version, or new license, then finally
restore from the backup.
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.05-67
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-73
5-74 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Lesson 3
This lesson defines the Cisco Unity Express (CUE) Auto Attendant and how it is used in a
production environment. It also defines how to customize additional automated attendant
scripts using the CUE Auto Attendant Editor (CUE AA Editor) and how to install and
configure them with a trigger. Interaction with the system to implement an Emergency
Alternate Greeting (EAG) and Administration Via TUI (AVT) is also discussed.
Objectives
Upon completing this lesson, you will be able to describe the components of and tasks required
to configure CUE Auto Attendant. This includes being able to meet these objectives:
Describe the workflow of CUE Auto Attendant
Describe CUE AA Editor and perform the steps for automated attendant script creation
Describe how to define the holidays
Describe how to define business hours
Describe CUE scripts and prompts
Perform the tasks to set up CUE Auto Attendant
Describe EAG and perform the tasks for configuration
Describe Administration Via TUI and perform the tasks for configuration
IPTX v2.05-3
The automated attendant functionality of CUE plays messages that callers hear when they dial
the companys telephone number, including prompts to guide the callers to specific extensions
or employees.
CUE can currently have up to five automated attendants per system that are active at any one
time. This allows for different numbers that a caller can dial to reach different sets of prompts
and menus. If the system default automated attendant is not desired, customized versions may
be constructed. This allows a customer to use custom prompts and custom call flows in the
automated attendant function.
A custom automated attendant can be constructed in a GUI by using the CUE AA Editor. This
editor allows for the easy construction of scripts by using prebuilt modules called steps. The
steps are logic blocks that can be placed in a specific order. These steps are then saved to a
script that can be uploaded to the CUE module.
Within the automated attendant, it is often desirable to have a message that is set up to play at
the front of the automated attendant script during an emergency. This allows the administrator
to toggle the EAG on and off through the TUI by using an IP Phone and dialing the AVT
number.
5-76 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.05-4
CUE comes with a default automated attendant. The default automated attendant maps to a
script called aa.aef (.aef is the file extension that all customized scripts need to be saved with).
This aa.aef script cannot be downloaded into the CUE AA Editor or even viewed. However, the
opening greeting wave file can be modified in the GUI web pages, and the EAG can be
activated via the TUI.
Four additional automated attendants can be uploaded and activated on both the CUE network
module (NM-CUE) and the CUE advanced integration module (AIM-CUE).
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-77
555.1212
PSTN
555.6789
555.2333
General Auto
Attendant:
Welcome to ACME
Publications ...
Specific Auto
Attendant :
Welcome to the
ACME automotive
center
Specific Auto
Attendant :
Welcome to the
ACME graphic
services
IPTX v2.05-5
If additional customization is required, a custom script can be constructed and associated with
a phone number. It is not uncommon for an enterprise to have multiple phone numbers and
want a different automated attendant for each. This allows for an enterprise to customize the
interaction of the caller based on the number dialed. It is also possible to associate multiple
phone numbers to run the same automated attendant.
Example
In the example in the figure, ACME has three different divisions, and each requires a different
automated attendant. If a customer dials the general phone number, then the general automated
attendant plays; if the automotive number is dialed, then the specific automated attendant for
that division plays. A third number for graphic services is tied to the specific automated
attendant for that division.
Note
5-78 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.05-6
Constructing a custom automated attendant requires that the CUE AA Editor is installed on a
Windows PC. This interface is used to construct the script off-line. The script is then uploaded
to CUE. The CUE system allows up to eight stored scripts on the CUE-NMs and four on the
CUE-AIMs. The custom scripts can be very complex there is no realistic limit to the number
of steps involved in customizing a script.
When custom scripts are constructed, they usually require the creation of custom prompts. The
AIM-CUE can have up to 25 prompts with a maximum size of 1 MB each, and the NM-CUE
can have up to 50 prompts with a maximum size of 1 MB each. The prompts themselves can be
recorded off-line and uploaded to the CUE system through the GUI or the command-line
interface (CLI). Prompts can also be recorded through the AVT if desired.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-79
Prompt Parameters
Record Prompts
Prompts used in script(s) can be recorded off-line and uploaded to the CUE
system
Prompts can also be recorded and managed via the TUI
IPTX v2.05-7
To create, install, and test the automated attendant application involves multiple steps. The first
step is to create a customized script if the default does not meet the needs of the enterprise. This
script creation is accomplished in a software tool called the CUE AA Editor. After the script is
created, it needs to be uploaded to the storage on the CUE module. Usually new prompts will
need to be recorded and uploaded to the storage of the CUE module as well.
After the script and prompts are present on the storage of CUE, the CLI or the GUI can be used
to create the automated attendant application. The automated attendant application connects the
script, pilot number, and the maximum number of ports. The new automated attendant
application invokes the prompts that are present in the storage of CUE.
It is important to test the function of the automated attendant application by calling the pilot
point number, which is also referred to as the pilot number.
5-80 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
PSTN
IP
4. Upload the script and prompts
to the CUE system for active call
control.
IPTX v2.05-8
The process of script preparation starts with installation of the CUE AA Editor. This
application can be installed on any modern Windows-based computer. The application itself
can be obtained from Cisco Connection Online or a CUE CD set. After the CUE AA Editor is
installed, it can be used to create a script. This script should be validated before saving it with
an .aef extension. After saving the script, upload it to the CUE system.
Usually when making a new script, new prompts must also be made. These can be recorded
either with the AVT or outside the system. Regardless of how the recording is made, the scripts
must be present on the CUE system. If they were recorded in the AVT, then they are already
present on the system; if recorded in another way, they must be uploaded.
Note
The construction of scripts in the CUE AA Editor is actually a type of visual programming,
and any experience in programming is helpful.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-81
CUE AA Editor
Palette
Folders
of Steps
Variable
Window
Work Area
Debug and
Message
Window
IPTX v2.05-9
The CUE AA Editor is a script editor that offers a visual programming environment for
creating automated attendant application scripts. You can use the CUE AA Editor on any PC
that has one of the following Microsoft Windows operating systems:
Windows NT (workstation or server) with Service Pack 4 or later
Windows 2000 (professional or server)
Windows XP Professional
The CUE AA Editor simplifies script development by providing blocks of contact-processing
logic in easy-to-use Java-based steps. Each step has its own unique capabilities, such as simple
incrementing, generating and playing out prompts, and obtaining user input.
Although the steps are written in Java, you do not need to understand Java programming to
build a CUE automated attendant script. You can assemble a script by dragging step icons from
a palette on the left pane of the workspace to the design area on the right pane of the workspace.
The CUE AA Editor supplies the code required to connect the steps; you provide the variable
definitions and other parameters. You can validate the completed script directly in the editor.
5-82 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
CUE AA Editor:
Constructing a Script
When starting a new
script, the only step
present in the workspace
will be a start step.
Steps are Java Beans.
Drag and drop steps
from the palette to the
workspace.
When dropping the step in
the workspace, it must be
dropped on top of an
existing step. It will then
appear below.
Validate the script, and if
successful, save with an
.aef extension.
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.05-10
A step must be dropped on top of another step it will then appear below the step it was
dropped on. If you try to drag a step to the Design pane when a Step Properties window is
open, the Design pane will not accept the step. Before you drag a step to the Design pane,
close any open Properties windows, one or more of which may be hidden behind the CUE
AA Editor window.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-83
CUE AA Editor:
Variables
To add a variable, click
the Add New Variable
button and define the
variable.
Check the parameter
box to allow this value
to be defined from the
CUE web pages by
the administrator
(top-level script only).
The value of the
variable can be
another variable or
explicitly defined here.
IPTX v2.05-11
Adding Variables
The Variable pane of the CUE AA Editor is where you add and modify the variables used by
the script. Variables store data that a script uses when it executes the steps. Any step in your
script can use variables after you define them in the Variable pane of the CUE AA Editor
window.
You can also map variables that you define for your script to variables that you define in a
subflow, which is a set of steps that function as part of another script, called the primary script.
A subflow can use and manipulate a variable, then return the data that is stored in the variable
to the primary script. Scripts cannot share variables with other scripts except in the case of
default scripts, where the primary script automatically transfers the values of its variables to
a default script. The value of a variable can change during execution.
To define a new variable, click the New Variable icon at the top left corner of the Variable
pane of the CUE AA Editor window. The Edit Variable window appears. In this window, you
can define a name. It is suggested that a naming convention be used so that variables can be
recognized easily. This naming convention simplifies configuration and enables the script
programmer to know by the name of the object if the object is a variable.
The type of variable can also be selected in the Type window. The value of the variable as well
as the parameter option can be defined.
Note
The parameter value field can contain an explicit pointer to a file, can contain another
variable, or can be left blank and populated by the script or populated in the GUI.
If checked, the parameter option allows the value of the variable to be set or overridden in the
CUE GUI. This allows changes to the script without having to open the CUE AA Editor.
5-84 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Note
The parameter option works only for top-level scripts. It does not work for nested scripts.
Using a naming convention is also beneficial when troubleshooting. There are many possible
naming conventions that can be used the main thing is to be consistent. An example of a
naming convention is to use two words with the letters of the first word all lowercase and the
first letter of the second word uppercase, such as, myVariable and testPrompt.
Variable Types
Boolean
A Boolean variable is either true or false, and it is used primarily by the If step in the General
palette of the CUE AA Editor.
Java Class Name java.lang.Boolean
Variable Input Format:
t, f
true, false
Character
A Character variable consists of characters, such as letters of the alphabet.
Java Class Name java.lang.Character
Variable Input Format:
Lowercase letters a to z
Uppercase letters A to Z,digits 0 to 9
Any escape sequence:
\uXXXX can be used to represent any character using the character hexadecimal
Unicode number XXXX
Float
A Float variable consists of decimal numbers.
Java Class Name java.lang.Float
Variable Input Format (examples):
3.14159
2E-12
-100
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-85
Integer
An Integer variable consists of whole numbers from 2147483648 to 2147483647 inclusive.
Java Class Name java.lang.Integer
Variable Input Format (examples):
234556789
0
23
String
A String variable consists of a set of Unicode characters from \u0000 to \uffff inclusive.
Java Class Name java.lang.String
Variable Input Format (examples):
Hello, C:\WINNT\win.ini; this format does not support any escape characters or
Unicode characters.
Date
The Date variable contains date information.
Java Class Name java.util.Date
Variable Input Format (examples):
D[12/13/05]
D[Dec 13, 2005]
D[January 20, 2005]
D[Tuesday, April 12, 2005]
D[12/13/05]
D[12/13/05 5:50 PM]
D[April 1, 2005 12:00:00 AM PST]
The parameter specified inside the brackets following D (D[ ]) is parsed based on any
combination of the following two formats:
<date>
<date> <time>
The CUE AA Editor supports four <date> specification formats:
SHORT completely numeric, such as 12/13/05
MEDIUM somewhat longer, such as Jan 12, 2005
LONG longer, such as January 12, 2005
FULL completely specified, such as Tuesday, April 12, 2005
5-86 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Time
The Time variable contains time information.
Java Class Name java.sql.Time
Variable Input Format (examples):
T[3:39 AM]
T[11:59:58 PM EST]
The parameter specified inside the brackets following T (T[ ]) is parsed based on the format
<time>.
The CUE AA Editor supports three <time> specification formats:
SHORT short, such as 3:30 PM
MEDIUM longer, such as 3:30:32 PM
LONG or FULL (which are identical) more complete, such as 3:30:42 PM PST
BigDecimal
The BigDecimal variable consists of an arbitrary-precision integer, along with a scale in which
the scale is the number of digits to the right of the decimal point.
Java Class Name java.math.BigDecimal
Variable Input Format (examples; same as Float variable):
3.14159
2E-12
-100
BigInteger
The BigInteger variable represents arbitrary-precision integers.
Java Class Name java.lang.BigInteger
Variable Input Format (examples; same as Integer variable):
234556789
0
23
Double
The Double variable represents an expanded Float variable.
Java Class Name java.lang.Double
Variable Input Format (examples; same as Float variable):
3.14159
2E-12
-100
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-87
Long
The Long variable is an expanded Integer variable.
Java Class Namejava.lang.Long
Variable Input Format (examples; same as Integer variable):
234556789
0
23
5-88 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
CUE AA Editor:
General Steps
Step
Description
Annotate
Call Subflow
Invoke a subflow.
Day of Week
Decrement
Delay
End
Goto
If
Increment
Label
Set
Start
Switch
Time of Day
Is Holiday
Check if it is a holiday.
Business Hours
IPTX v2.05-12
Call Subflow
Use the Call Subflow step to execute a subflow, which is analogous to a subroutine or module
in structured programming. Use the CUE AA Editor to create the subflow as an independent
script that you can reuse in other scripts. Subflows can be nested; that is, you can call subflows
from within scripts that are themselves used as subflows. During run time, if an exception
occurs within a subflow and you do not handle the exception within the subflow, the exception
is available to the parent script for processing.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-89
Day of Week
Use the Day of Week step to direct the script to different connection output branches
depending on the current day of the week. When the CUE system clock matches one of the
days associated with a connection, the script executes any steps that you configured for that
days connection branch. Configure all days with output branches and assign each day its own
connection(s). If a day is not assigned to at least one output branch, the CUE AA Editor
displays a warning dialog box when you close the Day of Week customizer window.
Decrement
Use the Decrement step to decrease the value of a chosen Integer variable by one. This step is
a specialized version of the Set step of the General palette, which you use to assign any value to
a variable. To decrease the chosen Integer variable by one, choose the desired variable from the
Variable drop-down menu and click OK. The Decrement customizer window closes. The
variable appears next to the Decrement step icon in the Design pane of the CUE AA Editor.
Delay
Use the Delay step to pause the processing of a script for a specified number of seconds.
End
Use the End step at the end of a script to complete processing and to free all allocated
resources. You can also use the End step at the end of a branch of logic in a script. Any call
still active by the time this step is executed automatically is processed by the system default
logic. This step has no properties and does not require a customizer.
Goto
Use the Goto step to cause the script logic to branch to a specified Label step within the script.
If
Use the If step to cause the script to go to one of two branches based on the evaluation of a
specified Boolean expression.
The If step automatically adds two output branches, Trueand False:
True: Steps following this output branch execute if the expression is true.
False: Steps following this output branch execute if the expression is false.
Increment
Use the Increment step to increase the value of a chosen Integer variable by one. This step is
a specialized version of the Set step of the Generalpalette, which you use to assign any value
to a variable.
Label
Use the Label step to insert a label into a script to serve as a target for a Goto step within the
same script.
5-90 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
On Exception Clear
Use the On Exception Clear step to remove an exception set by a previous On Exception
Goto step. Typically, this step is used in the following sequence:
1. An On Exception Goto step directs the script to a Label step.
2. The Label step is configured with a script to handle the exception.
3. An On Exception Clear step is then used to clear the exception.
You may also use this step when you no longer need to handle the selected exception within
the script.
On Exception Goto
Use the On Exception Goto step to catch problems that may occur during script execution and
allow a graceful exit from the situation. You can include any script steps in the Exception Flow
branch that you want to use to respond to the exception. If you are using subflows and the
subflow does not handle an exception, the exception is returned to the script and the script
can respond to it.
Set
Use the Set step to change the value of a variable. The Set step supports type casting
(with possible loss of precision) from any Number data type (Integer, Float, Long, Double,
BigInteger, BigDecimal) to any other Number data type. You can also use the Set step to
convert a String variable to any Number data type. For String conversions, the system replaces
all * characters with a decimal point (.) before performing the conversion.
Start
The CUE AA Editor automatically adds the Start step when you create a new script by
choosing File > New. This step has no properties and does not require a customizer. It is not
shown in any palette.
Switch
Use the Switch step to cause the program logic to branch to one of a number of cases based on
the evaluation of a specified expression. A case is a method for providing script logic based on
the value of a variable at a point in time. You can assign one case for each value. The Switch
step lets you define any number of case output branches. You can then create separate script
logic for each branch.
The Switch step supports switching based on the following variables:
Integer: Comparison of integers
String: Comparison of string variables (case insensitive)
The type of switching is automatically determined by the type of the specified expression. If the
integer or string expression you specify for a case is equal to the global expression defined in
the Switch Expression field, the script executes the steps configured for that case output branch.
The Defaultbranch of the step allows you to handle cases in which none of the branches
matches the expression.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-91
Time of Day
Use the Time of Day step to cause the script to branch to different connection branches
depending on the current time of day. When the CUE system clock indicates that the time of
day matches the time associated with a connection, the script executes any steps configured for
that output branch. Associate each output branch with a specified range of time. During run
time, if the current time falls out of the configured time range, the script follows the Restoutput
branch of the Time of Day step.
Is Holiday
Use to determine if the day is a defined holiday.
Business Hours
Use to determine if the time of day is within the defined open hours or closed hours.
5-92 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
CUE AA Editor:
User and Prompt Steps
Step
Description
User
Prompt
Create
Conditional
Prompt
Create Container
Prompt
Create
Generated
Prompt
IPTX v2.05-13
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-93
5-94 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
CUE AA Editor:
Contact and Call Contact Steps
Step
Contact
Call
Contact
Description
Accept
Answer a call.
Terminate
Disconnect a call.
Call Redirect
IPTX v2.05-14
You cannot mark a contact as unhandled. After a contact is reported as Handled, it is always
reported with that status.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-95
Terminate
Use the Terminate step to disconnect the call.
The steps in the Call Contact palette of the CUE AA Editor provide script designers with a way
to manage calls.
Call Redirect
Use the Call Redirect step to redirect a call to another extension. The Call Redirect step is
often used in applications to transfer a call after a desired extension has been specified.
The Call Redirect step produces four output branches:
Successful: The call is ringing at the specified extension.
Busy: The specified extension is busy and the call cannot be transferred.
Invalid:The specified extension does not exist.
Unsuccessful:The redirect step fails internally.
Configure script steps after each of the four branches to handle the possible outcomes of a
redirected call.
Get Call Contact Info
Use the Get Call Contact Info step to access call-specific information and to store values in
specified variables. You can use this step to handle a call in a variety of ways depending on the
source of the call and other properties associated with the session. For example, you can use
this step with the Call Redirect step to transfer a call to another extension, or you can use this
step with the Play Prompt step to play a voice prompt.
5-96 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Step
Description
Explicit Confirmation
Implicit Confirmation
Menu
Name To User
Play Prompt
IPTX v2.05-15
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-97
Menu
Use the Menu step to provide a menu from which callers can choose a series of options. The
Menu step receives a single digit entered by a caller and maps this entry to a series of option
output branches. The system executes the steps that you add after each of these option output
branches.
Name To User
The Name To User step is typically used to prompt a caller for the name of the person being
called (using DTMF), then to compare the name entered by the caller with names stored in a
directory. The Name To User step is often used in a script to automatically transfer a caller to
the extension of the person being called.
Another useful function of the Name To User step is to assign a value to a variable that can
later be queried using the Get User Info step to retrieve information such as the extension,
e-mail address, and spoken name of the user selected by the caller.
Play Prompt
Use the Play Prompt step to play back specified prompts to the caller.
5-98 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
CUE AA Editor:
Validate
When done
constructing the
script with steps:
IPTX v2.05-16
Validating checks for construction errors; it does not verify the logic of the script.
The next step after validation is to save the script with an .aef extension, then upload the script
through the administrator GUI web pages.
Note
Failure to validate the script can result in an invalid script being uploaded to the CUE
module, and this script will not be usable.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-99
Holiday List
Holiday List
Three years of holidays can be configured:
Moving window of the previous, current, and upcoming
year
Up to 26 holidays per year
In the GUI or the CLI, add a holiday by entering a date and an
optional description to identify the holiday.
Holidays can be copied from the current year to the next year
in the GUI.
Holiday lists can be used for Auto Attendant functionality
only.
The system and custom Auto Attendants can use the holiday
lists to branch to special menu items or prompts on these
dates.
IPTX v2.05-17
CUE permits configuration of a holiday list that causes the Auto Attendant to play a
customizable greeting to callers when the company is closed for a holiday. When a caller
reaches the Auto Attendant, the Auto Attendant plays the welcome prompt and checks to see if
the current day is a holiday. If it is a holiday, the Auto Attendant plays the holiday prompt to
the caller.
In the system Auto Attendant script provided with the CUE package, this prompt is called
AAHolidayPrompt.wav and by default says, We are closed today. Please call back later. You
can customize this prompt by recording a more meaningful message, such as We are closed
today for a holiday. If this is an emergency, please call 222 555-0150 for assistance. Otherwise,
please call back later.
By default, no holidays are configured on the CUE system. Up to three holiday lists the
previous year, the current year, and the upcoming year may be configured. If a year has no
configured entries, the system treats that year as having no holidays. Each of these years may
have a maximum of 26 holidays configured. This configuration may be done from either the
GUI or the CLI.
5-100 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Previous year:
System saves the holiday list, but cannot add or modify; can
only delete
IPTX v2.05-18
The administrator can delete entries from a previous years list but cannot add or modify that
list in any other way. The system automatically deletes the previous years list when the list is
more than one year old. For example, the system will delete the 2004 holiday list on January 1, 2006.
IPTX v2.05-19
To add a holiday, choose the Holiday Settings object from the Voice Mail drop-down menu,
then choose the Add link.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-101
IPTX v2.05-20
Choose Add and select the date of the holiday that is being added to the year. Choose Add to
commit the changes.
- -
-
-
-
-
-
-
-
-
-
5-102 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
-
-
-
-
--
--
IPTX v2.05-21
-
-
--
--
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.05-22
From the IOS router CLI, use the show calendar holiday command to display the
configured holidays.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-103
IPTX v2.05-23
CUE permits configuration of business hours that will cause the Auto Attendant to play a
customizable greeting to callers during off-hours. The system administrator can configure a
business hours schedule with the following properties:
Up to four business schedules may be configured.
Each 24-hour day is divided into half-hour time slots.
The system default is open for 24 hours each day.
The configuration can be done from the GUI or the CLI.
Use the GUI to copy one business schedule to another schedule, which can then be
modified.
5-104 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.05-24
When a caller reaches the Auto Attendant, the Auto Attendant plays the welcome prompt and
checks if the current day is a holiday. If it is a holiday, the Auto Attendant plays the holiday
greeting to the caller and does not check the business hours schedule.
If the current day is not a holiday, the system checks if the business is open. If it is, the business
open prompt plays. In the system Auto Attendant, this prompt (AABusinessOpen.wav) is
empty. If the business is closed, the system plays the business closed prompt. In the system
Auto Attendant, this prompt (AABusinessClosed.wav) plays We are currently closed. Please
call back later.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-105
IPTX v2.05-25
The CUE system ships with one default schedule, called SystemSchedule. This schedule
treats the business as open 24 hours per day, seven days per week. Use the GUI option
Voice Mail > Business Hours Settings or CLI commands to modify or delete this schedule.
To construct a new business schedule, choose Add and give the schedule a name, and
optionally, use an existing business schedule as a template.
IPTX v2.05-26
On the new schedule, select the half-hour increments to set the system to determine the open or
closed hours of the day.
5-106 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
- -
IPTX v2.05-27
At the CLI, use the command calendar biz-schedule to define or enter the configuration of a
definable schedule. After you are in the business subconfiguration mode, enter the open and
closed times using the openclosed command, respectively. When using either the open or
closed command, the day of the week must be specified by entering a numeric value. The
following are the available numeric values and their meaning:
1 Sunday
2 Monday
3 Tuesday
4 Wednesday
5 Thursday
6 Friday
7 Saturday
The range of time also needs to be specified. This is done by entering a 24-hour time value in
the hh:mm format.
Note
Valid time of day values may have an mm value of either :00 or :30.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-107
IPTX v2.05-28
- -
---
-
-
-
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.05-29
Use the command show calendar biz-schedule to display the configured business schedules.
5-108 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.05-30
Both custom scripts and custom prompts must be uploaded to the CUE module for them to
function. This may be done through either the GUI or the CLI of the CUE module. In addition
prompts may also be recorded from the TUI of the IP Phone. The CUE module has some
default scripts and a default welcome prompt. The default scripts may not be modified, deleted,
or viewed.
Note
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-109
IPTX v2.05-31
This figure shows the system scripts that are present after the installation of CUE. These
scripts are used by the system to perform system functions and include the following seven
default scripts:
aa.aef: the system automated attendant that plays by default
aasimple.aef: a simplified automated attendant to handle alternate, holiday, and business
hour greetings
checkaltgreet.aef: a subflow that checks for the existence of the AltGreeting.wav and
plays it if present; can be invoked by custom scripts
promptmgmt.aef: used by the TUI when it is called
setmwi.aef: used by the system to set the Message Waiting Indicator (MWI) lights on or off
voicebrowser.aef: the script that is used when voice mail is called
xfermailbox.aef: the script that is used to transfer a caller to a mailbox
5-110 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.05-32
System scripts cannot be deleted or downloaded. Therefore, they are grayed out. Scripts that are
not grayed out are custom scripts that can be deleted or downloaded.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-111
- --
IPTX v2.05-33
The command show ccn scripts shows the scripts that are currently uploaded to the CUE
system. Also displayed is the date the scripts were created and modified, along with their size.
Example
This shows the default scripts that are on a CUE system after installation.
- --
Name:
xfermailbox.aef
setmwi.aef
Name:
voicebrowser.aef
5-112 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Name:
aa.aef
Name:
promptmgmt.aef
Name:
checkaltgreet.aef
Name:
aasimple
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-113
Prompts
IPTX v2.05-34
Custom Prompts
IPTX v2.05-35
This figure shows that there have been three prompts uploaded to the CUE system from the
GUI or the CLI and one created through the TUI. The prompt created through the TUI has a
name that includes the time when the prompt was recorded. For example, if the name of the file
is UserPrompt_06252004192506.wav, the name of the file contains the date and time of June
25, 2004, at 7:25:06 p.m.
5-114 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.05-36
In this figure, the parameters of a new application are being modified through the administrator
GUI web pages. In this case, the AAWelcome.wav prompt is being replaced with a new prompt
that is being uploaded from the administrator PC.
When custom prompts are recorded, the file format requires the following:
1-MB file size limit on any prompt
Maximum of 50 prompts on an NM-CUE
Maximum of 25 prompts on an AIM-CUE
No error checking on file format during upload
Format for file must be .wav
G.711 mu-law
8 kHz
8 bit, Mono
Note
The system does not verify that the prompt is formatted correctly.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-115
IPTX v2.05-37
The command ccn copy url source destination can be used to either upload or download scripts
and prompts to or from the CUE system.
Example
Uploading a prompt called test.wav as newAA.wav to the CUE system:
-
- -
Name:
newAA.wav
5-116 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
- -
IPTX v2.05-38
The command show ccn prompts displays the prompts that reside on the CUE system.
Example
This shows the system default prompt of AAWelcome.wav and a prompt recorded through the
AVT called UserPrompt_030820040161012.wav.
- -
Name:
AAWelcome.wav
Name:
UserPrompt_03082004061012.wav
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-117
IPTX v2.05-39
Prompt names cannot be changed through the GUI or the CLI. In order to change a prompt
name, the following procedure must be followed:
Download the prompt to a PC using either the GUI or the CLI.
Change the filename on the PC.
Upload the prompt back to CUE.
Change any parameters in applications to point to the new name.
Delete the old prompt.
Example #1
The prompt UserPrompt_03082004061012.wav was created throught the AVT and the
administrator wishes to change the name.
-
-
Example #2
The prompt UserPrompt_03082004061012.wav was created in the TUI and the administrator
wishes to change the name.
Step 1
-
-
5-118 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Step 2
Step 3
Step 4
Update any references to the old prompt name with the new prompt name through
either the GUI or the CLI.
-
-
Step 5
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-119
IPTX v2.05-40
There is a system default automated attendant installed on the CUE module. Although this may
not meet the needs of many installations, it does provide basic automated attendant functions. If
the default automated attendant does not meet the needs of the installation, creation of a custom
automated attendant is required.
5-120 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.05-41
The automated attendant system that comes with the CUE installation uses the same prompts as
the CUE product. The system default is to play a file called AAWelcome.wav that contains a
verbal menu that presents the following options:
Press 1 to dial by number.
Press 2 to dial by name.
Press 0 to connect to the operator.
Note
The AAWelcome.wav file can be changed to use a different greeting wave file. However, the
menu options cannot be changed in the system script. If different options are desired, a custom
script must be constructed.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-121
----
-
--
--
---
---
----
-
---
IPTX v2.05-42
The command show ccn application displays the applications that are active on the
CUE system.
Example
This shows the default applications after the installation of CUE.
-
Name:
ciscomwiapplication
Description:
Script:
setmwi.aef
ID number:
Enabled:
ciscomwiapplication
0
yes
voicemail
Description:
Script:
voicebrowser.aef
ID number:
Enabled:
voicemail
1
yes
5-122 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
http://localhost/voicemail/vxmlscripts/login.vxml
Name:
autoattendant
Description:
Script:
autoattendant
aa.aef
ID number:
Enabled:
yes
AAHolidayPrompt.wav
busClosedPrompt AABusinessClosed.wav
allowExternalTransfers false
MaxRetry:
operExtn:
2001
welcomePrompt: AAWelcome.wav
businessSchedule systemschedule
Name:
promptmgmt
Description:
Script:
promptmgmt.aef
ID number:
Enabled:
promptmgmt
3
yes
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-123
IPTX v2.05-43
To view an application, choose Voice Mail > Auto Attendant. A list of the installed
automated attendants appears. In the figure, there are five automated attendants configured.
One of the five is the system default, which may be changed to use a nondefault script. Four of
the five automated attendants are custom and have been previously configured.
To configure custom automated attendants, perform the following steps in the series of
windows that appear after adding a new automated attendant:
Step 1
Step 2
Step 3
5-124 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.05-44
To add an application, choose Voice Mail > Auto Attendant. A list of the installed automated
attendants appears. Click the Add link to open the Add a New Automated Attendant window.
The first configuration page appears and allows a previously uploaded script to be associated
with this new application. In addition, on this page a language other than the system default can
be configured and a name can be assigned that will be used for the new application. When
completed, click Next.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-125
IPTX v2.05-45
The second configuration page appears and allows the administrator to set any variables that
have the parameter option selected in the script. If the variable was defined to be a prompt type,
then the Upload button appears to the right of the field along with a drop-down menu that
displays the uploaded prompts currently in the system. Other types of variables accept other
types of data as appropriate.
Although the use of variables is not mandatory, the use of variables with the parameter setting
allows customization of the scripts from the GUI or the CLI without using the CUE AA Editor.
The proper use of variables in construction of the script greatly enhances the power and
flexibility of custom scripts. It also makes administration easier whenever a change is needed
by eliminating the need to open a script in the CUE AA Editor, then reupload it.
Note
In most instances, the recorded prompt should accurately reflect the options available in the
menu unless hidden options are desired.
5-126 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.05-46
The final configuration page is where the phone number that maps to this automated attendant
is defined. This number should be set to what is delivered to CUE because digit manipulation
may happen on the Cisco CallManager Express router. The maximum number of sessions on
which this automated attendant can be simultaneously playing can also be defined. This does
not dedicate ports; it only sets an upper limit to the number of ports that can be in use by this
automated attendant at any one time.
Note
The Cisco recommendation is to configure all ports in one pool and allow both voice mail
and the automated attendant to use any free port in the pool. This is configured by leaving
the maximum sessions at the default setting.
The automated attendant can also be enabled or disabled at this point. Up to five automated
attendants can be enabled at any one time in the CUE system. When the configuration on this
page is complete, click Finish.
Note
The number of maximum sessions possible is solely dependent upon the hardware
platforms and is not a licensed feature.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-127
IPTX v2.05-47
The show ccn trigger command allows the display of the entry point and the automated
attendant associated with it from the CLI. Note that in this graphic, when CUE receives a call to
the number 6700, the system activates the automated attendant. Up to five sessions at one time
may be used in this example.
5-128 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.05-48
To configure an automated attendant from the CLI, the administrator uses the ccn trigger sip
phonenumber number command from the global configuration mode to enter the trigger
subconfiguration mode. From the trigger subconfiguration mode, the desired application can
then be defined with the application application_name command.
Note
Multiple triggers can be defined to point to the same application if desired, but this can only
be done from the CLI.
Example
This example shows the configuration of phone number 6900 to the automated attendant
application.
CUE#configure terminal
CUE(config)#ccn trigger sip phonenumber 6900
CUE(config-trigger)#application AutoAttendant
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-129
--
IPTX v2.05-49
After the new trigger has been created, the administrator may wish to remove the old trigger.
To delete a trigger, use the no version of the ccn trigger sip phonenumber number command.
This deletes the trigger and any configuration underneath it in trigger subconfiguration mode.
Example
This shows the deletion of the pilot number 6700.
-
Name: 6700
Type: SIP
Application: AutoAttendant
Locale: en_US
Idle Timeout: 5000
Name 6900
Type: SIP
Application: AutoAttendant
Locale: en_US
Idle Timeout: 5000
-
-
5-130 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Name: 6900
Type: SIP
Application: AutoAttendant
Locale: en_US
Idle Timeout: 5000
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-131
----
-
---
------
---
------
IPTX v2.05-50
In this example, the automated attendant application has three variables with the parameters
option selected. These variables may then be defined through either the GUI or the CLI without
using the CUE AA Editor.
Example
-
Name:
autoattendant
Description:
Script:
autoattendant
aa.aef
ID number:
Enabled:
yes
3
2001
welcomePrompt: AAWelcome.wav
The eight variables that can be modified in example script are:
busOpenPrompt
holidayPrompt
busClosedPrompt
allowExternalTransfers
MaxRetry
operExtn
5-132 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
welcomePrompt
businessSchedule
All entries that come after Maximum number of sessions are custom parameters.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-133
IPTX v2.05-51
The names of the parameters can be obtained by using the show ccn application command.
Then, after entering the application subconfiguration mode by using the ccn application
application_name command, the parameters can be set. The command to set the parameters is
parameters parameter_name parameter_value.
Example
This example shows setting a parameter from the CLI for the automated attendant application.
-
Name:
autoattendant
Description:
Script:
autoattendant
aa.aef
ID number:
Enabled:
2
yes
3
2000
welcomePrompt:
AAWelcome.wav
-
5-134 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Name:
autoattendant
Description:
Script:
autoattendant
aa.aef
ID number:
Enabled:
yes
5
2000
welcomePrompt: AAWelcome.wav
Application setting
and parameters
may be set from
the GUI or the CLI.
Names are case
sensitive.
IPTX v2.05-52
This figure compares equivalent ways of configuring the parameters of an application from the
administrator GUI web page and from the CLI.
Note
When using the CLI, use the show ccn application command to view the parameter
names. Remember that case does matter.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-135
Case Study
Case Study
The ACME company has just purchased Cisco
CallManager Express and CUE for a branch office.
Management wants the automated attendant to
answer the phone and present the caller with a
custom greeting: Welcome to ACME. Please press 1
if you know your partys extension. Please press 2 to
enter the name of the party you wish to reach and 3
to talk to a sales representative. ACME also wishes
to have hidden options of 9 to reach internal
technical support and 0 to reach the operator.
What tasks need to be completed in order to
implement this design?
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.05-53
Case Study
The ACME Company has just purchased Cisco CallManager Express and CUE for a branch
office. Management wants local calls to the branch office to go to an automated attendant that
will present the caller with the custom greeting Welcome to ACME. Please press 1 if you
know your partys extension. Please press 2 to enter the name of the party you wish to reach,
and press 3 to talk to a sales representative. ACME also wishes to have hidden options of 9 to
reach internal technical support and 0 to reach the operator. What tasks must be completed to
implement this design?
5-136 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.05-54
The first question that you should ask is: Does the automated attendant system default support
the needs of ACME?
In this case, menu options of 3 and 9 are needed in addition to the system options of 1, 2, and 0.
Because you cannot download or modify the menu of the aa.aef script that is used by the
automated attendant application, you cannot use this prebuilt application.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-137
IPTX v2.05-55
A custom application must be constructed for ACME. It will be built using the CUE AA Editor.
After you have built the application, you will validate, save, and upload the script to the CUE
system.
Note
5-138 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.05-56
This figure shows the script being uploaded from the administrators PC, which is where it was
constructed. Remember that no validation is done at this point. The CUE system permits a
script that has not been validated to be uploaded.
IPTX v2.05-57
This figure shows that the script casestudy.aef is now present on the CUE system.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-139
IPTX v2.05-58
The next step is to add the application to the system. This is a three-step process. The first step
is shown in this slide. The script is assigned and given an application name. This name does
not have to match the script name, although it is common that it be configured to match. To
proceed to the next step, click Next.
IPTX v2.05-59
Step 4b allows the administrator to set the variables of the script. In order for a variable to show
up on this page, it needs to have been marked with the parameter option in the CUE AA Editor
when it was constructed. Notice that some of the variables are prompts and some are extension
numbers in this example. Click Next to continue to the final page.
5-140 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.05-60
In Step 4c, the phone number and the number of allowed sessions are set. The script could be
disabled if desired, but is enabled by default. Choose Finish to complete the addition of an
application to CUE.
IPTX v2.05-61
The last step in this case study would be to test the application by calling the number that was
defined when you set up the application. Remember to test not only a successful call, but also
the failure and problem paths through the script.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-141
The EAG is recorded via the TUI or off-line and uploaded into
the system.
If uploaded, it must have the filename AltGreeting.wav
IPTX v2.05-62
The EAG allows an administrator to record and turn on a message that plays at the beginning
of an automated attendant. This is useful in situations where the default automated attendant
greeting does not give the caller pertinent information that may be desired. For example, if a
business closed unexpectedly because of heavy snow, the administrator can put a message at
the beginning of the automated attendant that informs the caller that the business is closed
today. When the emergency is over, the message can be deactivated and deleted by using the
AVT.
The aa.aef script, which is the default automated attendant in CUE, has a call subflow step that
uses checkaltgreet.aef to check for the existence of a prompt called AltGreeting.wav. If an
alternate greeting wave file is found, the subflow plays the alternate greeting at the start of the
script. This EAG is usually recorded via the AVT. It is possible to record the greeting off-line
and upload it to the CUE system. However, it must be named AltGreeting.wav for this to
function properly.
For custom scripts, program a call subflow to the checkaltgreet.aef script and place it in the
script where you want the alternate greeting to be heard. The checkaltgreet.aef cannot be
downloaded or changed, only called upon.
The EAG can be recorded, activated, or deactivated from the TUI. Simply dial the TUI number,
enter an administrator extension and PIN, then follow the prompts.
5-142 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.05-1
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-143
Format
TUI Access
IPTX v2.05-63
The AVT can be used for recording prompts to use in custom scripts and the default automated
attendant script. To use the TUI for this, the caller must have administrator privileges to log in.
This login is accomplished by entering an extension number and PIN when prompted. In the
TUI, prompts can be recorded, reviewed, and deleted as desired.
When a prompt is created through the TUI, it is given a name that cannot be changed while it is
on the CUE system. The naming convention that is used will have UserPrompt_ with a large
number representing the date and time appended after the underscore. The only way to change
this name is to download the prompt to another machine, change the name, upload it back to
CUE, then delete the original.
Prompts may also be uploaded, downloaded, assigned to variables, deleted, and managed from
the GUI and the CLI.
Note
All prompts need to be recorded in G.711 mu-law, 8 kHz, 8 bits, and in Mono.
5-144 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.05-1
The figure shows what will be heard by the Administrator when using the AVT. The portion of
the slide in red pertains to the recording prompts.
Note
Prompts cannot be rerecorded in one step. They must be deleted first, and then recorded
again.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-145
Summary
Summary
The automated attendant on CUE has system defaults, but
these can be customized.
The CUEAA Editor is the interface that is used to create a
custom automated attendant.
To install a custom automated attendant, validate, save,
and upload the .aef file.
Use either the GUI or the CLI to upload the script.
The GUI or the CLI can be used to upload and manage
prompts.
Either the GUI or the CLI is used to associate the script
with an application and set application parameters.
The GUI or the CLI can be used to view the configuration.
2005 Cisco Systems, Inc. All rights reserved.
5-146 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.05-64
Lesson 4
This lesson defines how users interact with the Cisco Unity Express (CUE) system and how the
administrator configures those users and groups.
Objectives
Upon completing this lesson, you will be able to configure users and groups. This includes
being able to meet these objectives:
Describe user GUI and CLI interfaces
Perform the tasks for user configuration
Perform the tasks for group configuration
Perform the configuration tasks for group mailboxes
User Interface
IPTX v2.05-2
In CUE, one of the basic concepts is that each user is associated with one and only one personal
mailbox. This mailbox is associated with the primary extension of the user, and only that line
can be redirected to voice mail. Only the top line of the Cisco IP Phone has the Message
Waiting Indicator (MWI) light function. Other lines on the Phone can have a flashing envelope
appear on the screen of the Phone when a message is present.
5-148 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Number of Users
Total number of users allowed on the system
as of CUE version 2.1:
Currently two times the number of mailboxes
allowed in the license/package purchased; for
example, a 12-mailbox license CUE system allows
12 mailboxes and 24 users to be defined
A user without a mailbox still appears in the
corporate directory
IPTX v2.05-3
The current version of CUE allows the number of definable users to be up to twice the number
of licensed mailboxes on the system. This allows for users to be defined who do not have a
personal mailbox.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-149
TUI Access
The MWI light is for the top
line appearance only.
IPTX v2.05-4
The user can interact with the CUE system by using the Telephony User Interface (TUI). The
TUI is a set of prompts that guide the user who has a personal mailbox through sending and
receiving voice mails as well as recording personal greetings. The TUI can be accessed by
dialing the number of the voice mail directly or by using the Messages or Envelope Icon button
on the IP Phone. The user becomes aware of a new voice mail message by noticing the MWI
light on the Phone.
5-150 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
TUI Operation
Subscriber TUI Functions
Subscriber and caller mailbox features
Caller automated attendant interaction
Administrator TUI Functions
Emergency Alternate Greeting
Greeting Management System
Subscriber TUI functions are not generally accessible via
the GUI or the CLI except for:
Resetting the mailbox PIN
Switching between the standard and alternate greeting
TUI voice mail prompts are the same as Unity 3.5 (ported).
IPTX v2.05-5
Users can manage their personal mailbox or interact with the CUE Auto Attendant using the
TUI. The administrator can manage the Emergency Alternate Greeting (EAG) and record
prompts using the administrator TUI.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-151
GUI
Administrator vs. User
Administrator
End User
IPTX v2.05-6
The menu items that appear in the GUI vary based on the credentials that are entered to log in
to the web site. The administrator has full access over the system. Users have a subset of the
menu items that the administrator has. Users have the following options:
Configure > Phone: Users can view the Phone that is associated to them.
Configure > Users: Users can view and change some information about themselves and
view information about other users.
Configure > Groups: Users can view information about the configured groups.
Configure > My Profile: Users can view information about themselves and reset their
password and PIN.
Voice Mail > Mailboxes: Users can view their mailbox, set the zero out setting, choose
whether the tutorial runs, and choose whether to use the standard or alternate greeting.
Search > Local Directory Search: Users can view the directory of users.
Help > About: Users can view information about the CUE system.
Help > Configuration: This is the link to the online help file for CUE users.
5-152 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
GUI (Cont.)
IPTX v2.05-7
A subscriber can log in to the GUI and view a list of all other users.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-153
IPTX v2.05-8
Subscribers, when viewing themselves in the Configure > Users page, will be able to reset their
PIN and password. The PIN is used to log in to the TUI and can be changed on the Configure >
My Profile or the Configure > Users web page. Users can also change their PIN from the TUI.
The password is for access to the GUI and can be reset from the GUI only by the user or an
administrator. The password and PIN are not displayed in clear text to the administrator if the
user has changed the password and PIN at least one time. The password and PIN are displayed
to the right of the field if they were randomly generated by the system.
It is very simple for the administrator to reset a forgotten password or PIN. The administrator
simply logs in, chooses the Configure > Users menu, and selects the user. On the user profile
page, the administrator highlights the password, the PIN, or both and enters the new password
and PIN.
Note
The password and PIN cannot be seen by the administrator if the user has changed them at
least once. The administrator can only reset them to a known value.
5-154 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
User Configuration
IPTX v2.05-9
When creating users, remember that usernames and passwords are case sensitive.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-155
IPTX v2.05-10
To add a user, an administrator chooses the Configure > Users web page. The administrator
clicks the Add link, and the Add New User web page appears.
5-156 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
First Name *
Last Name *
Nick Name *
Display Name *
Primary E.164 Number
Associated Phone
Primary Extension
Language
Password settings
PIN settings
Create Mailbox
Forward Setting
IPTX v2.05-11
This example shows an administrator changing the settings of a user with a username of
ZBeetlebrox. The Phone with a MAC address of 1111.2222.3333 has been associated with this
user account. The primary extension on the Phone is 1002. The primary extension should
always be the top line on the IP Phone because this is the only line that can use the MWI light
when a new message is present in the mailbox. Other lines display a blinking envelope when a
new message is present.
Other settings may also be configured here, such as the first and last name of the user, the
E.164 number of the user, the password, and the PIN.
While on this page, it is possible to create a mailbox by checking the Create Mailbox check
box. If the mailbox is not created here, then it will have to be created manually and associated
with this user at a later time.
Note
The Nick Name field currently has no significance to the system. It will retain whatever is
entered.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-157
- -
Creates a user
- -- - -
IPTX v2.05-12
The command username username create is used to add a new user from the CLI.
5-158 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
-
-
-
-
-
-
-
-
-
-
--
- -
- -
- -
--
- -
- -
IPTX v2.05-13
From the CLI, the administrator can enter the command username from either the privilege
EXEC mode or global configuration mode. The majority of the username commands are
entered in privilege EXEC mode. However, the username username phonenumber
phonenumber and the username username phonenumberE164 phonenumber commands are
entered in global configuration mode only.
Note
Notice that some commands are entered in privilege EXEC mode and some are entered in
global configuration mode.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-159
- - -- --
- -
Note
5-160 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.05-14
IPTX v2.05-15
- - -
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-161
IPTX v2.05-16
The act of creating a user does not necessarily associate the user with a Phone or extension.
Within the CUE system, twice as many users as licensed mailboxes can be configured. For
example, a consultant is an administrator of the system but does not have a voice mailbox
configured on the system.
5-162 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.05-17
To delete a user through the GUI, an administrator chooses the Configure > Users menu,
chooses the user to be deleted, then clicks the Delete link. This results not only in the deletion
of the credentials of the user but also in the deletion of the users mailbox and all of its
contents.
Caution
Deleted mailbox contents cannot be recovered without restoring the entire system and the
contents of all mailboxes.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-163
- -
IPTX v2.05-18
To delete a user via the CLI, use the username username delete command. However, this
deletes only the username and leaves the user mailbox and all its contents intact for seven days.
At the end of seven days the mailbox will be automatically deleted. Until the mailbox is
deleted, a user with the same name can be reassociated with the orphaned mailbox.
Note
This results in an orphaned mailbox. Use the no voicemail mailbox owner username
command to delete the orphaned mailbox sooner than its automatic deletion at the end of
seven days.
5-164 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
The new user defaults can be set on this page by the administrator.
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.05-19
Default settings can be defined for all newly created user accounts. To access the default
settings for user accounts, choose the Defaults > User menu and select the desired behavior.
Initial passwords and PINs can be randomly generated by the system or left blank. If created
randomly, the generated password and PINs are displayed after the user is created. The
administrator can print out or write down these settings. The administrator can also view these
in the GUI as long as the subscriber has not reset them. After the subscriber has changed the
password and PIN, the administrator cannot see the password or PIN but can reset these values.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-165
Group Configuration
IPTX v2.05-20
A group is a collection of users, usually with a common function or purpose, such as sales,
main office, customer service, technicians, and so on. A group has the following characteristics:
Members of a group can be individual users and other groups.
A group is assigned an extension. If the members of a group are configured with the
extension as a shared line, then anyone who calls this extension reaches a member of the
group.
A group usually has a mailbox assigned to it. This mailbox is called a General Delivery
Mailbox (GDM). All members of the group can access the mailbox to retrieve messages
that are stored there.
At least one user must be designated as the owner of a group. The owner adds and deletes
users from the group. The owner is not usually a member of the group.
Members of one group may belong to other groups.
Members can be added to a group from the global configuration mode using the
groupname command or the username command.
Note
Only members have access to the messages in a groups voice mailbox. The owner is not
automatically considered to be a member of the group. If the owner needs to access the group s
mailbox, add the owner as a member of the group. In that case, the owners name will appear
twice in the group: once as a member and once as the owner.
5-166 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
A group can be assigned a privilege level. The privilege level permits the members of the group
to access all or a restricted set of administrative functions. Use the show privileges command
to display the privilege levels installed on your system.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-167
IPTX v2.05-21
Groups may be configured from the GUI by choosing the Configure > Groups menu and
clicking the Add link on the page.
On the Add a New Group page, configure the following fields:
Group ID
Full Name
(Optional) Description
(Optional) Primary Extension, if this will have lines configured on Phones or voice mail
(Optional) Primary E.164 Number, if this will be called from the public switched telephone
network (PSTN)
(Optional) Create Mailbox, if a GDM for this group is desired
(Optional) Super Users, to allow any member of the group administrative privileges as well
as access to administration via telephone
(Optional) Administration via Telephone, to allow members of this group to use the basic
functions of administration via telephone
(Optional) Voice Mail Broadcaster, to allow any member of the group to broadcast
messages using administration via telephone
(Optional) Public List Manager, to allow any member of the group to create, delete, or edit
a public distribution list
(Optional) Private List Viewer, to allow any member of the group to view the private
distribution membership list
5-168 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.05-1
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-169
-
-
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.05-22
Use the groupname groupname commands to configure a group and its properties
from the CLI.
Example
- -
-
-
-
- -
- -
IPTX v2.05-23
To add a user to a group using the GUI, log on as an administrator or as the owner of the group
and choose Configure > Groups.Select the group, and on the Group Profile page, click the
Owners/Members tab.
IPTX v2.05-24
-
- -
-
-
IPTX v2.05-25
From the CLI, add a user to a group using the command groupname groupname member
username. The results can be verified with the show group detail groupname groupname
command.
Example
- -
5-172 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.05-26
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-173
IPTX v2.05-27
Next, one or more subscribers are added (in the figure, FPrefect is being added to the
Administrators group). This username is then able to log on to the GUI and have the privileges
of an administrator.
Only those usernames that belong to a group with administrative permissions, such as the
Administrators group, are able to perform administrative tasks in CUE.
Note
5-174 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
-
-
IPTX v2.05-28
The groupname groupname member username command is used to add a user to a group
from the CLI.
Example
This configures the user JSmith as an administrator:
-
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-175
IPTX v2.05-29
A user can also be added to a group from the Configure > Users menu in the GUI. Select the
user, and on the User Profile page, click the Groups tab to view current members. Click the
Subscribeas member link to add the user to a group.
IPTX v2.05-30
After clicking the Subscribe as member link, select the group or groups to which this user is
going to be added, then click the Select row(s) link to commit the changes.
5-176 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
- -
-
-
IPTX v2.05-31
From the CLI, a user can also be added to a group through the use of the username username
member groupname command.
Note
This command does not appear in the configuration. Instead, the groupname groupname
member username appears.
Example
-
- -
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-177
IPTX v2.05-32
To delete a group through the GUI, choose the Configure > Groups menu, select the group,
and click the Delete link. Click OK to commit.
Caution
Any mailbox and voice mail contents will be deleted with the group.
5-178 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Group Configuration:
Deleting a Group via the CLI
IPTX v2.05-33
To delete group via the CLI, use the command group groupname delete. Performing the
deletion from the CLI does not delete the mailbox and its voice mail contents. This results in an
orphaned mailbox, which can be deleted manually via the CLI.
Example
- -
-
- -
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-179
Group Mailboxes
Group Mailboxes
A GDM is a mailbox assigned to a group
A group definition contains:
(Mandatory) Group IDthe groups username,
e.g., Sales
(Optional) Member(s)
(Optional) Owner(s)
(Optional) Mailbox
A group without a mailbox and at least one
member is of limited use
IPTX v2.05-34
A GDM can be assigned to a group. That group can have multiple users as members. When
defining a group, the administrator must give the group a name, assign members to the group,
set the owner of the group, and (optionally) create a mailbox for the group. The mailbox that is
defined for the group is a GDM. The GDM is shared by all members of the group. Group
members still have their own personal mailboxes.
It is possible for a user to belong to many groups and potentially have access to many GDMs in
the system. Access to the GDM is through a TUI menu option in the user s personal mailbox.
Note
It is possible to have a group defined with just a name, but this configuration would be of
little value.
5-180 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.05-35
Groups and their GDMs should be defined for functions that are shared by a group of
individuals. This allows any member of that group to have access to the GDM. The group
number is often assigned as a shared line appearance that resides on a line on the Phones of the
group members.
The owner of a group is allowed to add or delete group members. If the owner needs to be a
part of the group, then the owner must be added as a member. If there is no owner, then only
the administrator can modify the group membership.
When a caller leaves a message in a GDM, no MWI is turned on. Instead, when members log in
to their personal mailbox, the mailbox menu allows members to access the messages in each
GDM. Only one person can access the GDM at a time. After the first person saves or deletes a
message in the GDM, the message is no longer played as new for subsequent members who
access the GDM.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-181
Not necessary if Create Mailbox was selected when the group was
created
No difference in Add screen of a personal mailbox vs. that of a GDM
A GDM is defined by the owner of the group
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.05-36
Step 2
As an administrator, choose the Voice Mail > Mailboxes menu to add a GDM. Click the Add
link and define the mailbox in the Add a New Mailbox window. In the Owner field, enter the
name of a group that has already been created. The mailbox settings of the GDM are the system
defaults and can be changed here.
5-182 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.05-37
A GDM can be set up when a new group is created. Choose the Configure > Groups menu
and click the Add link. In the Add a New Group window, configure the group. To
automatically create a GDM when the group is created, be sure to check the Create Mailbox
check box.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-183
Creates a group
IPTX v2.05-38
To create a group from the CLI, use the command group name create. Members are added to
the group using the command group name member username.
Example
Create a group called Sales, then add two members and a phone number:
-
-
-
-
5-184 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.05-39
The command voicemail mailbox owner groupname is used to create a GDM for the Sales
group.
IPTX v2.05-40
The GUI can be used to view Groups by choosing the Configure > Groups menu. The GDMs
can be viewed by choosing the Voice Mail > Mailboxes menu. The type of mailbox is
displayed in the Mailbox Type column.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-185
-
-
-
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.05-41
From the CLI, the show group command can be used to view the groups defined in the
CUE system.
If more detailed information (such as group membership) is required, then use the command
show group detail groupname groupname.
--
-- --
-
- --
--
--
--
-
- --
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.05-42
The show voicemail detail mailbox ownername command can be used to display a detailed
view of a specific mailbox, whether a personal mailbox or a GDM.
5-186 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.05-43
The group membership of a user can also be viewed from the user configuration pages within
the GUI. The Configure > Users menu can be used to go to a specific user. To view GDM
membership, click the Mailboxes tab to access the General Delivery Mailbox(es) section.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-187
Summary
Summary
The users interface is either the TUI or the GUI.
Users can reset their password from the GUI and
their PIN from either the TUI or the GUI.
The administrator can configure new users from
either the GUI or the CLI.
Groups can be configured by the administrator
from the GUI or the CLI.
Defining a GDM is very similar to defining a
personal mailbox.
Members of a group access the GDM through their
personal mailbox.
5-188 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.05-44
Lesson 5
This lesson defines how to set up, configure, and manage voice mail settings.
Objectives
Upon completing this lesson, you will be able to describe the components of and perform the
tasks for configuring voice mail. This includes being able to meet these objectives:
Describe the concept of voice mail entry point and port
Perform the tasks for MWI configuration
Describe the properties of broadcast messages
Describe mailbox and message sizes and defaults
Perform the configuration tasks for personal mailboxes
Describe and configure VPIM networking with CUE and Cisco Unity
Perform the configuration tasks for public and private distribution lists
This topic describes the voice mail entry point and port.
IPTX v2.05-2
In Cisco Unity Express (CUE), a port does not represent a physical port as it does in a
traditional telephony device. A port in CUE represents one call terminating on the system. The
number of ports in the system is dependent on the hardware and the license. The CUE network
module (NM-CUE) has four ports for the 12- and 25-mailbox license and eight ports for the 50and 100-mailbox license. The CUE advanced integration module (AIM-CUE) has a maximum
of four ports for the 12-, 25-, and 50-mailbox licenses. The AIM-CUE cannot have more than
50 mailboxes.
Note
For the purposes of this lesson, a port and a session are equivalent.
CUE, by default, has voice mail and automated attendant applications, which share all of the
ports on the system. Ports cannot be dedicated in CUE, but they can be partitioned.
One of the parameters that you can configure for the voice mail and automated attendant
applications is the maximum number of callers who can access the application concurrently
at any given time. The maximum sessions parameter is limited by the number of ports on the
CUE module.
Consider your expected call traffic when assigning the number of ports to an application. One
application may need more available ports than another, but each application should have at
least one port available for incoming calls. In most cases, the default configuration, which is all
ports in one pool of ports that can be used by any application, is the most efficient.
5-190 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Suppose, for example, that your CUE module has four ports and you assign a maximum
sessions parameter of 4 to the voice mail application and 4 to the automated attendant
application. In this case, if four callers access voice mail simultaneously, no ports will be
available for automated attendant callers. Only when zero, one, two, or three callers access
voice mail simultaneously will at least one port be available for the automated attendant.
Suppose, instead, that you assign a maximum sessions parameter of 3 to voice mail and 3 to
automated attendant. At no time will one application use up all the ports. If voice mail has three
active calls, then one caller can access the automated attendant. In this case, a second call to the
automated attendant will not go through at that moment. Also in this case, if four callers try to
call voice mail and no one is using the automated attendant, only three will be able to connect;
the fourth port is unused.
You must also assign themaximum sessions parameter to each application trigger, or pilot
number, which is the telephone number that activates the applications script. The triggers
maximum sessions parameter must not exceed that of the application.
Note
The Cisco best practice is to leave all ports using a common shared pool of ports. This
results in voice mail and the automated attendant efficiently sharing the ports in CUE.
IPTX v2.05-3
The voice mail pilot number (sometimes called the pilot point number) and the voice mail
operator number can be configured in the GUI by choosing the Voicemail > Call Handling
menu.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-191
IPTX v2.05-4
To configure the voice mail pilot number from the command-line interface (CLI), the command
ccn trigger sip phonenumber phonenumber is entered from global configuration mode. This
has the effect of entering a subconfiguration mode. The command application voicemail can
then be used to tie the trigger to invoke the voice mail application.
5-192 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
----
----
IPTX v2.05-5
The command maxsessions configured in the trigger mode defines the maximum allowable
number of sessions that can arrive at this trigger (number).
Note
-
----
----
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-193
The system default will be used for both the voice mail
application and any other applications.
The number of maximum sessions can be lowered per
application to partition the usage of the ports.
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.05-6
The GUI can also be used to configure the maximum sessions allowed for a trigger. This can be
done either under Voicemail > Call Handling for the voice mail trigger or when you are
adding a new automated attendant, which is done on the third and final screen of the process.
The maximum sessions setting cannot be more than the number of licensed ports on the
CUE system.
5-194 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
----
----
---
IPTX v2.05-7
The maxsessions command can also be used in application mode. In this configuration, the
maxsessions command defines the maximum sessions that can be used by this application
regardless of which trigger they arrived at. This setting cannot be set to more than the licensed
number of ports.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-195
CME
1. Message left
On
3. Message sent
to MWI directory
number
Off
4. SCCP message sent to
turn on MWI
The periods are very
important. If not
present, the MWI does
not work.
IPTX v2.05-8
CUE uses the MWI on and MWI off extensions with the affected telephone extension to
generate a session initiation protocol (SIP) call to Cisco CallManager Express, which changes
the status of the telephones MWI light. CUE refreshes the MWI lights automatically when new
messages are received, saved, and deleted and when the software is initialized. Use the GUI or
the CLI to refresh the MWI lights for a specific telephone or for all configured telephones.
The MWI display on an IP Phone is controlled by the extension associated with the line 1
button on the Phone.
If a voice message is left for an extension that is associated with line 1 of a Phone, then the
MWI light on the line 1 button of the Phone comes on and a flashing envelope icon appears
next to the extension appearance on the Phone display.
If a voice message is left for an extension that is associated with any line other than line 1,
then only a flashing envelope icon appears next to the extension appearance on the Phone
display.
The above operation is the same for all extensions, regardless of whether the extension is
associated with a user or a group or whether it is a single or multiappearance extension.
CUE requires that IP Phones with mailboxes all have extensions of the same length. The actual
length does not matter. It can be between 1 and 16 digits, as supported by Cisco CallManager
Express, but all extensions that have mailboxes must be of the same length within a particular
Cisco CallManager Express and CUE system. This restriction is because of MWI support.
5-196 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
CUE supports only a single defined set of MWI directory numbers: one on directory number
and one off directory number. The extension length is embedded within the MWI directory
number definition in the form of the number of periods at the end of the directory numbers. The
number of periods represents the length of the extensions in the Cisco CallManager Express
and CUE system. The CUE system sends the MWI number plus the extension number of the
mailbox that has a message to the Cisco CallManager Express via an SIP call when it wishes to
change the status of the MWI, whether from on to off or from off to on.
When a message is left in the mailbox that is associated with directory number 2001, the
following SIP call is received on the Cisco CallManager Express router from the CUE module.
- -
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-197
MWI Configuration
-
MWI number settings can be viewed and chosen from the GUI.
GUI numbers reflect the Cisco CallManager Express CLI settings.
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.05-9
To properly set up the MWIs, you must complete configurations on Cisco CallManager
Express as well as on CUE. This can be done from either the GUI or the CLI.
- -
- -
IPTX v2.05-10
IPTX v2.05-11
This shows the configuration from the GUI. Cisco CallManager Express must be configured
with an MWI on extension and an MWI off extension. From the GUI, choose the Configure >
Extensions menu and add two new extensions. Extension Type for both extensions must be set
to Message Waiting Indication (MWI). MWI Mode must be set to On for one extension
and Off for the other.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-199
IPTX v2.05-12
To create the MWI extensions from the CLI, simply create two ephone-dns and assign the
appropriate number followed by a number of periods equal to the extension length of the
directory numbers that will have MWI functionality. Then use the mwi on and mwi off
command to assign each of the ephone-dns a function. (There is an mwi on-off option that is
intended for integration with other voice mail systems, not for integration with CUE.)
Note
The periods are mandatoryeach represents one digit in the dial plan.
5-200 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
-
-- -
IPTX v2.05-13
To refresh the MWI using the GUI, choose Voice Mail > Message Waiting Indicators > Refresh
.
This can be useful if the MWI is not accurately reflecting the current voice mailbox state, for
example, if a new voice mail was left, but the MWI did not light. This can be done for
individual users, groups, or all Phones in the system.
IPTX v2.05-14
The CLI can also be used to refresh the MWI of one or all IP Phones in the system.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-201
Broadcast Messages
Broadcast Messages
Broadcast messages can be sent by authorized users.
To send a broadcast message, a user must belong to a group
with the Voice Mail Broadcaster capability set.
Broadcasts are sent from the TUI by an authorized user.
Broadcast messages will be heard after recipients log in to their
mailbox and can not be skipped or interrupted.
The broadcast can be saved or deleted by the recipient.
Broadcasts can go to local and remote users.
By default, broadcasts expire after 30 days.
Broadcast messages do not count against mailbox size unless
the broadcast message is saved.
By default, broadcast messages are sent to all users with
mailboxes on the system.
Broadcast messages can not go to a GDM.
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.05-15
CUE permits users with the broadcast privilege to send local and network broadcast messages.
Users obtain this privilege as members of a group that has the broadcast privilege.
Sending a broadcast message is accomplished through the CUE Telephone User Interface
(TUI).
Senders of a broadcast message have the option to review, rerecord, and readdress the message
before they send it. Senders also have the option to set the number of days the broadcast
message plays before the system deletes it. The maximum life of a broadcast message is 30
days, which is also the default message lifetime.
A sender can include any or all of the remote locations configured on the local system. The
remote addresses can be location numbers or location names. When using the location name,
the number of matches may resolve into several locations. If the number of locations is four or
fewer, the system gives the sender the option to select the exact location. If the number of
matches results in more than four locations, the sender must enter more letters to narrow the
search.
All subscribers at the remote location receive the broadcast message. The recipients hear the
message immediately after logging in to their voice mailboxes. Recipients cannot interrupt a
broadcast message, and they cannot reply to or forward the message. Recipients can save or
delete a broadcast message.
5-202 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.05-16
To use the GUI to enable members of a group to send a broadcast message, choose
Configure > Groups. Select the desired group, and on the Group Profile page, check
the Voice Mail Broadcaster check box. All members of the group are now able to send
broadcast messages.
-- -
IPTX v2.05-17
To use the CLI to configure the capability to send broadcast messages, use the command group
groupname privilege broadcast.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-203
IPTX v2.05-18
There are some default settings that apply to broadcast messages. To reach them, choose
Defaults > Voice Mail. The preferences regarding whether the MWI works for broadcasts, the
maximum length of a broadcast, and the default expiration time for the broadcast can be set on
this page.
5-204 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
- -
- --
IPTX v2.05-19
You can configure the broadcast message defaults from the CLI. The command voicemail
broadcast recording time broadcast-length sets the maximum length of a broadcast message
in seconds. The command voicemail default broadcast expiration time broadcast-days sets
the maximum number of days that a broadcast message is retained by the CUE system.
The system administrator at each location uses the command voicemail broadcast mwi to set
if or when the MWI lights up. This command affects only the local CUE system and applies
both to local broadcasts and to broadcasts received from a remote system.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-205
-
-
-
IPTX v2.05-20
The example in the figure shows the maximum message length set to 2 minutes and the
expiration period set to ten days. Upon receipt of a broadcast message, the MWI will light up.
- - ---
IPTX v2.05-21
IPTX v2.05-22
In order for a user to have a mailbox on the CUE system, the users directory number must be
under the control of the Cisco CallManager Express system that is integrated with the CUE
module. When messages are stored in CUE, they are stored as a G.711 file. Compression using
G.729 is not currently supported.
Even if a voice mail message is in more than one mailbox, there is only one copy of the voice
mail message on the hard drive (NM-CUE) or flash (AIM-CUE). The voice mail message is
included in the count of each mailbox in which it is present. It will not be deleted until all
mailboxes have deleted it.
Mailbox settings that include time limits for the message store, maximum message size, and
expiration time can all be customized on a per-user basis. This overrides the default settings on
the CUE system.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-207
IPTX v2.05-23
To set the system parameters in the GUI interface, choose the Default > Voice Mail menu.
The maximum voice message store is the total aggregation of all mailboxes in the system.
This number is a function of the hardware and cannot be raised above 6000 minutes for the
NM-CUE or 480 minutes for the AIM-CUE. Other settings here include the ability to limit the
size of outbound messages sent from within the subscribers mailbox. The last setting is the
prompt language that voice mail will use by default.
5-208 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.05-24
The default settings on new mailboxes include mailbox size, maximum length of a message,
and amount of time until the message expires. To reach these settings, choose Defaults >
Mailbox.
Note
Changing these settings does not affect the existing mailboxes; only new mailboxes inherit
these settings.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-209
- - --
--- --
IPTX v2.05-25
The voice mail system defaults can be configured from the CLI instead of the GUI. The
commands that govern the voice mail system settings are:
voicemail capacity time minutes Sets the capacity up to the maximum allowed by the
hardware
voicemail default expiration days Sets the number of days that a message is stored in
the mailbox
voicemail default mailboxsize seconds Sets the maximum amount of time that the total
of all messages in a mailbox can consume
voicemail default messagesize seconds Sets the maximum amount of time one message
can consume
voicemail operator telephone number Sets the extension to which callers are sent when
they press 0
voicemail recording time seconds Sets the maximum size of outbound messages sent
from one subscriber mailbox to another mailbox
5-210 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
-
---
- --
-- --
--
-- -
- -
IPTX v2.05-26
This figure shows an example of configuring the system voice mail defaults and mailbox
defaults.
IPTX v2.05-27
The settings of a mailbox that was created with the default settings can be overridden with
settings specific to that subscriber. To do this in the GUI, go to the subscribers profile, choose
Configure > Users, and select the user mailbox to change. In the User Profile window, click
the Mailboxes tab and make the desired changes.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-211
- --
- -
- ---- -
IPTX v2.05-28
To change a users mailbox settings from the CLI, first enter the mailbox for that user by using
the voicemail mailbox owner name command. In the mailbox subconfiguration mode, specific
commands may then be entered to change the settings of that mailbox. They are:
description description text Sets a description for the mailbox
mailbox size seconds Sets the maximum amount of time that all the messages can
consume
messagesize seconds Sets the maximum amount of time one message can consume
expiration time days Sets the number of days that a message is stored in the mailbox
no tutorial Disables the tutorial program that runs the first time a user logs in
enable Enables the mailbox
5-212 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
---
-
- -
- -
--
-- --
-
- --
--
--
--
-
- --
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.05-29
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-213
Personal Mailboxes
IPTX v2.05-30
A personal mailbox is a mailbox that is assigned to a specific user and is accessible only by this
user. When a caller leaves a message in this mailbox, the MWI light turns on.
To configure a user and mailbox from the GUI, choose Configure > Users and click the Add
link. This allows the administrator to add a new user from the GUI. On this page, the option
exists to create a mailbox for that user by check the Create Mailbox check box. This allows
the administrator to set up a mailbox and user in one step.
5-214 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
All
IPTX v2.05-31
To view the mailboxes after the initial configuration, choose Voice Mail > Mailboxes. All
configured mailboxes appear on this page and are managed from this page. The percentage of
usage can be viewed by selecting the mailbox.
- -
-
-
-
-
IPTX v2.05-32
The percentage of usage can be viewed for all mailboxes with one command from the CLI.
From the CLI, use the show voicemail mailboxes command.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-215
IPTX v2.05-33
To view and change the settings of a specific mailbox, choose Voice Mail > Mailboxes and
select the mailbox. If desired, changes can be made on the Mailbox Profile page.
- -
- --
--
--
--
-
-
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.05-34
To view the mailbox from the CLI, use the show voicemail detail mailbox username
command.
5-216 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Adding a Mailbox
Not necessary if mailbox created
when user was created
Associate the owner of the
mailbox to the mailbox
System default mailbox values
automatically populated
Tutorial enabled by default
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.05-35
To add a mailbox using the GUI, choose Voice Mail > Mailboxes and click the Add link. On
the Add a New Mailbox page, select a user to associate with the mailbox. This user must have
been previously defined.
The mailbox size, maximum caller message size, and message expiration time are populated
with the system mailbox defaults. These settings can be changed to different values if desired.
After the new mailbox settings have been configured, click the Add link to create the mailbox.
The new mailbox appears under the Voice Mail > Mailboxes menu.
Note
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-217
IPTX v2.05-36
To delete a mailbox using the GUI, choose Configure > Mailboxes, select the mailbox or
mailboxes to be deleted, and clicks the Delete link.
IPTX v2.05-37
To delete a mailbox using the CLI, use the command no voicemail mailbox owner name.
Note
5-218 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Greeting Management
Spoken names and mailbox greetings can only be
recorded over again or listened to via the TUI.
Requires the user to log in to the mailbox
The greeting that is currently chosen, standard or
alternate, can be displayed and changed via either
the GUI or CLI.
IPTX v2.05-38
A tutorial can be set to run when subscribers log in to their voice mail for the first time. This
TUI-based tutorial prompts subscribers to record their name and a standard personal greeting
that will be played for callers leaving a message. Subscribers can also use the TUI at any time
to change their spoken name and personal greeting or to rerecord them. In addition, the TUI can
be used to record an alternate greeting, which can then be activated from the TUI.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-219
- -
----
-
- -
- -
--
-- --
-
- --
--
--
--
-
-
IPTX v2.05-39
To view which of the two personal greetings is currently active, the administrator can use
the GUI or the CLI. The administrator can go to a users profile and view or set which greeting
is used.
Note
5-220 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
-
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.05-40
From the GUI, the user or administrator can set the greeting type that is played to callers who
leave a message in the users mailbox.
The administrator can also use the CLI to set the greeting that is played to callers who leave a
message. In mailbox configuration mode of the user whose greeting is to be set, use the
command greeting standard or greeting alternate.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-221
VPIM Networking
IPTX v2.05-41
CUE Release 2.1 supports the protocol Voice Profile for Internet Messaging (VPIM) version 2
to permit voice mail message networking between CUE and Cisco Unity voice mail systems
that are not located on the same router or server. Supported networked voice mail
configurations include:
CUE to CUE
CUE to Cisco Unity (versions 4.03 and 4.04)
Cisco Unity (versions 4.03 and 4.04) to CUE
If a message cannot be delivered, after a specified amount of time the sender receives a voice
mail message indicating the reason for nondelivery. If nondelivery is because the recipient s
mailbox is full, does not exist, or is disabled, the nondelivery message includes the sender s
original message. When the sender plays the nondelivery record, the sender can readdress and
send the original message again or delete the message.
If the system cannot deliver a message to a remote site after six hours, the local user receives a
nondelivery message indicating that the message was not sent or that the message was not
delivered to the recipients mailbox. CUE Release 2.1 adds a delayed delivery record, which is
a notification left in the senders mailbox after 60 minutes of trying to deliver the original
message. Unlike the nondelivery record, the delayed delivery record does not contain the
original message as an attachment and does not count against the senders mailbox capacity.
Additionally, the delayed delivery record cannot be saved, only deleted. The system stores only
one copy of a delayed delivery record for a particular message in the sender s mailbox. The
user has to delete the existing delayed delivery record in order to receive an updated delayed
delivery record for the same message.
5-222 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
VPIM Networking
To configure networking, the following may
need to be done:
Define the remote location(s)
Define the local location
Enable the sending of vCards
Enable the sending of the spoken name
Enable the LRU cache
Configure commonly used remote users
IPTX v2.05-42
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-223
IP
Network
seattle.cisco.com
10.10.0.10
QoS Not
Required
boston.cisco.com
10.20.0.10
IPTX v2.05-43
To add a location, choose the Administrator > Networking Locations menu, and on the
window that opens, click the Add link near the bottom of the page.
5-224 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IP
Network
seattle.cisco.com
10.10.0.10
QoS Not
Required
boston.cisco.com
10.20.0.10
IPTX v2.05-44
On the Add a New Location page, assign a Location ID, which is a numeric value used to
represent the location; the Location ID may be up to seven digits long. A maximum of 500
remote locations can be configured. The Location Name is a descriptive name to identify the
location. Other settings that may be configured are:
Abbreviation: An abbreviation that is used in the TUI
Domain Name/IP Address: Used to populate the domain part on the e-mail addresses that
are used by VPIM
Phone Prefix: Required if the local dial plan overlaps with this location
VPIM Broadcast ID: Required if domain names are the same between locations
Minimum Extension Length: Sets the minimum number of expected digits
Maximum Extension Length: Sets the maximum number of expected digits
Voicemail Encoding: Determines whether dynamic, G.711, or G.726 coder-decoders
(codecs) will be used
Send Spoken Name: Sends the spoken name of the sender along with any messages
destined for the remote location using VPIM
Send vCard Information: Sends the vCard information of the sender to the remote
location when a message is sent using VPIM
Enabled: Enables networking with the location
Note
The Location ID must be at least three digits in length, and the VPIM Broadcast ID must be
numeric when integrating with Cisco Unity.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-225
IP
Network
seattle.cisco.com
10.10.0.10
QoS Not
Required
boston.cisco.com
10.20.0.10
IPTX v2.05-45
The previous steps must be repeated in order to configure the local location. The configuration
of a local location is identical to configuring a remote location.
IP
Network
seattle.cisco.com
10.10.0.10
QoS Not
Required
boston.cisco.com
10.20.0.10
IPTX v2.05-46
To designate which of the configured locations is the local location, choose the
Administration> Networking Locations menu, enter the Location ID, and click the Apply
link. Only one location may be designated as the local location. Failure to perform this step will
result in networking not functioning on the system.
5-226 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.05-47
Multiple commands are required to configure a remote location from the CUE CLI. To start the
process, use the network location id number command from global configuration mode. This
will enter the location subconfiguration mode, from which settings for the location are entered.
The location should be given a name with the command name location-name. An abbreviated
name is specified with the command abbreviation name.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-227
IPTX v2.05-48
While still in location subconfiguration mode, enter the command email domain domain-name
to set the domain or IP address that will be used on the Simple Mail Transfer Protocol (SMTP)
messages going to this location. If the local dial plan overlaps with the location being defined,
then a prefix must be placed in front of the extension numbers. This number is configured with
the command voicemail phone-prefix digit-string. The expected length of extensions is set
with the command voicemail extension-length number.
5-228 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.05-49
The voice message being sent using VPIM can use either the G.711 or G.726 codec. This may
be statically set or negotiated. While still in location subconfiguration mode, the command
voicemail vpim-encoding g711ulaw or voicemail vpim-encoding g726 statically sets the
codec. The command voicemail vpim-encodingdynamic allows the system to negotiate
whether to use G.711 or G.729.
The default is to send the spoken name of a sender, but if this has been disabled, use the
command voicemail spoken-name to reenable it.
To enable networking on the local system, from global configuration mode use the command
network local location id number.
Note
Failure to define a local location will cause networking to be disabled on the local system
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-229
Seattle
IP
Network
Seattle
Configuration
Boston
IPTX v2.05-50
The example in this figure shows the CLI configuration required on the Seattle CUE module to
enable networking with the Boston CUE module.
-
--
-
- --
-
-
--
-
- --
-
Seattle
IP
Network
Boston
IPTX v2.05-51
The example in this figure shows the CLI configuration required on the Boston CUE module to
enable networking with the Seattle CUE module.
Note
Both Seattle and Boston must be configured before networking will function.
5-230 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Directory Entries
Directory entries are used to provide spellby-name and spoken-name confirmation.
Entries are added to the directory as follows:
Static entries in directory
IPTX v2.05-52
When a subscriber sends a message to another subscriber on the same (local) CUE voice mail
system, the sender can address the recipient using spell-by-name or extension number. The
sender hears a confirmation of the recipients spoken name, if it is recorded, or the recipients
extension number.
In order for spell-by-name and spoken-name confirmation to work, an entry must exist in the
directory of the CUE module. Local users are automatically in this directory, but remote users
are not. Remote users are entered into the local CUE directory in one of two ways: by an
administrator manually configuring the user and recording a spoken name through the TUI or
learned through the LRU cache.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-231
IPTX v2.05-53
The local CUE directory is enhanced to allow inclusion of frequently addressed remote users.
This capability allows a local voice mail sender to address a remote recipient using dial-byname. Additionally, the system provides the sender with a spoken-name confirmation of the
remote recipient so that the sender can verify that the name and location are correct.
Regardless of the license level, the NM-CUE and NM-CUE-EC support a maximum of 50
remote users. The AIM-CUE supports a maximum of 20 remote users. There is a new menu
option available on the TUI that allows the system administrators to record the spoken name for
the remote users. If a remote user does not have a spoken name recorded, the system uses the
remote extension number and location as confirmation to the local sender.
If the vCard option is configured, the vCard of the remote user updates the local system with
the first name, last name, or extension of the remote user.
The local sender hears the remote users spoken name if it is configured by one of the following
methods:
The spoken name is recorded on the local system.
The local system receives a message from the remote user, whose spoken name is recorded
on the remote system and the remote system is configured to send the spoken name to the
local system.
If the spoken name of the remote sender is not configured either locally or remotely, the local
user hears the remote extension number and remote location name. When a local user plays
back a message from a remote user, the local user hears the spoken name or phone number of
the remote sender, the spoken name of the remote office, the date, and the time the message
was sent. If the local system receives the message more than 30 minutes after the message was
sent, the local user also hears the time when the message was received. If the local user replies
to this message, the local system automatically sets up the appropriate remote address
information.
5-232 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
VM
from:1001@seattle.cisco.com
to:2001@boston.cisco.com
Spoken name of ADent (optional)
vCard of ADent (optional)
Administrator has
defined in Boston
the remote users
of FPrefect and
ADent and
recorded spoken
names.
IP
Network
seattle.cisco.com
10.10.0.10
FPrefect -1000
ADent -1001
2005 Cisco Systems, Inc. All rights reserved.
boston.cisco.com
10.20.0.10
ZBeetle -2000
MProsser -2001
IPTX v2.05-54
In the example in this figure, the administrator has defined in Seattle the remote users of
ZBeetle and MProsser, who reside in Boston. This allows users in Seattle to address messages
to those users in Boston using spell-by-name instead of the location and extension numbers. If
the administrator in Seattle has also recorded a spoken name or a message is received from that
user with a spoken name attached, the system plays the spoken name of the sender as a
confirmation.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-233
- -
- - - -
- - - -
IPTX v2.05-55
Configuring remote users from the CLI requires multiple commands. First create the user
by using the command remote user username location location-id. Use the remote user
username fullnamedisplay display-name command to associate a display name to the
user. Use the command remote user username fullname first first-name to assign a first
name to the user.
5-234 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
- - - -
- - -
- --
IPTX v2.05-56
The command remote user username fullname last last-name is used to assign a last name
to the user, and from global configuration mode, use the command remote user username
phonenumber extension-number to associate an extension number to the user.
The command show remote users displays all of the remote users configured in the system.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-235
- -- - -
- - -
- -
-
- -
IPTX v2.05-57
The example in this figure shows the configuration to add a user named Douglas Adams with
an extension of 3000.
5-236 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.05-58
The LRU cache is a database of remote users first names, last names, extension numbers, and
spoken names. The LRU cache is enabled by default and permits vCard information about the
remote users to be updated automatically. When a local sender addresses a voice mail message
to a remote user via spell-by-name, the system accesses the LRU cache information to address
and send a confirmation about the remote user to the local sender.
The users contained in the cache are referred to as cached users.
The maximum length of the LRU cache is 50 users on the NM-CUE and NM-CUE-EC. The
AIM-CUE is limited to caching a maximum of 20 of the final users that sent a message to the
system.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-237
Used when no entry exists in the LRU cache and no remote user for
the destination has been defined.
Requires the use of the location ID and extension number to
address the message.
Spell-by-name is not available, as the destination user is unknown
to the system.
When sending messages, the location and extension number is
used for confirmation.
Messages received will have no spoken name and will state the
location ID or spoken location if an administrator has recorded it
and extension number from which the message was received.
The validity of the destination is not known before sending the
message.
If the destination extension is not valid, a nondeliveryrecord will be
returned to the sender after six hours.
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.05-59
When a subscriber sends a message to a remote subscriber, if there is no entry in the LRU
cache and no remote user defined for this remote subscriber, the sender will not hear a
confirmation of the recipients name or extension. This is called blind addressing. The address
of the remote recipient is the location ID of the remote system plus the recipients extension
number at the remote location. The validity of this destination is not known before the user
sends the message. A nondelivery record is generated after six hours if the extension that is
entered is not valid.
5-238 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Blind Addressing
VM
LRU Cache
FPrefect
First name
Last name
from:1000@seattle.cisco.com
to:2000@boston.cisco.com
Spoken name of FPrefect (optional)
vCard of FPrefect (optional)
Extension
Spoken name
IP
Network
seattle.cisco.com
10.10.0.10
FPrefect -1000
ADent -1001
2005 Cisco Systems, Inc. All rights reserved.
boston.cisco.com
10.20.0.10
ZBeetle -2000
MProsser -2001
IPTX v2.05-60
The example in this figure shows blind addressing. A Seattle user named FPrefect with an
extension number of 1000 composes a voice message for ZBeetle in Boston. The spell-by-name
will not find a match because the Seattle system has no knowledge of the user ZBeetle.
FPrefect will have to enter the location and extension number to send the message. This is blind
addressing. The Seattle CUE system will construct an SMTP message with the voice message,
vCard (if enabled), and spoken name of FPrefect and send the message to the address of
2000@boston.cisco.com from 1000@seattle.cisco.com. In this case, ZBeetle is valid, and the
message will appear in the mailbox of ZBeetle in Boston.
Before receiving the message from FPrefect, the Boston CUE module did not know about
FPrefect. After the message from FPrefect to ZBeetle is received, the Boston system learns the
first name, last name, and extension number from the vCard that was sent by Seattle in the
message for ZBeetle. The spoken name of FPrefect is also learned from the message. This
learned information is stored in the LRU cache of the Boston system.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-239
LRU Cache
MProsser
VM
First name
Last name
Extension
Spoken name
LRU Cache
FPrefect
First name
Last name
from:2001@boston.cisco.com
to:1000@seattle.cisco.com
Spoken name of MProsser (optional)
vCard of MProsser (optional)
Extension
Spoken name
IP
Network
seattle.cisco.com
10.10.0.10
FPrefect -1000
ADent -1001
2005 Cisco Systems, Inc. All rights reserved.
boston.cisco.com
10.20.0.10
ZBeetle -2000
MProsser -2001
IPTX v2.05-61
The example in this figure shows MProsser (2001) creating and sending a message to FPrefect
(1000) from Boston. Because the Boston CUE system has received a message from FPrefect
(1000) that contained a vCard and the spoken name of FPrefect, the LRU cache contains
information about the user. This information is used to allow MProsser to spell out the name of
Ford Prefect and find a match. The spoken name of Ford Prefect is announced as a
confirmation and the message is sent.
The Seattle CUE module receives a message to FPrefect (1000) from MProsser (2001), which
allows the Seattle system to learn information about MProsser. The Seattle system learns the
first name, last name, extension number, and the spoken name of MProsser. This entry can be
used to address messages using spell-by-name for MProsser in Seattle.
5-240 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
- -
IPTX v2.05-62
The LRU cache is enabled by default. However, if it has been disabled, use the command
remote cache enable to enable it. The command show remote cache displays the learned
remote users that currently reside in the LRU cache.
- - -
IPTX v2.05-63
The command show network locations is used to display the configured locations on
the CUE module. The command variation that displays details on one specific location is
show network detail location id location-id.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-241
--
--
--
--
IPTX v2.05-64
The command show network detail local displays the local location and details on
its configuration.
Note
If no output shows, then a local location has not been designated and networking will be
disabled on this CUE module.
5-242 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Distribution Lists
Distribution Lists
Distribution lists are lists to which a voice mail can
be addressed.
Distribution lists may contain any combination of the following:
Local users
Remote users
GDMs
Groups
Other distribution lists
Blind addresses
Public distribution lists are available for all users to reference
and are created by the administrator.
Private distribution lists are specific for the user and are
defined by the user.
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.05-65
CUE permits configuration of distribution lists that enables users to send a voice mail message
to multiple recipients at one time.
Members of a distribution list can be any combination of:
Local and remote users
A remote user statically configured on the local system
GDMs
Groups
Other distribution lists
Recursive distribution lists are permitted. For example, list A can be a member of
list B and list B can be a member of list A.
Blind addresses
Specify the Location ID and extension of the blind address. The system verifies the
Location ID and the extension length.
Distribution lists may be either publicly available or private to a user.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-243
IPTX v2.05-66
Public distribution lists are always defined by either an administrator or a user in a group with
the Public List Manager permission set. There may be up to 15 public distribution lists defined
in the CUE system. The maximum total number of owners for all distribution lists in the system
is 50. All 50 owners could potentially be assigned to one public distribution list, but that would
not leave any owners for any other public distribution list. The maximum total membership on
the whole system is limited to 1000 memberships in all public lists.
By default, there is one public distribution list that may not be modified and has no owner. This
is the everyone distribution list. As the name implies, all defined users are in this list.
5-244 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.05-67
To add a new public distribution list to the CUE system, choose Voice Mail >
Distribution Lists > Public Lists and, on the page, click the Add link. This opens the Add a
Public Distribution List page. On this page, give the distribution list a name, a number, and a
description, then click the Add link. The new distribution list will now appear. Click the new
distribution list name link, choose the Members tab, then click AddMember .
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-245
IPTX v2.05-68
The Find page will appear. On this page, enter the search criteria and click the Find link to start
the search. The results will appear in the Find window. Choose one or more members to add to
the distribution list, then click the Select row(s) link. Notice the new member now appears in
the public distribution list.
- - -
- -
- -
IPTX v2.05-69
To create a public distribution list from the CLI, use the command list name listname number
listnumber create. This creates the public distribution list and assigns a number to it. The
command list number number owner owner-id assigns an owner to the list, and the command
list number number member member-name type type assigns a member to the list.
5-246 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
- - -
- --
-- -
-
-
- -
- - -
- --
-
--
IPTX v2.05-70
The optional command list number number description description adds a descriptive field to
the distribution list. The configured distribution lists may be viewed from the CLI with the
command show lists public.
- -
-
-- -
IPTX v2.05-71
To view detailed information about a distribution list, use the command show list detail public
number number.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-247
IPTX v2.05-72
Private distribution lists in CUE are created by the user and are individualized by the user. Each
user can create up to five private distribution lists from the GUI or the TUI. Only administrators
and users in a group with the Private List Viewer permissions set may view another user s
private distribution lists. The number of members in all of a users private lists cannot total
more than 50.
5-248 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.05-73
Users can add a new private distribution list from the GUI by choosing Voice Mail >
Distribution Lists > My Private Lists and clicking Add. This will open the Add a Private
Distribution List page. On this page, enter a name, a number, and a description for the
distribution list, then click Add. The new distribution list will now appear. Click the new
distribution list Name link.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-249
IPTX v2.05-74
On the Private List page, click the Add Member link. The Find page appears. On this page,
enter the search criteria and click the Find link to start the search. The results appear in the
Find window. Choose one or more members to add to the private distribution list, then click the
Select row(s) link. Notice the new member now appears in the private distribution list.
- -
--
- - -
-
-
-
-
-- -
IPTX v2.05-75
To view the membership of a private distribution list from the CLI, use the command
show list detail private name name owner owner-id.
5-250 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Summary
Summary
Voicemail requires the configuration of a pilot number
MWI integration involves the configuration of the CUE
module from either the CLI or the GUI web interface
Broadcast messages may be sent through the AVT by an
administrator
Mailbox setting may be defined globally but can always be
overridenon a mailbox by mailbox basis
Mailboxes may be configured from either CLY or the GUI web
interface
VPIM allows the CUE module to take and transfer messages
to other VPIM compliant CUE modules and Unity
Public and private distribution lists allow many mailboxes to
receive a message
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.05-76
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-251
5-252 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Lesson 6
Troubleshooting
Cisco Unity Express
Overview
This lesson defines the commonly used Cisco Unity Express (CUE) troubleshooting tools,
system architecture, system troubleshooting, troubleshooting the GUI, and problems with CUE
voice mail and automated attendant.
Objectives
Upon completing this lesson, you will be able to describe the troubleshooting guidelines and
tools. This includes being able to meet these objectives:
Describe the troubleshooting methodology and tools
Describe the overview architecture of CUE software
Describe the guidelines for system-level troubleshooting
Describe the guidelines for GUI troubleshooting
Describe the guidelines for troubleshooting voice mail and automated attendant
Finished
Gather Facts
Document Facts
Consider Possibilities
Problem Resolved
Start
Yes
Do
problem
symptoms
stop?
No
IPTX v2.05-3
A structured approach to troubleshooting has been proven to be the most effective method. The
Cisco approach to troubleshooting is a proven and effective guideline to analyzing problems
and achieving the fastest resolution times.
5-254 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Consider Possibilities
This step is used to contemplate the possible causes of the problem. It is quite easy to create a
very long list of possible causes. That is why it is so important to gather as much relevant
information as you can and to create an accurate problem statement. By defining the problem
and assigning the corresponding boundaries, the resulting list of possible causes diminishes
because the list focuses on the actual problem and not on possible problems.
However, this is just a list of possible causes. You must create an action plan, implement it,
then observe whether the changes that were made were effective. If they were not, you must go
back to the list of possible causes, checking each of the possibilities in the same way (creating a
plan, implementing it, then observing the results) until the cause of the problem is found.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-255
Observe Results
Observing results consists of using the exact same methods and commands that were used to
obtain information to define the problem. This enables you to see whether the changes that
were implemented were effective.
It may take more than one change to fix the problem, but you should observe each change
separately to monitor progress and to make sure that the change doesnt create any adverse
effects. After the first change is made, you should be able to gather enough information to
determine whether or not the change was effective, even if it doesnt entirely solve the problem.
After all of the changes from the action plan are implemented and the results are observed, you
can verify whether the action plan solved the problem. If the problem is solved, document the
changes that were made to the network.
If the changes did not work, go back and either gather more information or create a new action
plan. While working through the action plan process, you might get more ideas of possible
causes. Write them down; if the current action plan doesnt work, you will have notes about
other possibilities.
If you feel that all possible causes have been exhausted, you should probably go back and
gather more information that can give insights into more possible causes.
Repeat As Necessary
Iterations, or repetitions, of certain steps within the troubleshooting model, are how you narrow
implementation
down the causes of the problem. With each iteration of the action plan
observation process, you move closer to solving the problem. This is also the time to undo any
changes that had adverse effects or that did not fix the problem. Before you move on to
repeating the action plan
implementation
observation process, you must undo any
changes you made that did not work. Because you document the changes that you make each
time you implement an action plan, it is easy to undo those changes.
5-256 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.05-4
The GUI, although effective for day-to-day additions, moves, and changes, is not an effective
tool for troubleshooting the CUE system. The GUI can be used to reload CUE, view system
configuration, refresh MWI lights if out of sync, and turn on the tracing function. To effectively
troubleshoot, you must use the command-line interface (CLI) tools and functions.
Note
From the CLI of CUE, there are three different categories of tools that can be used. The first
category is the show commands. The many show commands can be used to view the
configuration, settings, and status of the CUE system.
Logging messages are another troubleshooting tool that can be used to diagnose a problem.
These unsolicited messages that come out of the system have a severity level associated with
them. These messages usually go to a syslog server or an internal log in memory.
Tracing is the equivalent of debugging in Cisco IOS software. Summary information to detailed
information is displayed on the screen, sent to a syslog server, or stored in memory. The trace
tools are used to focus on a specific aspect of the system.
Caution
Tracing can severely impact system performance and should be turned on with caution.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-257
High-Level Approach
1. Use the command show errors.
Shows the number of errors found per module
2. Examine the logs.
show logs (shows log file names)
show log (shows content of a log file)
3. Use trace commands.
Selective trace based on Module, Entity, Activity
-
--
--
---
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.05-5
To start troubleshooting CUE, use the show errors command. This command shows which
components of the system have errors. Invoke the problem that is occurring if it is repeatable
and notice which of the modules has the errors that are incrementing the counts.
Then use the show logs command to view the logs and the show log name logname command
to view the contents of the log files. This information may further define the problem or
component that is causing the errors.
Note
After the component or module that is causing the problems is known, the trace functionality
can be invoked and detailed output on the operation and function of the module can be
generated. This information should help troubleshoot the problem.
5-258 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Logging
Four Levels of logging messages exist in CUE:
Info: Syslog levels Debug, Info, and Notice
Warning: Syslog level Warning
Error: Syslog level Error
Fatal: Syslog level Critical, Alert, and Emergency
IPTX v2.05-6
Within the logging functions of CUE are four different levels of output. They are listed here
from least significant to most significant:
Info: Informational messages and notices
Warning: Events that may require attention
Error: Significant events that can affect functions
Fatal: Critical alerts and emergencies that can affect the stability of the system
These messages can be directed to three different destinations. They are:
Messages.log: A text file on the hard drive of the CUE network module (NM-CUE or NMCUE_EC) or the flash of the CUE advanced integration module (AIM-CUE). This is the
default action.
Console: Real-time messages or historical logs can be displayed on the console of CUE.
Syslog: The logging messages can be sent to an external syslog server.
Note
The log files in CUE are written as flat text files that can be opened with any text editor.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-259
Message.log
System log on NM-CUE:
Kept locally on the hard disk
(100-MB max size, history of two are kept)
/var/log/Messages.log
/var/log/Messages.log.prev
IPTX v2.05-7
By default, an NM-CUE sends all four categories of logging messages to a file on the
hard drive called /var/log/Messages.log. When this file reaches a set size, it is renamed as
/var/log/Messages.log.prev, and a new Messages.log file is started. When the Messages.log
file once again reaches a predetermined size, the Messages.log.prev is deleted along with the
entries it contained as the current Messages.log file gets renamed, again as Messages.log.prev.
And again, a new Messages.log file is created. This loop continues indefinitely.
The AIM-CUE uses flash instead of a hard drive, and this results in a different logging behavior
than that of the NM-CUE. Using flash can become an issue at this point because of the limited
number of times the data can write to a section of flash before the flash wears out. The consequence
of this is that the AIM-CUE logs only fatal and error messages to the Messages.log file by
default. The information and warning messages are not written to flash unless specifically
configured to do so.
The AIM-CUE uses a flat log, and when the log is full, any additional output is lost. This is to
ensure that the flash card is not overused.
Note
5-260 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Logging output is
---
stored in this file
-
IPTX v2.05-8
If no syslog server is present in the network, an alternative way to view the logging messages
stored in the log file is to send the Messages.log file to an FTP server. After it is on the server,
the file can be viewed using any text editor. Using a text editor is much easier than trying to
view the Messages.log file on the console of the CUE system.
In order for a log file to be displayed on the console or downloaded to a server, the administrator
needs to know the name of the log. The show logs command displays the log files on the
system. The logging messages are stored in the Messages.log file. The name can then be used
to copy the file to a URL.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-261
IPTX v2.05-9
The copy log logname url url command is used to copy the logging files to a server, such as an
FTP server. Then the file can be opened with a text editor. Because the amount of information
in the file can be significant, the search features of many text editors can be useful for finding
specific information or time stamps.
Note
This process works for any log file, including trace output stored in the atrace.log file.
5-262 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
- -- -- -
-
- --
--
-- -
IPTX v2.05-10
The second way to view the contents of the Messages.log file is from the console. This
is accomplished by using the show log name filename command. The drawback to this
command is that because the output to the console can be significant and the console is a
serial connection that typically runs at 9600 baud, the output can take a very long time to
fully display.
Tip
Use the keystroke CTRL-C to break out of this command while output is displaying to the
console or in the event that a CUE module appears unresponsive.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-263
IPTX v2.05-11
Logging messages can be sent to the console of CUE if desired. This is enabled by using the
command logging console [info | warning | error]. Any combination of levels of these logging
messages can be sent to display on the console. The fatal level of logging messages is always
set to display on the console port by default.
Caution
5-264 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
- -- --
- --
IPTX v2.05-12
Syslog servers are commonly used to centralize logging information in a network. This also
allows for archiving of messages if desired. If a syslog server is present, it is recommended that
CUE be configured to send its logging messages to the syslog server.
The log server address IP_address command is used to enable sending the logging messages
to a syslog server.
Tip
It is advised that the AIM-CUE be configured to use a syslog server to limit flash wear.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-265
---- -
-- - --
----- -- -
IPTX v2.05-13
This figure shows an example of warning level messages and their causes.
5-266 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
-- - --
-----
When a value is
set that is more
than that allowed
by license
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.05-14
This figure shows further examples of warning level messages and their causes.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-267
IPTX v2.05-15
The show logging command verifies which levels of logging messages are currently enabled to
the console. The default is that only fatal level logging messages are displayed to the console.
5-268 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Tracing
Equivalent of IOS software command debug
Composed of modules
Modules composed of one or more entities
Entity may have one or more activities under it
Output stored in atrace.log file as plain text
Used as temporary troubleshooting tool
IPTX v2.05-16
Whereas logging consists of unsolicited messages, tracing is something that the administrator
configures. Tracing in CUE is the equivalent of using debug commands in IOS software.
Knowledge of the system architecture is useful for understanding the structures within the trace
settings. Within trace, there are modules, and within the modules, there are entities. Entities
are composed of one or more activities. When configuring trace, all of these entities or any
combination of them can be enabled.
Trace output is stored in a log file as plain text. This file, atrace.log, is stored on the hard drive
(NM-CUE) or flash (AIM-CUE). Although trace may be enabled from either the GUI or the
CLI, it is viewed from the CLI.
Turning on excessive trace can cause performance issues in the CUE system, so trace should be
used as a temporary troubleshooting tool only. Trace should be turned off when the relevant
output has been gathered.
The trace output can be viewed in one of three different ways:
Displaying the log file: The atrace.log file can be output to the console of CUE.
Echoing to the console: Any new messages can be echoed to the console.
Copying the log file: The log file can be copied to a server and viewed with a text editor.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-269
Traces can be
turned on and off
via the GUI.
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.05-17
In the Administrator > Traces menu, the module is represented by a folder that can be opened
to view the entities. By selecting the folder level, all traces for that module can be enabled. A
more granular approach can be taken by selecting a specific entity to trace or a more specific
activity under the entity. Be sure to click the Apply button to commit the changes.
Note
Tracing is often turned on and collected under the direction of a Cisco Technical Assistance
Center (TAC) and the results sent to the TAC.
5-270 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Trace Commands
Tracing can be turned on independently for specific modules.
Within each module are a number of entities that can be traced individually.
Within each entity are activities that can be traced individually.
IPTX v2.05-18
To enable trace from the CLI, use the trace command. The trace command can be used to turn
on a specific entity, a whole module, or all tracing. Turning on tracing for a higher-level object
overrides lower-level objects. Much like debugging in IOS software on a router, tracing does
not survive the reboot of CUE. The trace setting returns to defaults upon a reboot.
Caution
Be careful of the trace all command because it can create a large amount of output and
have a serious impact on the performance of the CUE module.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-271
----
---
-
-
-
--
IPTX v2.05-19
The show trace command can be used to view the levels of trace that are currently configured.
The module, entity, and setting show up in the output. The setting is a 32-bit value that maps to
the activity or activities that have trace enabled in the system.
On the NM-CUE, there is some level of trace enabled by default. These values, displayed here,
are not easily understood in the CLI, but they can also be viewed in the GUI.
5-272 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Module
2005 Cisco Systems, Inc. All rights reserved.
Entity
32-bit Mask
IPTX v2.05-20
The setting field of the show trace command represents the level of tracing enabled. A setting
of ffffffff represents that all activities for an entity are enabled under the specified module.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-273
--
--
--
--
-
--
----
---
-
-
--
-
--
IPTX v2.05-21
The level of trace that is on by default varies depending on the module. The NM-CUE has
some focused low-level tracing turned on by default. The AIM-CUE has no tracing turned on
by default to prevent unnecessary flash wear.
Note
5-274 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.05-22
To view the trace output on the console of CUE, there are three choices:
Buffer history: The buffer of trace output can be sent to the console.
Output to console: Any new trace output can be sent to the console.
View the atrace.log: The atrace.log file can be sent to the console.
If the administrator wants to view the trace output in a text editor, the file can be copied to
an FTP server. This allows find and search tools to be used to look through large amounts
of output.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-275
Date/Time Stamp
Module
Entity
Message Text
IPTX v2.05-23
Trace output has structure and logic to the messages that are output to the atrace.log.
Included in the trace messages are:
Time date stamp: The time that the message was generated
Module: The module that the message originated from
Entity: The entity that the message originated from
Message: Text that conveys relevant information
5-276 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
- -
- -
--
----
-
--
-
-
----
IPTX v2.05-24
The output of trace since the last clearing of the buffer using the
clear buffer command or since the
last reboot, whichever was last, can be accomplished using CLI commands. The CLI command
to view the contents of the trace buffer is show trace buffer [long | short | containing]. The
long option does not use abbreviations for the module and entity like the short option does. One
of the most powerful options is the containing option, with which the administrator can search
for output that contains the specified text. This is very useful for finding messages that may
have occurred at a known time in the past.
Note
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-277
-
--
---
----
----
---
IPTX v2.05-25
To view trace output as it is generated, use the show trace buffer tail command. This
command sends all new trace messages to the console until the keystroke CTRL-C is entered.
Caution
Understand how much output to expect before turning this command on because output
may be generated faster than it can be sent to the console.
5-278 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.05-26
The entire contents of the atrace.log file can be sent to the console port of the CUE module.
Please be aware that the amount of output can be largeup to 100 MB of text in the NM-CUE
and up to 10 MB in the AIM-CUE. Another option that allows these larger files to be handled
better is a text editor.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-279
IPTX v2.05-27
To copy the atrace.log file to an FTP server, use the copy log atrace.log url url command.
5-280 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Interpreting a Debug
on Cisco CallManagerExpress
IOS software has built-in debugging tools
that can be used to troubleshoot problems
regarding the Cisco CallManagerExpress
component part of the integration:
Debugging tools may have a detrimental
performance impact on the router.
Debugging tools should be considered temporary
troubleshooting tools.
Output can be significant in volume.
Use the undebugall or no debug all command, when
finished, to disable all debugging.
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.05-28
CUE interacts with and depends upon Cisco CallManager Express, and as a result,
troubleshooting tools on Cisco CallManager Express are important. Debug tools
within IOS software can be used selectively to assist in solving problems.
Debugging tools should be used only when necessary. They should be used only temporarily,
turned on to troubleshoot and turned off when done. This is because of performance issues
use of these tools can have an impact on the system. When debugging is no longer needed, any
debugging function should be turned off using either the undebug all command or the no
debug all command. Both commands disable all debugging.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-281
- -
- -
--- ---
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.05-29
One very useful debugging command is the debug ephone command, which displays output
regarding the Cisco CallManager Expresscontrolled ephones.
Example
The following shows output for a message left, then retrieved and deleted.
- -
-
5-282 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.05-30
The debug ccsip command and its modifiers are very useful for debugging the session
initiation protocol (SIP). This is the connection between Cisco CallManager Express and CUE.
Other debug commands that can be useful include the following:
debug tftp Assists in troubleshooting Phone registration problems
debug ip http Troubleshoots GUI web page problems
debug voice ccapi inout Displays calls being set up to a Skinny Client Control Protocol
(SCCP) IP Phone
Caution
The debug voice ccapi inout command can cause a lot of output and overhead and should
be used carefully.
Example
The following shows debug ccsip calls output from checking voice mail.
CMERouter2#debug ccsip calls
SIP Call statistics tracing is enabled
Mar 8 13:27:04.455: //17/000000000000/SIP/Call/sipSPICallInfo:
The Call Setup Information is:
Call Control Block (CCB) : 0x6488517C
State of the Call : STATE_ACTIVE
TCP Sockets Used : NO
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-283
Mar 8 13:27:04.45://17/000000000000/SIP/Call/sipSPIMediaCallInfo:
Number of Media Streams:
Media Stream:
Negotiated Codec:
g711ulaw
Mar 8 13:27:10.223://17/000000000000/SIP/Call/sipSPICallInfo:
The Call Setup Information is:
Call Control Block (CCB): 0x6488517C
State of the Call :
STATE_DEAD
2025559000
Mar 8 13:27:10.223://17/000000000000/SIP/Call/sipSPIMediaCallInfo:
Number of Media Streams: 1
Media Stream:
Negotiated Codec:
g711ulaw
Mar 8 13:27:10.223://17/000000000000/SIP/Call/sipSPICallInfo:
Disconnect Cause (CC): 16
Disconnect Cause (SIP): 200
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-285
libc
Linux Kernel
TracingSyslogSNMPRBCP
Bootloader
BIOS
Hardware NM/AIM
Hardware and Operating System
IPTX v2.05-31
5-286 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Authentication
Tomcat
Open LDAP
PostgreSQL
Applications
CLI
Startup/Monitor
sysdb
JVM
Open LDAP
PostgreSQL
Tomcat
JAAS Authentication
IPTX v2.05-32
The application section of the system architecture is where the CUE applications run. The
different infrastructure components that make up the applications section assist the CUE
application in functioning properly. The infrastructure components are:
Authentication: Java Authentication and Authorization Service (JAAS) is used for
authentication.
HTTP server: A tomcat web server is used for the HTTP server.
LDAP directory: Open LDAP is used for the Lightweight Directory Access Protocol
(LDAP) directory and is where the user and administrator are defined.
Database: PostgreSQL is used for the database and is where voice mailboxes are defined
and voice mails are stored.
JVM: Java Virtual Machine is used in CUE to execute the system and custom scripts.
sysdb: Thissystem utility coordinates the different components that are working together.
Startup monitor: This monitors the bootup process of CUE.
CLI: This is the command-line interface of the CUE system.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-287
System-Level Troubleshooting
IPTX v2.05-33
The true core applications of CUE are the voice mail and the automated attendant. These
leverage the infrastructure applications to accomplish their tasks.
When a call arrives to either the automated attendant or to voice mail, an .aef script is run
within the Customer Response Solution (CRS) engine. This framework allows an instance of a
script to be executed for each call that arrives. When a call reaches the voice mail application,
voicebrowser.aef, the script has voice extensible markup language (VXML) information. This
launches a Java Server Page (JSP), which can be used to perform various functions, such as
retrieving user information from Open LDAP and sending PostgreSQL database calls to
retrieve voice mails.
5-288 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
System-Level Troubleshooting
on Cisco CallManager Express
- - --
IPTX v2.05-34
To address problems connecting to the CUE module from the host router, a good place to start
is with the status of the CUE module. The RBCP requires that the service module be in a stable
state before communication can take place. The state of the module can be determined by using
the service-module service-engine mod/port status command. If the module is in a nonsteady
state, a reload of the CUE module may be required. The command to reload the CUE module
from the router is service-module service-engine mod/port reload.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-289
System-Level Troubleshooting
on Cisco CallManager Express (Cont.)
- -
- -
-
- -
-
- - -
- - -
-
--
-
----
-
IPTX v2.05-35
To verify that the CUE module is recognized by the system, use the show version command.
The service module should be seen. If it is not seen with the show version command, some
possible causes are:
Invalid hardware platform: Cisco 2600XM, 2691, 2800 Series, 3700 Series, and
3800 Series platforms only
IOS Release: 12.3(4)T or later for the NM-CUE, 12.3(7)T or later for the AIM-CUE, and
12.3(14)T for the NM-CUE-EC
Feature set of IOS software: Minimum of IOS IP Plus or IP Voice
Seating of module: Reseat the module; OIR on 3745 and 3845 only
Verify IP configuration: View the IP configuration and verify that the service engine has
an IP address and is in the up/up state.
The status of the service engine IP address should be in the up/up condition with a valid
IP address that is on the same subnet as the service module address.
5-290 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
System-Level Troubleshooting:
Verifying Current System Parameters
- - -
- -- -
--
-
- -
-
-
- -
-
- - -
- -
-
- -
-
IPTX v2.05-36
To view the licensed capacity that the CUE system currently has, use the show software
licenses command. This command enables the administrator to verify that the correct license
was installed during deployment or upgrade.
To view the current version that is running on the CUE module, use the show software version
command. This command displays the version of installed packages on the system. This also
shows the amount of time that the CUE module has been running since the last reboot. There is
no other location or command that shows this information.
Note
The version of the boot loader file is commonly a different version from the other files.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-291
System-Level Troubleshooting:
Verifying Current System Usage
- -
Number of
- -
mailboxes
-
-
-
-- --
- --
--
- --
- -
IPTX v2.05-37
To view the current utilization of the CUE system, use the show voicemail usage command.
This is useful when troubleshooting problems which are occurring in numerous mailboxes.
5-292 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
System-Level Troubleshooting:
Verifying a Mailbox
-
---
-
-
- -
--
Mailbox settings
-- --
-
Mailbox usage
- --
--
information
--
--
IPTX v2.05-38
To view the specific usage and limits of a single mailbox, use the show voicemail detail
mailbox owner command. This is useful when troubleshooting a single user that is having
problems.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-293
System-Level Troubleshooting:
Show System Status
- --
-
-
-
--
- ---
--
- --
--
--
IPTX v2.05-39
From the CLI of the CUE module, use the show processes command to view the status of the
processes running on the module. If any of the processes show something other than alive,
a reload of the CUE module may be needed.
To view the CPU utilization, use the show processes cpu command. The information from
this command can be used to build a baseline for the CUE system, which can be useful later
for troubleshooting.
5-294 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
System-Level Troubleshooting:
Additional Useful show Commands
Additional useful show commands include:
IPTX v2.05-40
There are many other show commands that can be helpful in troubleshooting CUE. These
commands are all executed from the CUE CLI.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-295
GUI Troubleshooting
GUI Troubleshooting:
IOS Prerequisite Configuration
These fields must exist for the Cisco
CallManager Express and CUE GUI to operate
correctly
-
-
-
-
-
---
-- -- -
IPTX v2.05-41
For the GUI of CUE to work, there are some prerequisite configurations that must exist on the
Cisco CallManager Express router. The GUI of CUE is tightly integrated with the GUI of Cisco
CallManager Express. In fact, the GUI of CUE requires that the GUI of Cisco CallManager
Express be functioning properly. If problems are found in accessing the GUI of CUE, verify the
following on Cisco CallManager Express:
HTTP server: The HTTP server must be enabled.
Web pages loaded: The web pages must be loaded into the flash of Cisco CallManager
Express.
HTTP server path: The HTTP server must use the Cisco CallManager Express flash to
serve up the web pages.
Credentials: A web administrator must be defined in the Cisco CallManager Express
router.
5-296 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
GUI Troubleshooting:
Flash Files Required
- -
- - - --
-
-
-
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.05-42
The web pages must be loaded into flash. The contents of flash can be verified with the
show flash command.
Note
The specific files can vary with the version of Cisco CallManager Express.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-297
GUI Troubleshooting:
Applicable CUE Trace Commands
---
-
--
--
-
Trace module
for the GUI is
trace webinterface
IPTX v2.05-43
To troubleshoot the GUI of CUE, tracing can be enabled. This tracing of the GUI can be
configured with the trace webinterface entityactivity command. Assuming some functionality
of the GUI is working, the tracing of the web interface can be enabled from the GUI of CUE.
Caution
The use of trace as a troubleshooting tool can have a detrimental effect on the performance
of the CUE module.
5-298 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
GUI Troubleshooting:
ReviewAdministrators and Users
Two modes (privilege levels) of access
Administrator mode: Provides functions to
completely provision Cisco CallManager Express
as well as CUE
Default: Administrator mode
Maximum number of sessions: 1
User mode: Used to manage user-owned profiles
and preferences; limited capabilities
Maximum number of sessions: 4
IPTX v2.05-44
The GUI web page has some limitations on the number of users that can be logged on at any
one time. There can be only one administrator logged in at any time. The second administrator
gets the GUI of a user, not the full menus of the administrator.
Users can have a maximum of four sessions. The fifth user will be denied access.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-299
GUI Troubleshooting:
Failed Login
No JDoe user
--- - -
-- - -
--- - -
to log in
---
-
--- -
--
-
---
-
IPTX v2.05-45
When a login to the GUI fails, whether for a user or an administrator, there are some possible
causes that should be checked.
For a user, the most common problems are a forgotten password and the use of incorrect
usernames. To troubleshoot this, use the trace webinterface sessions login command. If the
password needs to be reset, use the GUI as the administrator to override the current password.
If the username is invalid, create the user or correct the user to the appropriate username.
If an administrator has forgotten the password, another administrator can log in and reset the
password. If there is no other administrator account, then a reinstall and restoration must be
performed. This could be problematic because, in order to make a backup, an administrator
must log in.
Tip
5-300 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
GUI Troubleshooting:
Groups
A group ID is unique and cannot be used to log in to the
CUE GUI.
A group can have only one mailbox.
A group ID cannot be used for a user ID and vice versa.
Users can log in to a group mailbox only via their personal
mailbox.
A group need not have any members.
A group can be a member of any number of other groups.
MWI for individual members of a group requires related
configuration on a Cisco CallManager Expressdedicated
Phone or a shared-line appearance on members Phones.
A group can be a member of another group, and a group can
own another group.
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.05-47
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-301
This topic describes the guidelines for troubleshooting voice mail and automated attendant.
--
-
--
-
Automated Attendant:
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.05-51
The trace command governing voice mail can be invoked with the command trace voicemail
entity activity. This command sends output that can be useful in troubleshooting voice mail. For
troubleshooting the automated attendant, the commands trace webinterface autoattendant
and trace webinterface prompt can be useful.
5-302 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.05-52
The script voicebrowser.aef provides the functionality of the CUE voice mail application . This
script uses VXML to implement its functionality. These functions can be viewed by using the
trace voicemail vxml all command.
The caller ID of users calling into voice mail is checked. If there is a mailbox associated to that
phone number, users are prompted for the PIN. If there is no matching mailbox, users are
prompted to enter the extension that their mailbox is associated with.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-303
---
-- - -
Digit 1 pressed
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.05-53
With the trace voicemail vxml all command turned on, a call arriving at voice mail and a
message being left for a subscriber can be viewed in the form of trace output. This output can
include the prompts played and any corresponding wave files that are mapped to those prompts.
The input of the caller can also be displayed in the output of the trace command.
5-304 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
DTMF digit of 1
is entered
-
-
-
--
-
-
-
-
When the subscriber notices the MWI light and checks the voice mail message, the act of
checking the voice mail can also be viewed in the form of trace voicemail vxml all output.
The password and input of the subscriber logging in and selecting to listen to the message is
displayed in the trace output.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-305
-
-
-
-
-
--
Various wave
files played
IPTX v2.05-55
A voice mail message is played to a subscriber, then input is received from the subscriber
instructing the system to delete the message. Various wave files are then played to the
subscriber.
5-306 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
---
-
-
- -
--
-- --
-
- --
--
--
--
IPTX v2.05-56
The specifics of a users mailbox can be viewed with the command show voicemail detail
mailbox owner. This displays the owner, description, state, size, usage statistics, and
expiration.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-307
IPTX v2.05-57
In the example, a caller dials into a phone number that has an automated attendant assigned to
it. The automated attendant has been defined by the administrator to play an application called
mygeneral. The following pages show how trace can be used to follow and troubleshoot the call
as it travels through the mygeneral application.
5-308 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
-
--
-
--
-
-
-
- -
- - -
IPTX v2.05-58
The trace ccn engine all command can be used to view the execution of an application. When
the call arrives, the system has been configured to use the application named mygeneral. The
settings on the mygeneral application can be viewed. The settings of ID number, description,
and maximum number of ports can be seen in the output from the trace ccn engine all
command.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-309
- -
- -
- -
- -
- -
- -
- -
- -
- -
IPTX v2.05-59
The trace ccn engine all command is still configured, and the output shows the various steps
being executed. If there is a problem with a step, it will show up in this output. In the case in
the figure, the steps all succeed.
5-310 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
- -
- -
- -
- -
- -
- -
- -
- -
IPTX v2.05-60
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-311
-
--
-
-
--
- - -
-
--- --
--
-
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.05-61
There is no error checking as a script is uploaded to the CUE system. The CUE system will
allow invalid scripts to be uploaded and applied. If this occurs, the tracing output can be used to
diagnose the problem.
If a script calls upon another script, this uses a call subflow step in the CUE Auto Attendant
Editor (CUE AA Editor). This requires that both scripts be uploaded to the CUE system. If the
subflow is not uploaded, then the output shown in the previous figure will be generated in the
trace ccn engine all output.
5-312 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Automated Attendant
Application Errors (Cont.)
-- --
-----
--
- - -
--- --
--- - -
--- -
-- - -
-
- -- - -
--
--
-
-
IPTX v2.05-62
This figure shows more specific information about the missing script, which is called
MissingScript.aef.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-313
7008
IPTX v2.05-63
In the example in this figure, a caller checks the voice mailbox by pressing the Messages or
Envelope icon button.
5-314 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.05-64
This figure shows a user logging in to the voice mailbox. Eventually, the spoken name is
retrieved.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-315
Summary
Summary
A structured and methodical approach to troubleshooting
is the most efficient.
Logs, show commands, and tracing are all tools that are
available to assist with troubleshooting.
An understanding of the architecture of the software will
help you understand troubleshooting.
The CLI has various tools and commands that can be
used if problems with the GUI are encountered.
Trace can be enabled in the GUI, but not viewed. This
must be done from the CLI.
Voice mail and automated attendant problems are
resolved from the CLI through logs,show commands, and
trace output.
2005 Cisco Systems, Inc. All rights reserved.
5-316 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.05-65
Module Summary
Module Summary
CUE provides voice mail and automated attendant
functionality that can be managed through the GUI or the CLI.
There are many requirements for installing or upgrading
CUE.
The system software, licensed capacity, or both can be
upgraded.
The automated attendant functions can be customized using
the CUEAA Editor.
Users and groups can be managed by the administrator
using the CLI or the GUI.
GDMs can be created and accessed through the user s
personal mailbox.
Logs, show commands, and traces are all valuable tools for
troubleshooting CUE.
IPTX v2.05-1
Reference
For additional information, refer to the following resources:
Cisco Systems, Inc. Cisco Unity Express Data Sheet .
http://www.cisco.com/en/US/products/hw/modules/ps3115/products_data_sheet09186a008
01c63a3.html.
Introduction to Cisco Unity Express Voice Mail and Auto Attendant.
http://www.cisco.com/univercd/cc/td/doc/product/voice/unityexp/rel1_1_2/cmecligd/ch1int
ro.pdf.
Introduction to Cisco Unity Express Voice Mail and Auto Attendant.
http://www.cisco.com/en/US/products/sw/voicesw/ps5520/products_administration_guide_
chapter09186a00802caaa3.html.
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-317
Module Self-Check
Use the questions here to review what you learned in this module. The correct answers and
solutions are found in the Module Self-Check Answer Key.
Q1) Choose the router platforms that are supported by the Cisco CallManager Express and
CUE platforms. (Choose all that apply.) (Source: Describing Cisco Unity Express
Installation and Initialization)
A) 3600
B) 2600XM
C) 3800
D) 7200
Q2) Name the three modules that are supported for running CUE. (Choose three.) (Source:
Describing Cisco Unity Express Installation and Initialization)
A) AIM-CUE
B) NM-CUE
C) CUE slot module
D) NM2V-CUE
E) NM-CUE-EC
Q3) What are the hardware specifications for the NM-CUE? (Source: Describing Cisco
Unity Express Installation and Initialization)
A) 2.4-GHz processor
B) 2 GIG of DDR RAM
C) Windows 2003 Slim Version
D) 250 GB ATA HDD
E) none of the above
Q4) What are the two main differences between the memory and storage of the NM-CUE
and the AIM-CUE? (Choose two.) (Source: Describing Cisco Unity Express
Installation and Initialization)
A) flash-based storage versus hard drive
based storage
B) the size of the hard drives
C) the operating system
D) the installation packages are different for the different modules
Q5) When rebooting a router that contains the CUE module, what effect does the key
sequence of *** have, if initiated? (Source: Describing Cisco Unity Express
Installation and Initialization)
A) causes the router to enter the CUE mode
B) initiates the CUE upgrade wizard
C) interrupts the reload and enters boot loader mode
D) starts up the CUE module
Q6) Which file extension is used on all script names created by the CUE AA Editor?
(Source: Configuring Cisco Unity Express Auto Attendant)
A) .aef
B) .txt
C) .vcs
D) .unt
5-318 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Q7) How many stored scripts will the AIM-CUE support in the CUE system? (Source:
Configuring Cisco Unity Express Auto Attendant)
A) 12
B) 8
C) 6
D) 4
Q8) How many stored scripts will the NM-CUE support in the CUE system? (Source:
Configuring Cisco Unity Express Auto Attendant)
A) 20
B) 10
C) 8
D) 12
Q9) Which is a limitation of using a variable to populate information within a script?
(Source: Configuring Cisco Unity Express Auto Attendant)
A) Scripts cannot share variables.
B) Variables cannot be modified.
C) Variables are limited to ten characters.
D) There are only 20 variable fields that can be populated.
Q10) Which steps are necessary when making a script available to the CUE system? (Choose
all that apply.) (Source: Configuring Cisco Unity Express Auto Attendant)
A) Save the script with an .aef extension.
B) Upload the script in the repository.
C) Refresh the script.
D) Make the script active.
Q11) Which CLI command shows all available prompts in the CUE system? (Source:
Configuring Cisco Unity Express Auto Attendant)
A)
B)
C)
D)
show prompt
show ccn prompts
show cue prompts
show all prompts
Q12) Prompt names cannot be changed within the CUE system. Choose the steps that are
necessary to change a prompt name. (Choose all that apply.) (Source: Configuring
Cisco Unity Express Auto Attendant)
A) Download the prompt to a PC.
B) Change the file name on the PC.
C) Upload the prompt back to the CUE system.
D) Change any parameters in applications to point to the new name.
E) Delete the old prompt.
Q13) What is used to trigger an initial script in the CUE system? (Source: Configuring Cisco
Unity Express Auto Attendant)
A) directory number
B) CED
C) ANI
D) call-in number
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-319
Q14) What is the maximum number of automated attendants that can be enabled at one time
in a CUE system? (Source: Configuring Cisco Unity Express Auto Attendant)
A) 10
B) 8
C) 5
D) 12
Q15) After a script has been constructed and uploaded to the CUE, how is it activated?
(Source: Configuring Cisco Unity Express Auto Attendant)
A) by assigning it to a number that will be dialed by a caller
B) from the GUI, checking the box to make it active
C) from the CLI, issuing the command
ccn active
D) nothing has to be done after uploading script
Q16) When you are recording prompts that will be used in the CUE system, which format
must be used? (Source: Configuring Cisco Unity Express Auto Attendant)
A) G.711 mu-law
B) G.711 a-law
C) G.729 mu-law
D) G.729 a-law
Q17) Where can CUE system users be created? (Choose all that apply.) (Source: Configuring
Cisco Unity Express Users and Groups)
A) TUI
B) CLI
C) GUI
D) initialization wizard
Q18) When creating users in CUE, there is a password field and a PIN field. What is the PIN
field used for? (Choose all that apply.) (Source: Configuring Cisco Unity Express
Users and Groups)
A) logging in to the user
s computer
B) logging in to the IP Phone
C) logging in to e-mail
D) none of the above
Q19) When setting mailbox and message limits, which of these fields are required? (Choose
all that apply.) (Source: Configuring Cisco Unity Express Voice Mail)
A) mailbox size
B) maximum call message size
C) maximum greeting size
D) message entry point
Q20) Which of the following must be configured for VPIM networking to function? (Choose
all that apply.) (Source: Configuring Cisco Unity Express Voice Mail)
A) remote users
B) the remote location(s)
C) the local location
D) the LRU cache
E) blind addressing
F) the local location must be designated
5-320 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Q21) When addressing a message from the TUI using spell-by-name, which of the following
scenarios will find a valid remote user, assuming an NM-CUE is being used? (Choose
all that apply.) (Source: Configuring Cisco Unity Express Voice Mail)
A) A remote user who has never sent a message to the local location before and is
not configured locally as a remote user.
B) A remote user who has never sent a message to the local location before and is
configured as a remote user on the local CUE module.
C) A remote user sent a message last week, and 60 other remote users sent
messages in the interim. The user is not defined locally as a remote user.
D) A remote user sent a message last week, and 40 other remote users sent
messages in the interim. The user is not defined locally as a remote user.
E) The LRU cache is disabled, and the remote user is not defined locally.
Q22) Broadcasts can be sent by which of the following users? (Choose all that apply.)
(Source: Configuring Cisco Unity Express Voice Mail)
A) all users in the Administrator group
B) users with the Broadcast Message check box enabled
C) all users in the broadcast group
D) all users in any group that has the broadcast capability set
E) any user may send a broadcast locally
F) any user that starts with a numeric value
Q23) Which two of the following best describe a distribution list? (Choose two.) (Source:
Configuring Cisco Unity Express Voice Mail)
A) Determines the administrative abilities of any member of the list.
B) Is used to broadcast messages to all members of the list.
C) Public distribution lists are available to all users.
D) Private distribution lists are specific to a user.
E) May only be defined by the administrator.
F) Are constructed through the TUI only.
Q24) When enabling tracing in the CUE system, where can the output be directed? (Choose
all that apply.) (Source: Troubleshooting Cisco Unity Express)
A) TFTP server
B) Messages.log
C) router
s flash
D) syslog server
Copyright 2005, Cisco Systems, Inc. Configuring Cisco Unity Express Automated Attendant and Voice Mail 5-321
Q2) A, B, E
Q3) E
Q4) A, B
Q5) C
Q6) A
Q7) D
Q8) C
Q9) A
Q10) A, B, C
Q11) B
Q12) A, B, C, D, E
Q13) D
Q14) C
Q15) A
Q16) A
Q17) B, C, D
Q18) B
Q19) A, B, D
Q20) B, C, F
Q21) B, D
Q22) A, C, D
Q23) C, D
Q24) B, D
5-322 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Module 6
Introducing IP Quality of
Service
Overview
In order to provide a quality user experience in a converged network, voice traffic must be
protected from other types of traffic. The employment and enforcement of quality of service
(QoS) policies within a network plays an essential role in enabling network administrators and
architects to meet the demands of a converged network. QoS is a crucial element of any
administrative policy that mandates how application traffic is to be handled on a network. This
module introduces the concept of quality of service, explains key issues of networked
applications, and describes different methods for implementing QoS.
Module Objectives
Upon completing this module, you will be able to explain the need to implement QoS and
explain methods for implementing and managing QoS using AutoQoS.
Define the terminology of QoS and explain the key steps to implement QoS on a converged
network
Describe the Differentiated Services model and explain how it can be used to implement
QoS in a network
Describe mechanisms for implementing QoS and identify where in a network the different
QoS mechanisms are commonly used
Explain how to implement a QoS policy using MQC
Identify capabilities provided by AutoQoS and successfully configure QoS on a network
using AutoQoS
6-2 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Lesson 1
Understanding Quality of
Service
Overview
Before QoS can be configured in a network, it is important to understand just what QoS is and
why it is useful in solving different problems that arise when different traffic types are
converged into a single network infrastructure. The basic concepts and key terminology of QoS
are explained in this lesson. Also included in this lesson are the three steps involved in
implementing a QoS policy and special QoS considerations for LANs.
Objectives
Upon completing this lesson, you will be able to define the terminology of QoS and identify
and explain the key steps in implementing QoS on a converged network. This includes being
able to meet these objectives:
Define the term quality of service with respect to traffic in a network
Identify the four key quality issues with converged networks
Explain the QoS requirements of common types of network applications
Define the term QoS policy
List and explain the key steps involved in implementing a QoS policy on a network
Identify QoS considerations of LAN switches
IPTX v2.06-3
QoS is the ability of the network to provide better or special service to selected users and/or
applications to the detriment of other users and/or applications.
Cisco IOS QoS features enable network administrators to control and predictably service a
variety of networked applications and traffic types, thus allowing network managers to take
advantage of a new generation of media-rich and mission-critical applications.
The goal of QoS is to provide better and more predictable network service by providing
dedicated bandwidth, controlled jitter and latency, and improved loss characteristics. QoS
achieves these goals by providing tools for managing network congestion, shaping network
traffic, using expensive wide-area links more efficiently, and setting traffic policies across the
network. QoS offers intelligent network services that when correctly applied, help to provide
consistent, predictable performance.
6-4 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Converged Networks
This topic explains why QoS was not important in nonconverged networks.
Converged Networks:
Network Before Convergence
IPTX v2.06-4
Historically, network engineering has been focused on connectivity. Different traffic types
(data, voice, video, and so on) have different network requirements and traffic characteristics.
Not too long ago, few tools existed to handle the differing needs of these traffic types, forcing
network engineers to build separate networks to handle these traffic requirements. Separate
networks mean higher equipment, installation, and operating costs and require a larger support
staff.
For traditional data networks that are supporting applications such as file transfer or email, the
rates at which data comes onto the network resulted in bursty data flows. The data arrives in
packets and tries to grab as much bandwidth as it can at any given time. The access is very
egalitarian its first come, first served, so whoever gets there first gets the bandwidth.
As a result of this somewhat anarchic way of attacking the network, the data rate is adaptive to
network conditions.
The protocols that have been developed for data networks adapt to the bursty nature of data
networks, and brief outages are survivable. Typically, if retrieving e-mail, a delay of a few
seconds is generally not noticeable. A delay of minutes is annoying, but not serious.
Converged Networks:
Network After Convergence
IPTX v2.06-5
This figure shows a converged network in which voice, video, and data traffic use the same
network facilities. Merging different traffic streams with dramatically differing requirements
can lead to a number of problems.
Although packets carrying voice traffic are typically very small, they cannot tolerate delay and
delay variation as they traverse the network or voice quality suffers. Voices break up and words
become incomprehensible.
On the other hand, packets carrying file transfer data are typically large and can survive delays
and drops. It is possible to retransmit part of a dropped file, but it is not feasible to retransmit a
part of a conversation.
The constant, but small packet voice flow competes with bursty data flows. Unless some
mechanism mediates the overall flow, voice quality suffers terribly at times of network
congestion. The critical voice traffic must get priority.
Voice traffic and video traffic are very time sensitive. They cannot be delayed or dropped or the
resulting quality of voice and video suffers.
6-6 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
This topic describes the basic quality issues presented by converged networks.
Converged Networks:
Quality Issues
IPTX v2.06-6
Converged Networks:
Quality Issues (Cont.)
Video Lacking
Proper QoS
IPTX v2.06-7
The three big problems facing converged enterprise networks are bandwidth capacity, delay
issues, variable delay, variation of delay (also called jitter), and packet loss.
Large graphic files, multimedia uses, and increasing use for voice and video cause bandwidth
capacity problems over data networks.
Delay is the amount of time it takes for a packet to reach the receiving endpoint after being
transmitted from the sending endpoint. This is called end-to-end delay, and it consists of two
components: fixed network delay and variable network delay. Jitter is the delta, or difference,
in the total end-to-end delay values of two voice packets in the voice flow.
Two types of fixed delay are serialization and propagation. Serialization is the process of
placing bits on the circuit. The higher the circuit speed, the less time it takes to place the bits on
the circuit. Therefore, the higher the speed of the link, the less the amount of serialization delay
that is incurred. Propagation delay is the time it takes for frames to transit the physical media.
Processing delay is a type of variable delay and is the time required by a networking device to
look up the route, change the header, and complete other switching tasks. In some cases, the
packet also must be manipulated. For example, the encapsulation type or the hop count must be
changed. Each of these steps can contribute to the processing delay.
Queuing delay is another type of variable delay and is the time a packet spends in a queue, or
buffer, before being processed. Packets may be queued by routers or switches on an ingress
interface, an egress interface, or both. Queuing delay can be significant if a rate change occurs
or if many interfaces are aggregated into a single uplink.
Loss of packets is usually caused by congestion in the WAN, resulting in speech dropouts or a
stutter effect if the play-out side tries to accommodate by repeating previous packets.
6-8 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Lack of Bandwidth
This topic explains how a lack of bandwidth can adversely impact QoS in a network and
describes ways to effectively increase bandwidth on a link.
Lack of Bandwidth
IPTX v2.06-8
Bandwidth must be considered on the entire communication path between source and
destination. The example in the figure illustrates an empty network with four hops between a
server and a client. Each hop is using different media with a different bandwidth. The
maximum available bandwidth is equal to the bandwidth of the slowest link. So although the
workstation has 10 Mbps of bandwidth, packets flowing between these devices must cross the
slow-speed WAN link at 256 kbps.
It is rare that only a single communication flow is present on a computer network at a given
time. In reality, multiple communication flows are competing for the same bandwidth. The
calculation of the available bandwidth is much more complex when multiple flows are
traversing the network. The calculation of the available bandwidth in the figure is a rough
approximation.
IPTX v2.06-14
The best approach is to increase the link capacity in order to accommodate all applications and
users with some extra bandwidth to spare. This solution sounds simple enough, but in the real
world it brings a high cost in terms of the money and time it takes to implement. Very often,
there are also technological limitations to upgrading to a higher bandwidth.
Another option is to classify traffic into QoS classes and prioritize it according to importance
(business-critical traffic should get enough bandwidth, voice should get enough bandwidth, and
prioritized forwarding and the least important traffic should get the remaining bandwidth).
There are a wide variety of mechanisms available in Cisco IOS software that provide
bandwidth guarantees, for example:
Priority queuing (PQ)
Custom queuing (CQ)
Class-based weighted fair queuing (CBWFQ)
Low latency queuing (LLQ)
LLQ is the preferred bandwidth guarantee mechanism in a Voice over IP (VoIP) network. LLQ
establishes a strict priority queue for voice packets and CBWFQ for other traffic classes.
Optimizing link usage by compressing the payload of frames (virtually) increases the link
bandwidth. Compression, on the other hand, also increases delay because of the complexity of
compression algorithms. Using hardware compression can accelerate the compression of packet
payloads. Stacker and Predictor are two compression algorithms available in Cisco IOS
software.
Another link efficiency mechanism is header compression. This mechanism is especially
effective in networks where most packets carry small amounts of data (payload-to-header ratio
is small). Typical examples of header compression are TCP Header Compression and RealTime Transport Protocol (RTP) Header Compression.
6-10 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
End-to-End Delay
This topic explains how end-to-end delay can adversely impact QoS in a network and describes
ways to effectively reduce delay.
End-to-End Delay
Delay = P1 + Q1 + P2 + Q2 + P3 + Q3 + P4 = X ms
IPTX v2.06-15
Delay must be considered over the entire communication path, end to end. Therefore, the total
end-to-end delay is the sum total of all delay experience over a communication path between a
sender and receiver. The figure illustrates the impact a network has on the end-to-end delay.
Each hop in the network adds to the overall delay because of these factors:
Propagation delay is caused by the speed-of-light traveling in the media (for example,
speed-of-light traveling in fiber optics or copper media).
Serialization delay is the time it takes to clock all the bits in a packet onto the wire. This is
a fixed value that is a function of the link bandwidth.
Processing and queuing delays within a router, caused by a wide variety of conditions.
People generally ignore propagation delay, but it can be significant (about 40 ms coast to coast
over optical). Ping is one way to measure the round-trip time of IP packets in a network.
6-12 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.06-24
PQ
CQ
LLQ
Payload compression reduces the size of packets and, therefore, virtually increases link
bandwidth. Additionally, compressed packets are smaller and need less time to be
transmitted. On the other hand, compression uses complex algorithms that take time and
add to the delay. This approach is, therefore, not used to provide low-delay propagation of
packets.
Header compression is not as CPU-intensive and can be used in combination with other
mechanisms to reduce delay. It is especially useful for voice packets that have a bad
payload-to-header ratio, which is improved by reducing the header of the packet (RTP
Header Compression). By minimizing delay, jitter is also reduced (delay is more
predictable).
6-14 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Packet Loss
This topic explains how packet loss can adversely impact QoS in a network and describes ways
to manage packet loss so that QoS is not affected.
Packet Loss
Tail-drops occur when the output queue is full. These are common
drops which happen when a link is congested
Many other types of drops exist, usually the result of router
congestion, that are uncommon and may require a hardware upgrade
(input drop, ignore, overrun, frame errors)
IPTX v2.06-25
The usual packet loss occurs when routers run out of buffer space for a particular interface
(output queue). The figure illustrates a full output queue of an interface, which causes newly
arriving packets to be dropped. The term used for such drops is simply output drop or taildrop (packets are dropped at the tail of the queue).
Routers might also drop packets for other (less common) reasons, for example:
Input queue dropmain CPU is congested and cannot process packets (the input queue is
full)
Ignorerouter ran out of buffer space
OverrunCPU is congested and cannot assign a free buffer to the new packet
Frame errors (CRC, runt, giant)hardware detected error in a frame
IPTX v1.07-30
Packet loss is usually a result of congestion on an interface. Most applications that use TCP
experience slowdown because of TCP adjusting to the networks resources (dropped TCP
segments cause TCP sessions to reduce their window sizes). There are some other applications
that do not use TCP and cannot handle drops (fragile flows).
The following approaches can be taken to prevent drops of sensitive applications:
Increase link capacity to ease or prevent congestion.
Guarantee enough bandwidth and increase buffer space to accommodate bursts of fragile
applications. There are several mechanisms available in Cisco IOS software that can
guarantee bandwidth and provide prioritized forwarding to drop-sensitive applications, for
example:
PQ
CQ
IP RTP prioritization
CBWFQ
LLQ
Prevent congestion by dropping other packets before congestion occurs. Weighted random
early detection (WRED) can be used to start dropping other packets before congestion
occurs.
There are some other mechanisms that can also be used to prevent congestion:
Traffic shaping delays packets instead of dropping them (generic traffic shaping, frame
relay traffic shaping, and class-based shaping).
Traffic policing can limit the rate of less important packets to provide better service to
drop-sensitive packets (committed access rate and class-based policing).
6-16 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
QoS Requirements
The following topic describes the QoS traffic requirements for voice, video, and data traffic.
Loss
< 1%*
17-106 kbps guaranteed
priority bandwidth
per call
150 bps (+ layer 2
overhead) guaranteed
bandwidth for VoiceControl traffic per call
*one-way requirements
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.06-31
Voice traffic has extremely stringent QoS requirements. Voice traffic usually generates a
smooth demand on bandwidth and has minimal impact on other traffic as long as it is managed.
While voice packets are typically small (60120 bytes), they cannot tolerate delay or drops.
The result of delays and drops are poor, and often unacceptable, voice quality. But drops cannot
be tolerated, so User Datagram Protocol (UDP) is used to package voice packets because TCP
retransmit capabilities have no value.
Voice packets can tolerate no more than a 150-ms delay (one-way requirement) and no more
than a 1 percent packet loss.
A typical voice call requires from 17 to 106 kbps of guaranteed priority bandwidth plus an
additional 150 bps per call for voice-control traffic. Multiplying these bandwidth requirements
times the maximum number of calls expected during the busiest time period provides an
indication of the overall bandwidth required for voice traffic.
Loss
< 1%
Minimum priority
bandwidth guarantee
required is:
Video-Stream + 20%
e.g. a 384 kbps stream would
require 460 kbps of priority
bandwidth
*one-way requirements
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.06-32
Video-conferencing applications also have stringent QoS requirements that are similar to voice.
But video-conferencing traffic is often bursty and greedy in nature, and as a result, it can
impact other traffic. Therefore, it is important to understand the video-conferencing
requirements for a network and to provision carefully for it.
The minimum bandwidth for a video-conferencing stream requires the actual bandwidth of the
stream (depending upon the type of video-conferencing coder-decoder [codec] being used) plus
some overhead. For example, a 384-kbps video stream actually requires a total of 460 kbps of
priority bandwidth.
6-18 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.06-33
QoS Policy
QoS Policy
A network-wide
definition of the
specific levels of
quality of service
assigned to different
classes of network
traffic
IPTX v2.06-34
A QoS policy is a networkwide definition of the specific levels of quality of service that are
assigned to different classes of network traffic.
Having a QoS policy is just as important in a converged network as a security policy. A written
and public QoS policy allows users to understand and negotiate for QoS in the network.
6-20 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.06-35
The figure shows an example of a QoS policy that could be defined for a network that has the
following three different traffic types:
Enterprise resource planning (ERP) applications have a high QoS priority and must be
available at all times to support replication between systems.
Video applications are guaranteed 100 kbps of bandwidth, but can only operate between
the hours of 9 a.m. to 5 p.m. on weekdays.
Voice traffic is guaranteed less than 150 ms delay in each direction, but that QoS guarantee
is limited to the hours of 9 a.m. to 5 p.m. on weekdays because there are no interoffice calls
during nonbusiness hours. Toll calls are completely restricted to avoid personal long
distance calls.
Step 1:
Identify Traffic and its Requirements
Network audit
Identify traffic on the
network
Business audit
Determine how each
type of traffic is
important for
business
Service levels required
Determine required
response time
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.06-36
The first step in implementing a QoS policy is identifying the traffic on the network and
determining the QoS requirements for the traffic.
Determine what users perceive the QoS problems to be. Measure the traffic on the network
during congested periods. Conduct CPU utilization assessment on each of their network devices
during busy periods to determine where problems might be occurring.
Determine the business model and business goals and obtain a list of business requirements.
This will help you define the number of classes of traffic and determine the business
requirements for each.
Define the service levels required by the different classes of traffic in terms of response time
and availability. What is the impact on business if a transaction is delayed by two or three
seconds? Can file transfers wait until the network is quiescent?
6-22 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Step 2:
Divide the Traffic into Service Classes
IPTX v2.06-37
Once the majority of network traffic has been identified and measured, use the business
requirements to define classes of traffic.
Voice traffic, because of its stringent QoS requirements, will almost always exist in a class by
itself. And Cisco has developed specific QoS mechanisms, such as LLQ, that ensure that voice
always receives priority treatment over all other traffic.
Once the applications with the most critical requirements have been defined, the remaining
traffic classes are defined using the business requirements.
Step 3:
Define Policies for Each Service Class
Set minimum
bandwidth guarantee
Set maximum
bandwidth limits
Assign priorities to
each class
Manage congestion
IPTX v2.06-38
Finally, define a QoS policy for each class of service. Defining a QoS policy involves:
Setting a minimum bandwidth guarantee
Setting a maximum bandwidth limit
Assigning priorities to each class
Using QoS technologies, such as advanced queuing, to manage congestion
6-24 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.06-39
Until recently, the conventional wisdom has been that QoS was not an issue in an enterprise
campus network where bandwidth is plentiful. As applications such as IP telephony and videoconferencing and mission-critical data applications have been implemented in the campus, it
has become evident that buffer management, not just bandwidth, is an issue that must be
addressed. QoS functions are required to manage bandwidth and buffers to minimize loss,
delay, and delay variation.
In campus LANs, serialization delay is not a significant concern. The amount of time required
for LAN interfaces to serialize the bits of packets onto the physical media is negligible; it is not
significant enough to affect delay-sensitive applications. In addition, propagation delay is of
little concern in LANs because by their very nature, LANs are not geographically dispersed.
The type of delay that is present in LANs is variation in delay, or jitter. This can adversely
affect voice and video quality by introducing packet loss through jitter buffer overruns and
underruns.
An additional contributor to packet loss in campus networks is transmit (Tx) buffer congestion.
Tx buffer congestion can happen if a rate change occurs or if many interfaces are aggregated
into a single uplink, resulting in an oversubscription of the uplink s capacity to buffer packets.
The bits of a traffic flow that run through a high-speed campus network serialize into and out of
switches at different rates depending on the link speed of the physical interfaces they are
traversing. When traffic serializes into a campus switch at gigabit speeds and is switched to a
100-Mb interface, the switch must have buffering capabilities in order to hold, or queue, the
bits while it waits to transmit them. When a Tx buffer fills, ingress interfaces are not able to
place new traffic into the Tx buffer of the target interface. When the switch cannot place a
packet into the transmit queue because of Tx buffer congestion or exhaustion, packet drops will
occur.
Using multiple queues on the transmit interfaces minimizes the potential for dropped or delayed
traffic caused by Tx buffer congestion. By separating voice, video, and mission-critical data
(which are all sensitive to loss, delay, and delay variation) into their own queues, you can
prevent flows from being dropped at the ingress interface even when Tx buffer congestion is
experienced. You can also minimize delayed transmission owing to non-QoS-sensitive traffic
congestion by servicing the QoS-sensitive queues in a priority fashion.
6-26 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Summary
Summary
Quality of Service (QoS) is the ability of the
network to provide better or special service to
users/applications.
Converged networks create new requirements for
managing network traffic.
Converged networks suffer from different quality
issues including, lack of adequate bandwidth,
end-to-end and variable delay, and lost packets.
Many technologies exist today which can
overcome the problems presented by lack of
bandwidth, delay, variable delay, and packet loss.
IPTX v2.06-40
Summary (Cont.)
Voice, video, and data have very different quality of
service requirements to run effectively on a
network
A QoS Policy is a network-wide definition of the
specific levels of quality of service assigned to
classes of network traffic
Building Quality of Service requires three steps:
identify requirements, classify network traffic, and
define network-wide policies for quality
IPTX v2.06-41
6-28 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Lesson 2
Objectives
Upon completing this lesson, you will be able to describe the DiffServ model and explain how
it can be used to implement QoS in a network. This includes being able to meet these
objectives:
Explain the purpose and key features of the DiffServ model
Describe the basic format and explain the purpose of the DSCP field in the IP header
Define and explain the different per-hop behaviors that are used in DSCP
Explain the interoperability between DSCP-based and IP-precedence-based devices in a
network
Describe data link layer to network layer interoperability between QoS markers
This topic explains the purpose and function of the DiffServ model.
IPTX v2.06-3
The DiffServ architecture is based on a simple model in which traffic entering a network is
classified and possibly conditioned at the boundaries of the network. The class of traffic is then
identified with either a DSCP or bit marking in the IP header.
DSCP values are used to mark packets and to select a per-hop behavior. Within the core of the
network, packets are forwarded according to the per-hop behavior associated with the DSCP.
The per-hop behavior is defined as an externally observable forwarding behavior applied at a
DiffServ-compliant node to a collection of packets with the same DSCP value.
One of the primary principles of the DiffServ model is that packets should be marked as close
to the edge of the network as possible. It is often a difficult and time-consuming task to
understand to which class of traffic a given data packet belongs, so you want to classify the
data as few times as possible. By marking the traffic at the network edge, core network devices
and other devices along the forwarding path are able to quickly determine the proper class of
service (CoS) to apply to a given traffic flow.
The primary advantage of the DiffServ model is scalability.
6-30 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.06-4
DiffServ is used for mission-critical applications and for providing end-to-end QoS. Typically,
DiffServ is appropriate for aggregate flow because it performs a relatively coarse level of
traffic classification.
The DiffServ model describes services and allows for many user-defined services to be enabled
in a DiffServ-enabled network.
Services are defined as QoS requirements and guarantees that are provided to a collection of
packets that have the same DSCP value. Services are provided to classes. A class can be
identified as a single application, as multiple applications with like service needs, or as being
based on the source or destination IP addresses in a packet.
Provisioning is used to allocate resources to defined traffic classes. An example of provisioning
is the set of methods used to set up the network configurations on devices that correctly enables
the devices to provide the correct set of capabilities for a particular class of traffic.
The idea is for the network to recognize a class without having to receive any request from
applications. This allows the QoS mechanisms to be applied to applications that do not have the
Resources Reservation Protocol (RSVP) functionality, which is the case with 99 percent of
applications that use IP.
The introduction of DSCPs replaces IP precedence, a 3-bit field in the ToS byte of the IP
header that was originally used to classify and prioritize types of traffic, but maintains
interoperability with non-DiffServ-compliant devices (those that still use IP precedence).
Because of this backward compatibility, DiffServ can be gradually deployed in large networks.
DSCP Encoding
This topic describes the basic format of and explains the purpose of the DSCP field in the IP
header.
DSCP Encoding
IPTX v2.06-5
The DiffServ model uses the DiffServ field in the IP header to mark packets according to their
classification into behavior aggregates (BAs). The DiffServ field occupies the same 8 bits of
the IP header that were previously used for the CoS byte.
There are three Internet Engineering Task Force (IETF) standards that describe the purpose of
those 8 bits:
RFC 791 includes specification of the CoS field in which the high-order 3 bits are used for
IP precedence. The other bits are used for delay, throughput, reliability, and cost.
RFC 1812 modifies the meaning of the CoS field by removing any meaning from the 5
low-order bits (those bits should all be 0). This gained widespread use and became known
as the original IP precedence.
RFC 2474 replaces the CoS field with the DiffServ field where the 6 high-order bits are
used for the DSCP. The remaining 2 bits are used for explicit congestion notification.
Each DSCP value identifies a BA. Each BA is assigned a per-hop behavior (PHB). Each PHB
is implemented using the appropriate QoS mechanism or set of QoS mechanisms.
6-32 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Per-Hop Behaviors
This topic defines and explains the different PHBs used in DSCP.
Per-Hop Behavior
IPTX v2.06-7
6-34 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.06-8
As the figure illustrates, three DSCP values are assigned to each of the four Assured
Forwarding classes.
Assured Forwarding Class
Assured Forwarding Class
Drop Probability
6-36 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
DSCP Value
IPTX v2.06-10
This topic explains the interoperability between DSCP-based and IP precedence based devices
in a network.
IPTX v2.06-11
The meaning of the 8 bits in the DiffServ field of the IP packet has changed over time to meet
the expanding requirements of IP networks.
Originally, the field was referred to as the CoS field and the first 3 bits of the field (bits 7-5)
defined a packets IP precedence value. A packet could be assigned one of six priorities based
on the value of the IP precedence value (8 total values minus 2 reserved values). IP precedence
5 (101) was the highest priority that could be assigned (RFC 791).
RFC 2474 replaced the CoS field with the DiffServ field in which a range of eight values
(Class-Selector PHB) is used for backward compatibility with IP precedence. There is no
compatibility with other bits used by the CoS field.
The Class-Selector PHB was defined to provide backward compatibility for DSCP with CoSbased IP precedence. RFC 1812 prioritizes packets according to the precedence value. The
PHB is defined as the probability of timely forwarding. Packets with higher IP precedence
should (on average) be forwarded in less time than packets with lower IP precedence.
The last three bits of the DSCP (2-4) set to 0 identify a Class-Selector PHB.
6-38 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
This topic describes the different QoS markers that can be used for interoperability between
data link layer and network layer QoS.
IPTX v2.06-12
IP headers are preserved end-to-end when IP packets are transported across a network; data link
layer headers are not. This means that the IP layer is the most logical place to mark packets for
end-to-end QoS. However, there are edge devices that can mark frames only at the data link
layer, and there are many other network devices that operate only at the data link layer. To
provide true end-to-end QoS, the ability to map QoS marking between the data link layer and
the network layer is essential.
Enterprise networks typically consist of a number of remote sites connected to the headquarters
campus via a WAN. Remote sites typically consist of a switched LAN, and the headquarters
campus network is both routed and switched. Providing end-to-end QoS through such an
environment requires that CoS markings that are set at the LAN edge be mapped into QoS
markings (such as IP precedence or DSCP) for transit through campus or WAN routers.
Campus and WAN routers can also map the QoS markings to new data link headers for transit
across the LAN. In this way, QoS can be preserved and uniformly applied across the enterprise.
Service providers offering IP services have a requirement to provide robust QoS solutions to
their customers. The ability to map network layer QoS to link layer CoS enables these
providers to offer a complete end-to-end QoS solution that does not depend on any specific link
layer technology.
Summary
Summary
The Differentiated Services model describes services
associated with traffic classes.
Complex traffic classification and conditioning is performed
at network edge resulting in a per-packet Differentiated
Services Code Point (DSCP).
A per-hop behavior is an externally observable forwarding
behavior applied at a DS-compliant node to a DS behavior
aggregate.
The Expedited Forwarding (EF) PHB guarantees and polices
bandwidth while ensuring a minimum departure rate.
The Assured Forwarding (AF) PHB guarantees bandwidth
while providing four classes each having three DSCP values.
The DSCP is backward compatible with IP Precedence
(Class Selector Code point).
2005 Cisco Systems, Inc. All rights reserved.
6-40 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.06-13
Lesson 3
Understanding IP QoS
Mechanisms
Overview
IP QoS mechanisms are used to implement a coordinated QoS policy in devices throughout the
network. The moment an IP packet enters the network, it is classified and usually marked with
its class identification. From that point on, the packet is treated by a variety of IP QoS
mechanisms according to the packets classification. Depending upon the mechanisms it
encounters, the packet could be expedited, delayed, compressed, fragmented, or even dropped.
Objectives
Upon completing this lesson, you will be able to correctly match QoS actions to mechanisms
for implementing QoS and identify where in a network the different QoS mechanisms are
commonly used. This includes being able to meet these objectives:
List the key mechanisms that are used to implement QoS in an IP network
Define classification and identify where classification is commonly implemented in a
network
Define marking and identify where marking is commonly implemented in a network
Explain the concept of trust boundaries and how they are used with classification and
marking
Define congestion management and identify where congestion management is commonly
implemented in a network
Define traffic shaping and identify where shaping is commonly implemented in a network
Explain the functions of compression and identify where compression is commonly
implemented in the network
Explain the functions of link fragmentation and interleaving (LFI) and identify where LFI
is commonly implemented in the network
QoS Mechanisms
This topic lists the key mechanisms use to implement QoS in an IP network.
QoS Mechanisms
Classification: Each class-oriented QoS mechanism has to
support some type of classification
Marking: Used to mark packets based on classification
and/or metering
Congestion Management: Each interface must have a
queuing mechanism to prioritize transmission of packets
Traffic Shaping: Used to enforce a rate limit based on the
metering by delaying excess traffic
Compression: Reduces serialization delay and bandwidth
required to transmit data by reducing the size of packet
headers or payloads
Link Efficiency: Used to improve bandwidth efficiency
through compression and link fragmentation and interleaving
2004 Cisco Systems, Inc. All rights reserved.
IPTX v2.06-3
This figure shows the main categories of QoS tools used in IPTX implementations and
describes how they contribute to QoS.
Classification and marking are the identifying and splitting of traffic into different classes and
the marking of traffic according to behavior and business policies.
Congestion management is the prioritization, protection, and isolation of traffic based on
markings.
Traffic conditioning mechanisms shape traffic to control bursts by queuing traffic.
One type of link efficiency technology is packet header compression, which improves the
bandwidth efficiency of a link. Another technology is LFI, which can decrease the jitter of
voice transmission by reducing voice packet delay.
6-42 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Classification
This topic defines classification and identifies where classification is commonly implemented
in a network.
Classification
IPTX v2.06-6
Classification is the identifying and splitting of traffic into different classes. In a QoS-enabled
network, all traffic is classified at the input interface of every QoS-aware device. Packet
classification can be recognized based on many factors, including:
DSCP
IP precedence
Source address
Destination address
The concept of trust is key for deploying QoS. Once an end device (such as a workstation or an
IP Phone) marks a packet with CoS or DSCP, a switch or router has the option of accepting or
not accepting values from the end device. If the switch or router chooses to accept the values,
the switch or router trusts the end device. If the switch or router trusts the end device, it does
not need to do any reclassification of packets coming from that interface. If the switch or router
does not trust the interface, then it must perform a reclassification to determine the appropriate
QoS value for packets coming from that interface. Switches and routers are generally set to not
trust end devices and must specifically be configured to trust packets coming from an interface.
Marking
This topic defines marking and identifies where marking is commonly implemented in a
network.
Marking
IPTX v2.06-9
Marking, which is also known as coloring, involves marking each packet as a member of a
network class so that devices throughout the rest of the network can quickly recognize the
packets class. Marking is performed as close to the network edge as possible and is typically
done using the Modular QoS command-line interface (CLI) (MQC).
QoS mechanisms set bits in the DSCP or IP precedence fields of each IP packet according to
the class that the packet is in. Other fields can also be marked to aid in the identification of a
packets class, such as CoS or a Frame Relay discard eligible (DE) bit.
Other QoS mechanisms use these bits to determine how to treat the packets when they arrive. If
they are marked as high-priority voice packets, the packets generally are never dropped by
congestion avoidance mechanisms and are given immediate preference by congestion
management queuing mechanisms. On the other hand, if the packets are marked as low-priority
file transfer packets, they are dropped when congestion is occurring and are generally moved to
the end of the congestion management queues.
6-44 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Trust Boundaries
This topic describes the concept of trust boundaries and how they are used with classification
and marking.
Trust Boundaries
Classify Where?
Ciscos QoS model assumes that the CoS carried in a frame may or
may not be trusted by the network device
For scalability, classification should be done as close to the edge as
possible
End hosts can mostly not be trusted to tag a packet s priority correctly
The outermost trusted devices represent the trust boundary
1
1 and 2
2 are optimal, 3
3 is acceptable (if access switchcannot
perform classification)
2004 Cisco Systems, Inc. All rights reserved.
IPTX v2.06-10
The concept of trust is important and is integral to deploying QoS. After the end devices have
set CoS or TOS values, the switch has the option of trusting them. If the switch trusts the
values, it does not need to reclassify; if it does not trust the values, then it must perform
reclassification for the appropriate QoS.
The notion of trusting or not trusting forms the basis for the trust boundary. Ideally,
classification should be done as close to the source as possible. If the end device is capable of
performing this function, the trust boundary for the network is at the end device. If the device is
not capable of performing this function or if the wiring closet switch does not trust the
classification done by the end device, the trust boundary might shift. How this shift happens
depends on the capabilities of the switch in the wiring closet. If the switch can reclassify the
packets, the trust boundary is in the wiring closet. If the switch cannot perform this function,
the task falls to other devices in the network, going toward the backbone. In this case, one good
rule is to perform reclassification at the distribution layer. This means that the trust boundary
has shifted to the distribution layer. It is likely that there is a high-end switch in the distribution
layer with features to support this function. If possible, try to avoid performing this function in
the core of the network.
Trust Boundaries
Mark Where?
IPTX v2.06-11
Classification should take place at the network edge, typically in the wiring closet or within
endpoints (servers, hosts, video endpoints, or IP telephony devices) themselves.
For example, consider the campus network containing IP telephony and host endpoints. Frames
can be marked as important by using link layer CoS settings or the IP precedence and DSCP
bits in the CoS and DiffServ field in the IPv4 header. Cisco IP Phones can mark voice packets
as high priority using CoS as well as ToS. By default, the IP Phone sends 802.1p tagged
packets with the CoS and ToS set to a value of 5 for its voice packets. Because most PCs do not
have an 802.1q-capable network interface card (NIC), they send packets untagged. This means
that the frames do not have an 802.1p field. Also, unless the applications that are running on the
PC send packets with a specific CoS value, this field is 0.
Note
A special case exists in which the TCP/IP stack in the PC has been modified to send all
packets with a ToS value other than 0. Typically this does not happen, and the ToS value is
zero.
Even if the PC is sending tagged frames with a specific CoS value, Cisco IP Phones can zero
out this value before sending the frames to the switch. This is the default behavior. Voice
frames coming from the IP Phone have a CoS of 5, and data frames coming from the PC have a
CoS of 0.
If the end device is not a trusted device, the reclassification function (setting/zeroing the bits in
the CoS and ToS fields) can be performed by the access layer switch if that device is capable of
doing so. If the device is not capable, then the reclassification task falls to the distribution layer
device. If reclassification cannot be performed at one of these two layers, a hardware upgrade
or a Cisco IOS software upgrade or both may be necessary.
6-46 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
802.1Q trunking between the switch and IP phone for multiple VLAN support
(separation of voice/data traffic) is preferred
The 802.1Q header contains the VLAN information and the CoS 3-bit field,
which determines the priority of the packet
For most Cisco IP phone configurations, traffic sent from the IPphone to the
switch is trusted to ensure that voice traffic is properly prioritized over other
types of traffic in the network
The trusted boundary feature usesCDP to detect an IP phone and otherwise
disables the trusted setting on the switch port to prevent misuse of a highpriority queue
2004 Cisco Systems, Inc. All rights reserved.
IPTX v2.06-13
In a typical network, you connect a Cisco IP Phone to a switch port as shown in the figure.
Traffic sent from the telephone to the switch is typically marked with a tag that uses the 802.1q
header. The header contains the VLAN information and the CoS 3-bit field, which determines
the priority of the packet. For most Cisco IP Phone configurations, the traffic sent from the
telephone to the switch is trusted to ensure that voice traffic is properly prioritized over other
types of traffic in the network.
By using the mls qos trust device cisco-phone and the mls qos trust cos interface
configuration commands, you can configure the switch port to which the telephone is
connected to trust the CoS labels of all traffic received on that port.
Congestion Management
This topic defines congestion management and identifies where congestion management is
commonly implemented in a network.
Congestion Management
IPTX v2.06-14
Congestion management mechanisms (queuing algorithms) use the marking on each packet to
determine which queue to place packets in. Different queues are given different treatment by
the queuing algorithm based on the class of packets in the queue. Generally, queues with
higher-priority packets receive preferential treatment.
All output interfaces in a QoS-enabled network use some kind of congestion management
(queuing) mechanism to manage the outflow of traffic. Each queuing algorithm is designed to
solve a specific network traffic problem and has a particular effect on network performance.
The Cisco IOS software features for congestion management, or queuing, include:
First-in, first-out (FIFO)
PQ
CQ
Weighted fair queuing (WFQ)
CBWFQ
LLQ
LLQ is now the preferred method. It is a hybrid (of PQ and CBWFQ) queuing method that was
developed specifically to meet the requirements of real-time traffic, such as voice.
6-48 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Traffic Shaping
This topic defines traffic shaping and identifies where traffic shaping is commonly
implemented in a network.
Shaping
IPTX v2.06-17
Shaping helps smooth out speed mismatches in the network and limits transmission rates.
Shaping mechanisms are used on output interfaces. They are typically used to limit the flow
from a higher-speed link to a lower-speed link to ensure that the lower-speed link does not
become overrun with traffic. Shaping can also be used to manage the flow of traffic at a point
in the network where multiple flows are aggregated.
Ciscos QoS software solutions include two traffic-shaping tools to manage traffic and
congestion on the network: generic traffic shaping and Frame Relay traffic shaping (FRTS).
Compression
This topic explains the functions of compression and identifies where compression is
commonly implemented in the network.
Compression
IPTX v2.06-21
Cisco IOS QoS software offers link-efficiency mechanisms that work in conjunction with
queuing and traffic shaping to manage existing bandwidth more efficiently and predictably.
One of these is compressed RTP (cRTP).
RTP is a host-to-host protocol used for carrying converged traffic, including packetized audio
and video, over an IP network. RTP provides end-to-end network transport functions that are
intended for applications that are transmitting real-time requirements, such as audio, video,
simulation data multicast, or unicast network services.
A voice packet carrying a 20-byte voice payload, for example, typically carries a 20-byte IP
header, an 8-byte UDP header, and a 12-byte RTP header. As shown in the figure, by using
cRTP, the three headers of a combined 40 bytes are compressed down to 2 or 4 bytes,
depending on whether the cyclic redundancy check (CRC) is transmitted. This compression can
dramatically improve the performance of a link.
Typically, compression is used on WAN links between sites to improve bandwidth efficiency.
6-50 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
This topic explains the functions of LFI and identifies where it is commonly implemented in
the network.
IPTX v2.06-23
Interactive traffic, such as Telnet and VoIP, is susceptible to increased latency and jitter when
the network processes large packets, such as LAN-to-LAN FTP Telnet transfers traversing a
WAN link. This susceptibility increases as the traffic is queued on slower links.
LFI can reduce delay and jitter on slower-speed links by breaking up large datagrams and
interleaving low-delay traffic packets with the resulting smaller packets.
Typically, LFI is used on WAN links between sites to ensure minimal delay for voice and video
traffic.
Summary
Summary
Different mechanisms can be used to implement QoS in a
network: classification, marking, congestion management,
shaping, compression, and link efficiency.
First step is always to identify classes of traffic so that the
appropriate QoS treatment can be applied to different traffic
types.
Traffic conditioners such as shapers are used to limit the
maximum rate of traffic sent or received on an interface.
Compression is a technique that is used to reduce the
amount of bandwidth required to transmit data by
compressing packet headers or payloads.
Bandwidth efficiency can be improved through link efficiency
mechanisms such as compression and fragmentation and
interleaving.
2004 Cisco Systems, Inc. All rights reserved.
6-52 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.06-24
Lesson 4
Objectives
Upon completing this lesson, you will be able to describe MQC and its associated components.
This includes being able to meet these objectives:
Explain at a high level, the MQC method of configuring QoS
Differentiate between class maps, policy maps, and service policies
Describe how a class map is used to define a class of traffic
Describe the Cisco IOS MQC commands that are required to configure and monitor a class
map
Describe how a policy map is used to assign a QoS policy to a class of traffic
Describe the Cisco IOS MQC commands that are required to configure and monitor a
policy map
Explain how a service policy is assigned to an interface
Describe the MQC commands that are used to attach a service policy to an interface
This topic describes the MQC method for implementing QoS on a network.
IPTX v2.06-5
MQC was introduced to allow any supported classification to be used with any QoS
mechanism.
The separation of classification from the QoS mechanism allows new Cisco IOS versions to
introduce new QoS mechanisms and reuse all available classification options. And old QoS
mechanisms can benefit from new classification options.
Another important benefit of MQC is the reusability of configuration. MQC allows the same
QoS policy to be applied to multiple interfaces. MQC, therefore, is a consolidation of all the
QoS mechanisms that have so far only been available as stand-alone mechanisms.
6-54 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
This topic describes the three steps involved in implementing a QoS policy using MQC.
Define Classes
of Traffic
What traffic do
we care about?
Each class of
traffic is defined
using a Class Map
Apply a Service
Policy
Where will this
policy be
implemented?
Attaches a Service
Policy configured
with a policy map
to an interface
IPTX v2.06-8
Class Maps
Class Maps
What traffic do we care about?
Each class is identified using a Class Map
A traffic class contains three major elements:
A case-sensitive name
A series of match commands
If more than one match command exists in the traffic class, an
instruction on how to evaluate these match commands
Class maps can operate in two modes:
Match All: all conditions have to succeed
Match Any: at least one condition must succeed
The default mode is Match all
Multiple traffic classes can be configured as a single traffic class
(nested)
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.06-9
Class maps are used to create classification templates that are later used in policy maps where
QoS mechanisms are bound to classes.
Routers can be configured with a large number of class maps (currently limited to 256). Each
traffic policy, however, may support a limited number of classes, for example, CBWFQ and
class-based LLQ are limited to 64 classes.
A class map is created using the class-map global configuration command. Class maps are
identified by case-sensitive names. Each class map contains one or more conditions that
determine if the packet belongs to the class.
There are two ways of processing conditions when there is more than one condition in a class
map:
Match all
Match any
6-56 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.06-10
The figure illustrates the full process of determining if a packet belongs to a class (match) or
not (no match).
The process goes through the list of conditions:
A match result is returned if one of the conditions is met and the match-any strategy is
used.
A match result is returned if all conditions are met and the match-all strategy is used.
Otherwise, a no match result is returned.
This topic explains the commands necessary for configuring and monitoring class maps.
-- --
- -
IPTX v2.06-11
Use the class-map global configuration command to create a class map and enter the class map
configuration mode. A class map is identified by a case-sensitive name; therefore, all
subsequent references to the class map must use exactly the same name.
At least one match command should be used within the class-map configuration mode (match
none is the default).
The description command is used for documenting a comment about the class map.
If a packet arrives on a router with traffic class called cisco1 configured on the interface, the
packet is evaluated to determine if it matches the IP protocol, QoS group 4, and access group
101. If all three of these match criteria are met, the packet matches traffic class cisco1.
6-58 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
-- --
One class map can use another class map for classification
Nested class maps allow generic template class maps to be
used in other class maps
IPTX v2.06-12
The match commands are used to specify various criteria for classifying packets. Packets are
checked to determine whether they match the criteria specified in the match commands; if a
packet matches the specified criteria, that packet is considered a member of the class and is
forwarded according to the QoS specifications set in the traffic policy. Packets that fail to meet
any of the matching criteria are classified as members of the default traffic class. MQC does not
necessarily require that users associate a single traffic class with one traffic policy. Multiple
traffic classes can be associated with a single traffic policy using the matchany command.
Match not inverts the condition specified. It specifies a match criterion value that prevents
packets from being classified as members of a specified traffic class. All other values of that
particular match criterion belong to the class.
MQC allows multiple traffic classes (nested traffic classes, which are also called nested class
maps) to be configured as a single traffic class. This nesting can be achieved with the use of the
match class-map command. The only method of combining match-any and match-all
characteristics within a single traffic class is with the match class-map command.
In traffic class cisco2, the match criteria are evaluated consecutively until a successful match
criterion is located. The packet is first evaluated to determine whether IP protocol can be used
as a match criterion. If IP protocol is not a successful match criterion, then QoS group 4 is
evaluated as a match criterion. If QoS group 4 is not a successful match criterion, then accessgroup 101 is evaluated as a match criterion. Each matching criterion is evaluated to see if the
packet matches that criterion. Once a successful match occurs, the packet is classified as a
member of traffic class cisco2. If the packet matches none of the specified criteria, the packet is
classified as a member of the traffic class.
both match-any and match-all characteristics in a single traffic class is to use the match classmap command. To combine match-any and match-all characteristics into a single class, a
traffic class created with the match-any instruction must use a class configured with the matchall instruction as a match criterion (through the match class-map command) or vice versa.
The following example shows how to combine the characteristics of two traffic classes, one
with match-any and one with match-all characteristics, into one traffic class with the match
class-map command. The result of traffic class class4 requires a packet to match one of the
following three match criteria to be considered a member of traffic class class4: IP protocol and
QoS group 4, destination MAC address 1.1.1, or access group 2.
In this example, only the traffic class called class4 is used with the traffic policy called policy1.
-- --
-
-- --
-- --
---
--
-- --
- ---
6-60 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
- -- --
Displays all class maps and their matching criteria
- --
-- --
--
-- --
-- --
IPTX v2.06-13
The show class-map command lists all class maps with their match statements.
The show class-map command with a name of a class map displays the configuration of the
selected class map.
The example in the figure shows three class maps:
The first, class-3, matches any packet to access-group 103.
The second, class-2, matches IP packets.
The third matches any input from interface Ethernet 1/0.
Policy Maps
This topic describes how to implement QoS policies using policy maps.
Policy Maps
What will be done to this traffic?
Defines a traffic policy which configures the QoS features
associated with a traffic class previously identified using a
class map
A traffic policy contains three major elements:
A case-sensitive name
A traffic class
The QoS policy associated with that traffic class
Up to 256 traffic classes can be associated with a single
traffic policy
Multiple policy maps can be nested to influence the
sequence of QoS actions
IPTX v2.06-14
The policy-map command is used to create a traffic policy. The purpose of a traffic policy is to
configure the QoS features that should be associated with the traffic that has been classified in a
user-specified traffic class or classes. A traffic policy contains three elements: a case-sensitive
name, a traffic class (specified with the class command), and the QoS policies.
The name of a traffic policy is specified in the policy-map CLI (for example, issuing the
policy-map class1 command creates a traffic policy named class1). Once the policy-map CLI
is issued, the user is placed into policy map configuration mode. The name of a traffic class can
then be entered, and the user enters policy-map class configuration mode. Here is where the
user enters QoS features to apply to the traffic that matches this class.
MQC does not necessarily require that users associate only one traffic class to a single traffic
policy. When packets match to more than one match criterion, multiple traffic classes can be
associated with a single traffic policy.
Note
A packet can match only one traffic class within a traffic policy. If a packet matches more
than one traffic class in the traffic policy, the first traffic class defined in the policy will be
used.
6-62 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
This topic describes the commands necessary to configure and monitor policy maps.
Enter policy-map configuration mode
Policy maps are identified by a case-sensitive name
-- -- --
Enter the per-class policy configuration mode by using the name of a
previously configured class-map
Use the name class-default to configure the policy for the default
class
-- --
Optionally you can define a new class-map by entering the condition
after the name of the new class map
Class map will use the match-any strategy
IPTX v2.06-15
Service policies are configured using the policy-map command. Up to 256 classes can be used
within one policy map using the class command with the name of a preconfigured class map.
A nonexistent class can also be used within the policy-map configuration mode if the match
condition is specified after the name of the class. The running configuration will reflect such a
configuration by using the match any strategy and inserting a full class-map configuration.
The following table shows starting and resulting configuration modes for the class-map,
policy-map and class commands:
Configuration Modes
Starting configuration mode
Command
Configuration mode
--
--
All traffic that is not classified by any of the class-maps used within the policy map is part of
the default class class-default. This class has no QoS guarantees by default. When used on
output, the default class can use one FIFO queue or flow-based WFQ. The default class is part
of every policy map even if not configured.
- -
It is recommended to use descriptions in large and complex configurations
The description has no operational meaning
-
Per-class service policies are configured within the per-class policy-map
configuration mode
MQC Supports the following QoS mechanisms:
Class-based Weighted Fair Queuing (CB-WFQ)
Low-latency Queuing (LLQ)
Class-based Policing (CB-Policing)
Class-based Shaping (CB-Shaping)
Class-based Marking (CB-Marking)
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.06-16
Policy maps, like class maps, should use descriptions in large QoS implementations in which a
large number of different policy maps are used.
Renaming a policy map normally requires the renaming of all the references to the policy map.
However, using the rename command simplifies the renaming process by automatically
renaming all references.
-
-- -
-- -
-- - --
6-64 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
--- -
--- -
Class Test1 has two match conditions evaluated in the match-all strategy. Classes Test2 and
Test3 use the match-any strategy.
IPTX v2.06-17
6-66 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
--
-
-
-
-
--
--
Example policy
Shape all traffic on FastEthernetto 2 Mbps
Out of the 2 Mbps, guarantee 1 Mbps to HTTP traffic
IPTX v2.06-18
In the example diagram, a child policy map QueueAll is created that guarantees bandwidth of 1
Mbps to HTTP traffic. The QueueAll policy map is then nested within a parent policy map
named ShapeAll. Finally, the parent policy map ShapeAll is applied to the FastEthernet
interface. Traffic out of the FastEthernet interface will first be shaped to 2 Mbps, then HTTP
traffic will be guaranteed 1 Mbps of the 2 Mbps of shaped traffic.
Step 2
Create a parent or top-level policy that applies class-based shaping. Apply the child
policy as a command under the parent policy because the admission control for the
child class is done based on the shaping rate for the parent class.
-- --
-
-
Step 3
-
Displays the configuration of all classes for a specified service
policy map or all classes for all existing policy maps
-
-
-- -
- - -
-- -
- - -
-- -
- - -
IPTX v2.06-19
The show policy-map command can be used to verify the configuration of a policy map.
In the output shown in the figure, three classes are defined called Test1, Test2, and Test3. Test1
is allocated a bandwidth of 100 kbps. Test2 is allocated a bandwidth of 200 kbps. Test3 is
allocated a bandwidth of 300 kbps.
6-68 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
-
- -
-
-
-- -
- - --
--
-
- - -
--
- -
-- --
- -
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.06-20
The show policy-map command also displays live information if the interface keyword is
used. The sample output shows the parameters and statistics of the policy map attached to
outbound traffic on interface FastEthernet0/0.
This command is useful for determining if traffic is exceeding its allocation. In the example in
the figure, both total drops and no-buffer drops are 0, indicating that traffic matching Test1 is
not exceeding the configured bandwidth of 100 kbps.
Service Policy
This topic describes how to attach a QoS policy to an interface using service policies.
Service Policy
Where will this policy be implemented?
IPTX v2.06-21
The last configuration step when configuring QoS mechanisms using MQC is to attach a policy
map to the inbound or outbound packets, using the service-policy command.
Using the service-policy command, it is possible to assign a single policy map to multiple
interfaces or to assign multiple policy maps to a single interface (a maximum of one in each
direction, inbound and outbound).
A service policy can be applied for inbound or outbound packets.
6-70 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
--
-- --
IPTX v2.06-22
6-72 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Summary
Summary
Modular QoS (MQC) is a modular approach to
designing and implementing an overall QoS policy.
Applying an overall QoS policy involves three steps:
defining class maps to identify classes of traffic,
defining a QoS policy maps, and assigning the policy
maps to interfaces.
Each class of traffic is defined in a class map module.
A policy map module defines a traffic policy which
configures the QoS features associated with a traffic
class previously identified using a class map
A service policy attaches a traffic policy configured
with a policy map to an interface.
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.06-23
6-74 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Lesson 5
Implementing AutoQoS
Overview
Objectives
Upon completing this lesson, you will be able to correctly identify capabilities provided by
AutoQoS and to use AutoQoS to successfully configure QoS on a network that has QoS issues.
This includes being able to meet these objectives:
Explain how AutoQoS is used to implement QoS policy
Describe the router environments in which AutoQoS can be used
Describe the switch environments in which AutoQoS can be used
Describe the prerequisites for configuring AutoQoS
Configure AutoQoS on a network using CLI
Use Cisco IOS commands to examine and monitor a network configuration after AutoQoS
has been enabled
Identify several of the QoS technologies that were automatically implemented on the
network via AutoQoS
AutoQoS
AutoQoS
One command per interface to enable and configure QoS
IPTX v2.06-4
AutoQoS enables customer networks to deploy QoS features for converged IP telephony and
data networks much faster and more efficiently. It simplifies and automates the MQC definition
of traffic classes and the creation and configuration of traffic policies (AutoQoS generates
traffic classes and policy maps using CLI templates). Therefore, when AutoQoS is configured
at the interface or a permanent virtual circuit (PVC), the traffic receives the required QoS
treatment automatically. In-depth knowledge of the underlying technologies, service policies,
link efficiency mechanisms, and Cisco QoS best practice recommendations for voice
requirements is not required to configure AutoQoS.
AutoQoS can be extremely beneficial for the following scenarios:
Small- to medium-sized businesses that need to deploy IP telephony quickly, but lack the
experience and staffing to plan and deploy IP QoS services
Large customer enterprises that need to deploy Cisco IP telephony on a large scale while
reducing the costs, complexity, and time frame for deployment and ensuring that the
appropriate QoS for voice applications is being set in a consistent fashion
International enterprises or service providers requiring QoS for VoIP where little expertise
exists in different regions of the world and where provisioning QoS remotely and across
different time zones is difficult
Service providers requiring a template-driven approach to delivering managed services and
QoS for voice traffic to large numbers of customer premise devices
6-76 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
AutoQoS (Cont.)
Manual QoS
--
--
-
--
--
2005 Cisco Systems, Inc. All rights reserved.
AutoQoS
--
-
IPTX v2.06-5
AutoQoS automatically creates the QoS-specific features required for supporting the
underlying transport mechanism and link speed of an interface or PVC type. For example,
FRTS would be automatically configured and enabled by AutoQoS for Frame Relay links. LFI
and cRTP would be automatically configured via the AutoQoS template for slow link speeds
(less than 768 kbps). Therefore, it is very important that the bandwidth statement be properly
set on the interface prior to configuring AutoQoS because the resulting configuration will vary
based on this configurable parameter.
Using AutoQoS, VoIP traffic is automatically provided with the required QoS template for
voice traffic via the auto qos voip command on an interface or PVC. AutoQoS enables the
required QoS based on Cisco best practice methodologies (the configuration generated by
AutoQoS can be modified if desired).
AutoQoS (Cont.)
Application Classification
Automatically discovers applications
and provides appropriate QoS treatment
Policy Generation
Automatically generates initial and
ongoing QoS policies
Configuration
Provides high level business
knobs, and multi-device / domain
automation for QoS
Monitoring & Reporting
Generates intelligent, automatic
alerts and summary reports
Consistency
Enables automatic, seamless
interoperability among all QoS features and
parameters across a network topology
LAN, MAN, and WAN
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.06-6
AutoQoS simplifies and shortens the QoS deployment cycle. AutoQoS helps in all five major
aspects of successful QoS deployments:
Application classification: AutoQoS leverages intelligent classification on routers,
utilizing Cisco NBAR to provide deep and stateful packet inspection. AutoQoS uses Cisco
Discovery Protocol (CDP) for voice packets, ensuring that the device attached to the LAN
is really an IP phone.
Policy generation: AutoQoS evaluates the network environment and generates an initial
policy. It automatically determines WAN settings for fragmentation, compression,
encapsulation, and Frame Relay-ATM interworking, eliminating the need to understand
QoS theory and design practices in various scenarios. Customers can meet additional and
special requirements by modifying the initial policy as they normally would.
The first release of AutoQoS provides the necessary AutoQoS-VoIP feature to automate
QoS settings for VoIP deployments. This feature automatically generates interface
configurations, policy maps, class maps, and ACLs. AutoQoS-VoIP automatically employs
Cisco NBAR to classify voice traffic and mark it with the appropriate DSCP value.
AutoQoS-VoIP can be instructed to rely on, or trust, the DSCP markings previously
applied to the packets.
Configuration: With one command, AutoQoS configures the port to prioritize voice traffic
without affecting other network traffic while still offering the flexibility to adjust QoS
settings for unique network requirements.
Not only does AutoQoS automatically detect IP Phones and enable QoS settings, but it also
disables the QoS settings when a IP Phone is relocated or moved to prevent malicious
activity.
AutoQoS-generated router and switch configurations are customizable using the standard
Cisco IOS CLI.
6-78 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Monitoring and reporting: AutoQoS provides visibility into the classes of service
deployed via system logging and Simple Network Management Protocol (SNMP) traps,
with notification of abnormal events (for example, VoIP packet drops).
Consistency: AutoQoS enables automatic and seamless interoperability between all of the
QoS features and parameters across the network topology, including LAN, MAN, and
WAN.
This topic identifies the router and switch platforms on which AutoQoS operates.
AutoQoS:
Router Platforms
Cisco 1760, 2600, 3600, 3700
and 7200 Series Routers
User can meet the voice QoS
requirements without
extensive knowledge about:
Underlying technologies
(i.e.: PPP, FR, ATM)
Service policies
Link efficiency
mechanisms
AutoQoS lends itself to
tuning of all generated
parameters & configurations
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.06-7
Initial support for AutoQoS includes the Cisco 2600, 2600-XM, 3600, 3700, and 7200 series
routers. Support for additional platforms will become available.
The AutoQoS VoIP feature is supported only on the following interfaces and PVCs:
Serial interfaces with PPP or High-Level Data Link Control (HDLC)
Frame Relay data-link connection identifiers (DLCIs) (PPP subinterfaces only)
AutoQoS does not support Frame Relay multipoint interfaces.
ATM PVCs
Cisco AutoQoS VoIP is supported on low-speed ATM PVCs on PPP subinterfaces
only (link bandwidth less than 768 kbps).
Cisco AutoQoS VoIP is fully supported on high-speed ATM PVCs (link bandwidth
greater than 768 kbps).
6-80 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
AutoQoS:
Switch Platforms
Cisco Catalyst 6500, 4500,
3550, 3560, 2970 and
2950(EI) Switches
User can meet the voice
QoS requirements without
extensive knowledge about:
Trust boundary
CoS to DSCP mappings
Weighted Round Robin
(WRR) & Priority Queue
(PQ) Scheduling
parameters
Generated parameters and
configurations are user
tunable
2005 Cisco Systems, Inc. All rights reserved.
6500
4500
3750
3550
3560
2970
2950EI
IPTX v2.06-8
Initial support for AutoQoS includes the Cisco Catalyst 6500, 4500, 3550, 3560, 2970, and
2950EI Series switches. Support for additional platforms, including the Cisco Catalyst 4000,
will become available.
The Enhanced Image (EI) is required on the Cisco Catalyst 2950 Series switches.
AutoQoS:
Switch Platforms (Cont.)
Single command at the interface level configures interface
and global QoS
Support for Cisco IP Phone & Cisco Soft Phone
Support for Cisco Soft Phone currently exists only on
the Cat6500
Trust Boundary is disabled when IP Phone is
moved/relocated
Buffer Allocation & Egress Queuing dependent on
interface type (GE/FE)
Supported on Static, dynamic-access, voice VLAN access,
and trunk ports
CDP must be enabled for AutoQoS to function properly
IPTX v2.06-9
To configure the QoS settings and the trusted boundary feature on the IP Phone, you must
enable CDP version 2 or later on the port. If you enable the trusted boundary feature, a syslog
message warns you if CDP is not enabled or if CDP is running version 1.
You need to enable CDP only for the ciscoipphone QoS configuration; CDP does not affect the
other components of the automatic QoS features. When you use the ciscoipphone keyword
with the port-specific automatic QoS feature, a warning displays if the port does not have CDP
enabled.
When executing the port-specific automatic QoS command with the ciscoipphone keyword
without the trust option, the trust-device feature is enabled. The trust-device feature is
dependent on CDP. If CDP is not enabled or not running version 2, a warning message displays
as follows:
- - - - -
- - - - - -
- - - -
- - -
-- -
- - - -
-
-
6-82 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
AutoQoS Prerequisites
This topic describes some of the key prerequisites for using AutoQoS.
Configuring AutoQoS:
Prerequisites for Using AutoQoS
Cisco Express Forwarding (CEF) must be enabled at the
interface or ATM PVC
This feature cannot be configured if a QoS policy
(service policy) is attached to the interface
An interface is classified as low-speed if its bandwidth is less
than or equal to 768 kbps. It is classified as high-speed if its
bandwidth is greater than 768 kbps
The correct bandwidth should be configured on all
interfaces or sub-interfaces using the bandwidth
command
If the interface or sub-interface has a link speed of 768
kbps or lower, an IP address must be configured using
the ip address command
IPTX v2.06-10
In addition to the AutoQoS prerequisites, the following are recommendations and requirements
when configuring AutoQoS. Be aware that these may change with Cisco IOS releases and
should be verified before implementing AutoQoS in your environment.
The AutoQoS VoIP feature is supported only on the following interfaces and PVCs:
Serial interfaces with PPP or HDLC
Frame Relay DLCIs (PPP subinterfaces only)
AutoQoS does not support Frame Relay multipoint interfaces.
ATM PVCs
CLI generated by configuring AutoQoS on an interface or PVC can be tuned manually (via
CLI configuration) if desired.
AutoQoS cannot be configured if a QoS service policy is already configured and attached
to the interface or PVC.
Multilink PPP (MLP) is configured automatically for a serial interface with low-speed link.
The serial interface must have an IP address, which is removed and put on the MLP bundle.
AutoQoS VoIP must also be configured on the other side of the link.
The no auto qos voip command removes AutoQoS. However, if the interface or PVC
AutoQoS-generated QoS configuration is deleted without configuring the no auto qos voip
command, AutoQoS VoIP will not be completely removed from the configuration properly.
AutoQoS SNMP traps are only delivered when an SNMP server is used in conjunction with
AutoQoS.
The SNMP community string AutoQoS should have write permissions.
If the device is reloaded with the saved configuration after configuring AutoQoS and
saving the configuration to NVRAM, some warning messages may be generated by
Remote Monitoring (RMON) threshold commands. These warnings messages may be
ignored. (To avoid further warning messages, save the configuration to NVRAM again
without making any changes to the QoS configuration.)
By default, Cisco 7200 Series routers and below that support MQC QoS, reserve up to 75
percent of the interface bandwidth for user-defined classes. The remaining bandwidth is
used for the default class. However, the entire remaining bandwidth is not guaranteed for
the default class. This bandwidth is shared proportionately between the different flows in
the default class and excess traffic from other bandwidth classes. At least 1 percent of the
available bandwidth is reserved and guaranteed for class default traffic by default (up to 99
percent can be allocated to the other classes) on Cisco 7500 Series routers.
6-84 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Configuring AutoQoS
Configuring AutoQoS:
Routers
- -
IPTX v2.06-11
To configure the AutoQoS VoIP feature on an interface, use the auto qos voip command in
interface configuration mode or Frame Relay DLCI configuration mode. To remove the
AutoQoS VoIP feature from an interface, use the no form of the auto qos voip command.auto
qos voip [trust] [fr-atm]
no auto qos voip [trust] [fr-atm]
Syntax Description
Parameter
Description
The bandwidth of the serial interface is used to determine the speed of the link. The speed of
the link is one element that is used to determine the configuration that is generated by the
AutoQoS VoIP feature. The AutoQoS VoIP feature uses the bandwidth at the time the feature
is configured and does not respond to changes made to bandwidth after the feature is
configured.
For example, if the auto qos voip command is used to configure the AutoQoS VoIP feature on
an interface with 1000 kbps, the AutoQoS VoIP feature generates configurations for high-speed
interfaces. However, if the bandwidth is later changed to 500 kbps, the AutoQoS VoIP feature
does not use the lower bandwidth. It retains the higher bandwidth and continues to use the
generated configurations for high-speed interfaces.
To force the AutoQoS VoIP feature to use the lower bandwidth (and thus generate
configurations for the low-speed interfaces), use the no auto qos voip command to remove the
AutoQoS VoIP feature, then reconfigure the feature.
6-86 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Configuring AutoQoS:
Cisco Catalyst 6500 Switch
-
- - -
-- -- - -
-
- -
- -
- - - - --
- - - ---
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.06-12
When you execute the global AutoQoS macro, all the global QoS settings are applied to all
ports in the switch. After completion, a prompt displays the CLI for the port-based AutoQoS
commands currently supported.
Configuring AutoQoS:
Cisco Catalyst 6500 Switch (Cont.)
-
- - - - --
IPTX v2.06-13
The port-specific AutoQoS macro handles all inbound QoS configuration that is specific to a
particular port.
The QoS ingress port-specific settings include port trust, default CoS, classification, and
policing but does not include scheduling. Input scheduling is programmed through the global
AutoQoS macro. Together with the global AutoQoS macro command, all QoS settings are
configured properly for a specific QoS traffic type.
Any existing QoS ACLs that are already associated with a port are removed if AutoQoS
modifies ACL mappings on that port. The ACL names and instances are not changed.
If the trust dscp or trust cos keyword is used, the trusted boundary feature is disabled. This
means an IP Phone will not rewrite the DSCP or CoS values from an attached PC.
6-88 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Configuring AutoQoS:
Cisco Catalyst 6500 Switch (Cont.)
-
- - - --
-
ciscosoftphone
The trusted boundary feature must be disabled for Cisco SoftPhone ports
QoS settings must be configured to trust the Layer 3 markings ofthe traffic
that enters the port
Only available on Catalyst 6500
ciscoipphone
The port is set up to trust-cos as well as to enable the trusted boundary feature
Combined with the global automatic QoS command, all settings areconfigured
on the switch to properly handle the signaling and voice bearer and PC data
entering and leaving the port
CDP must be enabled for the ciscoipphone QoS configuration
IPTX v2.06-14
The port-specific automatic QoS macro accepts a mod/port combination and must include a
Cisco IP Telephony type keyword. The ciscoipphone, ciscosoftphone, and trust keywords are
supported.
With the ciscoipphone keyword, the port is set up to trust CoS as well as to enable the trusted
boundary feature. Combined with the global AutoQoS command, all settings are configured on
the switch to properly handle the signaling and voice bearer and the PC data entering and
leaving the port.
In addition to the switch-side QoS settings covered by the global AutoQoS command, the
phone has a few QoS features that need to be configured in order for proper labeling to occur.
QoS configuration information is sent to the phone through the CDP from the switch. The QoS
values that need to be configured are the trust settings of the PC port on the phone (trust or
untrusted) and the CoS value that is used by the phone to remark packets in case the port is
untrusted.
Only the Catalyst 6500 supports AutoQoS for Cisco SoftPhone. On the ports that connect to a
Cisco SoftPhone, QoS settings must be configured to trust the Layer 3 markings of the traffic
that enters the port. Trusting all Layer 3 markings is a security risk because PC users could
send nonpriority traffic with DSCP 46 and gain unauthorized performance benefits. Although
not configured by AutoQoS, policing on all inbound traffic can be used to prevent malicious
users from obtaining unauthorized bandwidth from the network. Policing is accomplished by
rate-limiting the DSCP 46 (Expedited Forwarding) inbound traffic to the codec rate used by the
Cisco SoftPhone application (worst case G.723). Any traffic that exceeds this rate is marked
down to the default traffic rate (DSCP 0 best effort). Signaling traffic (DSCP 24) is also
policed and marked down to 0 if excess signaling traffic is detected. All other inbound traffic
types are reclassified to default traffic (DSCP 0 best effort).
Note
You must disable the trusted boundary feature for Cisco SoftPhone ports.
6-90 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Configuring AutoQoS:
Catalyst 2950EI, 3550 Switches
- -
- -
IPTX v2.06-15
When you enable the AutoQoS feature on the first interface, QoS is globally enabled ( mls qos
global configuration command).
When you enter the auto qos voip trust interface configuration command, the ingress
classification on the interface is set to trust the CoS QoS label received in the packet, and the
egress queues on the interface are reconfigured. QoS labels in ingress packets are trusted.
When you enter the auto qos voip cisco-phone interface configuration command, the trusted
boundary feature is enabled. It uses the CDP to detect the presence or absence of an IP Phone.
When an IP Phone is detected, the ingress classification on the interface is set to trust the QoS
label received in the packet. When an IP Phone is absent, the ingress classification is set to not
trust the QoS label in the packet. The egress queues on the interface are also reconfigured. This
command extends the trust boundary if IP Phone detected.
Monitoring AutoQoS
Monitoring AutoQoS:
Routers
- -
- -
IPTX v2.06-16
When the auto qos voip command is used to configure the AutoQoS VoIP feature,
configurations are generated for each interface or PVC. These configurations are then used to
create the interface configurations, policy maps, class maps, and ACLs. The show auto qos
command can be used to verify the contents of the interface configurations, policy maps, class
maps, and ACLs.
The show auto qos interface command can be used with Frame Relay DLCIs and ATM PVCs.
When the interface keyword is used along with the corresponding interface type argument, the
show auto qos interface [interface type] command displays the configurations created by the
AutoQoS VoIP feature on the specified interface.
When the interface keyword is used but an interface type is not specified, the show auto qos
interface command displays the configurations created by the AutoQoS VoIP feature on all the
interfaces or PVCs on which the AutoQoS VoIP feature is enabled.
6-92 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
--
--
--
- -
Monitoring AutoQoS:
Routers (Cont.)
-
Displays the packet statistics of all classes that are configured for all
service policies either on the specified interface or subinterface
- -
-
-- -
- - -
-
- -
- - -
-
-
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.06-17
To display the configuration of all classes configured for all service policies on the specified
interface or to display the classes for the service policy for a specific permanent virtual circuit
(PVC) on the interface, use the show policy-map interface EXEC or privileged EXEC
command.
-
6-94 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Monitoring AutoQoS:
Switches
- -
Displays the auto-QoS configuration that was initially applied
Does not display any user changes to the configuration that
might be in effect
-
-
-
-
-
- - --
-
- - - -
- - - -
IPTX v2.06-18
To display the initial AutoQoS configuration, use the show auto qos [interface [interface-id]]
privileged EXEC command. To display any user changes to that configuration, use the show
running-config privileged EXEC command. You can compare the show auto qos and the
show running-config command output to identify the user-defined QoS settings.
Monitoring AutoQoS:
Switches (Cont.)
- - -
- - ---
--
Displays QoS information at the interface level
- - - ----
-- -
--
--
-
- -
-
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.06-19
Display QoS information at the interface level, including the configuration of the egress queues
and the CoS-to-egress-queue map, which interfaces have configured policers, and ingress and
egress statistics (including the number of bytes dropped).
If no keyword is specified with the show mls qos interface command, the port QoS mode
(DSCP trusted, CoS trusted, untrusted, and so forth), default CoS value, DSCP-to-DSCPmutation map (if any) attached to the port, and policy map (if any) attached to the interface are
displayed. If an interface is not specified, the information for all interfaces is displayed.
Expressions are case sensitive. For example, if you enter | exclude output, the lines that
contain output are not displayed, but the lines that do not contain output are displayed,
including any lines that contain Output or OUTPUT.
6-96 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Monitoring AutoQoS:
Switches (Cont.)
- - - - -- -- -
- --
- -
--
IPTX v2.06-20
This topic identifies several of the QoS technologies that are automatically implemented on the
network when using AutoQoS.
IPTX v2.06-21
Automatically classifies RTP payload and VoIP control packets: H.323, H.225 Unicast,
Skinny Client Control Protocol (SCCP), session initiation protocol (SIP), and Media
Gateway Control Protocol (MGCP)
Builds service policies for VoIP traffic that are based on Cisco MQC
Provisions LLQ and PQ for VoIP bearer and bandwidth guarantees for control traffic
Enables WAN traffic shaping that adheres to Cisco best practices, where required
Enables link efficiency mechanisms, such as LFI and cRTP where required
Provides SNMP and syslog alerts for VoIP packet drops
LAN
Enforces the trust boundary on Cisco Catalyst switch access ports and on uplinks and
downlinks
Enables Cisco Catalyst strict priority queuing (also known as expedite queuing) with
Weighted Round Robin (WRR) scheduling for voice and data traffic, where appropriate
Configures queue admission criteria (maps CoS values in incoming packets to the
appropriate queues)
Modifies queue sizes and weights where required
6-98 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Summary
Summary
QoS can be enabled on a network by a single
command per interface using AutoQoS.
AutoQoSworks on a variety of Cisco routers and
switches.
AutoQos automatically configures and enables the
Diffserv mechanisms necessary for QoS.
IPTX v2.06-22
6-100 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Lesson 6
This case study activity provides information regarding the QoS administrative policy
requirements of a large, multisite network. Your task is to work with a partner to evaluate the
QoS requirements, then based on these requirements, identify where QoS mechanisms should
be applied. You will discuss your solution with the instructor and other classmates, and the
instructor will present a solution for the case study to the class.
Relevance
The ability to properly sort traffic into service classes and correctly position QoS mechanisms
is important in correctly implementing an administrative QoS policy.
Objectives
In this activity, you will you will correctly identify which QoS mechanisms can be used and
where QoS mechanisms should be applied to the network to implement an administrative QoS
policy. Upon completing this case study, you will be able to meet these objectives:
Review customer QoS requirements
Identify QoS service class requirements
Identify which QoS mechanisms should be used to meet customer requirements
Identify where QoS mechanisms should be applied to the network to meet customer
requirements
Present a solution to the case study
Required Resources
These are the resources required to complete this exercise:
Case Study Activity: QoS Mechanisms
A workgroup consisting of two learners
Job Aids
No job aids are required to complete this case study
Outline
This activity includes these tasks:
Step 1
Step 2
Identify QoS service class requirements. With the aid of your partner, identify the
service classes that are required in order to implement the administrative QoS policy
based on customer requirements.
Step 3
Step 4
Present your solution. After the instructor presents a solution to the case study,
present your solution to the class with your partner.
6-102 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Customer Situation
NHCS network currently has limited bandwidth capacity in their WAN links, and they do not
envision being able to increase bandwidth in the near future. All ten remote sites (two pictured
in the network diagram below) connect to the central site through a service provider via a
Frame Relay, Layer 2, 1 Mbps link service. The NHCS headquarters also connects to the
service provider via a Frame Relay, Layer 2, 1 Mbps link. NHCS LAN bandwidth is 10 Mbps.
NHCS connects to the Internet through its headquarters.
Since the installation of a new IP telephony system, NHCS has been encountering increasingly
serious problems with their network.
Users of the enterprise resource planning (ERP) applications have been complaining of
unacceptable response times. Their previously sub-second response time has stretched to
multiple seconds in many cases and up to a minute in some cases.
Key patient information files that used to arrive almost instantly are now taking 10 to 15
minutes to be transferred from headquarters to users at the remote sites (these are moderatesized, mostly text files).
Patient graphics files (x-rays, MRIs, and so on) that used to take 20 to 30 minutes to
transfer between the remote sites and headquarters now often have to be transferred
overnight (this is not deemed unacceptable as they are usually not needed immediately and
they tend to be extremely large files).
Users of the new IP telephony devices are the most upset. The quality of their calls is very
poor and their calls often just drop.
The key applications that are running on NHCS network are listed in the table.
Applications Running on NHCS Network
Application
Application
Importance
Response Time
Requirements
Use of Bandwidth
(Daytime)
critical
immediate
moderate
important
immediate
moderate
IP Telephony
important
no delay
moderate
Browser Traffic
not important
minimal
heavy
Device Number
Device Type
1 IP Phone
2 LAN Switch
3 Customer Edge Router
4 Service Provider Router
6-104 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Given NHCS network, how would you recommend classifying network traffic?
Traffic Classification and Prioritization
Type of Traffic (Application)
Traffic Priority
(Rank from 1 to 5)
Given NHCS network, how would you recommend deploying QoS mechanisms? In the
following four tables, mark each box (X) that represents where you believe that QoS
mechanisms could be applied in order to effectively resolve QoS problems at NHCS.
Where to Apply QoS Mechanisms: Classification and Marking
Device
#
1 IP Phone
1 IP Phone
2 Switch
2 Switch
Classification
on Input
Classification
on Output
Marking
on Input
Marking
on
Output
Interface to
Workstation
Switch
Phone
Interface to
Interface to IP
Interface to
Customer Edge Router
#
2 Switch
2 Switch
Phone
Congestion
Management
on Input
Interface to IP
Interface to
Customer Edge Router
6-106 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Congestion
Management
on Output
#
2 Switch
2 Switch
Traffic
Shaping
on Input
Traffic
Shaping
on Output
Interface to IP Phone
Interface to Customer
Edge Router
#
2 Switch
2 Switch
Compression
on Input
Compression
on Output
LFI on
Input
LFI on
Output
Interface to IP Phone
Interface to Customer
Edge Router
Together with your partner, present your solution to the class. Include the following
information:
Customer service class requirements
Network diagrams indicating where classification and marking should be applied
Justification for differences from the solution presented by the instructor
6-108 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Traffic Priority
IP Telephony Highest
Classification
on Input
Link to
Workstation
X X*
#
1 IP Phone
1 IP Phone
Link to Switch
2 Switch
2 Switch
Link to IP Phone
Link to Customer
Edge Router
X No,
Marking
on
Output
trusted*
Note
Marking
on Input
Classification
on Output
*The IP Phone is normally set to re-mark any traffic coming from its downstream workstation
(the IP Phones connection to the workstation is untrusted). The switch, on the other hand,
does not re-mark traffic coming from the IP Phone (traffic from the IP Phone is trusted).
Further explanation of trusted and untrusted interfaces is provided in Module 6 of this
course.
#
2 Switch
2 Switch
Link to IP Phone
Link to
Customer Edge Router
Congestion
Management
on Input
Congestion
Management
on Output
X
X
#
2 Switch
2 Switch
Traffic
Shaping
on Input
Link to IP Phone
Router
Link to
Possible
Possible
6-110 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Traffic
Shaping on
Output
#
2 Switch
2 Switch
Compression
on Input
LFI on
Input
LFI on
Output
Link to IP Phone
Link to Customer
Edge Router
Link
X X
X X
Note
Compression
on Output
This is a Frame Relay network, so the service provider passes frames through transparently
without compressing or fragmenting the frames.
6-112 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Module Summary
Module Summary
Quality of Service (QoS) is the ability of the network to provide
better or special service to select users and applications.
Converged networks create new requirements which create
challenges for managing network traffic as voice, video, and
data have very different requirements.
A QoS Policy is a network-wide definition of the specific levels
of quality of service assigned to classes of network traffic.
The Differentiated Services model is highly scalable and offers
the capability to define many different levels of service.
IP networks use a variety of mechanisms to implement QoS
including: classification, marking, congestion management,
metering, traffic shaping, compression, and link efficiency.
IPTX v2.06-1
IPTX v2.06-2
Voice and video traffic present new challenges to networking. QoS is the network glue that
makes it possible to incorporate voice and video traffic into a traditional networking
environment. An understanding of QoS is essential to guaranteeing voice quality in a
converged network. Prior to configuring QoS, a QoS policy should be developed.
DiffServ is a multiple-service model designed to satisfy various QoS requirements. With
DiffServ, the network tries to deliver a particular kind of service based on the QoS specified by
each packet. This specification can occur in different ways, for example, using the DSCP in IP
packets or source and destination addresses. The network uses the QoS specification of each
packet to classify, shape, and police traffic and to perform intelligent queuing.
IP networks use a variety of mechanisms to implement QoS, including classification, marking,
congestion management, traffic shaping, and link efficiency. IP QoS mechanisms are used to
implement a coordinated QoS policy in devices throughout the network. The moment an IP
packet enters the network, it is classified and usually marked with its class identification. From
that point on, the packet is treated by a variety of IP QoS mechanisms according to the packet s
classification. Depending upon the mechanisms it encounters, the packet could be expedited,
delayed, compressed, fragmented, or even dropped.
Both the MQC and Cisco AutoQoS were designed to aid in more rapid and consistent design,
implementation, and maintenance of QoS policies for converged networks. The MQC offers a
three-step, building-block approach to implementing extremely modular QoS policies for
network administrators who are required to carefully manage large and complex networks.
Cisco AutoQoS provides an easy-to-use, mostly automated means to provide consistent QoS
policies throughout a network, with minimal design and implementation effort.
References
For additional information, refer to the following resources:
Cisco Systems, Inc. Implementing Quality of Service: QOS Packet Marking.
http://www.cisco.com/en/US/partner/tech/tk543/tk757/technologies_white_paper09186a00
8017f93b.shtml. (CCO login required)
Blake, et. al. An Architecture for Differentiated Services.
http://www.ietf.org/rfc/rfc2475.txt.
Nichols, et. al. Definition of the Differentiated Services Field (DS Field) in the IPv4 and
IPv6 Headers. http://www.ietf.org/rfc/rfc2474.txt.
Heinanen, et. al. Assured Forwarding Per-Hop Behavior (PHB) Group.
http://www.ietf.org/rfc/rfc2597.txt.
Jacobson, et al. An Expedited Forwarding Per-Hop Behavior (PHB).
http://www.ietf.org/rfc/rfc3246.txt.
Cisco Systems, Inc. Quality of Service (QoS).
http://www.cisco.com/en/US/tech/tk543/tsd_technology_support_category_home.html.
Modular Quality of Service Command-Line Interface Overview.
http://www.cisco.com/en/US/products/sw/iosswrel/ps1835/products_configuration_guide_c
hapter09186a00800bd908.html.
Configuring the Modular Quality of Service Command-Line Interface.
http://www.cisco.com/en/US/products/sw/iosswrel/ps1835/products_configuration_guide_c
hapter09186a00800bd909.html.
6-114 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Cisco Systems, Inc. Cisco AutoQoS Whitepaper: QOS Configuration and Monitoring.
http://www.cisco.com/en/US/tech/tk543/tk759/technologies_white_paper09186a00801348
bc.shtml.
Configuring Automatic QoS.
http://www.cisco.com/en/US/products/hw/switches/ps708/products_configuration_guide_c
hapter09186a0080121d11.html.
Configuring QoS.
http://www.cisco.com/en/US/products/hw/switches/ps646/products_configuration_guide_c
aapter09186a0080115928.html.
Use the questions here to review what you learned in this module. The correct answers and
solutions are found in the Module Self-Check Answer Key.
Q1) Which of the following is the term used to describe the time it takes to actually transmit
a packet on a link (put bits on the wire)? (Source: Defining Quality of Service)
A) encoding delay
B) processing delay
C) serialization delay
D) transmission delay
Q2) Which three of the following are characteristics of converged network traffic? (Choose
three.) (Source: Defining Quality of Service)
A) constant small packet flow
B) time-sensitive packets
C) brief outages unacceptable
D) bursty small packet flow
Q3) How much one-way delay can a voice packet tolerate? (Source: Defining Quality of
Service)
A) 15 ms
B) 150 ms
C) 300 ms
D) 200 ms
Q4) Which transport layer protocol is used for voice traffic? (Source: Defining Quality of
Service)
A) UDP
B) TCP
C) XNS
D) HTTP
Q5) Which three of the following represent components of the definition of a QoS policy?
(Choose three.) (Source: Defining Quality of Service)
A) user-validated
B) network-wide
C) specific levels of quality of service
D) different classes of network traffic
Q6) Services are provided to which entities in the differentiated services model? (Source:
Describing the Differentiated Services Model)
A) frames
B) packets
C) applications
D) classes of traffic
6-116 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Q7) Which Assured Forwarding class and what drop probability would be indicated if the
DSCP was equal to 100100? (Source: Describing the Differentiated Services Model)
A) AF Class 1 and medium
B) AF Class 4 and medium
C) AF Class 1 and high
D) AF Class 4 and high
Q8) Which command would you use to attach a QoS policy to an interface? (Source:
Introducing Modular QoS CLI)
A)
B)
C)
D)
policy-set-interface
policy-map
policy-interface
service-policy
Q9) How can a service policy be attached to an interface? (Source: Introducing Modular
QoS CLI)
A) for inbound packets only
B) for outbound packets only
C) for inbound or outbound, not both
D) for inbound only, for outbound only, or for both inbound and outbound
Q10) What does the trust parameter in auto qos voip indicate should be trusted (relied
upon)? (Source: Implementing AutoQoS)
A) source address
B) MAC address of sender
C) DES keyword
D) DSCP
Q11) Which three of following is displayed by the show auto qos interface command?
(Choose three.) (Source: Implementing AutoQoS)
A) ACLs
B) class maps
C) policy maps
D) service maps
Q12) Which command would you use on a Catalyst switch to display the configuration of the
egress queues? (Source: Implementing AutoQoS)
A)
B)
C)
D)
Q13) Which three of the following does AutoQoS VoIP automatically do when used to
automatically configure a WAN interface? (Choose three.) (Source: Implementing
AutoQoS)
A) enables payload compression
B) provisions LLQ
C) classifies RTP payload and VoIP control packets
D) enables LFI where required
Q2) A, B, C
Q3) B
Q4) A
Q5) B, C, D
Q6) D
Q7) B
Q8) D
Q9) D
Q10) D
Q11) A, B, C
Q12) D
Q13) B, C, D
6-118 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Module 7
This is a foundation module to compare and contrast traditional telephony with Voice over IP
(VoIP). When deploying and designing a Cisco CallManager Express and Cisco Unity Express
(CUE) installation, there are some deployment models and caveats that need to be taken into
consideration. These include voice mail and other issues.
Module Objectives
Upon completing this module, you will be able to compare and contrast traditional telephony
with VoIP. This includes being able to meet these objectives:
Discuss deploying Cisco CallManager Express with approved deployment models
Describe integration with CUE and other voice mail applications
7-2 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Lesson 1
Describing Deployment
Scenarios and Design
Considerations
Overview
This lesson addresses some of the considerations regarding the design and deployment
considerations that should be understood when deploying Cisco CallManager Express and
Cisco Unity Express (CUE).
Objectives
Upon completing this lesson, you will be able to discuss deploying Cisco CallManager Express
with approved deployment models. This includes being able to meet these objectives:
Describe design considerations for standalone Cisco CallManager Express with
PSTN interfaces
Describe the design considerations for integration of Cisco CallManager Express with a
SIP network
Describe the design considerations for Cisco CallManager Express integration with
Cisco CallManager
Describe design consideration issues of Cisco CallManager Express migration to
Cisco CallManager and SRST
Describe the design issues and solutions of Cisco CallManager Express H.323
interoperability
IPTX v2.07-3
Analog phones via Cisco Analog Telephone Adaptor (ATA) 186 and 188
Copyright 2005, Cisco Systems, Inc. Designing Cisco CallManager Express and Cisco Unity Express Networks 7-5
A WAN connection to a carrier network can be set up for e-mail, Internet, chat, and other
services.
The following are call types:
Local calls
IP Phone to IP Phone
IP Phone to analog phones on the Cisco CallManager Express router FXS ports
Incoming calls from the PSTN to extensions 1011, 1012, and 1013 by using the following:
Private line, automatic ringdown (PLAR) connection via FXO port
Direct inward dialing (DID) and translation rules via ISDN
Outgoing calls via the PSTN
Incoming and outgoing calls from WAN and the Internet via H.323
Analog phones can appear as Skinny Client Control Protocol (SCCP) endpoints via
Cisco ATA 186 and 188
Voice mail can be hosted by the Server Message Block (SMB) and branch office (refer to
the section on Cisco CallManager Express integration with voice mail)
We have two options for fax support:
Connect the fax machine to the ATA that is connected to Cisco CallManager Express; only
fax passthrough is supported on the ATA
Connect the fax machine to the FXS port of the Cisco CallManager Express router; this
supports fax passthrough, T.38, and Cisco fax relay
7-6 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Cisco CallManagerExpress/CUE
Internet
PSTN
IPTX v2.07-4
Copyright 2005, Cisco Systems, Inc. Designing Cisco CallManager Express and Cisco Unity Express Networks 7-7
This topic describes Cisco CallManager Express in the session initiation protocol (SIP)
network.
IPTX v2.07-5
Integration of Cisco CallManager Express with a SIP network is supported and can be
implemented. This is more a function of the IOS software than a feature of Cisco CallManager
Express. The Cisco IOS software can support SIP dial peers, and this is how SIP integration is
accomplished with Cisco CallManager Express. This allows for the support of basic calls to and
from Cisco CallManager Express and the SIP network, as well as the ability to blindly transfer,
consultative transfer, and forward to SIP destinations.
Note
SIP endpoints cannot register to or be under the direct control of Cisco CallManager
Express.
7-8 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
SIP Invite,
Redirect, or Refer
PSTN
IP WAN
SIP Integration
SIP Site
IPTX v2.07-6
SIP redirect and SIP refer can be used for call transfer and call forwarding features from Cisco
CallManager Express. The mechanisms that are used are similar in function to H.450.2 and
H.450.3. Cisco SCCP phones, such as those used with Cisco CallManager Express systems, do
not support the standard in-band dual tone multifrequency (DTMF) relay mechanism used by
SIP phones to send keypad digits and, as a result, a nonstandard DTMF relay must be
configured on the SIP dial peers. The DTMF relay mechanism that is chosen will either be the
RFC 2833compliant mechanism or the Cisco-proprietary Notify method. The mechanism
that is selected must be configured the same on both ends of the call setup. To configure the
RFC 2833compliant mechanism, use the dtmf-relay rte-nte command under the appropriate
dial peer(s). The command that enables the Cisco Notify mechanism under the dial peer is
dtmf-relay sip-notify.
The SIP DTMF relay method is needed in the following situations:
When SIP is used to connect a Cisco CallManager Express system to a SIP-based
interactive voice response (IVR) or voice mail application
When SIP is used to connect a Cisco CallManager Express system to a SIP-PSTN voice
gateway that goes through the PSTN to a voice mail or an IVR application
Enabling a SIP gateway to register the E.164 numbers with a SIP proxy or SIP registrar is
similar to the way in which H.323 gateways can register E.164 numbers with a gatekeeper. SIP
gateways allow registration of E.164 numbers to a SIP proxy or registrar on behalf of analog
telephone voice ports (FXS ports) and IP Phone virtual voice ports (enhanced FXS [EFXS]
ports) for local SCCP phones.
When registering E.164 numbers in dial peers with an external registrar, you can also register
them with a secondary SIP proxy or registrar to provide redundancy. The secondary registration
can be used if the primary registrar fails. By default, SIP gateways do not generate SIP register
messages. If this function is desired, it must be enabled with the command sip-ua. After you
enter this mode, the primary and secondary registrar servers can be configured with the
registrar command.
Copyright 2005, Cisco Systems, Inc. Designing Cisco CallManager Express and Cisco Unity Express Networks 7-9
This topic describes Cisco CallManager Express integration with Cisco CallManager.
IPTX v2.07-7
The integration of Cisco CallManager Express and Cisco CallManager is accomplished through
an H.323 connection. This H.323 connection is through a WAN link that should be quality of
service (QoS)-enabled for both the call setup messages and the Real-Time Transport Protocol
(RTP) stream.
Cisco CallManager uses Empty Capabilities Set (ECS), a nonstandard protocol, which does not
handle multiple transfers of the same call gracefully and adds signaling delay for each transfer.
Cisco CallManager Express does support incoming ECS requests from other voice gateways
like Cisco CallManager, but Cisco CallManager Express will not initiate an ECS transfer
request. The H.450.X protocols are supported in Cisco CallManager Express, but are not
supported in Cisco CallManager. The workarounds for these issues, which are covered later in
this lesson, include hairpinning and tandem gateways.
7-10 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
PSTN
Cisco CallManager
Phones
Cisco CallManager
Express Phones
Branch
Branch Office
Office
Cisco CallManager
Cluster Central
Call Processing
Applications
(UM, IVR, IPCC, etc.)
Fat pipe
QoSenabled
IP WAN
Cisco CallManager
Express, CUE
Localized Call
Processing
Central Site
IPTX v2.07-8
In the scenario of Cisco CallManager Express and Cisco CallManager, the most common
topology would be one or more branch offices running Cisco CallManager Express and a
headquarters or other large site running Cisco CallManager. These sites would be connected via
QoS-enabled WAN links with appropriate service level agreements (SLAs), with VoIP calls
traversing the WAN link. The PSTN would be the backup link if the WAN went down or lost
connectivity and for connectivity customers and vendors.
Copyright 2005, Cisco Systems, Inc. Designing Cisco CallManager Express and Cisco Unity Express Networks 7-11
Cisco CallManager
Voice
mail
Distributed Cisco
CallManager with
CUE at small,
remote locations
Voice
mail
PSTN
Fat pipe
Cisco CallManager
Express, CUE
QoSenabled
IP WAN
Cisco CallManager
Express, CUE
IPTX v2.07-9
Another scenario in which Cisco CallManager Express can be integrated with Cisco
CallManager is when one or more branch offices running Cisco CallManager Express are
integrated with more than one Cisco CallManager cluster. This would likely be found in
situations where there are multiple sites with more than 480 users. This is because 480 is the
maximum number of phones supported in Survivable Remote Site Telephony (SRST). In this
scenario, the WAN link must be QoS-enabled and have an appropriate SLA.
7-12 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
This topic describes Cisco CallManager Express migration to Cisco CallManager and SRST.
IPTX v2.07-10
The Cisco CallManager Express deployment solution is designed to fully protect a customer s
investment if they decide to migrate to a Cisco CallManager and SRST solution because of
some specific feature needs or because they outgrow the 240-user limit of Cisco CallManager
Express. The full-featured data router that provides Cisco CallManager Express functionality
can be transitioned into a high-availability gateway in a centralized Cisco CallManager and
SRST design with only some configuration changes.
The Cisco CallManager Express feature license and phone seat licenses can be converted to
SRST licenses. Customers will not have to deal with additional upgrade issues unless they are
adding users above the current level. This allows a customer to choose Cisco CallManager
Express for the present and upgrade to Cisco CallManager and SRST in the future with no
additional costs.
When the customer wants to change to SRST on the router, this can be done on a site-by-site
basis. This allows for segmented upgrades in which a single branch office at a time can be
migrated to the more scalable Cisco CallManager and SRST configuration.
Copyright 2005, Cisco Systems, Inc. Designing Cisco CallManager Express and Cisco Unity Express Networks 7-13
CallManagerExpress
SRST
PSTN
SRST
QoSEnabled
IPWAN
Cisco CallManagerExpress,
CUE Localized Call
Processing
CallManagerExpress Phones
CallManagerPhones
Applications
(UM, IVR, ICD, etc.)
Fat pipe
Cisco CallManagerExpress
Phones CCM Phones
CallManagerExpress
Cisco CallManager
Cluster Central
Call Processing
Central Site
Cisco
IPTX v2.07-11
When a site is migrated to an SRST-based design, the IP Phone that was previously registered
to the Cisco CallManager Express router will now register and be under the control of the Cisco
CallManager cluster. As a result, some additional signaling and keepalive messages will
traverse the WAN link during normal operation. When the WAN link is down or connectivity
is lost, the IP Phones register to what used to be the Cisco CallManager Express router and is
now the SRST router. This SRST router is very similar to the functionality of the Cisco
CallManager Express router.
The router that used to run Cisco CallManager Express will need some configuration changes
in order to migrate to an SRST configuration. These changes are not difficult, but do require
some planning and forethought. During normal operations, the router will use H.323 to
communicate with the Cisco CallManager cluster. For additional SRST configuration
guidelines, see the following reference.
Reference
http://cisco.com/application/pdf/en/us/guest/products/ps5049/c1091/ccmigration_09186a008
01d1e94.pdf
7-14 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Cisco
Cisco CallManager
CallManager
ExpressA
ExpressA
Step 4 Call is
transferred or
forwarded
Step 2 -Transfer
or forward to 3000
Cisco CallManager
ExpressB
3000
3000
IP WAN
Cisco
Cisco
CallManager
CallManager
ExpressC
ExpressC
IPTX v2.07-12
H.450-Compliant Networks
In an environment in which all the devices are H.450-compliant, the forwarding and
transferring of calls is seamless and efficient. When a call is forwarded or transferred to a
phone on another Cisco CallManager Express router, the H.450.X protocols can be used to
ensure efficient use of bandwidth and resources.
Copyright 2005, Cisco Systems, Inc. Designing Cisco CallManager Express and Cisco Unity Express Networks 7-15
IPTX v2.07-13
Non-H.450-Compliant Networks
In a mixed network that involves two or more types of call agents or managers, there can be
H.323 communication protocol discrepancies and dependencies. Therefore, there is the
opportunity for interoperability glitches. These discrepancies show up most often when a call is
being transferred or forwarded. The recent Cisco CallManager Express releases have
introduced features to address these discrepancies and enable transparent transferring and
forwarding of calls across VoIP networks.
These issues can be addressed when not all gateways support H.450.X protocols, like Cisco
CallManager, BTS 10200, and PGW 2200. One way to address these issues is through the
hairpinning of calls. Hairpin call routing uses the VoIP-to-VoIP connection mechanisms that
were introduced in Cisco CallManager Express 3.1 to transfer and forward calls that cannot use
H.450 standards. When a call that originally terminated on a voice gateway is transferred or
forwarded by a phone or other application attached to the gateway, the gateway originates the
call again and routes the call as appropriate, making a VoIP-to-VoIPor hairpinconnection.
This approach avoids any protocol dependency on the far-end transferred-party endpoint or
transfer-destination endpoint.
Hairpinning can cause an inefficient use of bandwidth because one call is coming in and one
call is going out over the WAN link that is connecting sites. Additional issues arise because of
the increased latency and jitter as more links are traversed.
Another way to use this hairpinning function is to set up a separate gateway at the location of
the non-H.450.X device. This gateway would support H.450.X protocols, and it would front
end all transfers and forwards. This results in more efficient bandwidth utilization and WAN
utilization.
7-16 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Cisco
Cisco CallManager
CallManager
ExpressA
ExpressA
Non-H.450
Gateway
Cisco CallManager
ExpressB
Step 2 -Transfer
or forward to 3000
IP WAN
Step 3 Call is hairpinned
and connected to 3000
3000
3000
-
-
2005 Cisco Systems, Inc. All rights reserved.
IPTX v2.07-14
Non-H.450-CompliantNetworks Hairpinning
A call is placed from one Phone under the control of a Cisco CallManager Express system to
another Phone under a different Cisco CallManager Express system. The recipient of the phone
call is forwarded to a Phone on a Cisco CallManager cluster. Because Cisco CallManager does
not support H.450.X protocols, the call must be hairpinned on the recipient Cisco CallManager
Express router. This consumes bandwidth equal to two calls instead of one call. In addition, the
latency from the originator of the call to the Cisco CallManager cluster phone incurs two times
the latency of the WAN link where it is hairpinned.
Note
If Cisco CallManager Express B goes down while a call is in progress using the hairpin, the
call will be disconnected.
Although this is not the optimal solution, it is currently necessary when H.323 protocol
mismatches occur. This hairpinning of calls can be implemented in another fashion to reduce
the latency and bandwidth issues. Ultimately, this issue will be resolved with the introduction
of SIP support into the Cisco CallManager cluster in a future release.
Note
Copyright 2005, Cisco Systems, Inc. Designing Cisco CallManager Express and Cisco Unity Express Networks 7-17
CUE
SIP
H.323
H.323
Skinny
IP WAN
Gateway
3000
3000
Cisco
CallManager
Express
-
Step 2 A hairpin between the
H.323 call leg and the SIP call leg to
the CUE module is set up
- -
IPTX v2.07-15
H.323 to SIPHairpinning
H.323 to SIP call routing to CUE supports call transfer and call forward of incoming H.323
calls to CUE without using loopback-dns. The feature is enabled by configuring allowconnections h323 to sip in voice service voip configuration mode. When this command is
enabled, on any incoming H.323 calls that are forwarded or transferred to CUE, the H.323 call
leg and SIP call leg to CUE is hairpinned on the Cisco CallManager Express router. This
feature does not support hairpinning to any SIP endpoint other than CUE.
7-18 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
- -
- -
IPTX v2.07-16
To view a hairpinned call, use the show voip rtp connections command.
Copyright 2005, Cisco Systems, Inc. Designing Cisco CallManager Express and Cisco Unity Express Networks 7-19
Step 4 Call is
transferred or forwarded
H.450
Tandem
Gateway
IP WAN
3000
3000
Step 2 -Transfer or
forward from 2000
to 3000
Step 5 Local
hairpin at Cisco
CallManagersite,
not across WAN
IPTX v2.07-17
7-20 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Trunk Configuration
Gatekeeper controlled
or non-gatekeeper
controlled
Media Termination
Point Required must be
selected
Cisco CallManager
Express will register
with Cisco CallManager
MTP selected
IP address of Cisco
CallManagerExpress
or tandem gateway
IPTX v2.07-18
Non-H.450-Compliant Networks
Integrating Cisco CallManager Express and a Cisco CallManager cluster requires configuration
of an H.323 dial peer on the Cisco CallManager Express router and some configuration on the
Cisco CallManager cluster. The configuration of the Cisco CallManager cluster includes the
creation of an intercluster trunk. The trunk may be either gatekeeper-controlled if bandwidth is
an issue and Call Admission Control (CAC) is required or non-gatekeeper-controlled if
bandwidth is plentifulfor example, in a LAN environment. The IP address of the trunk must
be configured. It will either be populated with the address of the Cisco CallManager Express
router if hairpinning is done on the Cisco CallManager router or with the IP address of the
tandem gateway if hairpinning is done there. In addition to the IP address, the use of a media
termination point (MTP) is required and must be selected when adding the trunk.
Copyright 2005, Cisco Systems, Inc. Designing Cisco CallManager Express and Cisco Unity Express Networks 7-21
Set Send H225 User Info message to H225 Info for Ringback
IPTX v2.07-19
Non-H.450-Compliant Networks
There are some other settings that must also be configured in order to enable the integration to
work properly.
The first is the H.323 Faststart Inbound service parameter setting on the Cisco CallManager
service. It must be set to False (the default setting).
The second setting under the service parameters of the Cisco CallManager service is Send
H225 User Info Message, and it needs to be set to H225 Info for Ringback.
7-22 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.07-20
H.323 Gatekeeper
The gatekeeper is a part of the H.323 protocol suite. The gatekeeper can be used by the Cisco
CallManager Express system to perform some telephony functions. The primary function that
Cisco CallManager Express uses the gatekeeper for is CAC. CAC allows the gatekeeper to
regulate the number of calls that can be traversing a link at any one time. It can also deny
access to the regulated link. This prevents oversubscription of the WAN link, which can happen
when too many calls are allowed.
Another function that can be performed by the gatekeeper is to centralize the dial plan for
interCisco CallManager Express connections. This has the benefit of centralizing dial plan
management and administration, as well as minimizing the configuration changes on Cisco
CallManager Express.
Copyright 2005, Cisco Systems, Inc. Designing Cisco CallManager Express and Cisco Unity Express Networks 7-23
Pod2
Pod3
WAN
Pod7
Pod4
Pod8
Pod5
IPTX v2.07-21
A gatekeeper is often used in larger multisite deployments, as well as for connecting to service
provider networks. The gatekeeper is a function that can run on a Cisco IOS router. There is
one instance or zone per site, and the CAC functions can be defined on a per-zone basis. The
dial plan is also often centralized and configured on a per-zone basis.
Note
It is important to have an organized, well-thought-out dial plan that does not overlap.
The location of the gatekeeper does not need to be local to the WAN links that are being
governed. There just needs to be IP connectivity. Gatekeeper functionality should be deployed
in a pair of IOS routers with Hot Standby Router Protocol (HSRP) for redundancy and
Gatekeeper Update Protocol (GUP) to synchronize gatekeeper state information in case of a
failure.
7-24 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
-
--
-
-
-
-
-
-
-
-
-
-
WAN
Cisco CallManager
Express
Gatekeeper
IPTX v2.07-22
This figure shows a sample configuration for both Cisco CallManager Express and the
gatekeeper.
Copyright 2005, Cisco Systems, Inc. Designing Cisco CallManager Express and Cisco Unity Express Networks 7-25
Summary
Summary
The Cisco CallManagerExpress system can be configured
in a fashion similar to a key switch, PBX, or a hybrid of
both.
The simplest deployment will have a single site with one
Cisco CallManagerExpress router and up to 240 phones.
Cisco CallManagerExpress communicates with CUE via
the SIP protocol.
Cisco CallManagerExpress can be integrated with Cisco
CallManager.
The Cisco CallManagerExpress system can be migrated
to an SRST router with the migrating phones being under
the control of Cisco CallManager.
Cisco CallManager does not support H.450 protocols.
When integrating with Cisco CallManagerExpress, this
can be dealt with by hairpinningcalls or a tandem
gateway.
2005 Cisco Systems, Inc. All rights reserved.
7-26 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.07-23
Lesson 2
This lesson defines the different ways in which voice mail can be integrated with Cisco
CallManager Express. This includes Cisco Unity Express (CUE), Cisco Unity 4.0, and Octel.
Objectives
Upon completing this lesson, you will understand the issues involved in voice mail integration.
This includes being able to meet these objectives:
Describe the architecture of how CUE is integrated with Cisco CallManager Express using
SIP
Describe the architecture of how CUE and Cisco Unity are connected in the network for
voice mail integration using SCCP
Describe the procedures for integrating to a voice mail system using analog DTMF
This topic describes the session initiation protocol (SIP) integration with CUE.
SIP
CUE
SIP
SCCP
PSTN
PSTN
Gateway
IPTX v2.07-3
When integrating Cisco CallManager Express with CUE, the call control protocol is SIP. This
integration is used internally across the backplane of the router and cannot be used for phones
to directly set up a call to voice mail. When users check their voice mail from an IP Phone,
Skinny Client Control Protocol (SCCP) will be used to communicate with Cisco CallManager
Express, which will then set up a call to the CUE system using SIP. After the call is set up,
there will be two Real-Time Transport Protocol (RTP) streams going to and from the CUE
system.
The CallManager Express, Unity Express, and gateway functions can all reside in the same
chassis or can be physically separate from each other.
7-28 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.07-4
The integration of Cisco Unity 3.1 or higher with Cisco CallManager Express uses SCCP.
The phone system sends the following information in the form of skinny packets with
forwarded calls:
The extension of the called party
The extension of the calling party (for internal calls) or the phone number of the calling
party (if it is an external call and the system uses caller ID)
The reason for the forward (the extension is busy, does not answer, or is set to forward all
calls)
Cisco Unity uses this information to answer the call appropriately. For example, a call
forwarded to Cisco Unity is answered with the personal greeting of the subscriber. If the phone
system routes the call to Cisco Unity without this information, Cisco Unity answers with the
opening greeting.
Copyright 2005, Cisco Systems, Inc. Designing Cisco CallManager Express and Cisco Unity Express Networks 7-29
IP WAN
SCCP
RTP
2005 Cisco Systems, Inc. All rights reserved.
Cisco
Unity
Central Site
IPTX v2.07-5
A Cisco CallManager Express router registers Cisco Unity ports as skinny devices and
perceives them as ephones in which the voice mail pilot number is configured as an ephone-dn
and the voice mail device is configured as an ephone. For a four-port Cisco Unity server
integration, you need to configure four ephone-dns and four ephones for the four voice mail
ports and four voice-mail device IDs, respectively. Cisco CallManager Express voice mail
integration with Cisco Unity supports the following:
Direct access to the voice mail system
Call forward all, forward busy, and forward no answer to personal greeting
Message Waiting Indicator (MWI)
To access a mailbox from an IP Phone, users press the Messages button on the phone or dial the
voice mail number (for example, 52222). Then users are asked to enter their PIN to listen to
their own messages. To access their mailbox from the public switched telephone network
(PSTN), users dial a voice mail number (for example, 408 555-2222), then enter their extension
and PIN. After they are authenticated, they can listen to, then delete or store their messages.
When a calling party places a call to an extension connected to the Cisco CallManager Express
router and the extension is configured with the call forward option, the call is forwarded to
Cisco Unity voice mail for the extension dialed if the call is not answered, if the extension is
busy, or if forward all is set. Cisco CallManager Express communicates with the Cisco Unity
server via SCCP.
When a call is forwarded to the Cisco Unity voice mail server, the calling number, called party
number, and redirect number are all forwarded to the Cisco Unity server. Thus, the call is
forwarded to the called extensions own voice mailbox and the personal greeting can be heard.
Configure the Messages Button to Access the Voice Mail System (Pilot Number)
Directly
You may configure voice mail 52222 in telephony-service configuration mode:
telephony-service
voice mail 52222
Pressing the Messages button on the IP Phone or dialing 52222 will let you access the Cisco
Unity voice mail system.
To integrate with a four-port Cisco Unity server, configure four ephone-dns for the four ports
on the Cisco Unity server with the same voice mail number, 52222, for answering calls. Also
configure the MWI with preference 0, 1, 2, and 3 so that if the first port is busy, it will go to the
second port and so on. Alternatively, you may configure three ephone-dns for the three ports on
Cisco Unity with the same voice mail number, 52222, for answering calls and the fourth one
with number 52223, which is equivalent to the fourth port on Cisco Unity and is primarily for
dial-out MWI.
Copyright 2005, Cisco Systems, Inc. Designing Cisco CallManager Express and Cisco Unity Express Networks 7-31
This topic describes the analog dual tone multifrequency (DTMF) integration.
IPTX v2.07-6
Both Octel and Active Voice Reception voice mail systems support integration via traditional
analog ports. The calling, called, and redirected numbers are sent to the voice mail system in
the form of DTMF tones at the start of the call when integrating with an analog voice mail
system. The DTMF tones that are sent must match on both the Cisco CallManager Express and
an integration file on the voice mail server.
Note
Simplified Message Desk Interface (SMDI) and digital integration are not supported.
7-32 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
FXS
DTMF
Tones
IPTX v2.07-7
This figure shows that the connection between Cisco CallManager Express and Active
Voice Reception or Octel voice mail system is via Foreign Exchange Station (FXS) using
analog DTMF.
The voice mail system is connected to the FXS port of the router and is treated as a normal
extension for the Cisco CallManager Express router. For DTMF integrations, information on
how to route incoming or forwarded calls in the form of DTMF digits is sent by the Cisco
CallManager Express router, and MWI codes are sent from the voice mail system in the form of
DTMF packets. Voice mail systems are designed to respond to DTMF after the system has
answered the incoming calls.
Users can access their voice mail from an IP Phone by pressing the button on the Phone. When
the voice mail system answers the call, the Cisco CallManager Express router sends a DTMF
packet to inform the voice mail system that this is a direct call from extension 1011, and users
are automatically put into their own voice mailbox and prompted to enter the option to check
the messages.
Copyright 2005, Cisco Systems, Inc. Designing Cisco CallManager Express and Cisco Unity Express Networks 7-33
-
-
-
-
-
-
-
-
Integration on the
voice mail server that
matches the pattern
command settings
and number of ports
1/1/0 1/1/3
Cisco CallManager
Express
IPTX v2.07-8
The Cisco CallManager Express router communicates with the analog voice mail system by
sending DTMF patterns. The voice mail integration configuration in the figure and listed below
includes four call-forwarding scenarios when call forwarding to the voice mail system is
configured with DTMF patterns set to 4, 5, 6, and 7, respectively. This also requires that the
Active Voice Reception system be configured with correct patterns accordingly.
pattern ext-to-ext no-answer
The Cisco CallManager Express router sends 5 to notify the voice mail system to play a
personal greeting for no answer when a call coming from one extension to another is forwarded
with no answer.
pattern ext-to-ext busy
The Cisco CallManager Express router sends 7 to notify the voice mail system to play a
personal greeting for busy when a call coming from one extension to another is forwarded
with busy.
pattern trunk-to-ext no-answer
The Cisco CallManager Express router sends 4 to notify the voice mail system to play a
personal greeting for no answer when a call coming from Foreign Exchange Office (FXO) to
an extension is forwarded with no answer.
pattern trunk-to-ext busy
The Cisco CallManager Express router sends 6 to notify the voice mail system to play a
personal greeting for busy when a call coming from FXO to an extension is forwarded
with busy.
7-34 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.07-9
The command vm-integration is used to enable DTMF integration and enter vm-integration
mode. From within vm-integration mode, the digits that will be forwarded when a user presses
the Messages or Envelope icon button can be configured with the command pattern direct
tag1.
Copyright 2005, Cisco Systems, Inc. Designing Cisco CallManager Express and Cisco Unity Express Networks 7-35
IPTX v2.07-10
There are four situations in which a call can be forwarded to a voice mail system. The first of
the four commands is pattern ext-to-ext no-answer tag1.This handles calls going from an
extension to another extension when no one answers. The second command is pattern ext-toext busy tag1. It is for when an extension calls another extension and the destination is busy.
Note
The tag must match an integration file setting on the voice mail system.
7-36 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.07-11
The third of the four commands is pattern trunk-to-ext no-answer tag1.This handles calls
going from a PSTN trunk to another extension when no one answers. The final command is
pattern trunk-to-ext busy tag1. It is for when a call from a PSTN trunk goes to an extension
while the destination is busy.
Note
The tag must match an integration file setting on the voice mail system.
Copyright 2005, Cisco Systems, Inc. Designing Cisco CallManager Express and Cisco Unity Express Networks 7-37
Summary
Summary
Integrating Cisco CallManagerExpress with CUE
requires configuration on both devices.
Cisco CallManagerExpress can be integrated with
Cisco Unity via the SCCP.
DTMF digits are used to integrate Cisco
CallManagerExpress with an analog voice mail.
7-38 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX v2.07-12
Module Summary
Module Summary
It is important to understand issues that may arise
in a Cisco CallManagerExpress deployment.
There are design concerns when integrating Cisco
CallManagerExpress with a Cisco Unity voice mail
system or a legacy voice mail system.
IPTX v2.07-1
References
For additional information, refer to the following resources:
Cisco CallManager Express Security Guide and Best Practices.
http://cisco.com/en/US/netsol/ns340/ns394/ns165/ns391/networking_solutions_design_gui
dance09186a00801f8e30.html.
Cisco CallManager Express 3.2: Integrating Voice Mail.
http://cisco.com/en/US/products/sw/iosswrel/ps5207/products_feature_guide_chapter09186
a00802d255e.html.
Copyright 2005, Cisco Systems, Inc. Designing Cisco CallManager Express and Cisco Unity Express Networks 7-39
Module Self-Check
Use the questions here to review what you learned in this module. The correct answers and
solutions are found in the Module Self-Check Answer Key.
Q1) What is the maximum number of voice ports that can be supported on a Cisco
CallManager Express system? (Source: Describing Deployment Scenarios and Design
Considerations)
A) 300
B) 800
C) 720
D) 750
Q2) What is the maximum number of users that can be supported by the Cisco CallManager
Express system? (Source: Describing Deployment Scenarios and Design
Considerations)
A) 120
B) 150
C) 175
D) 240
E) 250
Q3) When Cisco CallManager Express and Cisco Unity Express communicate with one
another across the backplane of the router in a collocated installation, what protocol is
used? (Source: Describing Deployment Scenarios and Design Considerations)
A) MGCP
B) SCCP
C) H323
D) SIP
Q4) When joining two VoIP calls together, or hairpinning, what is true regarding the codecs
that are used? (Source: Describing Deployment Scenarios and Design Considerations)
A) One call leg may be H.323 and the other SIP.
B) One call leg may be SIP and the other SCCP.
C) Both call legs must be SIP only.
D) It does not matter.
E) None of the above.
Q5) What is the primary responsibility of the gatekeeper in a Cisco CallManager Express
environment? (Source: Describing Deployment Scenarios and Design Considerations)
A) dial plan
B) CAC (Call Admission Control)
C) control all voice gateways
D) none of the above
7-40 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Q6) In a Cisco CallManager Express environment containing five sites, how many
gatekeeper routers will be required? (Source: Describing Deployment Scenarios and
Design Considerations)
A) 7
B) 5
C) 3
D) 1
Q7) What are the two ways that you can access the Cisco Unity server from the IP Phone?
(Choose two.) (Source: Deploying Voice Mail with Cisco CallManager Express)
A) Dial the extension of your voice mailbox.
B) Dial the Cisco Unity Auto Attendant.
C) Push the Messages button.
D) Use the 800 voice mail number.
Q8) When integrating with a traditional analog voice mail system, what is sent as DTMF
tones at the start of the call? (Choose all that apply.) (Source: Deploying Voice Mail
with Cisco CallManager Express)
A) calling number
B) called number
C) redirected number
D) CED
Q9) What type of port is used to connect to an analog voice mail from a voice-enabled
router? (Source: Deploying Voice Mail with Cisco CallManager Express)
A) Ethernet port
B) FXS port
C) FXO port
D) ATA 186 and 188
Copyright 2005, Cisco Systems, Inc. Designing Cisco CallManager Express and Cisco Unity Express Networks 7-41
Q2) D
Q3) D
Q4) A
Q5) B
Q6) D
Q7) A, C
Q8) A, B, C
Q9) B
7-42 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
IPTX
IP Telephony
Express
Version 2.0
Lab Guide
Text Part Number: 97-2197-01
IPTX
Lab Guide
Overview
This guide presents the instructions and other information concerning the activities for this
course. You can find the solutions in the activity Answer Key.
Outline
This guide includes these activities:
Lab 2-1: Configuring Cisco CallManager Express
Lab 3-1: Configuring PSTN Interfaces and Dial Peers
Lab 4-1: Configuring Additional Cisco CallManager Express Features
Lab 5-1: Configuring Cisco Unity Express Automated Attendant and Voice Mail
Lab 6-1: Configuring AutoQoS
Activity Objective
In this activity, you will set up the Cisco CallManager Express network. After completing this
activity, you will be able to meet these objectives:
Describe the firmware location and download process
Identify the DHCP setup command
Describe the process to set up IP Phones
Identify configuration commands of ephone-dn and ephone
Visual Objective
The figure illustrates what you will accomplish in this activity.
PodX
X000 X001
1000100180008001
Required Resources
These are the resources and equipment required to complete this activity:
Cisco CallManager Express router
Two Cisco IP Phones
Inline-power-capable switch
Student PC
IPTX v2.03
Command List
The table describes the commands used in this activity.
Command
Description
-- -
Disables
-- -
--
--
- -
-
-
- -
- -
-
-
- -
--
Lab Guide 3
Command
Description
Sets the TFTP server that will be assigned to the DHCP clients
- -
Loads the firmware to use for the 7960 and 7940 IP Phones
--
Creates an ephone-dn
Creates an ephone
--
--
Job Aids
These job aids are available to help you complete the lab activity.
Table 1
Pod
Hostname
of Cisco
CallManager
Express
Router
IP Address
on Fa0/0
Type
Pod
1
Option 150
Default
Router
IP Network
for DHCP
Pool
DHCP Pool
Exclusion
Lab Guide 5
Table 2
Pod
Voicemail Extension
Worksheets
These worksheets may be used to document and as a reference for Labs 2, 3, 4, and 5.
Completed versions of the worksheets appear at the end of the lab guide.
Number
Function
Applied to
Settings
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
Lab Guide 7
Destination
Pattern
Incoming
Called-number
Settings
1
2
3
4
5
6
7
8
Pod 1 Identity
Username
First Name
Last Name
Ephone
CME
Administrator
CME Administrator
CUE
Administrator
CUE Administrator
Customer
Administrator
CME Customer
Administrator
First user
Second user
Comments
Comments
Activity Procedure
Complete these steps:
Step 1
Step 2
Step 3
Step 4
Step 5
From the router(config)# prompt, enter the hostname of your router using the
hostname CMERouterX, where X is the pod number. Use Table 1 to verify your
configuration.
Step 6
Set an enable password of cisco by using the enable password cisco command
(please do not deviate from this password).
Step 7
Step 8
Enter the command line vty 0 4 to enter the line subconfiguration mode.
Step 9
Step 10
Step 11
Lab Guide 9
Step 12
Step 13
Enter the command line console 0 in order to enter the line subconfiguration mode.
Step 14
Step 15
Step 16
Step 17
Step 18
Enter the configuration mode for the Fast Ethernet interface 0/0.X0 by using the
command interface fastethernet 0/0.X0 (where X is the pod number).
Step 19
Step 20
From subinterface configuration mode, enter the IP address for the data VLAN from
Table 1 using the ip address 10.X0.0.1 255.255.255.0 command (where X is the pod
number).
Step 21
Enter the configuration mode for the Fast Ethernet interface 0/0.X5 by using the
command interface fastethernet 0/0.X5 (where X is the pod number).
Step 22
Step 23
From subinterface configuration mode, enter the IP address for the voice VLAN
from Table 1 using the ip address 10.X5.0.1 255.255.255.0 command (where X is
the pod number).
Step 24
Enter the configuration mode for the Fast Ethernet interface 0/0 by using the
command interface fastethernet 0/0.
Step 25
Step 26
Step 27
Step 28
Enter the command ip dhcp pool CMEDataX (where X is the pod number).
Step 29
Use the network 10.X0.0.0 255.255.255.0 command to set up the range of addresses
that will be used (where X is the pod number).
Step 30
Step 31
Step 32
Use the router eigrp 100 command to start an EIGRP process with an autonomous
system of 100.
Step 33
Enter the network 10.0.0.0 command to enable EIGRP on all 10.0.0.0 networks.
Step 34
A console message should appear indicating that an adjacency has been formed.
Step 35
Use the show ip route command to verify that EIGRP routes appear in the routing
table.
Step 36
Verify connectivity by pinging the 10.X0.0.2 address (where X is the pod number).
Step 37
Activity Verification
You have completed this task when you attain these results:
Verify the ability to ping the 10.X0.0.1 addresses of all other pods.
Verify that the configuration has been saved.
Activity Procedure
Complete these steps:
Step 1
The instructor will diagram the ports that are assigned to the two phones in the pods.
Step 2
Telnet to the switch by entering telnet 10.0.0.4 (if different, the instructor will give
the IP address).
Step 3
Step 4
Enter the command enable to enter privileged EXEC mode. The password is cisco.
Step 5
Use the command show running-config to view the configuration that is present on
your IP Phone ports.
Step 6
Step 7
Activity Verification
You have completed this task when you attain these results:
Verify that you can view the configuration on your assigned ports.
Verify that you can obtain the data and voice VLAN.
Lab Guide 11
Activity Procedure
Complete these steps:
Step 1
Step 2
Step 3
The file will be written to flash and will take a couple of minutes to complete.
Step 4
Use the show flash command to verify that the IOS file is present in flash memory.
Step 5
Step 6
Verify the version of IOS software running on your router by using the show
version command. The version should be 12.3(11) XL.
Step 7
Step 8
From privileged EXEC mode, enter the command archive tar /xtract
tftp://IP_Addr/cme-basic-123-11XL.tarflash: (where IP_Addr is the TFTP server
provided by your instructor). This is used to extract the Cisco CallManager Express
files from a tar file and put them in flash locally. The URL will be provided by the
instructor.
Step 9
Enter show flash to verify that files that were extracted are present in flash RAM.
Step 10
From privileged EXEC mode, enter the command archive tar /xtract
tftp://IP_Addr/7970-602sr1-5.tarflash: (where IP_Addr is the TFTP server
provided by your instructor). This is used to extract the firmware files for the Cisco
7970 IP Phone.
Step 11
Enter show flash to verify that files that were extracted are present in flash RAM.
Step 12
Activity Verification
You have completed this task when you attain these results:
Verify that the Cisco CallManager Express files are present in flash.
Verify that the version of IOS software is 12.3(11)XL.
You understand the base configuration after installation.
Activity Procedure
Complete these steps:
Step 1
Step 2
When prompted with the choice to set up the DHCP service, choose yes.
Step 3
The IP network of the DHCP pool will be 10.X5.0.0 (where X is the pod number).
Step 4
Step 5
The TFTP server will be the Cisco CallManager Express router with an IP address
of 10.X5.0.1 (where X is the pod number).
Step 6
The default router for the pool will also be 10.X5.0.1 (where X is the pod number).
Lab Guide 13
Step 7
Answer yes to the question, Would you like to start setting up the telephony
service?
Step 8
For the source IP address, enter 10.X5.0.1 (where X is the pod number).
Step 9
Step 10
Step 11
Step 12
Choose the language that is desired on the phone (if in the United States, the default
may be used just press the Enter key).
Step 13
Choose the country for call progress tones (if in the United States, the default may
be used just press the Enter key).
Step 14
Choose the first extension number that is desired (see Table 2). Example: X000 1
(where X is the pod number).
Step 15
Step 16
When asked for the full E.164 number, enter the value from Table 2 that is specific
for the pod.
Step 17
Step 18
Enter the extension number for voice mail that is in Table 2. Example: X999 1
(where X is the pod number).
Step 19
Press the Enter key to accept the default of 18 seconds for Call Forward timeout.
Step 20
When asked if you want to start the configuration setup over, enter NO when asked.
Click YES if any mistakes have been made and start this section of the lab over
again.
Step 21
Watch the console output to see if the phones register. Output similar to the
following should be seen on the terminal window. Mar 2 23:57:09.080:
%IPPHONE-6-REGISTER: ephone-1 :SEP000F2470F92E IP:10.15.0.11
Socket:1 DeviceType:Phone has registered.
Step 22
Step 23
From privileged EXEC mode, use the show running-config command and view the
changes made in the configuration, noticing the telephony service section in
particular.
Step 24
Step 25
Activity Verification
You have completed this task when you attain these results:
Verify that a call can be placed between the two IP Phones within the pod.
Verify that the configuration reflects the changes.
Activity Procedure
Complete these steps:
Step 1
Step 2
When prompted with the choice to set up the DHCP service, choose yes.
Step 3
The IP network of the DHCP pool will be 10.X5.0.0 (where X is the pod number).
Step 4
Step 5
The TFTP server will be the Cisco CallManager Express router with an IP address
of 10.X5.0.1 (where X is the pod number).
Step 6
The default router for the pool will also be 10.X5.0.1 (where X is the pod number).
Step 7
Answer yes to the question regarding starting the telephony service setup.
Step 8
For the source IP address, enter 10.X5.0.1 (where X is equal to the pod number).
Step 9
Step 10
Step 11
Step 12
Select the language that is desired on the phone (if in the United States, the default
may be used just press the Enter key).
Lab Guide 15
Step 13
Select the country for call progress tones (if in the United States, the default may be
used just press the Enter key).
Step 14
Select the first extension number that is desired (see Table 2). Example: X000 1
(where X is the pod number).
Step 15
Step 16
When asked for the full E.164 number, enter the value from Table 2 that is specific
for the pod.
Step 17
Step 18
Enter the extension number for voice mail that is in Table 2. Example: X999 1
(where X is equal to the pod number).
Step 19
Press the Enter key to accept the default of eighteen seconds for Call Forward
timeout.
Step 20
When asked if you want to start the configuration over again, enter NO when asked.
Select YES if any mistakes have been made and you wish to start this section of the
lab over again.
Step 21
Watch the console output to see if the phones register. Output similar to the
following should be seen on the terminal window. Mar 2 23:57:09.080:
%IPPHONE-6-REGISTER: ephone-1 :SEP000F2470F92E IP:10.15.0.11
Socket:1 DeviceType:Phone has registered.
Step 22
Notice that the IP Phone 7960 has registered and has dial tone when it goes off hook.
Step 23
From privileged EXEC mode, use the show running-config command and view the
changes made in the configuration, noticing the telephony-service section in
particular.
Step 24
Reload the router, and do not save the configuration, so that a manual configuration
can be completed in the next task.
Activity Verification
You have completed this task when you attain these results:
Verify that a call can be placed between the two IP Phones within the pod.
Verify that the configuration reflects the changes.
In this task, you will configure the Cisco CallManager Express router and IP Phones using the
manual and partially automated setup.
Activity Procedure
Complete these steps:
Step 1
From a terminal connection to the Cisco CallManager Express router, use the show
running-config | begin tele command to verify that the telephony service has not
been configured. If a configuration exists, use the no telephony-service command to
erase any configuration.
Step 2
Step 3
Set the time and date of the router with the command clock set. This will be relevant
in a later lab and needs to be set accurately to the local time and date.
Step 4
Step 5
Enter the command ip dhcp pool CMEVoiceX (where X is the pod number).
Step 6
Use the network 10.X5.0.0 255.255.255.0 command to set up the range of addresses
that will be used.
Step 7
Step 8
Enter the command option 150 ip 10.X5.0.1 to assign the TFTP server.
Step 9
Lab Guide 17
Step 10
Enter the show flash command from privileged EXEC mode and note the firmware
files present; for example: P00303020214.bin. Write down the firmware files
present in flash:
_________________________________________________________________
_________________________________________________________________
_________________________________________________________________
Step 11
Step 12
Use the command tftp-server flash: P00303020214.bin to allow the firmware files
to be accessed through the TFTP server.
Step 13
If using an IP Phone 7970, enter the following commands to serve up the five files
required by the IP Phones 7970: tftp-server flash:Jar70.2-8-0-104.sbn; tftp-server
flash:TERM70.6-0-2SR1-0-5s.loads; tftp-server
flash:TERM70.DEFAULT.loads; tftp-server flash:cnu70.62-0-1-6.sbn; and tftpserver flash:jvm70.602ES1R6.sbn
Step 14
Step 15
Enter the command max-ephones 2 (this will be sufficient for the classroom lab).
Step 16
Enter the command max-dn 20 (this will be sufficient for the classroom lab).
Step 17
Load the firmware and associate it with the IP Phone 7960 by entering the command
load 7960-7940 P00303020214 (Note: Do not put the firmware file suffix on the
end.)
Step 18
Load the firmware and associate it with the IP Phone 7970 by entering the command
load 7970 TERM70.6-0-2SR1-0-5s (Note: Do not put the firmware file suffix on
the end.)
Step 19
Next use the ip source-address 10.X5.0.1 port 2000 command (where X is the pod
number) to define the address where the Cisco CallManager Express router is
listening for registrations (Skinny messages).
Step 20
Set the time zone to your current location by using the command time-zone.
Step 21
Use the create cnf-files command to build XML configuration files that will be used
by the phones during the bootup process.
Step 22
Set the keepalive interval to ten seconds by entering the command keepalive 10.
Step 23
Use the command show running-config | begin tele to view the results of the
manual configuration.
Step 24
Activity Verification
You have completed this task when you verify that you have successfully configured the Cisco
CallManager Express router and phones using the manual and partially automated setup.
In this task, you will manually configure either an IP Phone 7970, if present, or one of two IP
Phones 7960 in the pod.
Activity Procedure
Complete these steps:
Step 1
Step 2
Step 3
Step 4
Add an ephone-dn for the first line appearance on the first phone in the pod by
entering the ephone-dn 1dual-line command.
Step 5
In ephone-dn mode, enter the number X000 command (where X is the pod number).
Step 6
Enter your name that will be associated with this directory number by using the
name firstname lastname command. Either make up a name or use a students name.
(example: name John Smith).
Step 7
Enter the command ephone 1 to enter ephone configuration mode for the first phone
in the pod.
Step 8
The MAC address is on a sticker on the bottom of the phone. In the space provided,
write down the MAC address of the phone:
_________________________________________________________________
Step 9
Now that the MAC address of the phone is known, assign it to the ephone 1 with the
mac-address H.H.H (where H is equal to four hex characters).
Step 10
Assign the ephone-dn to the ephone line with the button 1:1 command.
Step 11
Step 12
Step 13
Step 14
Verify that the phone has registered and that the proper directory number appears
with the line.
Step 15
Lab Guide 19
Step 16
Step 17
Activity Verification
You have completed this task when you verify that one of the two phones is configured.
In this task, you will complete the steps required for the Cisco CallManager Express system to
assign an ephone-dn to the ephone.
Activity Procedure
Complete these steps:
Step 1
Step 2
Use the number X001 command to add a directory number (where X is the pod
number).
Step 3
Step 4
Turn on the ability to auto-assign numbers by entering the command auto assign 2
to 2.
Step 5
Step 6
Step 7
Place a call from one phone to the other in the pod to verify the configuration.
Step 8
Activity Verification
You have completed this task when you attain these results:
Verify that both phones are configured and registered.
Verify that calls may be placed between the two phones in the pod.
-- -
-
-
-
-
--
--
-
-
-
-
-
-
-
-
--
-
-
--
--
-
--
-
--
--
Copyright 2005, Cisco Systems, Inc.
Lab Guide 21
-
--- -
- -
- --
- --- --
- --
- -
-
-
---
--
- --
-
--
--
-- -
-
-
-
-
-- -
-
Activity Objective
In this activity, you will configure analog voice interfaces, digital voice interfaces, and dial
peers to set up VoIP communications. After completing this activity, you will be able to meet
these objectives:
Configure the analog ports on the router
Configure POTS dial peers for analog ports
Configure digital ports
Configure digital dial peers for digital ports
Configure VoIP dial peers to other pods
Configure COR
Visual Objective
The figure illustrates what you will accomplish in this activity.
Pod 1
PSTN
Pod 2
Pod 7
Pod 8
Pod 3-6
202-555-9000
...
207-555-9000
201-555-9000208-555-9000
IPTX v2.04
Lab Guide 23
Required Resources
These are the resources and equipment required to complete this activity:
One analog phone with RJ-11 cable
Serial cable for the Frame Relay connection
RJ-11 cable to connect to the PSTN
Worksheets from Lab 2 or completed form from end of the Lab Guide
Command List
The table describes the commands used in this activity.
Command
Description
- -
Sets the WAN interface card (WIC) to get the clock from the
router
Enters T1 interface
--
- -
Command
Description
- - --
Shows the ISDN switch type and the status of Layers 1, 2, and 3
-
-
-
-
--
Enables an interface
---
-
-
-
-
-
-
Lab Guide 25
Job Aids
These job aids are available to help you complete the lab activity.
Table 3
Pod
Dial Plan
Extension Numbers
Voice-Mail
Extension
Activity Procedure
Complete these steps:
Step 1
Plug the analog phone into the lowest-numbered FXS port. Write down the port
number here:
_________________________________________________________________
Step 2
Pick up the handset of the analog phone to verify that you can hear a dial tone.
Step 3
Attempt to dial one of the two IP Phones from the analog phone. Was the call
successful?
Step 4
At the command line on the Cisco CallManager Express router, enter privileged
EXEC mode by entering enable. If asked for a password, use cisco.
Step 5
Step 6
From global configuration mode, enter the voice port by using the voice-port fxsport-that-analog-phone-is-plugged-into.
Step 7
From voice-port mode, enter the command cptone AU to set the call progress tones
to Australia.
Step 8
Set the ring cadence with the command ring cadence pattern11.
Step 9
Place a call to an IP Phone and note that the call progress tones have changed.
Step 10
Activity Verification
You have completed this task when you attain these results:
Verify that you can place a call to an IP Phone from the analog phone.
Verify that the call progress tones have been changed and verified.
Verify that the ring cadence has been changed (although not verified yet).
Verify that the FXO port is configured to answer the call after three rings.
Copyright 2005, Cisco Systems, Inc.
Lab Guide 27
Task 2: Configuring an FXS Port and Dial Peers for the Local
Analog Phone
In this task, you will configure the dial peers that allow connections to the analog phone and
calls to and from the PSTN.
Activity Procedure
Complete these steps:
Step 1
Ensure that an analog phone is plugged into the lowest-numbered FXS port on the
router.
Step 2
Step 3
Step 4
Step 5
Call the analog phone from one of the two IP Phones and verify functionality.
Activity Verification
You have completed this task when you attain this result:
Verify that a call can be placed from the IP Phone to the analog phone and vice versa
within the pod.
Activity Procedure
Complete these steps:
Step 1
Ensure that you can make a connection to the lowest-numbered FXO port on the
router to the PSTN simulator assigned by your instructor.
Step 2
From global configuration mode, use the command voice-port mod/port to enter the
configuration for the FXO port.
Step 3
Enter the ring number 2 command to set the port to answer after two rings.
Step 4
Create an analog dial peer with the command dial-peer voice 2 pots.
Step 5
Use the command destination-pattern 120.5550... to set the digits that will match
this dial peer.
Step 6
Use the command port mod/port to associate the lowest FXO port with this dial
peer.
Step 7
Enter forward-digits all to forward all the digits to the PSTN (because POTS dial
peers consume digits).
Step 8
Step 9
Wait for your partner pod to get to this step before proceeding to the next.
Step 10
From one of your phones, dial 120Y-555-0000 (where Y is the number of your
partner pod). Pods 1 and 2 will be partners, Pods 3 and 4 will be partners, Pods 5 and
6 will be partners, and Pods 7 and 8 will be partners.
Step 11
You will hear a second dial tone after two rings; this is the default dial peer.
Step 12
Dial the extension number of one of the two IP Phones of your partner pod.
Step 13
Step 14
Step 15
Enter the lowest FXO voice port by using the command voice-port mod/port.
Step 16
Step 17
Step 18
Wait for your partner pod to get to this step before proceeding to the next.
Step 19
From one of your phones, dial 120Y-555-9000 (where Y is the number of your
partner pod). Pods 1 and 2 will be partners, Pods 3 and 4 will be partners, Pods 5 and
6 will be partners, and Pods 7 and 8 will be partners.
Step 20
Step 21
Lab Guide 29
Activity Verification
You have completed this task when you attain these results:
Verify that a call can be placed across the PSTN to another pod.
Verify that a PLAR connection on the analog line sends the call to the lowest IP Phone in
the partner pod.
Activity Procedure
Complete these steps:
Step 1
Step 2
From global configuration mode, use the command isdn switch-type primary-ni to
set the PRI switch type (if instructed use a different switch type).
Step 3
Step 4
From global configuration mode, enter controller T1 module/port for the lowest T1
interface(if using E1 equipment, use E1 instead of T1).
Step 5
In T1 controller mode, enter the command framing esf (use framing crc4 if
configuring an E1) to set the framing used.
Step 6
In T1 controller mode, enter the command linecode b8zs (use linecode hdb3 if
configuring an E1)to set the line code.
Step 7
Set the clock to the line with the clock source line command.
Step 8
Use the command pri-group timeslots 1-24 (use pri-group timeslots 1-30 if
configuring an E1) to assign all the channels to the PRI.
Step 9
The B channels should go up and you should see messages to that effect on the
console.
Step 10
Step 11
Use the show interface serial mod/port:23 command to verify that the interface is
up and up.
Step 12
Use the command show isdn status and verify that Layer 1 is ACTIVE and that
Layer 2 shows MULTIPLE_FRAME_ESTABLISHED.
Step 13
Wait for your partner pod to get to this step before proceeding to the next.
Step 14
Using your analog phone, dial 120Y-555-9000 (where Y is the number of your
partner pod). Pods 1 and 2 will be partners, Pods 3 and 4 will be partners, Pods 5 and
6 will be partners, and Pods 7 and 8 will be partners.
Step 15
Step 16
Make a dial peer by entering dial-peer voice 3 pots from global configuration
mode.
Step 17
Step 18
Step 19
From within dial-peer submode, enter the command port mod/port:23 to specify the
physical interface that will be assigned to the dial peer.
Step 20
Step 21
Wait for your partner pod to get to this step before proceeding to the next.
Step 22
Using your analog phone, dial 120Y-555-9000 (where Y is the number of your
partner pod). Pods 1 and 2 will be partners, Pods 3 and 4 will be partners, Pods 5 and
6 will be partners, and Pods 7 and 8 will be partners.
Step 23
Step 24
When a second dial tone is heard, dial the extension Y000 (where Y is the number of
your partner pod).
Step 25
Step 26
Step 27
Step 28
Step 29
Use the command dial-peer voice 4 pots to create and enter dial-peer configuration
mode.
Step 30
Enter the command incoming called-number 20X5559 to set the pattern that will
match the incoming call to this dial peer.
Lab Guide 31
Step 31
Enter the command port mod/port:23 to assign the dial peer to the PRI.
Step 32
Step 33
Step 34
Wait for your partner pod to get to this step before proceeding to the next.
Step 35
Using a phone, dial 120Y-555-9000 (where Y is the number of your partner pod).
Pods 1 and 2 will be partners, Pods 3 and 4 will be partners, Pods 5 and 6 will be
partners, and Pods 7 and 8 will be partners.
Step 36
Step 37
Verify that the DID for both IP Phones in your partner pod works.
Activity Verification
You have completed this task when you attain these results:
Verify that calls across the PSTN using the PRI connection work.
Verify that DID works for the two IP Phones.
Activity Procedure
Complete these steps:
Step 1
In this lab, Pod 1 and Pod 3 will partner, Pod 2 and Pod 4 will partner, Pod 5 and
Pod 7 will partner, and Pod 6 and Pod 8 will partner.
Step 2
Ensure that a serial cable is connected to the lowest serial interface on your router
terminating on the lowest serial interface on the router of your partner pod.
Step 3
Use the show controller serial mod/port for the lowest serial interface and notice if
the cable is a DCE or DTE.
Step 4
Step 5
If your pod has the DCE end of the cable, use the command clock rate 115200 to set
the clock rate of the lowest serial interface.
Step 6
Leave the encapsulation at the default of HDLC unless instructed otherwise by your
instructor.
Step 7
Step 8
Step 9
Step 10
Step 11
Wait for your assigned partner pod to complete the previous steps.
Step 12
Verify connectivity by using ping to test. Enter ping 10.100.0.X (where X is the pod
number).
Step 13
Attempt to dial the four-digit extension number of one of the phones in your
partners pod.
Step 14
Step 15
Step 16
Make a new dial peer with the command dial-peer voice 5 voip.
Step 17
To associate a pattern with the dial peer, use the destination-pattern Y... (where Y is
the number of your partner pod). For example, Pod 1s partner for this task is Pod 3,
so Y would be equal to 3 and you would enter destination pattern 3...
Step 18
Instead of a port command, use the command session target ipv4:10.10Z.0.Y (where
Z is the lowest pod number of the two pods and Y is the number of your partners
pod).
Step 19
Hardcode the codec that is to be used by entering the command codec g711ulaw.
Step 20
Step 21
Dial a four-digit extension number of one of the phones in your partner s pod and
stay connected.
Lab Guide 33
Step 22
Step 23
Step 24
Coordinating with your partner pod, place a second simultaneous call between the
pods using a four-digit extension. This will force two calls on the WAN link.
Step 25
Step 26
Verify that the codec is G.711 by quickly clicking the blue i or the question mark
button (depending on the model of phone) on the IP Phones twice while the calls are
connected.
Step 27
Step 28
Step 29
Make a new dial peer with the command dial-peer voice 5 voip.
Step 30
Step 31
Step 32
Coordinate with your partner to place two simultaneous calls across the WAN link
by dialing the four-digit extensions.
Step 33
Step 34
Verify that the codec is G.729 by quickly clicking the blue i or the question mark
button (depending on the model of phone) on the IP Phones twice while the calls are
connected.
Step 35
Activity Verification
You have completed this task when you attain these results:
Verify that you can place calls to your partner across the WAN by dialing a four-digit
extension.
Verify that the quality of the second call across the WAN link at the same time when using
G.711 is poor due to lack of bandwidth.
Verify that the codec is set to G.729 and you can place two calls across the WAN link
simultaneously.
Visual Objective
The figure illustrates what you will accomplish in this activity.
VoIP over
WAN
PSTN
IPTX v2.05
Lab Guide 35
Activity Procedure
Complete these steps:
Step 1
Step 2
From global configuration mode, enter the command dial-peer cor custom to enter
the COR mode.
Step 3
Step 4
Step 5
Step 6
Step 7
Define a COR list by entering the command dial-peer cor list callAnalog.
Step 8
Put a member in the COR list with the command member Analog.
Step 9
Step 10
Define a COR list by entering the command dial-peer cor list callPRI.
Step 11
Put a member in the COR list with the command member PRI.
Step 12
Step 13
Define a COR list by entering the command dial-peer cor list callWAN.
Step 14
Put a member in the COR list with the command member WAN.
Step 15
Step 16
Define a COR list by entering the command dial-peer cor list Type1.
Step 17
Put a member in the COR list with the command member WAN.
Step 18
Step 19
Define a COR list by entering the command dial-peer cor list Type2.
Step 20
Put the first of two members in the COR list with the command member WAN.
Step 21
Put the second of two members in the COR list with the command member Analog.
Step 22
Step 23
Step 24
Assign an outbound COR list to the dial peer with the command corlist outgoing
callAnalog.
Step 25
Step 26
Step 27
Assign an outbound COR list to the dial peer with the command corlist outgoing
callPRI.
Step 28
Step 29
Step 30
Assign an outbound COR list to the dial peer with the command corlist outgoing
callWAN.
Step 31
Step 32
Step 33
Step 34
Step 35
Step 36
Assign an outbound COR list to the dial peer with the command cor incoming
Type2.
Step 37
Test the COR settings by attempting to dial a partner pod over the WAN, over the
analog connection to the PSTN, and over the PRI connection to the PSTN. Test on
all three phones.
Step 38
When the test is successful, reload the router, making sure you do not save the
configuration.
Activity Verification
You have completed this task when you attain these results:
Verify that the ephone-dn 1 can call the partner pod over the WAN link but is not able to
call over the PSTN by either the analog or PRI connection.
Verify that the ephone-dn 2 can call over the WAN, analog, and PRI to another pod.
Verify that the analog phone can call another pod over the WAN or an analog connection
but not over the PRI.
Lab Guide 37
-- -
-
-
-
-
--
--
-
- -
-
--
-
-
-
-
-
-
--
-
-
--
--
-
--
-
--
38 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
-- -
-
--
-
--- -
- -
- --
- --
- --
- -- --
-
-
-
-
-
-
-
-
-
-
-
-
-
-
---
Copyright 2005, Cisco Systems, Inc.
Lab Guide 39
-
-
---
--
- --
- -
-
--
--
-- -
-
-
-
-
-- -
-
Complete this lab activity to practice what you learned in the related module.
Activity Objective
In this activity, you will configure additional Cisco CallManager Express system features. After
completing this activity, you will be able to meet these objectives:
Configure and use the GUI system administrator interface
Configure and use the GUI customer administrator interface
Configure and use the GUI phone user
Configure call transfer and call forward
Customize softkey layout
Configure Ephone hunt groups
Configure the B-ACD Service
Configure the IP Phone display
Configure an intercom
Configure paging groups
Configure and use the Acct softkey button
Visual Objective
The figure illustrates what you will accomplish in this activity.
Use to test
paging groups
X100
Sales Paging
Group
Emergency
Paging Group
Support
Paging Group
X000X001
Intercom between X000 and X001
IPTX v2.06
Lab Guide 41
Required Resources
These are the resources and equipment required to complete this activity:
A properly configured Cisco CallManager Express router
Two IP Phones
One analog phone
Student PC with Windows and IE 5.5 or greater
Worksheets from Lab 2 or completed form from end of the Lab Guide
Command List
The table describes the commands used in this activity.
Command
Description
- -
--
- --
-
-
- --
-
- -
10.X0.0.2
-
-
-
-
- -
-- --
---
-
Command
Description
-
-
-
--
-
--
- -
-- --
Lab Guide 43
Command
Description
- -
Job Aids
These job aids are available to help you complete the lab activity.
Table 4
Pod
Ephone
Extensi
on
First Name
Last Name
Username
Task 1: Configuring and Using the GUI Interface for the System
Administrator
In this task, the system administrator will be defined and the GUI web pages made available.
Activity Procedure
Complete these steps:
Step 1
Step 2
Enter the command ip http server to enable the web server on the Cisco
CallManager Express router.
Step 3
Enter the command ip http path flash: to define the location of the HTML files.
Step 4
Step 5
Enter ip http authentication local to ensure that credentials will be defined locally
on the router.
Step 6
Step 7
From telephony service mode, enter the command web admin system name IPTX
password cisco.
Step 8
Enter the command dn-webedit to allow changes to the directory number through
the web interface.
Step 9
Enter the command time-webedit to allow the Cisco CallManager Express time to
be set from the web interface.
Step 10
Step 11
Lab Guide 45
Step 12
Step 13
Step 14
When asked for credentials, use IPTX for the username and cisco for the password.
Step 15
From the Configure drop-down menu, choose Extensions and view the currently
configured extensions.
Step 16
Add a new extension with an extension number of X002 (where X is the pod
number) and leave the other setting at default.
Step 17
Step 18
From the Configure drop-down menu, choose Phones and view the currently
configured phones.
Step 19
Click the 2 link of one of the 7960 phones and add the extension that you just
defined to the second button of the phone.
Step 20
Add a speed dial number to the first speed dial field that is empty on the IP Phone
7960 (further down in the web page).
Step 21
Step 22
Step 23
From the System Parameters page, notice the different selections that are available.
Step 24
Notice the settings that may be changed and configured from this page.
Step 25
Use the Date and Time Format object to change the format displayed on the phone
to a nondefault format.
Step 26
Reset the two IP Phones by choosing the Configure >Phones menu. Use the Reset
All link to reset the phones.
Step 27
Step 28
Under the Directory Service object, choose Name Schema and notice the two
choices.
Step 29
Activity Verification
You have completed this task when you attain these results:
Verify that you can successfully access the GUI as the system administrator.
Verify that you can successfully add an extension and assign it to one of the IP Phones.
Verify that you can successfully change the time of the Cisco CallManager Express router
from the GUI.
Verify that you can successfully change the format of the date and time.
Activity Procedure
Complete these steps:
Step 1
Step 2
Change the Admin User Type to Customer and change the Admin User Name from
Customer to IPTXCust (remember that usernames are case sensitive).
Step 3
Step 4
Click the Change button and click OK when a popup window appears.
Step 5
Close the browser window and go to the CLI of the Cisco CallManager Express
router.
Step 6
Step 7
Step 8
Notice the web admin customer name IPTXCust password cisco line.
Step 9
Step 10
Go back to the GUI web page by using the URL http://10.X0.0.1/ccme.html (where
X is the pod number).
Step 11
When asked for credentials, use IPTXCust for the username and cisco for the
password.
Step 12
Notice that the level of access is exactly the same as the system administrator.
Step 13
Step 14
Lab Guide 47
Step 15
Step 16
Step 17
Go back to the student PC and start a command prompt by clicking the Start button
and choosing Run.In the Open line of the Run dialog, enter cmd, and then Enter. A
command prompt should appear. From the command line, enter cd c:\, which will
change the location to the root of the C drive. Open an FTP session to the classroom
router or a location specified by your instructor. The classroom server can be
reached by entering ftp IP_address. When asked for credentials, use the username
IPTX and the password cisco.
Step 18
Use the get xml.template command to download the file from the Cisco
CallManager Express router to the student PC.
Step 19
Step 20
Using a text editor, open the xml.template file on the root of the C drive of the
student PC.
Step 21
Using another instance of a text editor, open the newTemplate.xml file found on the
root of the C drive.
Step 22
Step 23
Go back to the terminal window and enter the copy tftp:// IP_address
/newTemplate.xml flash: command. Do not erase the contents of flash! This will
put a copy of the modified template on the local Cisco CallManager Express router.
Step 24
Enter the show flash command to verify that the newTemplate.xml file is present.
Step 25
Step 26
Step 27
Step 28
Step 29
When prompted to log in, use the username IPTXCust and password cisco.
Step 30
Step 31
Activity Verification
You have completed this task when you attain these results:
Verify that the ability to log in as the customer administrator is enabled.
Verify that the customer administrator has restricted access to the GUI web interface.
Task 3: Configuring and Using the GUI Interface for the Phone
User
In this task, you will configure an IP Phone user set of credentials.
Activity Procedure
Complete these steps:
Step 1
Step 2
When prompted to log in, enter the username IPTX and password cisco. These are
the system administrator credentials.
Step 3
Step 4
Click the link for IP Phone 1 and add the assigned username from Table 4 and the
password cisco to the Login Account area.
Step 5
Click the Change button to commit the new username and password.
Step 6
Save the changes by choosing the Administration >Save Router Config menu.
Step 7
Step 8
Go to a terminal window to access the CLI of the Cisco CallManager Express router.
Step 9
Enter the command show running-config | begin ephone to view the changes made
through the GUI web interface.
Step 10
Notice under the ephone that the line username username password cisco has
changed.
Step 11
Step 12
From global configuration mode, enter the command ephone 2 to enter ephone
configuration mode.
Step 13
Enter the command username username password cisco to configure a phone user
for the second phone (the assigned username is in Table 4).
Step 14
Step 15
Lab Guide 49
Step 16
Step 17
Step 18
Notice that the interface is has fewer options than when logged in as the
administrator.
Activity Verification
You have completed this task when you attain these results:
Verify that you can successfully log into the GUI as a phone user.
Verify that both phones have a phone user associated with them.
Activity Procedure
Complete these steps:
Step 1
Step 2
Using the Trnfer softkey button (this is one of the buttons along the bottom of the
screen on the IP phone), enter the extension of the other IP Phone.
Step 3
Step 4
Step 5
Step 6
Step 7
Step 8
Step 9
Step 10
Step 11
Use the Trnfer softkey button and enter the extension of the other IP Phone.
Step 12
Notice that the call is not automatically transferred. In fact, the caller (analog phone)
is on hold.
Step 13
Answer the transfer target IP Phone and from the IP Phone that initiated the transfer,
press the Trnfer softkey button a second time to complete the transfer.
Step 14
From one of the IP Phones in the pod, press the CFwdAll softkey button, and then
enter the number of the other IP Phone followed by the pound ( #) key. This is to
forward all calls to the other IP Phone.
Step 15
From the analog phone, call the number of the first IP Phone. The call should be
forwarded.
Step 16
Step 17
Step 18
Enter the command call-forward max-length 0 to disable call forwarding from the
IP Phone.
Step 19
From the IP Phone with ephone-dn 1 assigned to it, press the CFwdAll softkey
button. Is the behavior the same as it was before? Notice that call forwarding can no
longer be set in this way.
Step 20
Log on to the GUI web interface as a phone user and configure call forward all, call
forward busy, and call forward no answer. Notice that the user can still configure
forward settings from the GUI even though the call-forward max-length 0 is set.
Step 21
Activity Verification
You have completed this task when you attain these results:
Verify that a call can be transferred.
Verify that call forward all, call forward busy, and call forward no answer have been
successfully configured.
Lab Guide 51
Activity Procedure
Complete these steps:
Step 1
Place a call between the two IP Phones and, when the call is connected, view the
softkeys that are present and their order. Write down the order here:
____________________________________________________________________
Step 2
Step 3
In ephone template mode, use the command softkey connected Acct Endcall Flash
Hold Trnsfer to exclude the Confrn softkey.
Step 4
Step 5
Enter the ephone configuration mode by using the command ephone 2 (This should
be a Cisco 7960 IP Phone).
Step 6
From ephone configuration mode, use the command ephone-template 1 to apply the
template to the ephone.
Step 7
Reset the phone by either pressing **#** on the keypad or typing reset from ephone
configuration mode.
Step 8
Step 9
Once the IP Phone has reset, place a call and note the order, and the lack of a Confrn
softkey.
Step 10
With the second IP Phone on hook, notice the softkeys present and their order.
Document the order here:
____________________________________________________________________
Step 11
Step 12
In ephone template mode, enter the command softkey idle Dnd Redial Newcall
Pickup Gpickup Login to change the order of the softkeys.
Step 13
Step 14
Enter the ephone configuration mode by using the command ephone 1 (This should
be a Cisco 7970 IP Phone if present, or a 7960 IP Phone if no 7970 is being used).
Step 15
From ephone configuration mode, use the command ephone-template 2 to apply the
template to the ephone.
Step 16
Reset the phone by either pressing **#** on the keypad or typing reset from ephone
mode.
Step 17
Step 18
Notice the order of the softkeys when the IP Phone is finished resetting.
Step 19
Activity Verification
You have completed this task when you attain these results:
Verify that the softkey template is applied to the ephone.
Verify that the order of the softkeys has been changed.
Activity Procedure
Complete these steps:
Step 1
Step 2
Step 3
Step 4
Assign the ephone-dn to button 2 of the ephone with the command button 1:1 2:3
3:4.
Step 5
Step 6
Step 7
Step 8
Assign the ephone-dn to button 2 of the ephone with the command button 1:2 2:5.
Step 9
Now create a sequential hunt group with the command ephone-hunt 1 sequential.
Step 10
In ephone hunt configuration mode, enter a pilot of X200 with the command pilot
X200 (where X is the pod number).
Lab Guide 53
Step 11
Create the order of the sequential hunt group by using the list X000, X002, X010,
X001, X011 command.
Step 12
Set the amount of time the call will ring on each line before redirecting to the next
number in the list to five seconds by using the command timeout 5.
Step 13
Step 14
From the analog phone in your pod, call the pilot number of X200 and answer the
call immediately on the first line that rings. Which line rang? _____________
Step 15
From the analog phone in your pod, call the pilot number of X200 and answer the
call immediately on the first line that rings. Which line rang? _____________
Step 16
From the analog phone in your pod, call the pilot number of X200 and do not answer
the call immediately on the first line that rings. What order do the lines ring in?
___________________________________________________________________
Step 17
Now create a longest idle hunt group with the command ephone-hunt 2 longestidle.
Step 18
In ephone hunt configuration mode, enter a pilot of X201 with the command pilot
X201 (where X is the pod number).
Step 19
Create the order of the sequential hunt group by using the list X000, X001, X010,
X011 command.
Step 20
Set the time the call will ring on each line before redirecting to the next number in
the list to five seconds by using the command timeout 5.
Step 21
Step 22
From the analog phone in your pod, call the pilot number of X201 and answer the
call immediately on the first line that rings. Which line rang? _____________
Step 23
From the analog phone in your pod, call the pilot number of X201 and answer the
call immediately on the first line that rings. Which line rang? _____________
Step 24
From the analog phone in your pod, call the pilot number of X201 and answer the
call immediately on the first line that rings. Which line rang? _____________
Step 25
From the analog phone in your pod, call the pilot number of X201 and answer the
call immediately on the first line that rings. Which line rang? _____________
Step 26
On one of the two IP Phones, use the DND softkey to put the IP Phone in the DND
state.
Step 27
From the analog phone in your pod, call the pilot number of X201 and answer the
call immediately on the first line that alerted. Which line rang? _____________
Step 28
From the analog phone in your pod, call the pilot number of X201 and answer the
call immediately on the first line that alerted. Which line rang? _____________
Step 29
From the analog phone in your pod, call the pilot number of X201 and answer the
call immediately on the first line that alerted. Which line rang? _____________
Step 30
From the analog phone in your pod call the pilot number of X201 and answer the
call immediately on the first line that alerted. Which line rang? _____________
Step 31
Remove the DND state from the phone by pressing the DND softkey.
Step 32
Now create a sequential hunt group with the command ephone-hunt 3 peer.
Step 33
In ephone hunt configuration mode, enter a pilot of X202 with the command pilot
X202 (where X is the pod number).
Step 34
Create the order of the peer hunt group by using the list X000, X002, X010, X001,
X011 command.
Step 35
Set the time the call will ring on each line before redirecting to the next number in
the list to five seconds by using the command timeout 5.
Step 36
Step 37
From the analog phone in your pod, call the pilot number of X202 and answer the
call immediately on the first line that rings. Which line rang? _____________
Step 38
From the analog phone in your pod, call the pilot number of X202 and answer the
call immediately on the first line that rings. Which line rang? _____________
Step 39
From the analog phone in your pod, call the pilot number of X202 and answer the
call immediately on the first line that rings. Which line rang? _____________
Step 40
From the analog phone in your pod, call the pilot number of X202 and answer the
call immediately on the first line that rings. Which line rang? _____________
Step 41
Return to the first configured hunt group by using the command ephone-hunt 1
sequential.
Step 42
Step 43
From the analog phone in your pod, call the pilot number of X200 and do not answer
the call until X001 is ringing.
Step 44
From the analog phone in your pod, call the pilot number of X200 and do not answer
the call. What is the order that is used by the hunt group?
__________________________________________________________________
Step 45
Notice that ephone 1 is in the DND state. Remove the DND and call the pilot
number of X200 again.
Activity Verification
You have completed this task when you attain these results:
Verify that ephone hunt groups function.
Verify the auto logout functions.
Lab Guide 55
Activity Procedure
Complete these steps:
Step 1
From privileged EXEC mode, use the command archive tar /xtract
ftp://ftp_ip_address/cme-b-acd-IPTXcustomprompts.tar flash: to extract the two
TCL scripts and the seven audio files to flash on the CallManager Express router.
Step 2
Use the command show flash to verify that all nine files are present in flash.
Step 3
Load the automated attendant TCL script from global configuration mode by using
the command call application voice aa flash:app-b-acd-aa-2.0.0.0.tcl . A read
succeeded message should be sent to the console.
Step 4
Set the pilot number of the automated attendant application to X300 by using the call
application voice aa aa-pilot X300 command (where X is the pod number).
Step 5
Set the call retry setting to try and connect the caller every 15 seconds with the call
application voice aa call-retry-timer 15 command.
Step 6
Set the time before the caller hears the second greeting to 30 seconds with the call
application voice aa second-greeting-time 30 command.
Step 7
Set the maximum time in queue to 60 seconds with the command call application
voice aa max-time-call-retry 60.
Step 8
Set the maximum number of times that transferring to voice mail may be attempted
to two with the command call application voice aa max-time-vm-retry 2.
Step 9
Associate the name of the call queuing application with the automated attendant
using the command call application voice aa service-name queue.
Step 10
Set the zero out to operator function by using the call application voice aa operator
X100 command (where X is the pod number).
Step 11
Define which option will be used to dial an extension with the call application
voice aa dial-by-extension-option 1 command.
Step 12
Set the voice mail extension with the command call application voice aa voicemail X900.
Step 13
Set the number of hunt groups to three with the command call application voice aa
number-of-hunt-grps 3.
Step 14
Assign the language with the command call application voice aa language 1 en.
Step 15
Set the language to English with the command call application voice aa setlocation en 0 flash:
Step 16
Define the call queuing TCL script with the command call application voice queue
flash:app-b-acd-2.0.0.0.tcl.
Step 17
Set the call queue length to ten callers with the command call application voice
queue queue-len 10.
Step 18
Set option 2 in the menu to use hunt group X200 with the command call application
voice queue aa-hunt3 X200.
Step 19
Set option 3 in the menu to use hunt group X201 with the command call application
voice queue aa-hunt4 X201.
Step 20
Set the option 4 in the menu to use hunt group X202 with the command call
application voice queue aa-hunt2 X202.
Step 21
Set the number of hunt groups to three with the command call application voice
queue number-of-hunt-grps 3.
Step 22
Associate the automated attendant name with the call queuing application with the
command call application voice queue aa-name aa.
Step 23
Enable debugging of the B-ACD scripts with the command call application voice
queue queue-manager-debugs 1.
Step 24
Make a new dial peer by using the command dial-peer voice 6 pots.
Lab Guide 57
Step 25
In dial peer mode, enter the command application aa to associate the B-ACD
service to the dial peer.
Step 26
In dial peer mode, enter the command incoming called-number X300 to match the
call incoming.
Step 27
Use the command port module/submodule/port to associate the physical port to the
dial peer (Use the lowest numbered FXS port which should currently have your
analog phone attached).
Step 28
Step 29
Create a loopback interface that will be used for a VoIP dial peer by entering the
command interface loopback 0.
Step 30
In loopback interface mode, assign an IP address to the interface with the command
ip address 10.X1.0.1 255.255.255.0 (where X is the pod number).
Step 31
Step 32
Make a new dial peer by entering the command dial-peer voice 7 voip.
Step 33
In dial peer mode, enter the command application aa to associate the B-ACD
service to the dial peer.
Step 34
In dial peer mode, enter the command incoming called-number X300 to match the
call incoming.
Step 35
Step 36
Point to the loopback IP address with the command session target ipv4:10.X1.0.1.
Step 37
Step 38
Step 39
Step 40
Step 41
Pick up the analog phone in your pod and place a call to the pilot number of X300
and verify that the B-ACD service automated attendant answers the call.
Step 42
Use the command show call application session to verify that the application has
been invoked.
Step 43
Explore the menu options making sure to go to an ephone hunt group with agents
and then to an ephone hunt group with all agents in the DND state.
Step 44
Turn on debugging of the B-ACD service by using the command debug voip ivr
script.
Step 45
Activity Verification
You have completed this task when you attain these results:
Verify that calls to the pilot number of the B-ACD service are answered by the automated
attendant.
Verify that the automated attendant presents the menus to the callers.
Verify that the menus work and transfer calls to the ephone hunt groups.
Verify that when all phones are in the DND state, any calls to that hunt group are queued
by the call queuing of the B-ACD service.
Activity Procedure
Complete these steps:
Step 1
Step 2
Step 3
Step 4
Enter the command ephone-dn 8 to create an ephone for use as a call park slot.
Step 5
Step 6
Use the command park-slot timeout 10 limit 3 to set a reminder after ten seconds
and to terminate the call after three reminders.
Step 7
Reset the IP Phones by using the keys on the IP Phones to enter **#**.
Step 8
From the analog phone, call one of the IP Phones and answer the call.
Step 9
Use the More softkey button to find and press the Park softkey button.
Step 10
Wait ten seconds. What do you hear on the analog phone and on the IP Phone?
Step 11
Step 12
From the analog phone, call one of the IP Phones and answer the call.
Step 13
Use the More softkey button to find and press the Park softkey button.
Lab Guide 59
Step 14
From the second IP Phone, use the More softkey button to find and press the
PickUp softkey button. When a dial tone is heard, dial X400 to retrieve the parked
call.
Step 15
Step 16
From the analog phone, call one of the IP Phones and answer the call.
Step 17
Use the More softkey button to find and press the Park softkey button.
Step 18
From the IP Phone that parked the call, use the More softkey button to find and
press the PickUp softkey button. When a dial tone is heard, dial * to retrieve the
call.
Step 19
From the analog phone, call one of the IP Phones and answer the call.
Step 20
Use the Trnsfr softkey button to transfer the call to the extension number X400.
Step 21
From the second IP Phone, use the More softkey button to find and press the
PickUp softkey button. When a dial tone is heard, dial X400 to retrieve the parked
call.
Step 22
Activity Verification
You have completed this task when you verify that the call park functions properly.
Activity Procedure
Complete these steps:
Step 1
Step 2
Step 3
On the System Parameters page, highlight the System Message object and enter a
message of IPTX Classroom.
Step 4
Go to a terminal and enter the CLI of the Cisco CallManager Express router.
Step 5
Step 6
Enter the ephone configuration mode for the first IP Phone by using the ephone-dn
1 command.
Step 7
Enter the description Phone1 command to set the label on the IP Phone header bar.
Step 8
Enter the ephone configuration mode for the second phone by using the ephone-dn
2 command.
Step 9
Enter the command description 20X5559001 (where X is the pod number) to set the
IP Phone header bar.
Step 10
Step 11
Enter the command ephone-dn 1 to enter the configuration for your first ephone-dn.
Step 12
Enter the command label my line X000 (where X is equal to the pod number) to set
a label on ephone-dn 1.
Step 13
Reset all the IP Phones by pressing **#** on the keypad of both IP Phones.
Step 14
Step 15
Step 16
Step 17
Verify that the changes you implemented are present on the IP Phones.
Activity Verification
You have completed this task when you verify that the displays on the IP Phones are
customized.
Activity Procedure
Complete these steps:
Step 1
Step 2
Lab Guide 61
Step 3
Step 4
Set the extension number to D4444 with a sequence number of 6, an extension type
of Intercom, a name of Intercom, a top label field on the page of Intercom, and an
intercom number of D3333. Leave all other settings at default.
Step 5
Step 6
Step 7
Step 8
Verify that the intercom connects in both directions by going off hook and choosing
the second line to which the intercom ephone-dn was assigned. This should work in
both directions.
Step 9
Go to a terminal window and, at the CLI, enter privileged EXEC mode using the
enable command.
Step 10
Enter the show running-config | telephony-service to view the changes made to the
configuration.
Step 11
Activity Verification
You have completed this task when you verify that an intercom works in both directions
between the two IP Phones.
Activity Procedure
Complete these steps:
Step 1
Step 2
Set the extension number to X500 (where X is the pod number) with a sequence
number of 9, an extension type of Intercom, a name of Dialable Int, a top label
field on the page of Dialable Int, and an intercom number of X550. Leave all other
settings at default.
Step 3
Step 4
Set the extension number to X550 (where X is the pod number) with a sequence
number of 10, an extension type of Intercom, a name of Dialable Int, a top label
field on the page of Dialable Int, and an intercom number of X500. Leave all other
settings at default.
Step 5
Step 6
Step 7
Verify that the intercom connects in both directions by going off hook and choosing
the second line to which the intercom ephone-dn was assigned. This should work in
both directions.
Step 8
Using the analog phone, dial X500 (where X is the pod number).
Step 9
Step 10
Using the analog phone, dial X550 (where X is the pod number).
Step 11
Step 12
Go to a terminal window and at the CLI, enter privileged EXEC mode using the
enable command.
Step 13
Use the show running-config | begin tele to view the changes made to the
configuration.
Step 14
Activity Verification
You have completed this task when you attain these results:
Verify that an intercom works between the two IP Phones and that it works in both
directions.
Verify that both intercoms can be dialed from the analog phone.
Lab Guide 63
Activity Procedure
Complete these steps:
Step 1
As the system administrator, choose the Configure >Extension menu in the GUI
web interface.
Step 2
Add a paging extension using an extension number of X600 (where X is the pod
number) with a sequence number of 11, a name of Sales,and a description of Sales.
Step 3
Add a second paging extension with an extension number of X700 (where X is the
pod number), a sequence number of 12, a name of Support,and a description of
Support.
Step 4
Assign the paging ephone-dn X600 to ephone 1 and X700to ephone 2. Click yes for
Unicast.
Step 5
Test the paging function by dialing X600 and X700 from the analog phone.
Step 6
Use the terminal to access the CLI and enter privileged EXEC mode with the enable
command.
Step 7
Step 8
From global configuration mode, enter the ephone-dn 13 command to create a new
ephone-dn.
Step 9
Assign a directory number to the page using the number X800 command (where X
is the pod number).
Step 10
Step 11
Step 12
Step 13
Step 14
Step 15
Step 16
Use the analog phone to test the paging function by dialing the X700 paging number.
Activity Verification
You have completed this task when you verify that the pages to the paging extensions function
correctly.
Activity Procedure
Complete these steps:
Step 1
Place a call from one IP Phone to the other IP Phone in the pod.
Step 2
While the call is in progress, press the Acct softkey and enter 12341234#.
Step 3
Enter the show call active voice command to view the account number.
Step 4
Hang up the call and enter the show call history voice last 2 command and view the
account number appended at the end of the information for the last call.
Activity Verification
You have completed this task when you verify that the account number shows up in the show
commands.
Lab Guide 65
-- -
-
-
-
-
--
--
-
- -
-
--
-
--
-
-
-
-
-
--
-
-
--
--
-
--
-
-66 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
-
-- -
-
--
-
--- -
-
- --- --
- ---
- -
- --
-
-
-
-
-
-
-
-
- -
-
-
-
-
-
Copyright 2005, Cisco Systems, Inc.
Lab Guide 67
-
---
-
---
-
-
---
-- -- --
- --
- -
-
-- -- -
- - -- -
-
--- -
-- - -
--
-
-
-
-
68 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
--
--
-
-
-
-
-
-
-
-
-
-- -
-
Lab Guide 69
Complete this lab activity to practice what you learned in the related module.
Activity Objective
In this activity, you will integrate CUE with Cisco CallManager Express. After completing this
activity, you will be able to meet these objectives:
Installation of the Unity Express software and the post-installation automated macro
process
Run the Initialization Wizard to configure the CUE module
Configure the default automated attendant
Create and run a custom automated attendant
Create users and mailboxes
Troubleshoot CUE with trace and syslog messages
Visual Objective
The figure illustrates what you will accomplish in this activity.
SIP
CallManager
Express
Web browser
for Using the
GUI Interface
Use to the
Automated
Attendant
X100
SCCP
SCCP
IPTXUser1 With
a Mailbox
2005 Cisco Systems, Inc. All rights reserved.
IPTXUser2 With
a Mailbox
X000X001
IPTX v2.07
Required Resources
These are the resources and equipment required to complete this activity:
A Cisco CallManager Express router configured with the baseline configuration from the
end of Lab 4-1
Two IP Phones
One analog phone
Student PC with Windows and IE 5.5 or greater
An NM-CUE or an AIM-CUE
Worksheets from Lab 2 or completed form from end of the Lab Guide
Command List
The table describes the commands used in this activity.
Command
Description
- -
-
-- -
--- -
---
Lab Guide 71
Command
Description
- -
-
-
---
- -
- - --
- - --
- -
Job Aids
These job aids are available to help you complete the lab activity.
Terminal software to connect to the CLI
IE 6.0 web browser
Windows student PC
Domain Name
Location
ID
Location
Name
Abbreviation
VPIM Broadcast
ID
Partner
Pod
Activity Procedure
Complete these steps:
Step 1
From the console of your router, enter the command enable. Enter the enable
password (cisco) when prompted.
Step 2
Enter the show version command to verify that the Cisco service engine is detected.
Step 3
Enter the show ip interface brief command to determine the interface number of the
service engine. Write the interface number here: _________________.
Step 4
Step 5
Step 6
Under the service engine mode, use the command ip unnumbered fastethernet
0/0.X0 (where X is equal to the pod number) to assign an address to the interface.
Step 7
Lab Guide 73
Step 8
Set a default gateway on the module by using the service-module ip defaultgateway 10.X0.0.1 command.
Step 9
Step 10
Step 11
Step 12
Create the SIP dial peer that is used to set up a call to the Cisco Unity Express
module. This is started by using the command dial-peer voice 8 voip.
Step 13
In dial-peer mode, enter the command destination-pattern X9.. (where X is the pod
number).
Step 14
Enter the command session protocol sipv2 to use SIP for this dial peer.
Step 15
Enter the command dtmf-relay sip-notify to send DTMF digits in notify packets.
Step 16
Enter the session target ipv4:10.X0.0.10 command (where X is the pod number) to
specify the IP of the service engine.
Step 17
Step 18
Step 19
Step 20
Step 21
In the ephone-dn submode, enter number 9001.... (the four periods represent the
four digits in the dial plan).
Step 22
Step 23
Step 24
In the ephone-dn submode, enter number 9000.... (the four periods represent the
four digits in the dial plan).
Step 25
Step 26
Step 27
Step 28
Step 29
Use the clock set hh:mm:ss day-of-month month year command to set the time to
your current location (the month must be spelled out).
Step 30
Step 31
Activity Verification
You have completed this task when you attain these results:
Verify that all commands have been entered properly.
Verify that the configuration shows the desired changes.
Verify that the configuration is saved.
Activity Procedure
Complete these steps:
Step 1
Collect the IP address of the classroom TFTP server from the instructor:
_________________
Step 2
Collect the IP address of the classroom FTP server from the instructor:
__________________
Step 3
Ping the TFTP and FTP servers (they may be the same machine) to verify
connectivity. If any problems occur, tell your instructor.
Step 4
Step 5
Enter the command reload at the prompt. If you are sure a reload is wanted, enter y
when prompted.
Step 6
Watch carefully as the module is reloaded and enter *** (three asterisks) within ten
seconds of seeing the Please enter *** to change boot configuration: prompt. If
the ten-second window is missed, the module will have to be reloaded and this step
repeated.
Step 7
Step 8
Step 9
Step 10
Step 11
Enter the address of the TFTP server that your instructor gave you.
Step 12
Step 13
Step 14
Step 15
Lab Guide 75
Step 16
Accept the default setting of primary for the default boot loader. This will now
save the boot loader configuration to flash.
Step 17
Ping the TFTP and FTP servers (they may be the same machine).
Step 18
Enter the command boot helper to initialize the installation file. If any errors occur,
notify your instructor. A spinning prompt should be seen. This indicates that the
installer is being downloaded (this may take several minutes). If the prompt is not
spinning, tell your instructor.
Step 19
A menu will be presented allowing the installer to select to either install software or
to reload the module. Choose the install software option.
Step 20
When asked for the package name, enter cue-vmlicense_50mbx_cme_eng_2.1.0.17.pkg. If a typo is made, continue through the next
steps and, when prompted to install software, start this step over.
Step 21
When asked for the URL, enter the following: ftp://ip-address/ (where the IP
address is provided by the instructor).
Step 22
Step 23
When prompted for a password, leave the field blank or enter the password provided
by your instructor.
Step 24
When asked for the package name, enter cue-vm.2.1.0.17.pkg. If a typo is made,
continue through the next steps and, when prompted to install software, start this
step over.
Step 25
When asked for the URL, enter the following ftp://ip-address/ (where the IP address
is provided by the instructor).
Step 26
Step 27
When prompted for a password, leave the field blank or enter the password provided
by your instructor.
Step 28
Next, a language menu will appear. Select the desired language by entering the
corresponding number. Up to two languages may be selected.
Step 29
When the desired language(s) have been selected, enter x to continue with the
installation of the package.
Step 30
The installation or upgrade will take a few minutes. At the end of the installation or
upgrade, the system will ask if you want to start the configuration. Enter y.
Step 31
Step 32
Important! If you are asked if the configuration should be restored, enter n to not
restore the configuration.
Step 33
Step 34
When prompted for a domain name, refer to Table 5 to specify the pod domain
name.
Step 35
When asked if DNS is going to be used, enter n. Then enter y when prompted if you
are sure.
Step 36
When asked for the IP address of the primary NTP server, enter 10.X0.0.1 (where X
is the pod number).
Step 37
When asked for the IP address of the secondary NTP server, press the Enter key to
bypass.
Step 38
Step 39
Step 40
Step 41
If your choices are correct, enter 1 to end the post-installation routine and the system
will then load the operating system and the CUE application. Please be patient
because this may take some time to load (especially if using AIM cards).
Step 42
Step 43
Step 44
Step 45
The prompt should now show CUEX> (where X is the pod number).
Step 46
Use the command show software versions to verify that the version of CUE is 2.1.1
(it is okay if the boot loader is not 2.1.1).
Step 47
Use the command show software licenses and verify that there are 50 personal
mailboxes. Verify that the application mode is equal to CCME.
Activity Verification
You have completed this task when you attain these results:
Verify that the CUE system reloads itself successfully.
Verify that the appropriate licensed capacity and version are installed.
Activity Procedure
Complete these steps:
Step 1
Verify that the command web admin exists by using the show running-config |
begin web admin command.
Step 2
Open Internet Explorer and enter the URL http://10.X0.0.10 (where X is the pod
number) from the student PC.
Step 3
A web page will appear with these words in red: System is not initialized. Only
Administrator logins are allowed. On this page, enter the username of CUEAdmin
and a password of cisco, then click Login.
Step 4
Choose the option Run Initialization Wizard to start the configuration process.
Lab Guide 77
Step 5
The first of five steps appears. The credentials for Cisco CallManager Express must
be entered. Enter a username of IPTX and a password of cisco, then click Next.
Step 6
The second step imports the Cisco CallManager users. In this interface, choose only
the user associated with the X000 and make sure to choose the mailbox and
administrator checkbox. Make sure the other user is not selected (this user and
mailbox will be created later in the lab). Click Next.
Step 7
The third step allows the default setting and actions to be defined. Leave all settings
at the default. Click Next.
Step 8
The fourth step defines the call handling. On this page, enter X900 for the Voice
Mail Number (where X is the pod number).
Step 9
Step 10
Enter X901 for the Auto Attendant Access Number (where X is the pod number).
Step 11
Enter X001 for the Auto Attendant Operator Number (where X is the pod number).
Step 12
Enter X902 for the Administration Via Telephony Number (where X is the pod
number).
Step 13
Verify that the MWI settings are automatically populated with the configuration
settings performed on the Cisco CallManager Express router, including the four
periods at the end of the MWI numbers.
Step 14
Step 15
Review the information for accuracy and if correct, click the checkbox Finally, save
to startup configuration, then click Finish. This can take a couple of minutes to
complete.
Step 16
A summary page will be displayed. Note the password and PIN for the user
imported and write them down here. Password_______________________
PIN________
Step 17
Verify that there are no failures. If there are failures, notify your instructor, then
click Logout.
Step 18
Click Login Again and enter a username of CUEAdmin and a password of cisco
and verify that the administrative web page can be accessed.
Activity Verification
You have completed this task when you attain these results:
Verify that the Initialization Wizard runs successfully without errors.
Verify that the system administrator can log in to the administrative web pages.
Activity Procedure
Complete these steps:
Step 1
From the administrative web interface, logged in as the administrator, choose the
Defaults>User menu.
Step 2
Step 3
Step 4
Step 5
Step 6
View the voice mail defaults and notice the available options.
Activity Verification
You have completed this task when the defaults of the system have been viewed.
Activity Procedure
Complete these steps:
Step 1
Step 2
From the Users menu, choose the user JDoe. A User Profile page will appear.
Step 3
On the properties page, set the first name and last name based on Table 4
Step 4
For the Primary E.164 Number field, enter 20X5559000 (where X is the pod
number).
Step 5
Step 6
Step 7
Step 8
Press the Messages or Envelope icon button on your X000 IP Phone (where X is the
pod number).
Step 9
When prompted for a password, enter 1234# (this is really the PIN setting; the
password is used for logging in to the web page as a user).
Step 10
The tutorial will play and prompt you to record a name by pressing 1. Record a
name at the tone, then review and approve it.
Lab Guide 79
Step 11
You will then be played a standard greeting and will be presented with the option to
record a personal greeting by pressing 1.
Step 12
Step 13
Step 14
From the X001 IP Phone, call the X000 IP Phone (where X is the pod number in both
cases) and let the call go into voice mail.
Step 15
Leave a message with urgent priority (the minimum length of a message is two
seconds).
Step 16
Notice that the MWI light is lit on the X000 IP Phone (where X is the pod number)
and has an envelope icon next to it.
Step 17
Press the Messages or Envelope icon button on the X000 IP Phone (where X is the
pod number), enter the PIN of 4321, and check the message in the mailbox.
Step 18
Activity Verification
You have completed this task when you attain these results:
A voice mail appears in the mailbox of the first phone.
The voice mail is checked and deleted.
Activity Procedure
Complete these steps:
Step 1
Open the CUE administrative web page by going to http://10.X0.0.10 (where X is the
pod number) or, if the page is still open, click Login Again on the page.
Step 2
Step 3
Choose the Configure>Users menu . On the Users page, add a new user.
Step 4
The Add a New User page will appear. Fill in the page with the information in the
following steps.
Step 5
Set the User ID, First name, and Last name for the second ephone based upon Table
4.
Step 6
Set the Primary E.164 Number to 20X5559001 (where X is the pod number).
Step 7
Step 8
Click Specify.
Step 9
Step 10
Click Specify.
Step 11
Step 12
Step 13
The Add a New Mailbox page will appear. Leave the settings at the default and click
Add.
Step 14
Verify that the new user appears on the Users page within the administrative web
pages.
Step 15
On the second IP Phone (X001), call voice mail and set up the mailbox by recording
a recorded name and a personal greeting.
Step 16
Activity Verification
You have completed this task when you attain these results:
Verify that there are two users and two personal mailboxes.
Verify that the system administrator can log in to the administrative web pages.
Verify that the second mailbox is set up and the tutorial has been completed.
Activity Procedure
Complete these steps:
Step 1
Step 2
Step 3
Step 4
Using Table 5, configure the pop-up window Add a New Location to configure
your partner pod networking location. Assign a location ID of your partner pod,
location name of your partner pod, abbreviation of your partner, IP address of your
partner's CUE module, null prefix blank, VPIM broadcast ID of your partner, min
extension length 4, max extension length 4, and all other settings to default. Then
click Add.
Step 5
Click Add a second time and define the local pod information.
Step 6
Using Table 5, configure the pop-up window Add a New Location to configure
your pods networking location. Assign the local location ID, location name,
abbreviation, IP address of the local CUE module, null prefix blank, VPIM
broadcast ID, min extension length 4, max extension length 4, and leave all other
settings at the default. Click Add to commit.
Lab Guide 81
Step 7
In the Local Location ID field, enter the location ID of the local location and click
Apply.
Step 8
Test VPIM by pressing the message button on the lowest number extension and
when prompted enter the PIN (the TUI will ask for a password).
Step 9
In the TUI, compose a message by pressing 2 when prompted. Spell out the last
name of the user associated with the top line of ephone 2 in your partner pod. What
is the result?
Step 10
Step 11
Step 12
View the least recently used (LRU) cache by using the command show remote
cache from the CLI of the CUE module. Verify that information from your partner
appears in the cache before proceeding to the next step.
Step 13
Dial into the AVT(Administration Via TUI) pilot number of X902 and when
prompted enter the extension number of X000 and a PIN of 4321.
Step 14
Step 15
Step 16
Step 17
Step 18
When prompted, record the name of the location for the pod of your partner. When
completed, disconnect the call.
Step 19
From ephone 2 in your pod, compose a message from the TUI using spell-by-name
of the user associated with the top line of ephone 1 in your partner pod. What is the
result? How did spell-by-name work? Is this learning permanent?
Step 20
Using Table 4, configure both users for your partner pod by choosing the Configure
>Remote Users menu.
Step 21
Click Add and, in the window that appears, configure the user associated with Y000
by configuring the username, first name, last name, primary extension (Y000), and
the location ID. Click Add to commit the changes.
Step 22
Click Add and, in the window that appears, configure the user associated with Y001
by configuring the username, first name, last name, primary extension (Y001), and
the location ID. Click Add to commit the changes.
Step 23
From ephone 2 in your pod, compose a message from the TUI using spell-by-name
of the user associated with the top line of ephone 1 in your partner pod. What is the
result? How did spell-by-name work? Is this learning permanent?
Activity Procedure
Complete these steps:
Step 1
Browse to the CUE administrative web page at http://10.X0.0.10 (where X is the pod
number).
Step 2
Step 3
Choose the Voice Mail>Distribution Lists menu and then choose Public Lists.
Step 4
Step 5
In the Add a Public Distribution List window that appears, configure a name of
Sales and a number of X998. Click Add when completed.
Step 6
Choose the new distribution list named Sales from the Public Lists page.
Step 7
In the Public List Sales web page, choose the Members tab and then click Add
Member.
Step 8
On the Find web page, choose the ID radio button and then click Find.
Step 9
The list of users should appear in a Find window. Select the lowest numbered
extension for your pod and the pod of your partner. Then click Select Rows. This
will add a local user and a remote user to the distribution list.
Step 10
From a phone that is not in the distribution list, press the Messages button and log in
to the voice mailbox.
Step 11
Step 12
Step 13
Record a test message to the sales distribution list and verify that the local phone and
the phone of your partner receive a copy of the message in their voice mailbox.
Activity Verification
You have completed this task when you verify that both members of the Sales public
distribution list receive a message to the list.
Lab Guide 83
Activity Procedure
Complete these steps:
Step 1
Browse to the CUE administrative web page at http://10.X0.0.10 (where X is the pod
number).
Step 2
Step 3
Step 4
Step 5
Step 6
Choose the first IP Phone and then click an unassigned button. This will bring up
the line page. Choose a ring type of Feature Ring and check the box in front of
extension X150. Click Save and then the Change button to commit the changes.
Step 7
Repeat the previous steps for the second IP Phone in the pod.
Step 8
Choose the Configure>Groups menu. From the Groups page, click Add.
Step 9
An Add a New Group page appears. On the Group ID field, enter Sales. In the
Primary Extension field, enter X150. In the Primary E.164 Number field, enter
20X5559150, click the Create Mailbox check box, and finally, click Add.
Step 10
The Add a New Mailbox page will open up. Leave the defaults settings and click
Add.
Step 11
Choose the Configure>Groups menu. From the Groups page, choose the Sales
group and go to the Owners/Members tab.
Step 12
Click +Subscribe member to open a Find page. Click the blue Find button, choose
both of the pods users, and click +Select row(s).
Step 13
Click +Subscribe owner to add an owner to the group mailbox. Click the blue Find
button and click the checkbox in front of the user associated with ephone 1. Click
Select Rows to commit the changes.
Step 14
Call voice mail by pressing the envelope icon button on an IP Phone and, when
prompted, enter the PIN number of 4321.
Step 15
There should be a new option in the TUI. When prompted, press 9 to enter the
general delivery mailbox management. Choose general delivery mailbox X150 when
prompted and press 1. (Only one IP Phone at a time is permitted in the general
delivery mailbox.)
Step 16
The tutorial will play. Record a name and personal greeting for the group.
Step 17
Call the extension number for the general delivery mailbox at X150, let the call go to
voice mail, and leave a message. Notice that both phones have an indicator in the
form of an envelope icon on the line to which the sales ephone-dn was assigned.
(Only the top line appearance can use the MWI light of the IP Phone.)
Step 18
Call voice mail by pressing the envelope icon button on the phone and, when
prompted, enter the PIN number of 4321.
Step 19
There should be a new option in the TUI. When prompted, press 9 to enter the
general delivery mailbox management for X150. Check and delete the message by
following the TUI prompts.
Activity Verification
You have completed this task when you attain these results:
Verify that a sales general delivery mailbox has been successfully configured.
Verify that a message has been left and checked from the TUI.
Activity Procedure
Complete these steps:
Step 1
Attempt to dial the Administrative TUI by dialing X902 from extension X000. Enter
the extension and PIN when prompted. What is the result?
Step 2
Browse to the CUE administrative web page at http://10.X0.0.10 (where X is the pod
number).
Step 3
Step 4
Choose the Configure>Groups menu. From this menu, choose the Sales group
that was previously configured.
Step 5
Click the Voicemail Broadcaster checkbox and click Apply to save the changes.
Step 6
Dial the Administrative TUI by dialing X902 from extension X000. Enter the
extension and PIN when prompted. What is the result?
Step 7
Step 8
Step 9
Step 10
Record the message. Send the message by pressing #. Who received the message?
Step 11
Dial the Administrative TUI by dialing X902 from extension X000. Enter the
extension and PIN when prompted. What is the result?
Step 12
Step 13
Lab Guide 85
Step 14
Step 15
Step 16
Step 17
Record the message. Send the message by pressing #. Who received the message?
Activity Procedure
Complete these steps:
Step 1
From the CLI of the CUE module, use the command show clock to determine the
time and date of the CUE module. Write down the time and date here.
Step 2
In the administrative web interface choose the Voice Mail > Business Hour
Settings menu.
Step 3
Step 4
Step 5
Step 6
In the Add a New Schedule web page that appears, define a name for the new
schedule called summerschedule.
Step 7
Step 8
Step 9
Set the current half hour time interval and the next half hour interval to closed. For
example, if the time is currently Thursday at 2:15 p.m., you would set the 2:00 2:29
p.m. and 2:303:00 p.m. intervals to closed. This will allow you to test what happens
when the current time is closed.
Step 10
Activity Procedure
Complete these steps:
Step 1
From the analog phone, dial the number of the automated attendant. This should be
X901 (where X is the pod number).
Step 2
The call should enter the automated attendant. Press 1 to enter the extension of one
of the two IP Phones and notice that you are connected.
Step 3
Step 4
Dial the automated attendant again and enter the automated attendant prompts.
Step 5
Press 2 to spell the name of a user. Spell out the last name of the user associated
with ephone 1 using the keypad, and the call should be connected to the IP Phone.
Step 6
Step 7
Step 8
Step 9
Step 10
Click Next.
Step 11
On the Script Parameter page, set operExtn* to X000, and note that the
businessSchedule parameter is selected by default, then click Next.
Step 12
Click Finish.
Step 13
Dial the automated attendant again and enter the automated attendant prompts.
Step 14
Step 15
Step 16
Step 17
Click Next.
Step 18
Step 19
Click Finish.
Step 20
Step 21
Step 22
Lab Guide 87
Step 23
Click Next.
Step 24
On the Script Parameter page, set the businessSchedule parameter back to the
default of systemschedule, then click Next.
Step 25
Click Finish.
Step 26
Step 27
Click Add.
Step 28
On the Add New Holiday web page, click the calendar icon and select today s date.
Step 29
Step 30
Step 31
Step 32
Activity Verification
You have completed this task when you attain these results:
Verify that the default automated attendant has been tested and that it works.
Verify that the operator extension has been tested and defined.
Verify that the business hours function.
Verify that the holiday settings function.
Activity Procedure
Complete these steps:
Step 1
Step 2
Choose the Administrators group and, on the Group Profile page that appears,
choose the Owners/Members tab.
Step 3
Click the checkboxes for both users and click Subscribe Member.
Step 4
Enter the Administrative TUI by calling X902 and entering your extension and PIN.
Step 5
Step 6
Step 7
Record a prompt for the ACME company that says Thank you for calling
ACME.
Step 8
Create a second prompt that says For sales, press one; for support, press two; for
the operator, press zero.
Step 9
Create a third prompt that says I am sorry that you are having problems.
Step 10
Create a fourth prompt that says I am sorry the number you are trying to reach
is busy, please call back later.
Step 11
Create a fifth prompt that says I am sorry but we are currently closed.
Step 12
Step 13
Open the web administrative GUI interface by logging in with the CUEAdmin
username and a password of cisco.
Step 14
Choose the VoiceMail>Prompts menu. Notice that the four prompts are present in
the order recorded with a timestamp.
Step 15
Notice the name of the .wav file that was recorded. There is a timestamp embedded
in the name.
Step 16
Choose the prompt that was recorded first and rename it to ACMEWelcome.wav
and then click Apply.
Step 17
Choose the prompt that was recorded second and rename it to ACMEMenu.wav and
then click Apply.
Step 18
Choose the prompt that was recorded third and rename it to ACMEProblems.wav
and then click Apply.
Step 19
Choose the prompt that was recorded fourth and rename it to ACMEClosed.wav and
then click Apply.
Step 20
Choose the prompt that was recorded fifth and rename it to ACMEBusy.wav and
then click Apply.
Activity Verification
You have completed this task when you verify that five new prompts are created in the CUE
system.
Activity Procedure
Complete these steps:
Step 1
Step 2
Run the CUEEditor.2.1.1.exe application to install the CUE Auto Attendant Editor.
Step 3
Step 4
Step 5
Lab Guide 89
Step 6
Step 7
To start the CUE Auto Attendant Editor, click the Start button in MSWindows on
your PC and go to the Program Files.
Step 8
From Program Files, move to the Cisco CUE Developer object and then start the
Cisco CUE Editor.
Step 9
Step 10
Step 11
Expand all of the folders on the left pane to view all of the steps.
Step 12
In the variable pane (bottom left pane), click the blue arrow icon to add a new
variable.
Step 13
The Edit Variable window will appear. Give the variable a case-sensitive name of
welcomeGreetingACM.
Step 14
For the Type field, choose Prompt. Leave the value blank, check the Parameter
box, and click OK.
Step 15
In the variable pane (bottom-left pane), click the blue arrow icon to add a new
variable.
Step 16
The Edit Variable window will appear. Give the variable a (case-sensitive) name of
menuACME.
Step 17
For the Type field, choose Prompt. Leave the value blank, click the Parameter
checkbox, and click OK.
Step 18
In the variable pane (bottom-left pane), click the blue arrow icon to add a new
variable.
Step 19
The Edit Variable window will appear, give the variable a (case-sensitive) name of
systemProblemsACME.
Step 20
For the Type field, choose Prompt. Leave the value blank, click the Parameter
checkbox, and click OK.
Step 21
In the variable pane (bottom-left pane), click the blue arrow icon to add a new
variable.
Step 22
The Edit Variable window appears. Give the variable a (case-sensitive) name of
systemSchedule.
Step 23
For the Type field, choose Schedule. Leave the value null, click the Parameter
checkbox, and click OK.
Step 24
In the variable pane (bottom-left pane), click the blue arrow icon to add a new
variable.
Step 25
The Edit Variable window appears. Give the variable a (case-sensitive) name of
systemClosedACME.
Step 26
For the Type field, choose Prompt. Leave the value blank, click the Parameter
checkbox, and click OK.
Step 27
In the variable pane (bottom-left pane), click the blue arrow icon to add a new
variable.
Step 28
The Edit Variable window appears. Give the variable a (case-sensitive) name of
systemBusyACME.
Step 29
For the Type field, choose Prompt. Leave the value blank, click the Parameter
checkbox, and click OK.
Step 30
In the variable pane (bottom-left pane), click the blue arrow icon to add a new
variable.
Step 31
The Edit Variable window appears. Give the variable a (case-sensitive) name of
operatorExtensionACME.
Step 32
For the Type field, choose String. Set the value to 0 (quotes must be included here),
click the Parameter checkbox, and click OK.
Step 33
In the variable pane (bottom-left pane), select the blue arrow icon to add a new
variable.
Step 34
The Edit Variable window appears. Give the variable a (case-sensitive) name of
salesSharedDNACME.
Step 35
For the Type field, choose String. Set the value to X201 (quotes must be included
here and X is the pod number), click the Parameter checkbox, and click OK.
Example: the value for Pod 9 would be 9201.
Step 36
In the variable pane (bottom-left pane), click the blue arrow icon to add a new
variable.
Step 37
The Edit Variable window appears. Give the variable a (case-sensitive) name of
supportExtensionACME.
Step 38
For the Type field, choose String. Set the value to X000 (quotes must be included
here and X is the pod number), click the Parameter checkbox, and click OK.
Example: the value for Pod 9 would be 9000.
Step 39
Drag the Accept step from the Contact folder in the left pane and drop it on top of
the Start step.
Step 40
From the Media folder, drag and drop the Play Prompt step on top of the Accept
step.
Step 41
Step 42
Choose the Prompt tab and click the button with the ellipsis on it.
Step 43
Step 44
Click OK to close the properties page for the Play Prompts step.
Step 45
From the General folder, drag and drop the Label step on top of the Play Prompt
step.
Step 46
Step 47
Lab Guide 91
Step 48
From the General folder, drag and drop another Label step on top of the
ACMECLOSEDLabel step.
Step 49
Step 50
Step 51
From the General folder, drag and drop the Is Holiday step on top of the Play
Prompt step. This will add the step above the two label steps.
Step 52
Expand the plus in front for the Is Holiday step to reveal the Yes and No logic
branches.
Step 53
From the General folder, drag and drop the Goto step on top of the Yes branch of
the Is Holiday step.
Step 54
Step 55
Step 56
From the General folder, drag and drop the Business Hours step on top of the No
icon under the Is Holiday step.
Step 57
Step 58
Step 59
Expand the plus in front of the Business Hours step to reveal the Open and Closed
logic branches.
Step 60
From the General folder, drag and drop the Goto step on top of the Closed branch of
the Business Hours step.
Step 61
Step 62
Step 63
From the General folder, drag and drop the Goto step on top of the Open branch of
the Business Hours step.
Step 64
Step 65
Step 66
From the Media folder, drag and drop the Menu step on top of the ACMEMENU
label step.
Step 67
Step 68
On the General tab, highlight Output 1 and notice the 1 is checked. Click Modify,
rename it to Sales, and then click OK.
Step 69
On the General tab, highlight Output 2 and notice the 2 is checked. Click Modify
and rename it to Support, then click OK.
Step 70
On the General tab, highlight Output 3 and notice the 3 is checked. Click the 0
checkbox and clear the 3 checkbox. Click Modify, rename it to Operator, and then
click OK.
Step 71
On the Prompt tab, click the button with the ellipsis on it.
Step 72
Choose the list of variables and choose menuACME, then click OK.
Step 73
From the Input tab, notice the setting for timeouts and retries.
Step 74
Step 75
Drag and drop a Call Redirect step from the Call Contact folder onto the Sales
branch of the Menu step.
Step 76
Step 77
For the Extension field, choose salesSharedDNACME, then click OK to save and
close the Properties page.
Step 78
Drag and drop an End step from the General folder onto the Successful branch of
the Call Redirect step.
Step 79
Drag and drop a Play Prompt step from the Media folder onto the Busy branch of
the Call Redirect step.
Step 80
Step 81
On the Prompt tab, click the button with the ellipsis on it.
Step 82
Choose the variables menu and choose the systemBusyACME variable. Then click
OK.
Step 83
Step 84
Drag and drop a Terminate step from the Contact folder onto the Play Prompt in the
Busy branch of the Call Redirect step.
Step 85
Drag and drop an End step from the General folder onto the Terminate in the Busy
branch of the Call Redirect step.
Step 86
Drag and drop a PlayPrompt step from the Media folder onto the Invalid branch of
the Call Redirect step.
Step 87
Step 88
On the Prompt tab, click the button with the ellipsis on it.
Step 89
Choose the Variables menu and choose the systemProblemsACME variable. Click
OK.
Step 90
Step 91
Drag and drop a Terminate step from the Contact folder onto the Play Prompt in the
Invalid branch of the Call Redirect step.
Step 92
Drag and drop an End step from the General folder onto the Terminate in the Invalid
branch of the Call Redirect step.
Step 93
Drag and drop a Play Prompt step from the Media folder onto the Unsuccessful
branch of the Call Redirect step.
Step 94
Step 95
On the Prompt tab, click the button with the ellipsis on it.
Lab Guide 93
Step 96
Choose the Variables menu and select the systemProblemsACME variable. Click
OK.
Step 97
Step 98
Drag and drop a Terminate step from the Contact folder onto the Play Prompt in the
Unsuccessful branch of the Call Redirect step.
Step 99
Drag and drop an End step from the General folder onto the Unsuccessful branch of
the Call Redirect step.
Step 100
Highlight the CallRedirect step under the Menu, right-click it, and choose Copy.
Step 101
Highlight the Support folder under the Menu step, right-click it, and paste the Call
Redirect step onto it.
Step 102
Highlight the Operator folder under the Menu step, right-click it, and paste the Call
Redirect step onto it.
Step 103
Right-click the new Call Redirect under the Support folder and choose Properties.
Step 104
Step 105
Step 106
Right-click the new Call Redirect under the Operator folder and choose Properties.
Step 107
Step 108
Step 109
For the Timeout branch of the Menu step, drag and drop Goto from the General
folder.
Step 110
Right-click Goto and choose the Properties menu item. Choose the ACMEMENU
label from the drop-down menu on the Properties page.
Step 111
Click OK.
Step 112
For the Unsuccessful branch of the Menu step, drag and drop Goto from the General
folder.
Step 113
Right-click Goto and choose the Properties menu item. Choose ACMEMENU
label from the drop-down menu on the Properties page.
Step 114
Click OK.
Step 115
Drag and drop a Play Prompt step from the Media folder onto the Label step called
ACMECLOSED.
Step 116
Step 117
Step 118
Drag and drop a Terminate step from the Contact folder onto the Play Prompt under
the ACMECLOSED Label step.
Step 119
Drag and drop an End step from the General folder onto the Play Prompt under the
ACMECLOSED Label step.
Step 120
Validate the script by pulling down the Tools menu and choosing Validate .
Step 121
Step 122
Step 123
Step 124
On the Auto Attendant page, click Add to add a new automated attendant.
Step 125
This will start a three-step process. In the first step, click Upload.
Step 126
Step 127
Step 128
Step 129
Step 130
Step 131
Step 132
For the salesSharedDNACME prompt, choose X201 (where X is the pod number).
Step 133
For the SupportExtensionACME prompt, choose X000 (where X is the pod number).
Step 134
Step 135
Step 136
Step 137
Step 138
For the operatorExtensionACME prompt, choose X001 (where X is the pod number).
Step 139
Step 140
Define a pilot number of X903 for this new automated attendant and leave the other
settings to defaults.
Step 141
Step 142
From the analog phone, call the number X903 and test all three options to verify
functionality.
Activity Verification
You have completed this task when you verify that the custom automated attendant has been
tested and works.
Lab Guide 95
Activity Procedure
Complete these steps:
Step 1
From the console of the Cisco CallManager Express router, enter enable to enter
privileged EXEC mode.
Step 2
Step 3
Step 4
Place a call to the custom automated attendant and notice the output.
Activity Verification
You have completed this task when you verify that the debug output can be viewed from the
Cisco CallManager Express router.
Activity Procedure
Complete these steps:
Step 1
Step 2
Step 3
Enter the command show logging to view the current level of console logging.
Step 4
Step 5
From global configuration mode, enter the command log console errors and log
console warning to enable all syslog messages to the console.
Step 6
Step 7
Enter the command show logging to verify which levels of logging are turned on.
Step 8
Attempt to check the voice mail on one of your IP Phones. Enter an incorrect PIN
three times in a row. Note the output.
Step 9
Step 10
Step 11
Step 12
Notice the default level of tracing that is enabled (if an AIM-CUE is used, all tracing
will be disabled).
Step 13
Step 14
Enter a checkmark enabling tracing for the root level Voicemail folder, which will
enable all tracing underneath it for voice mail.
Step 15
Step 16
Step 17
Go back to the CLI of the CUE module and enter the command clear trace.
Step 18
Enter the show trace command to view the tracing that is enabled.
Step 19
Step 20
Enter the command show trace buffer to view the output. Note the details in the
output.
Step 21
Step 22
In the ccn folder, check the box for all subfolders that start with Step .
Step 23
Step 24
Go back to the CLI of the CUE module and enter the command clear trace.
Step 25
Call the custom automated attendant at X903 (where X is the pod number) and
choose one of the options.
Step 26
Back at the CLI, use the show trace buffer command to view the output.
Activity Verification
You have completed this task when you attain these results:
Verify that the syslog messages appear on the console.
Verify that the tracing output is generated and viewed.
Lab Guide 97
-- -
-
-
-
-
--
--
-
- -
-
--
-
--
-
-
-
-
-
--
-
-
--
--
-
--
-
--
-- -
-
-
- --
-
-
---
-
-
- --- -- -- --
- ---
- -
- --
-
-
-
-
-
-
-
-
- -
-
-
-
Copyright 2005, Cisco Systems, Inc.
Lab Guide 99
-
-
-
---
-
---
-
--- -
---
-
-
-
---
-- -- --
- --
- -
-
-- -- -
- - -- -
-
--- -
-- - -
--
-
-
-
-
-
100 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
- - -- -
--
-
--
-
-
-
-
-
-
-
-
-
Copyright 2005, Cisco Systems, Inc.
-- -
-
-
--
--
-
-
-
-
-
-
-
--
-- --
-- -- -
-- -
-- -
- -
-
- ---
-
-
----
-
- ---
-- ----
-- -
--- ---
102 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
----
-
- ---
-- ----
-- -
--- ---
-
- -
----
- -
-
-
-
----
-
-
----
- -
----
---
---
--
---
--- -
--
---
-
----
-
----
-
----
Copyright 2005, Cisco Systems, Inc.
-
-
- --
-
-
-
- --
-
-
-
-
-
-
-
- -
- -
-
-
104 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Complete this lab activity to practice what you learned in the related module.
Activity Objective
In this activity, you will set up AutoQoS. After completing this activity, you will be able to
meet these objectives:
Configure AutoQoS on Cisco IOS routers
Configure AutoQoS on the Catalyst 2950 workgroup switch
Use Cisco IOS monitoring commands and network connectivity tools (ping) to gather
network response time data
Visual Objective
The figure illustrates what you will accomplish in this activity.
Pod 1
PSTN
Pod 2
Pod 7
Pod 8
Pod 3-6
202-555-9000
...
207-555-9000
201-555-9000208-555-9000
IPTX v2.08
Required Resources
These are the resources and equipment required to complete this activity:
Lab topology configured for QoS
Student workgroup consisting of one user-controlled Cisco 3725 router and one usercontrolled Cisco 3550 workgroup switch
Classroom reference materials as follows:
Student pod workstation with Telnet or console access to workstation pod devices
Command List
The table describes the commands used in this activity.
Command
Description
-
-
106 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Job Aid
The job aid available to help you complete the lab activity is your assigned workgroup pod
number provided by the instructor.
Activity Procedure
Complete these steps:
Step 1
Step 2
Step 3
Enable the AutoQoS for VoIP feature for traffic on the Sx/x interface. Do not
configure AutoQoS to trust DSCP markings.
Step 4
Display and examine the resulting AutoQoS configuration after enabling AutoQoS.
The following is an example output:
---
---
-- -
--
-- -
--
--
-
- -
-
-
-- -
- -
-- -
- -
--
- -
-- --
--
Copyright 2005, Cisco Systems, Inc.
--
--
-
--
--
- -
Step 5
Enter the show ip interface brief command on CMERouterX and ensure that the
Frame Relay subinterface is up.
Activity Verification
You have completed this task when you verify that you have successfully enabled the AutoQoS
for VoIP feature on CMERouterX.
Activity Procedure
Complete these steps:
Step 1
Step 2
Enable the AutoQoS for VoIP feature for traffic on the Fa0/1 interface of
CMESwitchX and trust the CoS markings from the core switch.
Step 3
Display and examine the resulting AutoQoS configuration after enabling AutoQoS.
-
-
-
-
- - --
-
- - - - -
Activity Verification
You have completed this task when you verify that you have successfully enabled the AutoQoS
for VoIP feature on CMESwitchX.
108 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Job Aids
The job aids available to help you complete the lab activity are the tables on the following
pages.
Number
Function
Applied to
Settings
notifications
Ephone 2 button 6
Destination
Pattern
Incoming
Called-number
Settings
Pod 1 Identity
Username
IPTX
First Name
Last Name
Ephone
CME Administrator
CUEAdmin
IPTXCust
CUE Administrator
CME Customer Administrator
Comments
110 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Comments
Number
Function
Applied to
Settings
notifications
multicast to 239.1.1.1
Ephone 2 button 6
Destination
Pattern
Incoming
Called-number
Settings
Pod 2 Identity
Username
IPTX
First Name
Last Name
Ephone
CME Administrator
CUEAdmin
IPTXCust
CUE Administrator
CME Customer Administrator
Comments
112 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Comments
Number
Function
Applied to
Settings
notifications
multicast to 239.1.1.1
Ephone 2 button 6
Destination
Pattern
Incoming
Called-number
Settings
Pod 3 Identity
Username
IPTX
First Name
Last Name
Ephone
CME Administrator
CUEAdmin
IPTXCust
CUE Administrator
CME Customer Administrator
Comments
114 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Comments
Number
Function
Applied to
Settings
notifications
multicast to 239.1.1.1
Ephone 2 button 6
Destination
Pattern
Incoming
Called-number
Settings
Pod 4 Identity
Username
IPTX
First Name
Last Name
Ephone
CME Administrator
CUEAdmin
IPTXCust
CUE Administrator
CME Customer Administrator
Comments
116 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Comments
Number
Function
Applied to
Settings
notifications
multicast to 239.1.1.1
Ephone 2 button 6
Destination
Pattern
Incoming
Called-number
Settings
Pod 5 Identity
Username
IPTX
First Name
Last Name
Ephone
CME Administrator
CUEAdmin
IPTXCust
CUE Administrator
CME Customer Administrator
Comments
118 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Comments
Number
Function
Applied to
Settings
notifications
multicast to 239.1.1.1
Ephone 2 button 6
Destination
Pattern
Incoming
Called-number
Settings
Pod 6 Identity
Username
IPTX
First Name
Last Name
Ephone
CME Administrator
CUEAdmin
IPTXCust
CUE Administrator
CME Customer Administrator
Comments
120 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Comments
Number
Function
Applied to
Settings
notifications
multicast to 239.1.1.1
Ephone 2 button 6
Destination
Pattern
Incoming
Called-number
Settings
Pod 7 Identity
Username
IPTX
First Name
Last Name
Ephone
CME Administrator
CUEAdmin
IPTXCust
CUE Administrator
CME Customer Administrator
Comments
122 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Comments
Number
Function
Applied to
Settings
notifications
multicast to 239.1.1.1
Ephone 2 button 6
Destination
Pattern
Incoming
Called-number
Settings
Pod 8 Identity
Username
IPTX
First Name
Last Name
Ephone
CME Administrator
CUEAdmin
IPTXCust
CUE Administrator
CME Customer Administrator
Comments
124 IP Telephony Express (IPTX) v2.0 Copyright 2005, Cisco Systems, Inc.
Comments