Cisco Unified Border Element with
Gatekeeper Configuration Guide
Release 12.4T
Americas Headquarters
Cisco Systems, Inc.
170 West Tasman Drive
San Jose, CA 95134-1706
USA
http://www.cisco.com
Tel: 408 526-4000
800 553-NETS (6387)
Fax: 408 527-0883
THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL
STATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT
WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS.
THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT
SHIPPED WITH THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE
OR LIMITED WARRANTY, CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY.
The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB’s public
domain version of the UNIX operating system. All rights reserved. Copyright © 1981, Regents of the University of California.
NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED “AS IS” WITH
ALL FAULTS. CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT
LIMITATION, THOSE OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF
DEALING, USAGE, OR TRADE PRACTICE.
IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING,
WITHOUT LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO
OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
CCDE, CCENT, CCSI, Cisco Eos, Cisco HealthPresence, Cisco IronPort, the Cisco logo, Cisco Lumin, Cisco Nexus, Cisco Nurse Connect, Cisco StackPower,
Cisco StadiumVision, Cisco TelePresence, Cisco Unified Computing System, Cisco WebEx, DCE, Flip Channels, Flip for Good, Flip Mino, Flip Video, Flip Video (Design),
Flipshare (Design), Flip Ultra, and Welcome to the Human Network are trademarks; Changing the Way We Work, Live, Play, and Learn, Cisco Store, and Flip Gift Card are
service marks; and Access Registrar, Aironet, AsyncOS, Bringing the Meeting To You, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, CCSP, CCVP, Cisco, the
Cisco Certified Internetwork Expert logo, Cisco IOS, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity, Collaboration Without
Limitation, EtherFast, EtherSwitch, Event Center, Fast Step, Follow Me Browsing, FormShare, GigaDrive, HomeLink, Internet Quotient, IOS, iPhone, iQuick Study,
IronPort, the IronPort logo, LightStream, Linksys, MediaTone, MeetingPlace, MeetingPlace Chime Sound, MGX, Networkers, Networking Academy, Network Registrar,
PCNow, PIX, PowerPanels, ProConnect, ScriptShare, SenderBase, SMARTnet, Spectrum Expert, StackWise, The Fastest Way to Increase Your Internet Quotient, TransPath,
WebEx, and the WebEx logo are registered trademarks of Cisco Systems, Inc. and/or its affiliates in the United States and certain other countries.
All other trademarks mentioned in this document or website are the property of their respective owners. The use of the word partner does not imply a partnership relationship
between Cisco and any other company. (0907R)
Any Internet Protocol (IP) addresses used in this document are not intended to be actual addresses. Any examples, command display output, and figures included in the
document are shown for illustrative purposes only. Any use of actual IP addresses in illustrative content is unintentional and coincidental.
Cisco Unified Border Element with Gatekeeper Configuration Guide
© 2009 Cisco Systems, Inc. All rights reserved.
About Cisco IOS and Cisco IOS XE Software
Documentation
Last Updated: March 5, 2009
This document describes the objectives, audience, conventions, and organization used in Cisco IOS and
Cisco IOS XE software documentation, collectively referred to in this document as Cisco IOS
documentation. Also included are resources for obtaining technical assistance, additional
documentation, and other information from Cisco. This document is organized into the following
sections:
•
Documentation Objectives, page i
•
Audience, page i
•
Documentation Conventions, page ii
•
Documentation Organization, page iii
•
Additional Resources and Documentation Feedback, page xi
Documentation Objectives
Cisco IOS documentation describes the tasks and commands available to configure and maintain Cisco
networking devices.
Audience
The Cisco IOS documentation set is intended for users who configure and maintain Cisco networking
devices (such as routers and switches) but who may not be familiar with the configuration and
maintenance tasks, the relationship among tasks, or the Cisco IOS commands necessary to perform
particular tasks. The Cisco IOS documentation set is also intended for those users experienced with
Cisco IOS who need to know about new features, new configuration options, and new software
characteristics in the current Cisco IOS release.
i
About Cisco IOS and Cisco IOS XE Software Documentation
Documentation Conventions
Documentation Conventions
In Cisco IOS documentation, the term router may be used to refer to various Cisco products; for example,
routers, access servers, and switches. These and other networking devices that support Cisco IOS
software are shown interchangeably in examples and are used only for illustrative purposes. An example
that shows one product does not necessarily mean that other products are not supported.
This section includes the following topics:
•
Typographic Conventions, page ii
•
Command Syntax Conventions, page ii
•
Software Conventions, page iii
•
Reader Alert Conventions, page iii
Typographic Conventions
Cisco IOS documentation uses the following typographic conventions:
Convention
Description
^ or Ctrl
Both the ^ symbol and Ctrl represent the Control (Ctrl) key on a keyboard. For
example, the key combination ^D or Ctrl-D means that you hold down the
Control key while you press the D key. (Keys are indicated in capital letters but
are not case sensitive.)
string
A string is a nonquoted set of characters shown in italics. For example, when
setting a Simple Network Management Protocol (SNMP) community string to
public, do not use quotation marks around the string; otherwise, the string will
include the quotation marks.
Command Syntax Conventions
Cisco IOS documentation uses the following command syntax conventions:
ii
Convention
Description
bold
Bold text indicates commands and keywords that you enter as shown.
italic
Italic text indicates arguments for which you supply values.
[x]
Square brackets enclose an optional keyword or argument.
...
An ellipsis (three consecutive nonbolded periods without spaces) after a syntax
element indicates that the element can be repeated.
|
A vertical line, called a pipe, indicates a choice within a set of keywords
or arguments.
[x | y]
Square brackets enclosing keywords or arguments separated by a pipe indicate an
optional choice.
{x | y}
Braces enclosing keywords or arguments separated by a pipe indicate a
required choice.
[x {y | z}]
Braces and a pipe within square brackets indicate a required choice within an
optional element.
About Cisco IOS and Cisco IOS XE Software Documentation
Documentation Organization
Software Conventions
Cisco IOS uses the following program code conventions:
Convention
Description
Courier font
Courier font is used for information that is displayed on a PC or terminal screen.
Bold Courier font
Bold Courier font indicates text that the user must enter.
<
>
An exclamation point at the beginning of a line indicates that the text that follows
is a comment, not a line of code. An exclamation point is also displayed by
Cisco IOS software for certain processes.
!
[
Angle brackets enclose text that is not displayed, such as a password. Angle
brackets also are used in contexts in which the italic font style is not supported;
for example, ASCII text.
]
Square brackets enclose default responses to system prompts.
Reader Alert Conventions
The Cisco IOS documentation set uses the following conventions for reader alerts:
Caution
Note
Timesaver
Means reader be careful. In this situation, you might do something that could result in equipment
damage or loss of data.
Means reader take note. Notes contain helpful suggestions or references to material not covered in the
manual.
Means the described action saves time. You can save time by performing the action described in the
paragraph.
Documentation Organization
This section describes the Cisco IOS documentation set, how it is organized, and how to access it on
Cisco.com. Included are lists of configuration guides, command references, and supplementary
references and resources that make up the documentation set. The following topics are included:
•
Cisco IOS Documentation Set, page iv
•
Cisco IOS Documentation on Cisco.com, page iv
•
Configuration Guides, Command References, and Supplementary Resources, page v
iii
About Cisco IOS and Cisco IOS XE Software Documentation
Documentation Organization
Cisco IOS Documentation Set
Cisco IOS documentation consists of the following:
•
Release notes and caveats provide information about platform, technology, and feature support for
a release and describe severity 1 (catastrophic), severity 2 (severe), and severity 3 (moderate) defects
in released Cisco IOS code. Review release notes before other documents to learn whether or not
updates have been made to a feature.
•
Sets of configuration guides and command references organized by technology and published for
each standard Cisco IOS release.
– Configuration guides—Compilations of documents that provide informational and
task-oriented descriptions of Cisco IOS features.
– Command references—Compilations of command pages that provide detailed information
about the commands used in the Cisco IOS features and processes that make up the related
configuration guides. For each technology, there is a single command reference that covers all
Cisco IOS releases and that is updated at each standard release.
•
Lists of all the commands in a specific release and all commands that are new, modified, removed,
or replaced in the release.
•
Command reference book for debug commands. Command pages are listed in alphabetical order.
•
Reference book for system messages for all Cisco IOS releases.
Cisco IOS Documentation on Cisco.com
The following sections describe the documentation organization and how to access various document
types.
Use Cisco Feature Navigator to find information about platform support and Cisco IOS, Cisco IOS XE,
and Catalyst OS software image support. To access Cisco Feature Navigator, go to
http://www.cisco.com/go/cfn. An account on Cisco.com is not required.
New Features List
The New Features List for each release provides a list of all features in the release with hyperlinks to the
feature guides in which they are documented.
Feature Guides
Cisco IOS features are documented in feature guides. Feature guides describe one feature or a group of
related features that are supported on many different software releases and platforms. Your Cisco IOS
software release or platform may not support all the features documented in a feature guide. See the
Feature Information table at the end of the feature guide for information about which features in that
guide are supported in your software release.
Configuration Guides
Configuration guides are provided by technology and release and comprise a set of individual feature
guides relevant to the release and technology.
iv
About Cisco IOS and Cisco IOS XE Software Documentation
Documentation Organization
Command References
Command reference books describe Cisco IOS commands that are supported in many different software
releases and on many different platforms. The books are provided by technology. For information about
all Cisco IOS commands, use the Command Lookup Tool at http://tools.cisco.com/Support/CLILookup
or the Cisco IOS Master Command List, All Releases, at
http://www.cisco.com/en/US/docs/ios/mcl/allreleasemcl/all_book.html.
Cisco IOS Supplementary Documents and Resources
Supplementary documents and resources are listed in Table 2 on page xi.
Configuration Guides, Command References, and Supplementary Resources
Table 1 lists, in alphabetical order, Cisco IOS and Cisco IOS XE software configuration guides and
command references, including brief descriptions of the contents of the documents. The Cisco IOS
command references are comprehensive, meaning that they include commands for both Cisco IOS
software and Cisco IOS XE software, for all releases. The configuration guides and command references
support many different software releases and platforms. Your Cisco IOS software release or platform
may not support all these technologies.
For additional information about configuring and operating specific networking devices, go to the
Product Support area of Cisco.com at http://www.cisco.com/web/psa/products/index.html.
Table 2 lists documents and resources that supplement the Cisco IOS software configuration guides and
command references. These supplementary resources include release notes and caveats; master
command lists; new, modified, removed, and replaced command lists; system messages; and the debug
command reference.
Table 1
Cisco IOS and Cisco IOS XE Configuration Guides and Command References
Configuration Guide and Command Reference Titles
Features/Protocols/Technologies
Cisco IOS AppleTalk Configuration Guide
AppleTalk protocol.
Cisco IOS XE AppleTalk Configuration Guide
Cisco IOS AppleTalk Command Reference
Cisco IOS Asynchronous Transfer Mode
Configuration Guide
LAN ATM, multiprotocol over ATM (MPoA), and WAN ATM.
Cisco IOS Asynchronous Transfer Mode
Command Reference
v
About Cisco IOS and Cisco IOS XE Software Documentation
Documentation Organization
Table 1
Cisco IOS and Cisco IOS XE Configuration Guides and Command References (continued)
Configuration Guide and Command Reference Titles
Cisco IOS Bridging and IBM Networking
Configuration Guide
Features/Protocols/Technologies
•
Transparent and source-route transparent (SRT) bridging,
source-route bridging (SRB), Token Ring Inter-Switch Link
(TRISL), and token ring route switch module (TRRSM).
•
Data-link switching plus (DLSw+), serial tunnel (STUN),
block serial tunnel (BSTUN); logical link control, type 2
(LLC2), synchronous data link control (SDLC); IBM
Network Media Translation, including Synchronous Data
Logical Link Control (SDLLC) and qualified LLC (QLLC);
downstream physical unit (DSPU), Systems Network
Architecture (SNA) service point, SNA frame relay access,
advanced peer-to-peer networking (APPN), native client
interface architecture (NCIA) client/server topologies, and
IBM Channel Attach.
Cisco IOS Bridging Command Reference
Cisco IOS IBM Networking Command Reference
Cisco IOS Broadband and DSL Configuration Guide
Cisco IOS XE Broadband and DSL Configuration Guide
Point-to-Point Protocol (PPP) over ATM (PPPoA) and PPP over
Ethernet (PPPoE).
Cisco IOS Broadband and DSL Command Reference
Cisco IOS Carrier Ethernet Configuration Guide
Cisco IOS Carrier Ethernet Command Reference
Cisco IOS Configuration Fundamentals
Configuration Guide
Cisco IOS XE Configuration Fundamentals
Configuration Guide
Connectivity fault management (CFM), Ethernet Local
Management Interface (ELMI), IEEE 802.3ad link bundling,
Link Layer Discovery Protocol (LLDP), media endpoint
discovery (MED), and operations, administration, and
maintenance (OAM).
Autoinstall, Setup, Cisco IOS command-line interface (CLI),
Cisco IOS file system (IFS), Cisco IOS web browser user
interface (UI), basic file transfer services, and file management.
Cisco IOS Configuration Fundamentals
Command Reference
Cisco IOS DECnet Configuration Guide
DECnet protocol.
Cisco IOS XE DECnet Configuration Guide
Cisco IOS DECnet Command Reference
Cisco IOS Dial Technologies Configuration Guide
Cisco IOS XE Dial Technologies Configuration Guide
Cisco IOS Dial Technologies Command Reference
Cisco IOS Flexible NetFlow Configuration Guide
Cisco IOS Flexible NetFlow Command Reference
vi
Asynchronous communications, dial backup, dialer technology,
dial-in terminal services and AppleTalk remote access (ARA),
large scale dialout, dial-on-demand routing, dialout, modem and
resource pooling, ISDN, multilink PPP (MLP), PPP, virtual
private dialup network (VPDN).
Flexible NetFlow.
About Cisco IOS and Cisco IOS XE Software Documentation
Documentation Organization
Table 1
Cisco IOS and Cisco IOS XE Configuration Guides and Command References (continued)
Configuration Guide and Command Reference Titles
Features/Protocols/Technologies
Cisco IOS H.323 Configuration Guide
Gatekeeper enhancements for managed voice services,
Gatekeeper Transaction Message Protocol, gateway codec order
preservation and shutdown control, H.323 dual tone
multifrequency relay, H.323 version 2 enhancements, Network
Address Translation (NAT) support of H.323 v2 Registration,
Admission, and Status (RAS) protocol, tokenless call
authorization, and VoIP gateway trunk and
carrier-based routing.
Cisco IOS High Availability Configuration Guide
A variety of High Availability (HA) features and technologies
that are available for different network segments (from
enterprise access to service provider core) to facilitate creation
of end-to-end highly available networks. Cisco IOS HA features
and technologies can be categorized in three key areas:
system-level resiliency, network-level resiliency, and embedded
management for resiliency.
Cisco IOS XE High Availability Configuration Guide
Cisco IOS High Availability Command Reference
Cisco IOS Integrated Session Border Controller
Command Reference
A VoIP-enabled device that is deployed at the edge of networks.
An SBC is a toolkit of functions, such as signaling interworking,
network hiding, security, and quality of service (QoS).
Cisco IOS Intelligent Services Gateway
Configuration Guide
Subscriber identification, service and policy determination,
session creation, session policy enforcement, session life-cycle
management, accounting for access and service usage, session
state monitoring.
Cisco IOS Intelligent Services Gateway
Command Reference
Cisco IOS Interface and Hardware Component
Configuration Guide
LAN interfaces, logical interfaces, serial interfaces, virtual
interfaces, and interface configuration.
Cisco IOS XE Interface and Hardware Component
Configuration Guide
Cisco IOS Interface and Hardware Component
Command Reference
Cisco IOS IP Addressing Services Configuration Guide
Cisco IOS XE Addressing Services Configuration Guide
Cisco IOS IP Addressing Services Command Reference
Cisco IOS IP Application Services Configuration Guide
Cisco IOS XE IP Application Services Configuration
Guide
Cisco IOS IP Application Services Command Reference
Cisco IOS IP Mobility Configuration Guide
Address Resolution Protocol (ARP), Network Address
Translation (NAT), Domain Name System (DNS), Dynamic
Host Configuration Protocol (DHCP), and Next Hop Address
Resolution Protocol (NHRP).
Enhanced Object Tracking (EOT), Gateway Load Balancing
Protocol (GLBP), Hot Standby Router Protocol (HSRP), IP
Services, Server Load Balancing (SLB), Stream Control
Transmission Protocol (SCTP), TCP, Web Cache
Communication Protocol (WCCP), User Datagram Protocol
(UDP), and Virtual Router Redundancy Protocol (VRRP).
Mobile ad hoc networks (MANet) and Cisco mobile networks.
Cisco IOS IP Mobility Command Reference
Cisco IOS IP Multicast Configuration Guide
Cisco IOS XE IP Multicast Configuration Guide
Cisco IOS IP Multicast Command Reference
Protocol Independent Multicast (PIM) sparse mode (PIM-SM),
bidirectional PIM (bidir-PIM), Source Specific Multicast
(SSM), Multicast Source Discovery Protocol (MSDP), Internet
Group Management Protocol (IGMP), and Multicast VPN
(MVPN).
vii
About Cisco IOS and Cisco IOS XE Software Documentation
Documentation Organization
Table 1
Cisco IOS and Cisco IOS XE Configuration Guides and Command References (continued)
Configuration Guide and Command Reference Titles
Features/Protocols/Technologies
Cisco IOS IP Routing Protocols Configuration Guide
Cisco IOS IP Routing Protocols Command Reference
Border Gateway Protocol (BGP), multiprotocol BGP,
multiprotocol BGP extensions for IP multicast, bidirectional
forwarding detection (BFD), Enhanced Interior Gateway
Routing Protocol (EIGRP), Interior Gateway Routing Protocol
(IGRP), Intermediate System-to-Intermediate System (IS-IS),
on-demand routing (ODR), Open Shortest Path First (OSPF),
and Routing Information Protocol (RIP).
Cisco IOS IP SLAs Configuration Guide
Cisco IOS IP Service Level Agreements (IP SLAs).
Cisco IOS XE IP Routing Protocols Configuration Guide
Cisco IOS XE IP SLAs Configuration Guide
Cisco IOS IP SLAs Command Reference
Cisco IOS IP Switching Configuration Guide
Cisco IOS XE IP Switching Configuration Guide
Cisco Express Forwarding, fast switching, and Multicast
Distributed Switching (MDS).
Cisco IOS IP Switching Command Reference
Cisco IOS IPv6 Configuration Guide
Cisco IOS XE IPv6 Configuration Guide
For IPv6 features, protocols, and technologies, go to the IPv6
“Start Here” document at the following URL:
Cisco IOS IPv6 Command Reference
http://www.cisco.com/en/US/docs/ios/ipv6/configuration/
guide/ip6-roadmap.html
Cisco IOS ISO CLNS Configuration Guide
ISO connectionless network service (CLNS).
Cisco IOS XE ISO CLNS Configuration Guide
Cisco IOS ISO CLNS Command Reference
Cisco IOS LAN Switching Configuration Guide
Cisco IOS XE LAN Switching Configuration Guide
VLANs, Inter-Switch Link (ISL) encapsulation, IEEE 802.10
encapsulation, IEEE 802.1Q encapsulation, and multilayer
switching (MLS).
Cisco IOS LAN Switching Command Reference
Cisco IOS Mobile Wireless Gateway GPRS Support Node
Configuration Guide
Cisco IOS Mobile Wireless Gateway GPRS Support Node
Command Reference
Cisco IOS Mobile Wireless Home Agent
Configuration Guide
Cisco IOS Mobile Wireless Home Agent
Command Reference
Cisco IOS Mobile Wireless Packet Data Serving Node
Configuration Guide
Cisco IOS Mobile Wireless Packet Data Serving Node
Command Reference
Cisco IOS Mobile Wireless Radio Access Networking
Configuration Guide
Cisco IOS Mobile Wireless Radio Access Networking
Command Reference
viii
Cisco IOS Gateway GPRS Support Node (GGSN) in a
2.5-generation general packet radio service (GPRS) and
3-generation universal mobile telecommunication system (UMTS)
network.
Cisco Mobile Wireless Home Agent, an anchor point for mobile
terminals for which mobile IP or proxy mobile IP services are
provided.
Cisco Packet Data Serving Node (PDSN), a wireless gateway that
is between the mobile infrastructure and standard IP networks and
that enables packet data services in a code division multiple access
(CDMA) environment.
Cisco IOS radio access network products.
About Cisco IOS and Cisco IOS XE Software Documentation
Documentation Organization
Table 1
Cisco IOS and Cisco IOS XE Configuration Guides and Command References (continued)
Configuration Guide and Command Reference Titles
Features/Protocols/Technologies
Cisco IOS Multiprotocol Label Switching
Configuration Guide
MPLS Label Distribution Protocol (LDP), MPLS Layer 2 VPNs,
MPLS Layer 3 VPNs, MPLS Traffic Engineering (TE), and
MPLS Embedded Management (EM) and MIBs.
Cisco IOS XE Multiprotocol Label Switching
Configuration Guide
Cisco IOS Multiprotocol Label Switching
Command Reference
Cisco IOS Multi-Topology Routing Configuration Guide
Cisco IOS Multi-Topology Routing Command Reference
Cisco IOS NetFlow Configuration Guide
Cisco IOS XE NetFlow Configuration Guide
Unicast and multicast topology configurations, traffic
classification, routing protocol support, and network
management support.
Network traffic data analysis, aggregation caches, export
features.
Cisco IOS NetFlow Command Reference
Cisco IOS Network Management Configuration Guide
Cisco IOS XE Network Management Configuration Guide
Cisco IOS Network Management Command Reference
Cisco IOS Novell IPX Configuration Guide
Basic system management; system monitoring and logging;
troubleshooting, logging, and fault management;
Cisco Discovery Protocol; Cisco IOS Scripting with Tool
Control Language (Tcl); Cisco networking services (CNS);
DistributedDirector; Embedded Event Manager (EEM);
Embedded Resource Manager (ERM); Embedded Syslog
Manager (ESM); HTTP; Remote Monitoring (RMON); SNMP;
and VPN Device Manager Client for Cisco IOS Software
(XSM Configuration).
Novell Internetwork Packet Exchange (IPX) protocol.
Cisco IOS XE Novell IPX Configuration Guide
Cisco IOS Novell IPX Command Reference
Cisco IOS Optimized Edge Routing Configuration Guide
Cisco IOS Optimized Edge Routing Command Reference
Cisco IOS Quality of Service Solutions
Configuration Guide
Cisco IOS XE Quality of Service Solutions
Configuration Guide
Cisco IOS Quality of Service Solutions
Command Reference
Cisco IOS Security Configuration Guide
Cisco IOS XE Security Configuration Guide
Cisco IOS Security Command Reference
Optimized edge routing (OER) monitoring, policy
configuration, routing control, logging and reporting, and
VPN IPsec/generic routing encapsulation (GRE) tunnel
interface optimization.
Class-based weighted fair queuing (CBWFQ), custom queuing,
distributed traffic shaping (DTS), generic traffic shaping (GTS),
IP- to-ATM class of service (CoS), low latency queuing (LLQ),
modular QoS CLI (MQC), Network-Based Application
Recognition (NBAR), priority queuing, Security Device
Manager (SDM), Multilink PPP (MLPPP) for QoS, header
compression, AutoQoS, QoS features for voice, Resource
Reservation Protocol (RSVP), weighted fair queuing (WFQ),
and weighted random early detection (WRED).
Access control lists (ACLs), authentication, authorization, and
accounting (AAA), firewalls, IP security and encryption,
neighbor router authentication, network access security, network
data encryption with router authentication, public key
infrastructure (PKI), RADIUS, TACACS+, terminal access
security, and traffic filters.
ix
About Cisco IOS and Cisco IOS XE Software Documentation
Documentation Organization
Table 1
Cisco IOS and Cisco IOS XE Configuration Guides and Command References (continued)
Configuration Guide and Command Reference Titles
Features/Protocols/Technologies
Cisco IOS Service Selection Gateway Configuration Guide Subscriber authentication, service access, and accounting.
Cisco IOS Service Selection Gateway Command Reference
Cisco IOS Software Activation Configuration Guide
Cisco IOS Software Activation Command Reference
Cisco IOS Software Modularity Installation and
Configuration Guide
Cisco IOS Software Modularity Command Reference
Cisco IOS Terminal Services Configuration Guide
Cisco IOS Terminal Services Command Reference
An orchestrated collection of processes and components to
activate Cisco IOS software feature sets by obtaining and
validating Cisco software licenses.
Installation and basic configuration of software modularity
images, including installations on single and dual route
processors, installation rollbacks, software modularity binding,
software modularity processes and patches.
DEC, local-area transport (LAT), and X.25 packet
assembler/disassembler (PAD).
Cisco IOS XE Terminal Services Command Reference
Cisco IOS Virtual Switch Command Reference
Virtual switch redundancy, high availability, and packet handling;
converting between standalone and virtual switch modes; virtual
switch link (VSL); Virtual Switch Link Protocol (VSLP).
Note
Cisco IOS Voice Configuration Library
Cisco IOS Voice Command Reference
Cisco IOS VPDN Configuration Guide
Cisco IOS XE VPDN Configuration Guide
Cisco IOS VPDN Command Reference
For information about virtual switch configuration, refer
to the product-specific software configuration
information for the Cisco Catalyst 6500 series switch or
for the Metro Ethernet 6500 series switch.
Cisco IOS support for voice call control protocols, interoperability,
physical and virtual interface management, and troubleshooting.
The library includes documentation for IP telephony applications.
Layer 2 Tunneling Protocol (L2TP) dial-out load balancing and
redundancy, L2TP extended failover, L2TP security VPDN,
multihop by Dialed Number Identification Service (DNIS),
timer and retry enhancements for L2TP and Layer 2 Forwarding
(L2F), RADIUS Attribute 82: tunnel assignment ID, shell-based
authentication of VPDN users, tunnel authentication via
RADIUS on tunnel terminator.
Cisco IOS Wide-Area Networking Configuration Guide
Frame Relay, Layer 2 Tunneling Protocol Version 3 (L2TPv3),
Procedure, Balanced (LAPB), Switched
Cisco IOS XE Wide-Area Networking Configuration Guide Link Access
Multimegabit Data Service (SMDS), and X.25.
Cisco IOS Wide-Area Networking Command Reference
Cisco IOS Wireless LAN Configuration Guide
Cisco IOS Wireless LAN Command Reference
x
Broadcast key rotation, IEEE 802.11x support, IEEE 802.1x
authenticator, IEEE 802.1x local authentication service for
Extensible Authentication Protocol-Flexible Authentication via
Secure Tunneling (EAP-FAST), Multiple Basic Service Set ID
(BSSID), Wi-Fi Multimedia (WMM) required elements, and
Wi-Fi Protected Access (WPA).
About Cisco IOS and Cisco IOS XE Software Documentation
Additional Resources and Documentation Feedback
Table 2
Cisco IOS Supplementary Documents and Resources
Document Title
Description
Cisco IOS Master Command List, All Releases
Alphabetical list of all the commands documented in all
Cisco IOS releases.
Cisco IOS New, Modified, Removed, and
Replaced Commands
List of all the new, modified, removed, and replaced commands
for a Cisco IOS release.
Cisco IOS Software System Messages
List of Cisco IOS system messages and descriptions. System
messages may indicate problems with your system; be
informational only; or may help diagnose problems with
communications lines, internal hardware, or the
system software.
Cisco IOS Debug Command Reference
Alphabetical list of debug commands including brief
descriptions of use, command syntax, and usage guidelines.
Release Notes and Caveats
Information about new and changed features, system
requirements, and other useful information about specific
software releases; information about defects in specific
Cisco IOS software releases.
MIBs
Files used for network monitoring. To locate and download
MIBs for selected platforms, Cisco IOS releases, and feature
sets, use Cisco MIB Locator at the following URL:
http://www.cisco.com/go/mibs
RFCs
Standards documents maintained by the Internet Engineering
Task Force (IETF) that Cisco IOS documentation references
where applicable. The full text of referenced RFCs may be
obtained at the following URL:
http://www.rfc-editor.org/
Additional Resources and Documentation Feedback
What’s New in Cisco Product Documentation is published monthly and describes all new and revised
Cisco technical documentation. The What’s New in Cisco Product Documentation publication also
provides information about obtaining the following resources:
•
Technical documentation
•
Cisco product security overview
•
Product alerts and field notices
•
Technical assistance
Cisco IOS technical documentation includes embedded feedback forms where you can rate documents
and provide suggestions for improvement. Your feedback helps us improve our documentation.
xi
About Cisco IOS and Cisco IOS XE Software Documentation
Additional Resources and Documentation Feedback
CCDE, CCENT, Cisco Eos, Cisco HealthPresence, the Cisco logo, Cisco Lumin, Cisco Nexus, Cisco StadiumVision, Cisco TelePresence,
Cisco WebEx, DCE, and Welcome to the Human Network are trademarks; Changing the Way We Work, Live, Play, and Learn and Cisco Store are
service marks; and Access Registrar, Aironet, AsyncOS, Bringing the Meeting To You, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, CCSP,
CCVP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco IOS, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo,
Cisco Unity, Collaboration Without Limitation, EtherFast, EtherSwitch, Event Center, Fast Step, Follow Me Browsing, FormShare, GigaDrive,
HomeLink, Internet Quotient, IOS, iPhone, iQuick Study, IronPort, the IronPort logo, LightStream, Linksys, MediaTone, MeetingPlace,
MeetingPlace Chime Sound, MGX, Networkers, Networking Academy, Network Registrar, PCNow, PIX, PowerPanels, ProConnect, ScriptShare,
SenderBase, SMARTnet, Spectrum Expert, StackWise, The Fastest Way to Increase Your Internet Quotient, TransPath, WebEx, and the WebEx logo
are registered trademarks of Cisco Systems, Inc. and/or its affiliates in the United States and certain other countries.
All other trademarks mentioned in this document or website are the property of their respective owners. The use of the word partner does not imply
a partnership relationship between Cisco and any other company. (0812R)
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any
examples, command display output, network topology diagrams, and other figures included in the document are shown for illustrative purposes only.
Any use of actual IP addresses or phone numbers in illustrative content is unintentional and coincidental.
© 2008–2009 Cisco Systems, Inc. All rights reserved.
xii
Using the Command-Line Interface in Cisco IOS
and Cisco IOS XE Software
Last Updated: March 5, 2009
This document provides basic information about the command-line interface (CLI) in Cisco IOS and
Cisco IOS XE software and how you can use some of the CLI features. This document contains the
following sections:
•
Initially Configuring a Device, page i
•
Using the CLI, page ii
•
Saving Changes to a Configuration, page xii
•
Additional Information, page xii
For more information about using the CLI, see the “Using the Cisco IOS Command-Line Interface”
section of the Cisco IOS Configuration Fundamentals Configuration Guide.
For information about the software documentation set, see the “About Cisco IOS and Cisco IOS XE
Software Documentation” document.
Initially Configuring a Device
Initially configuring a device varies by platform. For information about performing an initial
configuration, see the hardware installation documentation that is provided with the original packaging
of the product or go to the Product Support area of Cisco.com at
http://www.cisco.com/web/psa/products/index.html.
After you have performed the initial configuration and connected the device to your network, you can
configure the device by using the console port or a remote access method, such as Telnet or Secure Shell
(SSH), to access the CLI or by using the configuration method provided on the device, such as Security
Device Manager.
i
Using the Command-Line Interface in Cisco IOS and Cisco IOS XE Software
Using the CLI
Changing the Default Settings for a Console or AUX Port
There are only two changes that you can make to a console port and an AUX port:
Note
•
Change the port speed with the config-register 0x command. Changing the port speed is not
recommended. The well-known default speed is 9600.
•
Change the behavior of the port; for example, by adding a password or changing the timeout value.
The AUX port on the Route Processor (RP) installed in a Cisco ASR1000 series router does not serve
any useful customer purpose and should be accessed only under the advisement of a customer support
representative.
Using the CLI
This section describes the following topics:
•
Understanding Command Modes, page ii
•
Using the Interactive Help Feature, page v
•
Understanding Command Syntax, page vi
•
Understanding Enable and Enable Secret Passwords, page viii
•
Using the Command History Feature, page viii
•
Abbreviating Commands, page ix
•
Using Aliases for CLI Commands, page ix
•
Using the no and default Forms of Commands, page x
•
Using the debug Command, page x
•
Filtering Output Using Output Modifiers, page x
•
Understanding CLI Error Messages, page xi
Understanding Command Modes
The CLI command mode structure is hierarchical, and each mode supports a set of specific commands.
This section describes the most common of the many modes that exist.
Table 1 lists common command modes with associated CLI prompts, access and exit methods, and a
brief description of how each mode is used.
ii
Using the Command-Line Interface in Cisco IOS and Cisco IOS XE Software
Using the CLI
Table 1
CLI Command Modes
Command
Mode
Access Method
Prompt
Exit Method
User EXEC
Log in.
Router>
Issue the logout or exit
command.
Privileged
EXEC
From user EXEC mode,
issue the enable
command.
Router#
Issue the disable
command or the exit
command to return to
user EXEC mode.
Mode Usage
•
Change terminal
settings.
•
Perform basic tests.
•
Display device status.
•
Issue show and debug
commands.
•
Copy images to the
device.
•
Reload the device.
•
Manage device
configuration files.
•
Manage device file
systems.
Global
configuration
From privileged EXEC
mode, issue the
configure terminal
command.
Router(config)#
Issue the exit command Configure the device.
or the end command to
return to privileged
EXEC mode.
Interface
configuration
From global
configuration mode,
issue the interface
command.
Router(config-if)#
Issue the exit command Configure individual
to return to global
interfaces.
configuration mode or
the end command to
return to privileged
EXEC mode.
Line
configuration
Router(config-line)# Issue the exit command Configure individual
From global
configuration mode,
to return to global
terminal lines.
issue the line vty or line
configuration mode or
console command.
the end command to
return to privileged
EXEC mode.
iii
Using the Command-Line Interface in Cisco IOS and Cisco IOS XE Software
Using the CLI
Table 1
CLI Command Modes (continued)
Command
Mode
Access Method
Prompt
Exit Method
ROM monitor
From privileged EXEC
mode, issue the reload
command. Press the
Break key during the
first 60 seconds while
the system is booting.
rommon # >
Issue the continue
command.
Diagnostic
(available only
on the Cisco
ASR1000
series router)
Router(diag)#
The router boots or
enters diagnostic mode
in the following
scenarios. When a
Cisco IOS process or
processes fail, in most
scenarios the router will
reload.
•
•
•
iv
The # symbol
represents the line
number and increments
at each prompt.
A user-configured
access policy was
configured using
the transport-map
command, which
directed the user
into diagnostic
mode.
The router was
accessed using an
RP auxiliary port.
A break signal
(Ctrl-C,
Ctrl-Shift-6, or the
send break
command) was
entered, and the
router was
configured to enter
diagnostic mode
when the break
signal was received.
If a Cisco IOS process
failure is the reason for
entering diagnostic
mode, the failure must
be resolved and the
router must be rebooted
to exit diagnostic mode.
If the router is in
diagnostic mode
because of a
transport-map
configuration, access
the router through
another port or using a
method that is
configured to connect to
the Cisco IOS CLI.
If the RP auxiliary port
was used to access the
router, use another port
for access. Accessing
the router through the
auxiliary port is not
useful for customer
purposes.
Mode Usage
•
Run as the default
operating mode when a
valid image cannot be
loaded.
•
Access the fall-back
procedure for loading an
image when the device
lacks a valid image and
cannot be booted.
•
Perform password
recovery when a
CTRL-Break sequence is
issued within 60 seconds
of a power-on or reload
event.
•
Inspect various states on
the router, including the
Cisco IOS state.
•
Replace or roll back the
configuration.
•
Provide methods of
restarting the Cisco IOS
software or other
processes.
•
Reboot hardware, such
as the entire router, an
RP, an ESP, a SIP, a SPA,
or possibly other
hardware components.
•
Transfer files into or off
of the router using
remote access methods
such as FTP, TFTP, and
SCP.
Using the Command-Line Interface in Cisco IOS and Cisco IOS XE Software
Using the CLI
EXEC commands are not saved when the software reboots. Commands that you issue in a configuration
mode can be saved to the startup configuration. If you save the running configuration to the startup
configuration, these commands will execute when the software is rebooted. Global configuration mode
is the highest level of configuration mode. From global configuration mode, you can enter a variety of
other configuration modes, including protocol-specific modes.
ROM monitor mode is a separate mode that is used when the software cannot load properly. If a valid
software image is not found when the software boots or if the configuration file is corrupted at startup,
the software might enter ROM monitor mode. Use the question symbol (?) to view the commands that
you can use while the device is in ROM monitor mode.
rommon 1 > ?
alias
boot
confreg
cont
context
cookie
.
.
.
rommon 2 >
set and display aliases command
boot up an external process
configuration register utility
continue executing a downloaded image
display the context of a loaded image
display contents of cookie PROM in hex
The following example shows how the command prompt changes to indicate a different command mode:
Router> enable
Router# configure terminal
Router(config)# interface ethernet 1/1
Router(config-if)# ethernet
Router(config-line)# exit
Router(config)# end
Router#
Note
A keyboard alternative to the end command is Ctrl-Z.
Using the Interactive Help Feature
The CLI includes an interactive Help feature. Table 2 describes how to use the Help feature.
Table 2
CLI Interactive Help Commands
Command
Purpose
help
Provides a brief description of the help feature in any command mode.
?
Lists all commands available for a particular command mode.
partial command?
Provides a list of commands that begin with the character string (no
space between the command and the question mark).
partial command<Tab>
Completes a partial command name (no space between the command
and <Tab>).
command ?
Lists the keywords, arguments, or both associated with the command
(space between the command and the question mark).
command keyword ?
Lists the arguments that are associated with the keyword (space between
the keyword and the question mark).
v
Using the Command-Line Interface in Cisco IOS and Cisco IOS XE Software
Using the CLI
The following examples show how to use the help commands:
help
Router> help
Help may be requested at any point in a command by entering a question mark '?'. If nothing
matches, the help list will be empty and you must backup until entering a '?' shows the
available options.
Two styles of help are provided:
1. Full help is available when you are ready to enter a command argument (e.g. 'show ?')
and describes each possible argument.
2. Partial help is provided when an abbreviated argument is entered and you want to know
what arguments match the input (e.g. 'show pr?'.)
?
Router# ?
Exec commands:
access-enable
access-profile
access-template
alps
archive
<snip>
Create a temporary access-List entry
Apply user-profile to interface
Create a temporary access-List entry
ALPS exec commands
manage archive files
partial command?
Router(config)# zo?
zone zone-pair
partial command<Tab>
Router(config)# we<Tab> webvpn
command ?
Router(config-if)# pppoe ?
enable
Enable pppoe
max-sessions Maximum PPPOE sessions
command keyword ?
Router(config-if)# pppoe enable ?
group attach a BBA group
<cr>
Understanding Command Syntax
Command syntax is the format in which a command should be entered in the CLI. Commands include
the name of the command, keywords, and arguments. Keywords are alphanumeric strings that are used
literally. Arguments are placeholders for values that a user must supply. Keywords and arguments may
be required or optional.
Specific conventions convey information about syntax and command elements. Table 3 describes these
conventions.
vi
Using the Command-Line Interface in Cisco IOS and Cisco IOS XE Software
Using the CLI
Table 3
CLI Syntax Conventions
Symbol/Text
Function
Notes
< > (angle brackets)
Indicate that the option is an
argument.
Sometimes arguments are displayed
without angle brackets.
A.B.C.D.
Indicates that you must enter a
dotted decimal IP address.
Angle brackets (< >) are not always
used to indicate that an IP address is
an argument.
WORD (all capital letters)
Indicates that you must enter
one word.
Angle brackets (< >) are not always
used to indicate that a WORD is an
argument.
LINE (all capital letters)
Indicates that you must enter
more than one word.
Angle brackets (< >) are not always
used to indicate that a LINE is an
argument.
<cr> (carriage return)
Indicates the end of the list of —
available keywords and arguments, and also indicates when
keywords and arguments are
optional. When <cr> is the only
option, you have reached the
end of the branch or the end of
the command if the command
has only one branch.
The following examples show syntax conventions:
Router(config)# ethernet cfm domain ?
WORD domain name
Router(config)# ethernet cfm domain dname ?
level
Router(config)# ethernet cfm domain dname level ?
<0-7> maintenance level number
Router(config)# ethernet cfm domain dname level 7 ?
<cr>
Router(config)# snmp-server file-transfer access-group 10 ?
protocol protocol options
<cr>
Router(config)# logging host ?
Hostname or A.B.C.D IP address of the syslog server
ipv6
Configure IPv6 syslog server
Router(config)# snmp-server file-transfer access-group 10 ?
protocol protocol options
<cr>
vii
Using the Command-Line Interface in Cisco IOS and Cisco IOS XE Software
Using the CLI
Understanding Enable and Enable Secret Passwords
Some privileged EXEC commands are used for actions that impact the system, and it is recommended
that you set a password for these commands to prevent unauthorized use. Two types of passwords, enable
(not encrypted) and enable secret (encrypted), can be set. The following commands set these passwords
and are issued in global configuration mode:
•
enable password
•
enable secret password
Using an enable secret password is recommended because it is encrypted and more secure than the
enable password. When you use an enable secret password, text is encrypted (unreadable) before it is
written to the config.text file. When you use an enable password, the text is written as entered (readable)
to the config.text file.
Each type of password is case sensitive, can contain from 1 to 25 uppercase and lowercase alphanumeric
characters, and can start with a number. Spaces are also valid password characters; for example,
“two words” is a valid password. Leading spaces are ignored, but trailing spaces are recognized.
Note
Both password commands have numeric keywords that are single integer values. If you choose a number
for the first character of your password followed by a space, the system will read the number as if it were
the numeric keyword and not as part of your password.
When both passwords are set, the enable secret password takes precedence over the enable password.
To remove a password, use the no form of the commands: no enable password or
no enable secret password.
For more information about password recovery procedures for Cisco products, see
http://www.cisco.com/en/US/products/sw/iosswrel/ps1831/
products_tech_note09186a00801746e6.shtml.
Using the Command History Feature
The CLI command history feature saves the commands you enter during a session in a command history
buffer. The default number of commands saved is 10, but the number is configurable within the range of
0 to 256. This command history feature is particularly useful for recalling long or complex commands.
To change the number of commands saved in the history buffer for a terminal session, issue the
terminal history size command:
Router# terminal history size num
A command history buffer is also available in line configuration mode with the same default and
configuration options. To set the command history buffer size for a terminal session in line configuration
mode, issue the history command:
Router(config-line)# history [size num]
To recall commands from the history buffer, use the following methods:
•
viii
Press Ctrl-P or the up arrow key—Recalls commands beginning with the most recent command.
Repeat the key sequence to recall successively older commands.
Using the Command-Line Interface in Cisco IOS and Cisco IOS XE Software
Using the CLI
•
Press Ctrl-N or the down arrow key—Recalls the most recent commands in the history buffer after
they have been recalled using Ctrl-P or the up arrow key. Repeat the key sequence to recall
successively more recent commands.
Note
•
The arrow keys function only on ANSI-compatible terminals such as the VT100.
Issue the show history command in user EXEC or privileged EXEC mode—Lists the most recent
commands that you entered. The number of commands that are displayed is determined by the
setting of the terminal history size and history commands.
The CLI command history feature is enabled by default. To disable this feature for a terminal
session, issue the terminal no history command in user EXEC or privileged EXEC mode or the
no history command in line configuration mode.
Abbreviating Commands
Typing a complete command name is not always required for the command to execute. The CLI
recognizes an abbreviated command when the abbreviation contains enough characters to uniquely
identify the command. For example, the show version command can be abbreviated as sh ver. It cannot
be abbreviated as s ver because s could mean show, set, or systat. The sh v abbreviation also is not valid
because the show command has vrrp as a keyword in addition to version. (Command and keyword
examples from Cisco IOS Release 12.4(13)T.)
Using Aliases for CLI Commands
To save time and the repetition of entering the same command multiple times, you can use a command
alias. An alias can be configured to do anything that can be done at the command line, but an alias cannot
move between modes, type in passwords, or perform any interactive functions.
Table 4 shows the default command aliases.
Table 4
Default Command Aliases
Command Alias
Original Command
h
help
lo
logout
p
ping
s
show
u or un
undebug
w
where
To create a command alias, issue the alias command in global configuration mode. The syntax of the
command is alias mode command-alias original-command. Following are some examples:
•
Router(config)# alias exec prt partition—privileged EXEC mode
•
Router(config)# alias configure sb source-bridge—global configuration mode
•
Router(config)# alias interface rl rate-limit—interface configuration mode
ix
Using the Command-Line Interface in Cisco IOS and Cisco IOS XE Software
Using the CLI
To view both default and user-created aliases, issue the show alias command.
For more information about the alias command, see
http://www.cisco.com/en/US/docs/ios/fundamentals/command/reference/cf_book.html.
Using the no and default Forms of Commands
Most configuration commands have a no form that is used to reset a command to its default value or
disable a feature or function. For example, the ip routing command is enabled by default. To disable this
command, you would issue the no ip routing command. To re-enable IP routing, you would issue the
ip routing command.
Configuration commands may also have a default form, which returns the command settings to their
default values. For commands that are disabled by default, using the default form has the same effect as
using the no form of the command. For commands that are enabled by default and have default settings,
the default form enables the command and returns the settings to their default values.
The no and default forms of commands are described in the command pages of command references.
Using the debug Command
A debug command produces extensive output that helps you troubleshoot problems in your network.
These commands are available for many features and functions within Cisco IOS and Cisco IOS XE
software. Some debug commands are debug all, debug aaa accounting, and debug mpls packets. To
use debug commands during a Telnet session with a device, you must first enter the terminal monitor
command. To turn off debugging completely, you must enter the undebug all command.
For more information about debug commands, see the Cisco IOS Debug Command Reference at
http://www.cisco.com/en/US/docs/ios/debug/command/reference/db_book.html.
Caution
Debugging is a high priority and high CPU utilization process that can render your device unusable. Use
debug commands only to troubleshoot specific problems. The best times to run debugging are during
periods of low network traffic and when few users are interacting with the network. Debugging during
these periods decreases the likelihood that the debug command processing overhead will affect network
performance or user access or response times.
Filtering Output Using Output Modifiers
Many commands produce lengthy output that may use several screens to display. Using output modifiers,
you can filter this output to show only the information that you want to see.
Three output modifiers are available and are described as follows:
x
•
begin regular expression—Displays the first line in which a match of the regular expression is found
and all lines that follow.
•
include regular expression—Displays all lines in which a match of the regular expression is found.
•
exclude regular expression—Displays all lines except those in which a match of the regular
expression is found.
Using the Command-Line Interface in Cisco IOS and Cisco IOS XE Software
Using the CLI
To use one of these output modifiers, type the command followed by the pipe symbol (|), the modifier,
and the regular expression that you want to search for or filter. A regular expression is a case-sensitive
alphanumeric pattern. It can be a single character or number, a phrase, or a more complex string.
The following example illustrates how to filter output of the show interface command to display only
lines that include the expression “protocol.”
Router# show interface | include protocol
FastEthernet0/0 is up, line protocol is up
Serial4/0 is up, line protocol is up
Serial4/1 is up, line protocol is up
Serial4/2 is administratively down, line protocol is down
Serial4/3 is administratively down, line protocol is down
Understanding CLI Error Messages
You may encounter some error messages while using the CLI. Table 5 shows the common CLI error
messages.
Table 5
Common CLI Error Messages
Error Message
Meaning
% Ambiguous command:
“show con”
You did not enter enough
Reenter the command followed by a
characters for the command to space and a question mark (?). The
be recognized.
keywords that you are allowed to
enter for the command appear.
% Incomplete command.
You did not enter all the
keywords or values required
by the command.
% Invalid input detected at “^” You entered the command incorrectly. The caret (^) marks
marker.
the point of the error.
How to Get Help
Reenter the command followed by a
space and a question mark (?). The
keywords that you are allowed to
enter for the command appear.
Enter a question mark (?) to display
all the commands that are available in
this command mode. The keywords
that you are allowed to enter for the
command appear.
For more system error messages, see the following documents:
•
Cisco IOS Release 12.2SR System Message Guide
•
Cisco IOS System Messages, Volume 1 of 2 (Cisco IOS Release 12.4)
•
Cisco IOS System Messages, Volume 2 of 2 (Cisco IOS Release 12.4)
xi
Using the Command-Line Interface in Cisco IOS and Cisco IOS XE Software
Saving Changes to a Configuration
Saving Changes to a Configuration
To save changes that you made to the configuration of a device, you must issue the copy running-config
startup-config command or the copy system:running-config nvram:startup-config command. When
you issue these commands, the configuration changes that you made are saved to the startup
configuration and saved when the software reloads or power to the device is turned off or interrupted.
The following example shows the syntax of the copy running-config startup-config command:
Router# copy running-config startup-config
Destination filename [startup-config]?
You press Enter to accept the startup-config filename (the default), or type a new filename and then press
Enter to accept that name. The following output is displayed indicating that the configuration was saved:
Building configuration...
[OK]
Router#
On most platforms, the configuration is saved to NVRAM. On platforms with a Class A flash file system,
the configuration is saved to the location specified by the CONFIG_FILE environment variable. The
CONFIG_FILE variable defaults to NVRAM.
Additional Information
•
“Using the Cisco IOS Command-Line Interface” section of the Cisco IOS Configuration
Fundamentals Configuration Guide:
http://www.cisco.com/en/US/docs/ios/fundamentals/configuration/guide/cf_cli-basics.html
or
“Using Cisco IOS XE Software” chapter of the Cisco ASR 1000 Series Aggregation Services Routers
Software Configuration Guide:
http://www.cisco.com/en/US/docs/routers/asr1000/configuration/guide/chassis/Using_CLI.html
•
Cisco Product Support Resources
http://www.cisco.com/web/psa/products/index.html
•
Support area on Cisco.com (also search for documentation by task or product)
http://www.cisco.com/en/US/support/index.html
•
Software Download Center (downloads; tools; licensing, registration, advisory, and general
information) (requires Cisco.com User ID and password)
http://www.cisco.com/kobayashi/sw-center/
•
Error Message Decoder, a tool to help you research and resolve error messages for
Cisco IOS software
http://www.cisco.com/pcgi-bin/Support/Errordecoder/index.cgi
•
Command Lookup Tool, a tool to help you find detailed descriptions of Cisco IOS commands
(requires Cisco.com user ID and password)
http://tools.cisco.com/Support/CLILookup
xii
Using the Command-Line Interface in Cisco IOS and Cisco IOS XE Software
Additional Information
•
Output Interpreter, a troubleshooting tool that analyzes command output of supported
show commands
https://www.cisco.com/pcgi-bin/Support/OutputInterpreter/home.pl
CCDE, CCENT, Cisco Eos, Cisco HealthPresence, the Cisco logo, Cisco Lumin, Cisco Nexus, Cisco StadiumVision, Cisco TelePresence,
Cisco WebEx, DCE, and Welcome to the Human Network are trademarks; Changing the Way We Work, Live, Play, and Learn and Cisco Store are
service marks; and Access Registrar, Aironet, AsyncOS, Bringing the Meeting To You, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, CCSP,
CCVP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco IOS, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo,
Cisco Unity, Collaboration Without Limitation, EtherFast, EtherSwitch, Event Center, Fast Step, Follow Me Browsing, FormShare, GigaDrive,
HomeLink, Internet Quotient, IOS, iPhone, iQuick Study, IronPort, the IronPort logo, LightStream, Linksys, MediaTone, MeetingPlace,
MeetingPlace Chime Sound, MGX, Networkers, Networking Academy, Network Registrar, PCNow, PIX, PowerPanels, ProConnect, ScriptShare,
SenderBase, SMARTnet, Spectrum Expert, StackWise, The Fastest Way to Increase Your Internet Quotient, TransPath, WebEx, and the WebEx logo
are registered trademarks of Cisco Systems, Inc. and/or its affiliates in the United States and certain other countries.
All other trademarks mentioned in this document or website are the property of their respective owners. The use of the word partner does not imply
a partnership relationship between Cisco and any other company. (0812R)
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any
examples, command display output, network topology diagrams, and other figures included in the document are shown for illustrative purposes only.
Any use of actual IP addresses or phone numbers in illustrative content is unintentional and coincidental.
© 2008–2009 Cisco Systems, Inc. All rights reserved.
xiii
Using the Command-Line Interface in Cisco IOS and Cisco IOS XE Software
Additional Information
xiv
Cisco Unified Border Element with Gatekeeper
Features Roadmap
This roadmap lists the features documented in the Cisco Unified Border Element with Gatekeeper
Configuration Guide(previously known as the Cisco Multiservice IP-to-IP Gateway with Gatekeeper
Application Guide) and maps them to the modules in which they appear.
Roadmap History
This roadmap was first published on June 19, 2006, and last updated on July 11, 2008.
Cisco Unified Border ElementFeature and Release Support
Table 1 lists Cisco Unified Border Element with Gatekeeper feature support for the following
Cisco IOS software release trains:
•
Cisco IOS Releases 12.2T, 12.3, 12.3T, 12.4, and 12.4T
Only features that were introduced or modified in Cisco IOS Release Cisco IOS Releases 12.2(13)T or
a later release appear in the table. Not all features may be supported in your Cisco IOS software release.
Use Cisco Feature Navigator to find information about platform support and software image support.
Cisco Feature Navigator enables you to determine which Cisco IOS and Catalyst OS software images
support a specific software release, feature set, or platform. To access Cisco Feature Navigator, go to
http://www.cisco.com/go/cfn. An account on Cisco.com is not required.
Note
Table 1 lists only the Cisco IOS software release that introduced support for a given feature in a given
Cisco IOS software release train. Unless noted otherwise, subsequent releases of that Cisco IOS
software release train also support that feature.
Americas Headquarters:
Cisco Systems, Inc., 170 West Tasman Drive, San Jose, CA 95134-1706 USA
© 2008 Cisco Systems, Inc. All rights reserved.
Cisco Unified Border Element with Gatekeeper Features Roadmap
Table 1
Release
Supported Cisco Multiservice Cisco Unified Border Element with Gatekeeper Configuration Guide
Features
Feature Name
Feature Description
Where Documented
Cisco IOS Releases 12.2T, 12.3, 12.3T, 12.4, and 12.4T
12.4(20)T
Extended InterZone Clear Provides additional security to the gatekeeper by
Token
ensuring that ARQ and RRQ are not spoofed.
Configring Extended
InterZone Clear Token
Support section of the
“Configuring Cisco
Unified Border Element
with Gatekeeper” chapter
of this guide.
Enhanced ARQ and RRQ Provides additional security checks upon recieving the
Security for Gatekeeper
registration request (RRQ) from an enpoint. Introduces
Registrations
the following features:
Enhanced ARQ and RRQ
Security for Gatekeeper
Registrations section of
the “Configuring Cisco
Unified Border Element
with Gatekeeper” chapter
of this guide.
•
Enhanced ARQ and RRQ Security for Gatekeeper
Registrations
•
Enhanced Security checks at GK for ARQ/DRQ/
BRQ/URQ/IIR
12.4(15)XZ
Extended InterZone Clear Provides additional security to the gatekeeper by
Token
ensuring that ARQ and RRQ are not spoofed.
Configring Extended
InterZone Clear Token
Support section of the
“Configuring Cisco
Unified Border Element
with Gatekeeper” chapter
of this guide.
12.4(15)XY
—
—
The Cisco Multiservice IP-to-IP Gateway with
Gatekeeper Application Guide was renamed Cisco
Unified Border Element with Gatekeeper Configuration
guide to match the marketed product name change.
Enhanced ARQ and RRQ Provides additional security checks upon recieving the
Security for Gatekeeper
registration request (RRQ) from an enpoint. Introduces
Registrations
the following features:
12.4(9)T
—
•
Enhanced ARQ and RRQ Security for Gatekeeper
Registrations
•
Enhanced Security checks at GK for ARQ/DRQ/
BRQ/URQ/IIR
Content found in the Cisco IOS Multiservice IP-to-IP
—
Gateway Application Guide was divided into two books;
Cisco Multiservice IP-to-IP Gateway with Gatekeeper
Application Guide and the Cisco Multiservice IP-to-IP
Gateway with Gatekeeper Application Guide.
Cisco Unified Border Element with Gatekeeper Configuration Guide
2
Enhanced ARQ and RRQ
Security for Gatekeeper
Registrations section of
the “Configuring Cisco
Unified Border Element
with Gatekeeper” chapter
of this guide.
Cisco Unified Border Element with Gatekeeper Features Roadmap
Table 1
Supported Cisco Multiservice Cisco Unified Border Element with Gatekeeper Configuration Guide Features
(continued)
Release
Feature Name
Feature Description
Where Documented
12.4(6)T
Unique Calling Party
Information with
Alternate Endpoints
Enables alternate endpoint capabilities of the Cisco IOS
H.323 gatekeeper and voice gateway to associate a
unique calling party number automatic number
identification (ANI) with each alternate endpoint using
the GKTMP.
“Unique Calling Party
Information with
Alternate Endpoints”
section of the
“Configuring Cisco
Unified Border Element
with Gatekeeper” chapter
of this guide.
In-Service Updates to
Gatekeeper Zone Prefix
Configuration
Increases the availability of H.323 VoIP networks by
allowing changes to a gatekeeper zone prefix while the
gatekeeper is running and managing active E.164
registrations.
“In-Service Updates to
Gatekeeper Zone Prefix
Configuration” section of
the “Configuring Cisco
Unified Border Element
with Gatekeeper” chapter
of this guide.
Dynamic Control of
Gatekeeper Sequential
LRQ Processing Through
Gatekeeper Transaction
Message Protocol
Enables a control field in the GKTMP that allows an
external application to halt normal alternate routing
procedures at the gatekeeper, to reduce call setup times
and reject calls quickly during peak traffic periods in the
wholesale provider’s network.
“Dynamic Control of
Gatekeeper Sequential
LRQ Processing Through
GKTMP” section of the
“Configuring Cisco
Unified Border Element
with Gatekeeper” chapter
of this guide.
RAS retry and timer
Allows service providers the ability to control transmit
time margins on Cisco gatekeepers by changing RAS
message timeout LRQ value and message retry counter
values.
“Configuring RAS Retry
and Timer” section of the
“Configuring Cisco
Unified Border Element
with Gatekeeper” chapter
of this guide.
Real-Time Call Type
Reporting Through
Gatekeeper Transaction
Message Protocol
(GKTMP)
Enables Cisco H.323 VoIP gateways to report the call
“Configuring Real-Time
type (voice/fax/modem) to a Cisco IOS gatekeeper at the Call Type Reporting
end of each call.
Through GKTMP”
section of the
“Configuring Cisco
Unified Border Element
with Gatekeeper” chapter
of this guide.
Sequential LRQ timer
Defines the time window during which the gatekeeper
collects responses from the gateway before resending a
RAS message to a gatekeeper, and the number of times to
resend the RAS message after the timeout period expires.
12.4(4)T
“Configuring the
Sequential LRQ Timer”
section of the
“Configuring Cisco
Unified Border Element
with Gatekeeper” chapter
of this guide.
Cisco Unified Border Element with Gatekeeper Configuration Guide
3
Cisco Unified Border Element with Gatekeeper Features Roadmap
Table 1
Release
Supported Cisco Multiservice Cisco Unified Border Element with Gatekeeper Configuration Guide Features
(continued)
Feature Name
Feature Description
Where Documented
H.323 Standard Based
Hopcount Field in LRQ
Support for H.225 version 4 standard hopCount field in
LocationRequest RAS message.
“H.323 Standard-Based
Hopcount Field in LRQ”
section of the
“Configuring Cisco
Unified Border Element
with Gatekeeper” chapter
of this guide.
Identify Alternate
Controls alternate endpoint hunting based on call
Endpoint Call Attempts in disconnect cause codes.
RADIUS Call
Accounting Records
“Configuring Alternate
Endpoint Call Attempts
in RADIUS Call
Accounting Records”
section of the
“Configuring Cisco
Unified Border Element
with Gatekeeper” chapter
of this guide.
No Retry on User Busy in Changes the default behavior of the gateway to not retry “Configuring Alternate
an Cisco Unified Border alternate endpoints when the release complete reason is Endpoint Call Attempts
user busy.
in RADIUS Call
Element
Accounting Records”
section of the
“Configuring Cisco
Unified Border Element
with Gatekeeper” chapter
of this guide.
CCDE, CCENT, Cisco Eos, Cisco Lumin, Cisco Nexus, Cisco StadiumVision, Cisco TelePresence, the Cisco logo, DCE, and Welcome to the Human
Network are trademarks; Changing the Way We Work, Live, Play, and Learn and Cisco Store are service marks; and Access Registrar, Aironet,
AsyncOS, Bringing the Meeting To You, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, CCSP, CCVP, Cisco, the Cisco Certified Internetwork
Expert logo, Cisco IOS, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity, Collaboration Without Limitation,
EtherFast, EtherSwitch, Event Center, Fast Step, Follow Me Browsing, FormShare, GigaDrive, HomeLink, Internet Quotient, IOS, iPhone, iQ
Expertise, the iQ logo, iQ Net Readiness Scorecard, iQuick Study, IronPort, the IronPort logo, LightStream, Linksys, MediaTone, MeetingPlace,
MeetingPlace Chime Sound, MGX, Networkers, Networking Academy, Network Registrar, PCNow, PIX, PowerPanels, ProConnect, ScriptShare,
SenderBase, SMARTnet, Spectrum Expert, StackWise, The Fastest Way to Increase Your Internet Quotient, TransPath, WebEx, and the WebEx logo
are registered trademarks of Cisco Systems, Inc. and/or its affiliates in the United States and certain other countries.
All other trademarks mentioned in this document or Website are the property of their respective owners. The use of the word partner does not imply
a partnership relationship between Cisco and any other company. (0807R)
Any Internet Protocol (IP) addresses used in this document are not intended to be actual addresses. Any examples, command display output, and
figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses in illustrative content is unintentional and
coincidental.
© 2008 Cisco Systems, Inc. All rights reserved.
Cisco Unified Border Element with Gatekeeper Configuration Guide
4
Overview of Cisco Unified Border Element with
Gatekeeper
Revised: August 5, 2009
First Published: June 19, 2006
Last Updated: August 5, 2009
This guide describes the Cisco Unified Border Element with Gatekeeper(Cisco UBE with Gatekeeper)
and related features.
Activation
Before you can configure the software features described in this guide, you will need a Product
Authorization Key (PAK). Before you start the configuration process, please register your products and
activate your PAK at the following URL http://www.cisco.com/go/license.
An Cisco Unified Border Element, in this guide called an Cisco UBE but sometimes elsewhere called an
IP-to-IP Gateway, border element or session border controller, facilitates connectivity between
independent VoIP networks by enabling H.323 VoIP and videoconferencing calls from one IP network
to another. This gateway performs most of the same functions of a PSTN-to-IP gateway, but typically
joins two IP call legs, rather than a PSTN and an IP call leg. Media packets can flow either through the
gateway (thus hiding the networks from each other) or around the gateway, if so configured.
Cisco Unified Border Element with Gatekeeper is a special Cisco IOS software image that runs on Cisco
multiservice gateway platforms. It provides a network-to-network interface point for billing, security,
call admission control, quality of service, and signaling interworking.
Cisco Unified Border Element with Gatekeeper is designed to meet the interconnection needs of Internet
telephony service providers (ITSPs) and of enterprises. One set of images provides basic interconnection
and a second set provides interconnection through an Open Settlement Protocol (OSP) provider,
enabling ITSPs to gain the benefits of the Cisco Unified Border Element with Gatekeeper while making
use of the routing, billing, and settlement capabilities offered by OSP-based clearinghouses.
For the most effective and scalable results, use the Cisco Unified Border Element concurrently with a
Cisco gatekeeper.
Feature history for the umbrella Cisco Unified Border Element with Gatekeeper suite of features is
shown below. Individual feature histories are provided in the following chapters.
Americas Headquarters:
Cisco Systems, Inc., 170 West Tasman Drive, San Jose, CA 95134-1706 USA
© 2008 Cisco Systems, Inc. All rights reserved.
Overview of Cisco Unified Border Element with Gatekeeper
Contents
Finding Feature Information in This Module
Your Cisco IOS software release may not support all of the features documented in this module. To reach
links to specific feature documentation in this module and to see a list of the releases in which each feature
is supported, use the “Cisco Unified Border Element Features Roadmap” chapter of this book.
Finding Support Information for Platforms and Cisco IOS and Catalyst OS Software Images
Use Cisco Feature Navigator to find information about platform support and Cisco IOS and Catalyst OS
software image support. To access Cisco Feature Navigator, go to http://www.cisco.com/go/cfn. An
account on Cisco.com is not required.
Note
For more information about Cisco IOS voice features, see the entire Cisco IOS Voice Configuration
Library—including library preface and glossary, feature documents, and troubleshooting
information—at http://www.cisco.com/univercd/cc/td/doc/product/software/ios124/124tcg/vcl.htm.
Contents
•
Prerequisites for Cisco Unified Border Element with Gatekeeper Configuration, page 6
•
Restrictions for Cisco Unified Border Element with Gatekeeper Configuration, page 8
•
Information About Cisco Unified Border Element with Gatekeeper, page 8
•
Toll Fraud Prevention, page 13
•
Additional References, page 14
Prerequisites for Cisco Unified Border Element with Gatekeeper
Configuration
Cisco Unified Border Element with Gatekeeper Hardware
•
Install the routers that will serve as session border controllers in your VoIP network.
Cisco Unified Border Element with Gatekeeper Software
•
Activation
Cisco Product Authorization Key (PAK)
Before you can configure the software features described in this guide, you will need a Product
Authorization Key (PAK). Before you start the configuration process, please register your products and
activate your PAK at the following URL http://www.cisco.com/go/license.
•
Obtain the appropriate feature license for each router on which you will install an image that
supports the Cisco Unified Border Element with Gatekeeper feature. Additional information on
obtaining a feature license can be found at:
http://www.cisco.com/en/US/products/sw/voicesw/ps5640/products_data_sheet
09186a00801da698.html
•
Install the appropriate Cisco IOS image on each router and configure a working VoIP network.
Cisco Unified Border Element with Gatekeeper Configuration Guide
6
Overview of Cisco Unified Border Element with Gatekeeper
Prerequisites for Cisco Unified Border Element with Gatekeeper Configuration
Use Cisco Feature Navigator to find information about platform support and software image
support. Cisco Feature Navigator enables you to determine which Cisco IOS and Catalyst OS
software images support a specific software release, feature set, or platform. To access Cisco Feature
Navigator, go to http://tools.cisco.com/ITDIT/CFN/. An account on Cisco.com is not required.
Table 1 provides additional information on image and feature sets that support the Cisco Unified
Border Element with Gatekeeper.
Table 1
Cisco IOS Image and Feature Sets for the Cisco Unified Border Element with Gatekeeper Feature
Platform
Software Image Name
Software Feature Set
Cisco 2601XM
Cisco 2611XM
Cisco 2620XM
Cisco 2621XM
Cisco 2650XM
Cisco 2651XM
c2600-adventerprisek9_ivs-mz
c2600-ipvoice_ivs-mz
Cisco 2600 INT VOICE/VIDEO, IPIPGW, TDMIP GW AES
Cisco 2600 INT VOICE/VIDEO, IPIPGW, TDMIP GW
Cisco 2691
c2691-adventerprisek9_ivs-mz
c2691-ipvoice_ivs-mz
Cisco 2600 INT VOICE/VIDEO, IPIPGW, TDMIP GW AES
Cisco 2600 INT VOICE/VIDEO, IPIPGW, TDMIP GW
Cisco 2851
Cisco 2821
Cisco 2811
c2800nm-adventerprisek9_ivs-mz
c2800nm-ipvoice_ivs-mz
Cisco 2800 INT VOICE/VIDEO, IPIPGW, TDMIP GW AES
Cisco 2800 INT VOICE/VIDEO, IPIPGW, TDMIP GW
Cisco 2801
c2801-adventerprisek9_ivs-mz
c2801-ipvoice_ivs-mz
Cisco 2801 INT VOICE/VIDEO, IPIPGW, TDMIP GW AES
Cisco 2801 INT VOICE/VIDEO, IPIPGW, TDMIP GW
Cisco 3725
c3725-adventerprisek9_ivs-mz
c3725-ipvoice_ivs-mz
Cisco 3725 INT VOICE/VIDEO, IPIPGW, TDMIP GW AES
Cisco 3725 INT VOICE/VIDEO, IPIPGW, TDMIP GW
Cisco 3745
c3745-adventerprisek9_ivs-mz
c3745-ipvoice_ivs-mz
Cisco 3745 INT VOICE/VIDEO, IPIPGW, TDMIP GW AES
Cisco 3745 INT VOICE/VIDEO, IPIPGW, TDMIP GW
Cisco 3825
c3825-adventerprisek9_ivs-mz
c3825-ipvoice_ivs-mz
Cisco 3825 INT VOICE/VIDEO, IPIPGW, TDMIP GW AES
Cisco 3825 INT VOICE/VIDEO, IPIPGW, TDMIP GW
Cisco 3845
c3845-adventerprisek9_ivs-mz
c3845-ipvoice_ivs-mz
Cisco 3845 INT VOICE/VIDEO, IPIPGW, TDMIP GW AES
Cisco 3845 INT VOICE/VIDEO, IPIPGW, TDMIP GW
Cisco AS5350XM
c5350-adventerprisek9_ivs-mz
c5350-ipvoice_ivs-mz
Cisco 5350 INT VOICE/VIDEO, IPIPGW, TDMIP GW AES
Cisco 5350 INT VOICE/VIDEO, IPIPGW, TDMIP GW
Cisco AS5400XM
c5400-adventerprisek9_ivs-mz
c5400-ipvoice_ivs-mz
Cisco 5400 INT VOICE/VIDEO, IPIPGW, TDMIP GW AES
Cisco 5400 INT VOICE/VIDEO, IPIPGW, TDMIP GW
Cisco 7200
c7200-adventerprisek9_mz
c7200-adventerprisek9_li-mz
c7200-adventerprisek9_li-mz
Cisco 7200 Series IOS ADVANCED ENTERPRISE SERVICES
Cisco 7301
c7301-adventerprisek9_mz
c7301-adventerprisek9_li-mz
c7200-adventerprisek9_li-mz
Cisco 7301 Series IOS ADVANCED ENTERPRISE SERVICES
Cisco Unified Border Element with Gatekeeper Configuration Guide
7
Overview of Cisco Unified Border Element with Gatekeeper
Restrictions for Cisco Unified Border Element with Gatekeeper Configuration
Restrictions for Cisco Unified Border Element with Gatekeeper
Configuration
•
Via-zone-enabled gatekeepers are not supported by Cisco Unified Communications Manager.
Information About Cisco Unified Border Element with
Gatekeeper
Feature benefits include the following:
•
Capacity control and improved call routing control using carrier-based routing with the
Cisco Unified Border Element with Gatekeeper feature and routing traffic through the gateways.
•
Improved billing and settlement capabilities.
•
Provides key services at the edge of the network for scalability.
To configure the Cisco Unified Border Element with Gatekeeper feature, you should understand the
following concepts:
•
Gatekeeper Functionality, page 8
•
Cisco Unified Border Element with Gatekeeper Network Topology, page 8
•
Features Supported by the Cisco Unified Border Element with Gatekeeper, page 11
Gatekeeper Functionality
Gatekeepers are responsible for the following tasks.
•
Gateway selection and load balancing
•
Call routing (zone selection)
•
Gatekeeper-based billing
•
Control of call admission, security, and bandwidth
•
Enforcement of call capacities
Cisco Unified Border Element with Gatekeeper Network Topology
In the current VoIP market, ITSPs who provide wholesale VoIP services use their own IP-to-TDM
gateways to exchange calls with the PSTN. Problems occur when a wholesaler receives a call from an
originating ITSP and decides to terminate the call to another ITSP. Because it does not own the PSTN
gateways, the wholesaler does not receive call setup or release information and therefore cannot bill for
the call. Wholesalers are forced either to forbid these connections, thereby foregoing a potential revenue
source, or to set up the call through a combination of back-to-back IP-to-TDM gateways. This solution
results in reduced quality due to double media coding and decoding, and it wastes TDM port resources.
Cisco UBE allows the wholesaler to terminate the call from the originating ITSP and then reoriginate it,
thereby providing a point at which accurate call detail records (CDRs) can be collected for billing.
Cisco Unified Border Element with Gatekeeper Configuration Guide
8
Overview of Cisco Unified Border Element with Gatekeeper
Information About Cisco Unified Border Element with Gatekeeper
The superior interconnect capability provided by the Cisco UBE enables service providers to conceal
their internal network and business relationships while improving call admission control, flexible
routing, and protocol interworking capabilities.
The Cisco UBE includes the following changes to gateways and gatekeepers to allow Cisco UBE with
Gatekeeper call legs:
•
Support for H.323-to-H.323, H.323-to-SIP, and SIP-to-SIP connection types
•
Support for transparent codec on H.323-to-H.323 connection types
•
Support for H.323 call capacities
•
Introduction of gatekeeper via-zones. Via-zone is a Cisco term for a zone that contains Cisco UBEs
and via-zone-enabled gatekeepers. A via-zone-enabled gatekeeper is capable of recognizing
via-zones and sending traffic to via-zone gateways. Cisco via-zone-enabled gatekeepers include a
via-zone command-line interface (CLI) command.
Via-zones are usually located on the edge of an ITSP network and are like a VoIP transfer point, or
tandem zone, where traffic passes through on the way to the remote zone destination. Gateways in
this zone terminate requested calls and reoriginate traffic to its final destination. Via-zone
gatekeepers operate as usual for applications that are not Cisco UBE Gatekeepers in via-zones
support resource management (for example, gateway selection and load balancing) using the
Capacities field in the H.323 Version 4 RAS messages.
Figure 1 shows a simple topology example of the Cisco UBE using via-zone gatekeepers.
Figure 1
Cisco Unified Border Element with Gatekeeper Feature Sample Topology
Domain A
Cisco VoIP to VoIP
gateway via zone
GKVIA
7, 8, 9, 12
408 zone
Domain B
3, 4
GK408
323
6
GK919 14, 15
13
V
GW919
82786
GW408
10, 11
Cisco Unified
Border Element
2, 5
V
323
The gatekeeper in Domain A and the gatekeeper in Domain B are connected to the via-zone gatekeeper.
GK408 and the via-zone gatekeeper exchange Registration, Admission, and Status (RAS) messages for
the originating side. Then the connection is made between the originating gateway and the Cisco UBE.
Cisco Unified Border Element with Gatekeeper Configuration Guide
9
Overview of Cisco Unified Border Element with Gatekeeper
Information About Cisco Unified Border Element with Gatekeeper
The via-zone gatekeeper exchanges RAS messages with GK919 for the terminating side. If the call is
accepted, the Cisco UBE completes the connection from GW408 to GW919, and the media flows
through the Cisco UBE.
In a basic call scenario, on receiving a location request (LRQ) message from the originating gatekeeper
(GK408), the via-zone-enabled gatekeeper (GKVIA) processes the message and determines that the call
should be set up using the Cisco UBE. After the originating gateway receives its admission confirmation
(ACF) message, it sets up the call.
With the Cisco Multiservice IP-to-IP Gateway feature, instead of the originating gateway signaling the
terminating gateway directly, the Cisco UBE controls the call set-up both the signaling and media
channel. The Cisco UBE is terminating the signaling and media channels, but the information associated
with the media is propagated through to the opposite call leg. This process allows the endpoints to
determine what media channel capabilities to use for the call. When the call is established, the audio
stream flows through the Cisco UBE, meaning that the gateway terminates the audio channel on one call
leg and then reoriginates it to the other leg.
The following scenario illustrates a basic call from the originating gateway to the terminating gateway,
using the Cisco UBE and gatekeepers.
1.
GW408 (the originating gateway) calls someone in the 919 area code, which is serviced by GW919
(the terminating gateway).
2.
GW408 sends an ARQ with the called number having the 919 area code to a gatekeeper in its zone
(GK408).
3.
GK408 resolves 919 to belong to a via-zone gatekeeper (GKVIA). GK408 then sends an LRQ to
GKVIA.
4.
GKVIA receives the LRQ for the 919 number. GKVIA resolves the 919 prefix to belong to the Cisco
UBE. GKVIA is configured to route requests for 919 prefix calls through its Cisco UBE. GKVIA
sends an LCF to GK408.
5.
GK408 returns an ACF specifying Cisco UBE to GW408.
6.
GW408 sends a SETUP message to Cisco UBE for the 919 number.
7.
Cisco UBE consults GKVIA with an ARQ message with the answerCall=true parameter to admit
the incoming call.
8.
GKVIA responds with an ACF to admit the call. From the perspective of the gatekeeper, the first
call leg has been established.
9.
Cisco UBE has a dial peer specifying that RAS messages should be sent to GKVIA for all prefixes.
Cisco UBE initiates the resending of the call by sending the ARQ message with the answerCall
parameter set to, false to GKVIA for 919.
10. GKVIA knows that prefix 919 belongs to GK919, and since the source zone is the via-zone, the
GKVIA sends an LRQ to GK919.
11. GK919 sees prefix 919 as a local zone and sends an LCF pointing to GW919.
12. GKVIA returns an ACF specifying GW919.
13. Cisco UBE sends a SETUP message to GW919 for the 919 call.
14. GW919 sends an ARQ to GK919 to request admission for the call.
15. GK919 sends an ACF with the answerCall=true parameter.
All other messages (for example, Proceeding, Alerting, and Connect) are created as two legs between
GW408, and GW919, with the Cisco UBE acting as an intermediate gateway
Cisco Unified Border Element with Gatekeeper Configuration Guide
10
Overview of Cisco Unified Border Element with Gatekeeper
Information About Cisco Unified Border Element with Gatekeeper
Features Supported by the Cisco Unified Border Element with Gatekeeper
This section contains lists of the following types of supported features:
•
Gatekeeper Call-Signaling Features, page 11
•
Gatekeeper-Related Features, page 12
•
Interoperability Features, page 12
Gatekeeper Call-Signaling Features
Table 2 is a list of supported Gatekeeper call-signaling features.
Table 2
Cisco Unified Border Element with Gatekeeper Call Signaling Features
Feature
H.323-to-H.323 H.323-to-SIP SIP-to-SIP
Support?
Support?
Support?
Additional Information
Alternate endpoint retry
Yes
—
—
Configuration for all alternate endpoints must be
consistent.GK
Alternate gatekeeper support
Yes
—
—
—
Annex E
Yes
—
—
—
Bandwidth request (BRQ)
Yes
—
—
—
Call Deflection (H.450.3)
No
—
—
—
Call multiplexing over single
H.225 channel
Yes
—
—
—
Carrier-based routing
Yes
—
—
—
Facility Call Forward
No
—
—
—
Facility RouteCall to
Gatekeeper
Yes
—
—
—
Gatekeeper security
Yes
—
—
—
Interdomain LRQ
authentication
Yes
—
—
—
Interzone token
Yes
—
—
—
IRR call start time
Yes
—
—
—
IRR frequency
Yes
—
—
—
ISUP/GTD transport in H.225 Yes
(Annex M.2)
—
—
—
Lightweight RRQs
Yes
—
—
—
Overlap signaling processing
on H.323 terminating
gateways
Yes
—
—
—
QSIG Tunneling
Yes
—
—
—
Security checks at GK for
ARQ/DRQ/ BRQ/URQ/IIR
Yes
—
—
Introduced in Cisco IOS Release12.4(15)XY.
Cisco Unified Border Element with Gatekeeper Configuration Guide
11
Overview of Cisco Unified Border Element with Gatekeeper
Information About Cisco Unified Border Element with Gatekeeper
Table 2
Cisco Unified Border Element with Gatekeeper Call Signaling Features
H.323-to-H.323 H.323-to-SIP SIP-to-SIP
Support?
Support?
Support?
Additional Information
Feature
Security Checks at GK for
RRQ
Yes
—
—
Introduced in Cisco IOS Release12.4(15)XY.
Source CallSignaling address Yes
(in the answer ARQ)
—
—
—
Unsolicited IRR with billing
token
—
—
—
Yes
Gatekeeper-Related Features
Table 3 shows a list of supported gatekeeper-related features. Those gatekeeper functions not listed are
supported in conjunction with via-zones.
Table 3
Supported Gatekeeper-Related Features
Feature
Supported?
Directory gatekeepers
Yes
Gatekeeper clusters
Yes
Annex G border elements
No
ISUP/GTD transport in RAS
Yes
GKTMP
Yes
Multiple local zones
Yes
Hot Standby Router Protocol (HSRP)
Yes
Interoperability Features
Table 4 shows a list of supported interoperability features.
Table 4
Supported Interoperability Features
Feature
Supported?
Additional Information
BroadSoft
Yes
First supported in 12.4(6)T images.
Cisco ATA 186
Yes
—
Cisco ATA 188
Yes
First supported in 12.3(7)T images.
Cisco Unified Communications Manager Yes
—
Cisco CallManager Express
Yes
—
Cisco gateways
Yes
Compatible with H.323 version 2 and above.
Cisco MCM Proxy
Yes
Cannot register proxy in the same zone as an
Cisco UBE.
Third-party gatekeepers
Yes
Third-party gatekeepers must support the
equivalent of via-zone functionality.
Third-party gateways
Partially
First supported in 12.3(7)T images.
Cisco Unified Border Element with Gatekeeper Configuration Guide
12
Overview of Cisco Unified Border Element with Gatekeeper
Toll Fraud Prevention
Toll Fraud Prevention
When a Cisco router platform is installed with a voice-capable Cisco IOS software image, appropriate
features must be enabled on the platform to prevent potential toll fraud exploitation by unauthorized
users. Deploy these features on all Cisco router Unified Communications applications that process voice
calls, such as Cisco Unified Communications Manager Express (CME), Cisco Survivable Remote Site
Telephony (SRST), Cisco Unified Border Element (UBE), Cisco IOS-based router and standalone
analog and digital PBX and public-switched telephone network (PSTN) gateways, and Cisco
contact-center VoiceXML gateways. These features include, but are not limited to, the following:
•
Disable secondary dial tone on voice ports—By default, secondary dial tone is presented on voice
ports on Cisco router gateways. Use private line automatic ringdown (PLAR) for foreign exchange
office (FXO) ports and direct-inward-dial (DID) for T1/E1 ports to prevent secondary dial tone from
being presented to inbound callers.
•
Cisco router access control lists (ACLs)—Define ACLs to allow only explicitly valid sources of
calls to the router or gateway, and therefore to prevent unauthorized Session Initiation Protocol (SIP)
or H.323 calls from unknown parties to be processed and connected by the router or gateway.
•
Close unused SIP and H.323 ports—If either the SIP or H.323 protocol is not used in your
deployment, close the associated protocol ports. If a Cisco voice gateway has dial peers configured
to route calls outbound to the PSTN using either time division multiplex (TDM) trunks or IP, close
the unused H.323 or SIP ports so that calls from unauthorized endpoints cannot connect calls. If the
protocols are used and the ports must remain open, use ACLs to limit access to legitimate sources.
•
Change SIP port 5060—If SIP is actively used, consider changing the port to something other than
well-known port 5060.
•
SIP registration—If SIP registration is available on SIP trunks, turn on this feature because it
provides an extra level of authentication and validation that only legitimate sources can connect
calls. If it is not available, ensure that the appropriate ACLs are in place.
•
SIP Digest Authentication—If the SIP Digest Authentication feature is available for either
registrations or invites, turn this feature on because it provides an extra level of authentication and
validation that only legitimate sources can connect calls.
•
Explicit incoming and outgoing dial peers—Use explicit dial peers to control the types and
parameters of calls allowed by the router, especially in IP-to-IP connections used on CME, SRST,
and Cisco UBE. Incoming dial peers offer additional control on the sources of calls, and outgoing
dial peers on the destinations. Incoming dial peers are always used for calls. If a dial peer is not
explicitly defined, the implicit dial peer 0 is used to allow all calls.
•
Explicit destination patterns—Use dial peers with more granularity than .T for destination patterns
to block disallowed off-net call destinations. Use class of restriction (COR) on dial peers with
specific destination patterns to allow even more granular control of calls to different destinations on
the PSTN.
•
Translation rules—Use translation rules to manipulate dialed digits before calls connect to the PSTN
to provide better control over who may dial PSTN destinations. Legitimate users dial an access code
and an augmented number for PSTN for certain PSTN (for example, international) locations.
•
Tcl and VoiceXML scripts—Attach a Tcl/VoiceXML script to dial peers to do database lookups or
additional off-router authorization checks to allow or deny call flows based on origination or
destination numbers. Tcl/VoiceXML scripts can also be used to add a prefix to inbound DID calls.
If the prefix plus DID matches internal extensions, then the call is completed. Otherwise, a prompt
can be played to the caller that an invalid number has been dialed.
Cisco Unified Border Element with Gatekeeper Configuration Guide
13
Overview of Cisco Unified Border Element with Gatekeeper
Additional References
•
Host name validation—Use the “permit hostname” feature to validate initial SIP Invites that contain
a fully qualified domain name (FQDN) host name in the Request Uniform Resource Identifier
(Request URI) against a configured list of legitimate source hostnames.
•
Dynamic Domain Name Service (DNS)—If you are using DNS as the “session target” on dial peers,
the actual IP address destination of call connections can vary from one call to the next. Use voice
source groups and ACLs to restrict the valid address ranges expected in DNS responses (which are
used subsequently for call setup destinations).
For more configuration guidance, see the “Cisco IOS Unified Communications Toll Fraud Prevention”
paper.
Additional References
The following sections provide additional references related to the Cisco Unified Border Element with
Gatekeeper.
Note
•
In addition to the references listed below, each chapter provides additional references related to
Cisco Unified Border Element.
•
Some of the products and services mentioned in this guide may have reached end of life, end of sale,
or both. Details are available at http://www.cisco.com/en/US/products/prod_end_of_life.html.
•
The preface and glossary for the entire voice-configuration library suite of documents is listed
below.
Related Documents
Related Topic
Document Title
Cisco IOS Release 12.4
•
Cisco IOS Release 12.4 Configuration Guides
•
Cisco IOS Release 12.4T Configuration Guides
•
Cisco IOS Release 12.4 Command References
•
Cisco IOS Voice Configuration Library
http://www.cisco.com/en/US/docs/ios/12_3/vvf_c/cisco_ios_voice_configura
tion_library_glossary/vcl.htm
Note
Cisco IOS Release 12.3
This website contains the library preface and glossary.
•
Cisco IOS Release 12.3 documentation
•
Cisco IOS voice commands
•
Cisco IOS Voice Troubleshooting and Monitoring Guide
•
Tcl IVR Version 2.0 Programming Guide
Cisco Unified Border Element with Gatekeeper Configuration Guide
14
Overview of Cisco Unified Border Element with Gatekeeper
Additional References
Related Topic
Cisco IOS Release 12.2
DSP documentation
Document Title
•
Cisco IOS Voice, Video, and Fax Configuration Guide, Release 12.2 at
http://www.cisco.com/en/US/docs/ios/12_2/voice/configuration/guide/fvvfax
_c.html
High-Density Packet Voice Feature Card for Cisco AS5350XM and AS5400XM
Universal Gateways
http://www.cisco.com/univercd/cc/td/doc/product/software/ios124/124newft/124l
imit/124x/124xc4/vfc_dsp.htm
GKTMP (GK API) Documents
internet Low Bitrate Codec (iLBC)
Documents
•
GKTMP Command Reference:
http://www.cisco.com/en/US/docs/ios/12_2/gktmp/gktmpv4_2/gk_cli.htm
•
GKTMP Messages:
http://www.cisco.com/en/US/docs/ios/12_2/gktmp/gktmpv4_2/gk_tmp.html
•
Codecs section of the Dial Peer Configuration on Voice Gateway Routers
Guide
http://www.cisco.com/univercd/cc/td/doc/product/software/ios123/123cgcr/v
vfax_c/int_c/dpeer_c/dp_ovrvw.htm#1035124
•
Dial Peer Features and Configuration section of the Dial Peer Configuration
on Voice Gateway Routers Guide
http://www.cisco.com/univercd/cc/td/doc/product/software/ios123/123cgcr/v
vfax_c/int_c/dpeer_c/dp_confg.htm
Cisco Unified Border Element
Configuration Examples
Related Application Guides
•
Local-to-remote network using the IPIPGW
http://www.cisco.com/en/US/tech/tk1077/technologies_configuration_
example09186a00801b0803.shtml
•
Remote-to-local network using the IPIPGW:
http://www.cisco.com/en/US/tech/tk1077/technologies_configuration_examp
le09186a0080203edc.shtml
•
Remote-to-remote network using the IPIPGW:
http://www.cisco.com/en/US/tech/tk1077/technologies_configuration_examp
le09186a0080203edd.shtml
•
Remote-to-remote network using two IPIPGWs:
http://www.cisco.com/en/US/tech/tk1077/technologies_configuration_examp
le09186a0080203edb.shtml
•
Cisco Unified Communications Manager and Cisco IOS Interoperability
Guide
•
Cisco IOS Fax, Modem, and Text Support over IP Configuration Guide
•
“Configuring T.38 Fax Relay” chapter
•
Cisco IOS SIP Configuration Guide
•
Cisco Unified Communications Manager (CallManager) Programming Guides
at:
http://www.cisco.com/en/US/products/sw/voicesw/ps556/products_program
ming_reference_guides_list.html
•
Quality of Service for Voice over IP at
http://www.cisco.com/en/US/docs/ios/solutions_docs/qos_solutions/QoSVoI
P/QoSVoIP.html
Cisco Unified Border Element with Gatekeeper Configuration Guide
15
Overview of Cisco Unified Border Element with Gatekeeper
Additional References
Related Topic
Document Title
Related Platform Documents
Related gateway configuration
documentation
•
Cisco 2600 Series Multiservice Platforms
•
Cisco 2800 Series Integrated Services Routers
•
Cisco 3600 Series Multiservice Platforms
•
Cisco 3700 Series Multiservice Access Routers
•
Cisco 3800 Series Integrated Services Routers
•
Cisco 7200 Series Routers
•
Cisco 7301
Media and Signaling Authentication and Encryption Feature for Cisco IOS H.323
Gateways.
http://www.cisco.com/en/US/docs/ios/12_4t/12_4t11/htsecure.htm
Cisco IOS NAT Configuration Guide,
Release 12.4T
Troubleshooting and Debugging guides
•
Configuring Cisco IOS Hosted NAT Traversal for Session Border Controller
http://www.cisco.com/en/US/docs/ios/12_4t/ip_addr/configuration/guide/htnatsb
c.html
•
Cisco IOS Debug Command Reference, Release 12.4 at
http://www.cisco.com/en/US/docs/ios/debug/command/reference/db_book.ht
ml
•
Troubleshooting and Debugging VoIP Call Basics at
http://www.cisco.com/en/US/tech/tk1077/technologies_tech_note09186a008
0094045.shtml
•
VoIP Debug Commands at
http://www.cisco.com/en/US/docs/routers/access/1700/1750/software/config
uration/guide/debug.html
Cisco Unified Border Element with Gatekeeper Configuration Guide
16
Overview of Cisco Unified Border Element with Gatekeeper
Additional References
Standards
Standards
Title
H.323 Version 4 and earlier
H.323 (ITU-T VOIP protocols)
MIBs
MIBs
MIBs Link
None.
To locate and download MIBs for selected platforms, Cisco IOS
releases, and feature sets, use Cisco MIB Locator found at the
following URL: http://www.cisco.com/go/mibs
RFCs
RFCs
Title
RFC 2833
RTP Payload for DTMF Digits, Telephony Tones and Telephony
Signals
RFC 3261
SIP: Session Initiation Protocol
Technical Assistance
Description
Link
The Cisco Support website provides extensive online
resources, including documentation and tools for
troubleshooting and resolving technical issues with
Cisco products and technologies.
http://www.cisco.com/techsupport
To receive security and technical information about
your products, you can subscribe to various services,
such as the Product Alert Tool (accessed from Field
Notices), the Cisco Technical Services Newsletter, and
Really Simple Syndication (RSS) Feeds.
Access to most tools on the Cisco Support website
requires a Cisco.com user ID and password.
Cisco Unified Border Element with Gatekeeper Configuration Guide
17
Overview of Cisco Unified Border Element with Gatekeeper
Glossary
Glossary
IZCT—Inter-Zone Clear Token.
OGK —Originating Gatekeeper.
TGK —Terminating Gatekeeper.
OGW—Originating Gateway.
TGW—Terminating Gateway.
ARQ— Admission Request.
ACF—Admission Confirm.
ARJ—Admission Reject.
LRQ—Location Request.
LCF— Location Confirm.
LRJ—Location Reject.
CCDE, CCENT, CCSI, Cisco Eos, Cisco HealthPresence, Cisco IronPort, the Cisco logo, Cisco Lumin, Cisco Nexus, Cisco Nurse Connect ,
Cisco StackPower, Cisco StadiumVision, Cisco TelePresence, Cisco Unified Computing System, Cisco WebEx, DCE, Flip Channels, Flip for Good,
Flip Mino, Flip Video, Flip Video (Design), Flipshare (Design), Flip Ultra, and Welcome to the Human Network are trademarks; Changing the Way
We Work, Live, Play, and Learn, Cisco Store, and Flip Gift Card are service marks; and Access Registrar, Aironet, AsyncOS, Bringing the Meeting
To You, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, CCSP, CCVP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco IOS,
Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity, Collaboration Without Limitation, EtherFast, EtherSwitch,
Event Center, Fast Step, Follow Me Browsing, FormShare, GigaDrive, HomeLink, Internet Quotient, IOS, iPhone, iQuick Study, IronPort, the
IronPort logo, LightStream, Linksys, MediaTone, MeetingPlace, MeetingPlace Chime Sound, MGX, Networkers, Networking Academy,
Network Registrar, PCNow, PIX, PowerPanels, ProConnect, ScriptShare, SenderBase, SMARTnet, Spectrum Expert, StackWise, The Fastest Way to
Increase Your Internet Quotient, TransPath, WebEx, and the WebEx logo are registered trademarks of Cisco Systems, Inc. and/or its affiliates in the
United States and certain other countries.
All other trademarks mentioned in this document or website are the property of their respective owners. The use of the word partner does not imply
a partnership relationship between Cisco and any other company. (0907R)
Any Internet Protocol (IP) addresses used in this document are not intended to be actual addresses. Any examples, command display output, and
figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses in illustrative content is unintentional and
coincidental.
© 2009 Cisco Systems, Inc. All rights reserved.
Cisco Unified Border Element with Gatekeeper Configuration Guide
18
Configuring Cisco Unified Border Element with
Gatekeeper
Revised: July 11, 2008
First Published: June 19, 2006
Last Updated: July 11, 2008
This chapter describes fundamental configuration tasks required for Configuring Cisco Unified Border
Element with gatekeeper functionality. A Cisco Unified Border Element, in this guide also called an
IP-to-IP gateway (IPIPGW), border element (BE), or session border controller, facilitates connectivity
between independent VoIP networks by enabling H.323 VoIP and videoconferencing calls from one IP
network to another. This gateway performs most of the same functions of a PSTN-to-IP gateway, but
typically joins two IP call legs, rather than a PSTN and an IP call leg.
Finding Feature Information in This Module
Your Cisco IOS software release may not support all of the features documented in this module. To reach
links to specific feature documentation in this module and to see a list of the releases in which each feature is
supported, use the “Feature Information for Cisco Unified Border Element Configuration Guide” section on
page 45.
Finding Support Information for Platforms and Cisco IOS and Catalyst OS Software Images
Use Cisco Feature Navigator to find information about platform support and Cisco IOS and Catalyst OS
software image support. To access Cisco Feature Navigator, go to http://www.cisco.com/go/cfn. An
account on Cisco.com is not required.
Activation
The software features in this guide require a Product Authorization Key (PAK) to configure the features
described in this guide. Please register your products at and activate your PAK at
http://www.cisco.com/go/license before starting your configuration process.
Americas Headquarters:
Cisco Systems, Inc., 170 West Tasman Drive, San Jose, CA 95134-1706 USA
© 2008 Cisco Systems, Inc. All rights reserved.
Configuring Cisco Unified Border Element with Gatekeeper
Contents
Contents
•
Prerequisites for Configuring Cisco Unified Border Element with Gatekeeper, page 18
•
How to Configure Cisco Unified Border Element with Gatekeeper, page 18
•
Configuration Examples for Gatekeepers, page 40
•
Additional References, page 43
Prerequisites for Configuring Cisco Unified Border Element with
Gatekeeper
•
Perform the prerequisites listed in the Cisco Unified Border Element at:
http://www.cisco.com/univercd/cc/td/doc/product/software/ios123/123cgcr/vvfax_c/
callc_c/h323_c/ipipgw/index.htm
•
Perform basic H.323 gatekeeper configuration.
Note
For configuration instructions, see the “Configuring H.323 Gatekeepers” chapter of the
Cisco IOS Voice, Video, and Fax Configuration Guide, Release 12.2.
How to Configure Cisco Unified Border Element with
Gatekeeper
This section describes how to configure and verify the Cisco UBE features on gatekeepers.
•
Configuring Via-Zones, page 19 (required)
•
In-Service Updates to Gatekeeper Zone Prefix Configuration, page 22
•
Configuring Call-Capacity Thresholds, page 22
•
Configuring LRQ Resource Rejection, page 23
•
Configuring the Sequential LRQ Timer, page 24
•
H.323 Standard-Based Hopcount Field in LRQ, page 25
•
Dynamic Control of Gatekeeper Sequential LRQ Processing Through GKTMP, page 26
•
Enhanced ARQ and RRQ Security for Gatekeeper Registrations, page 26
•
Configring Extended InterZone Clear Token Support, page 29
•
Configuring RAS Retry and Timer, page 31
•
Configuring Real-Time Call Type Reporting Through GKTMP, page 32
•
Configuring Alternate Endpoint Call Attempts in RADIUS Call Accounting Records, page 34
•
Unique Calling Party Information with Alternate Endpoints, page 35
Cisco Unified Border Element with Gatekeeper Configuration Guide
18
Configuring Cisco Unified Border Element with Gatekeeper
How to Configure Cisco Unified Border Element with Gatekeeper
Note
•
Verifying Gatekeeper Configuration and Operation, page 35
•
Troubleshooting Gatekeeper Configuration and Operation, page 39
For sample gatekeeper configurations, see the “Configuration Examples for Gatekeepers” section on
page 40.
Configuring Via-Zones
Via-zone gatekeepers differ from legacy gatekeepers in how LRQ and ARQ messages are used for call
routing. Using via-zone gatekeepers will maintain normal clusters and functionality. Legacy gatekeepers
examine incoming LRQs based on the called number, and more specifically the dialedDigits field in the
destinationInfo portion of the LRQ. Via-zone gatekeepers look at the origination point of the LRQ before
looking at the called number. If an LRQ comes from a gatekeeper listed in the via-zone gatekeeper’s
remote zone configurations, the gatekeeper checks to see that the zone remote configuration contains an
invia or outvia keyword. If the configuration contains these keywords, the gatekeeper uses the new
via-zone behavior; if not, it uses legacy behavior.
For ARQ messages, the gatekeeper determines if an outvia keyword is configured on the destination
zone. If the outvia keyword is configured, and the zone named with the outvia keyword is local to the
gatekeeper, the call is directed to a Cisco Multiservice IP-to-IP Gateway in that zone by returning an
ACF pointing to the Cisco Multiservice IP-to-IP Gateway. If the zone named with the outvia keyword
is remote, the gatekeeper sends a location request to the outvia gatekeeper rather than the remote zone
gatekeeper. The invia keyword is not used in processing the ARQ.
Note
•
Video calls can take advantage of the benefits offered by via-zone gatekeeper processing. For a more
detailed description of how via-zone gatekeepers process calls, see the “Configuring Via-Zones”
section on page 19.
•
Using the zone local command, you can specify invia and outvia gatekeepers to be used for
intrazone video calls. You can also use the enable-intrazone keyword to force all intrazone calls to
use the via-zone gatekeeper.
This section contains the following information:
•
Configure Remote Zones, page 20
•
Configure Local Zones, page 21
Cisco Unified Border Element with Gatekeeper Configuration Guide
19
Configuring Cisco Unified Border Element with Gatekeeper
How to Configure Cisco Unified Border Element with Gatekeeper
Configure Remote Zones
To configure remote zones on the gatekeeper, perform the following steps.
SUMMARY STEPS
1.
enable
2.
configure terminal
3.
gatekeeper
4.
zone remote gatekeeper-name domain-name [ras-IP-address] [invia inbound-gatekeeper | outvia
outbound-gatekeeper [enable-intrazone]]
5.
exit
DETAILED STEPS
Step 1
Command or Action
Purpose
enable
Enables privileged EXEC mode. Enter your password if
prompted.
Example:
Router> enable
Step 2
configure terminal
Enters global configuration mode.
Example:
Router# configure terminal
Step 3
gatekeeper
Enters gatekeeper configuration mode.
Example:
Router(config)# gatekeeper
Step 4
zone remote gatekeeper-name domain-name
[ras-IP-address] [invia inbound-gatekeeper |
outvia outbound-gatekeeper [enable-intrazone]]
Example:
Router(config-gk)# zone remote termGK cisco
10.16.193.158 1719 invia hurricane outvia
hurricane
Cisco Unified Border Element with Gatekeeper Configuration Guide
20
Defines the remote gatekeeper zone. Keywords and
arguments are as follows:
•
zone-name—Name (ID) of the remote zone
gatekeeper.
•
domain-name—Name (ID) of the domain that the
remote zone is serving.
•
ip-address—IP address for the remote gatekeeper.
•
port-number—RAS signaling port number for the
remote zone. Range: 1 to 65535. Default: the
well-known RAS port number 1719.
•
invia inbound-gatekeeper—Name of the via-zone
gatekeeper to use for calls coming from the remote
zone name.
•
outvia outbound-gatekeeper—Name of the via-zone
gatekeeper to use for calls coming to the remote zone
name.
Configuring Cisco Unified Border Element with Gatekeeper
How to Configure Cisco Unified Border Element with Gatekeeper
Step 5
Command or Action
Purpose
exit
Exits the current mode.
Example:
Router(config-gk)# exit
Configure Local Zones
To configure local zones on the gatekeeper, perform the following steps.
SUMMARY STEPS
1.
enable
2.
configure terminal
3.
gatekeeper
4.
zone local gatekeeper-name domain-name [ras-IP-address] [invia inbound-gatekeeper | outvia
outbound-gatekeeper [enable-intrazone]]
5.
exit
DETAILED STEPS
Step 1
Command or Action
Purpose
enable
Enables privileged EXEC mode. Enter your password if
prompted.
Example:
Router> enable
Step 2
configure terminal
Enters global configuration mode.
Example:
Router# configure terminal
Step 3
gatekeeper
Enters gatekeeper configuration mode.
Example:
Router(config)# gatekeeper
Cisco Unified Border Element with Gatekeeper Configuration Guide
21
Configuring Cisco Unified Border Element with Gatekeeper
How to Configure Cisco Unified Border Element with Gatekeeper
Step 4
Command or Action
Purpose
zone local gatekeeper-name domain-name
[ras-IP-address] [invia inbound-gatekeeper |
outvia outbound-gatekeeper [enable-intrazone]]
Defines the local gatekeeper zone. Keywords and
arguments are as follows:
Example:
Router(config-gk)# zone local termGK example.com
10.16.193.158 invia hurricane outvia hurricane
enable-intrazone
Step 5
•
gatekeeper-name—Gatekeeper name or zone name
•
domain-name—Domain name served by this
gatekeeper
•
ras-IP-address—IP address of one of the interfaces
on the gatekeeper
•
invia inbound-gatekeeper—Gatekeeper for calls
entering this zone
•
outvia outbound-gatekeeper—Gatekeeper for calls
leaving this zone
•
enable-intrazone—All intrazone calls must use the
via-zone gatekeeper
Exits the current mode.
exit
Example:
Router(config-gk)# exit
In-Service Updates to Gatekeeper Zone Prefix Configuration
This feature increases the availability of H.323 VoIP networks by allowing changes to a gatekeeper zone
prefix while the gatekeeper is running and managing active E.164 registrations.
Prior to Cisco IOS Release 12.4(6)T the gatekeeper had to be shut down before changes can be applied.
The shutdown removed all existing calls and registrations, making modification of zone prefix
configurations inconvenient and costly for customers.
No configuration is required.
Configuring Call-Capacity Thresholds
To configure call-capacity thresholds on the gatekeeper, perform the following steps.
Note
Setting the threshold on the gatekeeper causes the gatekeeper to send an ARJ message to the gateway if
call capacity is exceeded. If LRJ resource rejection is configured, the gatekeeper also sends an LRJ
message in response to an LRQ message when call capacity is exceeded.
SUMMARY STEPS
1.
enable
2.
configure terminal
3.
gatekeeper
4.
endpoint resource threshold onset high-water-mark abatement low-water-mark
5.
exit
Cisco Unified Border Element with Gatekeeper Configuration Guide
22
Configuring Cisco Unified Border Element with Gatekeeper
How to Configure Cisco Unified Border Element with Gatekeeper
DETAILED STEPS
Step 1
Command or Action
Purpose
enable
Enables privileged EXEC mode. Enter your password if
prompted.
Example:
Router> enable
Step 2
Enters global configuration mode.
configure terminal
Example:
Router# configure terminal
Step 3
Enters gatekeeper configuration mode.
gatekeeper
Example:
Router(config)# gatekeeper
Step 4
endpoint resource threshold onset high-water-mark
abatement low-water-mark
Example:
Sets the call volume thresholds in the gatekeeper for
monitoring its gateway. Keywords and arguments are as
follows:
•
onset high-water-mark—Maximum call-volume
usage for the gateway, as a percentage. Range: 1 to
99. Default: 90.
•
abatement low-water-mark—Minimum call-volume
usage for the gateway, as a percentage. Range: 1 to
99. Default: 80.
Router(config-gk)# endpoint resource threshold
onset 85 abatement 65
Step 5
Exits the current mode.
exit
Example:
Router(config-gk)# exit
Configuring LRQ Resource Rejection
By default, the gatekeeper does not reject LRQs based on resource limits of the endpoints. To configure
the gatekeeper to reject LRQs, perform the following steps.
SUMMARY STEPS
1.
enable
2.
configure terminal
3.
gatekeeper
4.
lrq reject-resource-low
5.
exit
Cisco Unified Border Element with Gatekeeper Configuration Guide
23
Configuring Cisco Unified Border Element with Gatekeeper
How to Configure Cisco Unified Border Element with Gatekeeper
DETAILED STEPS
Step 1
Command or Action
Purpose
enable
Enables privileged EXEC mode. Enter your password if
prompted.
Example:
Router> enable
Step 2
configure terminal
Enters global configuration mode.
Example:
Router# configure terminal
Step 3
Enters gatekeeper configuration mode.
gatekeeper
Example:
Router(config)# gatekeeper
Step 4
lrq reject-resource-low
Configures the gatekeeper to reject an LRQ if the
endpoints that can service a call are out of resources.
Example:
Router(config-gk)# lrq reject-resource-low
Step 5
Exits the current mode.
exit
Example:
Router(config-gk)# exit
Configuring the Sequential LRQ Timer
This features allows service providers the ability to define the time window during which the gatekeeper
collects responses from the gateway before resending a RAS message to a gatekeeper and to set the
number of times to resend the RAS message after the timeout period expires. To configure the sequential
LRQ timer, perform the following tasks.
SUMMARY STEPS
1.
enable
2.
configure terminal
3.
gatekeeper
4.
timer lrq seq delay
5.
timer lrq window decisec
6.
no shutdown
7.
exit
Cisco Unified Border Element with Gatekeeper Configuration Guide
24
Configuring Cisco Unified Border Element with Gatekeeper
How to Configure Cisco Unified Border Element with Gatekeeper
DETAILED STEPS
Step 1
Command or Action
Purpose
enable
Enables privileged EXEC mode.
•
Enter your password if prompted.
Example:
Router> enable
Step 2
Enters global configuration mode.
configure terminal
Example:
Router# configure terminal
Step 3
Enters gatekeeper configuration mode.
gatekeeper
Example:
Router(config)# gatekeeper
Step 4
Defines the time interval between successive sequential
LRQs.
timer lrq seq delay
Example:
Router(config-gk)# timer lrq seq delay 1
Step 5
Defines the time window during which the gatekeeper
collects responses to one or more outstanding LRQs.
timer lrq window decisec
Example:
Router(config-gk)# timer lrq window decisec 3
Step 6
Enables the gatekeeper.
no shutdown
Example:
Router(config-gk)# no shutdown
Step 7
Exits the current mode.
exit
Example:
Router(config-gk)# exit
H.323 Standard-Based Hopcount Field in LRQ
This feature adds support for H.225 version 4 standard hopCount field in the LocationRequest RAS
message.
The hopCount field defines the number of gatekeepers through which a message may propagate. If
hopCount is greater than 0, the gatekeeper inserts the new hop count value into the message to be
forwarded. If hopCount has reached 0, the gatekeeper will not forward the message.
The hopCount field was added in H225 version 4. The Cisco gatekeeper supported the same mechanism
before it was added to the standard using Non-Standard fields. Support for the Non-Standard mechanism
for backward compatibility exists.
No configuration is required.
Cisco Unified Border Element with Gatekeeper Configuration Guide
25
Configuring Cisco Unified Border Element with Gatekeeper
How to Configure Cisco Unified Border Element with Gatekeeper
Dynamic Control of Gatekeeper Sequential LRQ Processing Through GKTMP
If a gatekeeper receives a location reject message (LRJ) When an alternate gatekeeper is connected, the
default process is to repeat the location request (LRQ). This feature allows service providers to reject
traffic at the Gatekeeper Transaction Message Protocol (GKTMP) server.
No configuration is required.
Enhanced ARQ and RRQ Security for Gatekeeper Registrations
This feature provides additional security checks upon receiving the registration request (RRQ) from an
endpoint. Enhanced ARQ and RRQ Security for gatekeepers describes comparisons made in the
endpoint ID, aliases, source address, RAS address, and call signaling address for the end point to its
registration and reject the request if the appropriate fields don’t match.
The enhanced security checks at the gatekeeper compares source address, RAS address and call
signaling addresses for the endpoint and sends the reject RRQ if the appropriate fields don’t match. To
configure enhanced security checks at the gatekeeper for RRQ, perform the steps in this section. This
section contains the following subsections:
•
Restrictions for ARQ and RRQ Security for Gatekeeper Registrations, page 26
•
Information About ARQ and RRQ Security for Gatekeeper Registrations, page 26
•
Configuring ARQ and RRQ Security for Gatekeeper Registrations, page 27
•
Verifying Enhanced ARQ and RRQ Security for Gatekeeper Registrations, page 28
Restrictions for ARQ and RRQ Security for Gatekeeper Registrations
Security enhancements on the ARQ to not enforce control between ARQ and Setup; it is still possible
for an unauthorized user with a VoIP account to:
•
Establish a call on behalf of another user by sending the correct source info in the ARQ along with
spoofed source info in the Setup.
•
Send a valid ARQ to enable any unregistered third party endpoint to pass the call.
Information About ARQ and RRQ Security for Gatekeeper Registrations
The Gatekeeper in the Cisco UBE performs the initial security checks upon receiving the registration
request (RRQ) from an endpoint. The GK should reject the RRQ if the security checks fail. The enhanced
security features are beneficial for networks that have the Cisco Unifed Border Element co-located in
the same box as their gatekeeper.
This feature describes how the gatekeeper should be less verbose when the security checks fails and
return a generic error condition (securityDenial) and how to handle legitimate endpoints that return
specific error causes.
The following enhanced checks should be done by the gatekeeper on a RRQ:
High RRQ—new registrations or repeated refresh RRQ
•
Match transport address. Reject RAS messages from endpoints if they do not use the same ip address
for both RAS as well as call signaling.
Cisco Unified Border Element with Gatekeeper Configuration Guide
26
Configuring Cisco Unified Border Element with Gatekeeper
How to Configure Cisco Unified Border Element with Gatekeeper
Check the RAS address presented, if the address is not “source address = = ras address (RRQ) = =
call signaling address (RRQ)”; send a security denial (RRJ).
•
Match alias address(es) list sent in the RAS message with the alias address(es) already registered
with the GK. If any alias address is found to be duplicate (i.e. registered with another endpoint),
reject the RAS message.
For all alias addresses in the RRQ if a registered endpoint is found
– If the register endpoint call signaling address is not the same as call signaling address in the
RRQ: send security denial (RRJ).
– If the endpoint ID is present in the RRQ and is not the same as the registers endpoint; send
security denial (RRJ).
Low RRQ—keepalives
•
Check the RAS address presented in the RRQ, if the address is not “ras address = = source address
= = registered endpoint’s address”; send a security denial (RRJ).
•
If the call signaling address present in the RRQ is not “call sig address= = source address= =
registered endpoint’s call signaling address; send security denial (RRJ)
Enhanced Security checks at GK for ARQ/DRQ/ BRQ/URQ/IIR
Security loopholes addressed by:
•
Checks done for RRQ/ARQ/URQ/BRQ/DRQ requests.
•
Checks done for IRR responses to maintain uniformity
Configuring ARQ and RRQ Security for Gatekeeper Registrations
To enable ARQ and RRQ Security for Gatekeeper Registrations, perform the following steps.
SUMMARY STEPS
1.
enable
2.
configure terminal
3.
gatekeeper
4.
security match source-ip
5.
security match alias-address-list
6.
exit
Cisco Unified Border Element with Gatekeeper Configuration Guide
27
Configuring Cisco Unified Border Element with Gatekeeper
How to Configure Cisco Unified Border Element with Gatekeeper
DETAILED STEPS
Step 1
Command or Action
Purpose
enable
Enables privileged EXEC mode. Enter your password if
prompted.
Example:
Router> enable
Step 2
Enters global configuration mode.
configure terminal
Example:
Router# configure terminal
Step 3
Enters gatekeeper configuration mode.
gatekeeper
Example:
Router(config)# gatekeeper
Step 4
security match source-ip
Configures the gatekeeper to check the source, ras, and
call signaling address for all relevant RAS messages.
Example:
Router(config-gk)# security
Step 5
security match alias-address-list
Configures the gatekeeper to perform checks on the
alias-address list for all relevant RAS messages.
Example:
Router(config-gk)# security match
alias-address-list
Step 6
Exits the current mode.
exit
Example:
Router(config-gk)# exit
Examples
Router# config terminal
Router(config)# gatekeeper
Router(config-gk)# security match source-ip
Router(config-gk)# security match alias-address-list
Router(config-gk)# exit
Verifying Enhanced ARQ and RRQ Security for Gatekeeper Registrations
The following example shows the configuration of a gatekeeper with Enhanced ARQ and RRQ Security
for Gatekeeper Registrations enabled. Note that the aaa alias-address command must be enabled for the
gatekeeper to send the source address and alias-address info in the AAA requests. This command is
enabled by default and not visible to users for manual configuration.
Router# show run all | security gatekeeper
gatekeeper
zone local OGK cisco.com 10.10.10.4 invia OGK outvia OGK
zone remote TGK cisco.com 10.10.10.5 1719
Cisco Unified Border Element with Gatekeeper Configuration Guide
28
Configuring Cisco Unified Border Element with Gatekeeper
How to Configure Cisco Unified Border Element with Gatekeeper
zone prefix TGK 54*
zone prefix OGK 63*
security match source-ip
security match alias-address-list
security aaa alias-address
no shutdown
Configring Extended InterZone Clear Token Support
The Extended InterZone Clear Token support provides the ability for terminating gatekeeper (TGK) or
originating gatekeeper OGK) to compute the Inter-Zone Clear Token (IZCT) hash token based on the
Destination Alias, Destination CSA, Destination epid, Source Alias, Source CSA & Source epid.
Currently gatekeepers compute the IZCT hash token only based on the Destination Alias. Extending the
IZCT abilities increases Billing and Service integrity.
This feature provides additional security checks upon receiving the registration request (RRQ) from an
endpoint. Enhanced Admission Request (ARQ) and RRQ Security for gatekeepers describes
comparisons made in the endpoint ID, aliases, source address, RAS address, and call signaling address
for the end point to its registration and reject the request if the appropriate fields don’t match.
The enhanced security checks at the gatekeeper compares source address, RAS address and call
signaling addresses for the endpoint and sends the reject RRQ if the appropriate fields don’t match. To
configure enhanced security checks at the gatekeeper for RRQ, perform the steps in this section. This
section contains the following subsections:
•
Restrictions for ARQ and RRQ Security for Gatekeeper Registrations, page 26
•
Information About ARQ and RRQ Security for Gatekeeper Registrations, page 26
•
Configuring ARQ and RRQ Security for Gatekeeper Registrations, page 27
•
Verifying Enhanced ARQ and RRQ Security for Gatekeeper Registrations, page 28
Restrictions for Extended InterZone Clear Token Support
•
The security izct command must be configured at OGK/TGK in order to enable the feature.
•
The call will fail if the hash keyword at TGK is changed from the point of computation of IZCT hash
token to the point of re-computation of IZCT hash token after receiving the ARQ from TGW.
•
The IZCT token generated is valid only for 30 seconds
•
IZCT Hash token generated by TGK can be used for multiple calls only with in 30 seconds.
•
When configuring an outgoing gateway (OGW) <-> outgoing gatekeeper (OGK) <-> a trunking
gatekeeper (TGK) <-> a trunking gateway (TGW). The secutity izct command is optional at the
OGK, and required at the TGK. If hash parameter is not specified at the TGK, then dest-alias
(default) will be used for hash token computation.
Information About Extended InterZone Clear Token Support
•
The Hash keyword at OGK and TGK do not need to match.
•
More than one hash keyword can be configured for thesecurity izct command
Cisco Unified Border Element with Gatekeeper Configuration Guide
29
Configuring Cisco Unified Border Element with Gatekeeper
How to Configure Cisco Unified Border Element with Gatekeeper
Configuring Extended InterZone Clear Token Support
To enable Extended InterZone Clear Token Support, perform the following steps.
SUMMARY STEPS
1.
enable
2.
configure terminal
3.
gatekeeper
4.
security izct password password {hash dest-alias | src-alias | src-csa | dest-csa | src-epid |
dst-epid}
5.
exit
DETAILED STEPS
Step 1
Command or Action
Purpose
enable
Enables privileged EXEC mode.
•
Enter your password if prompted.
Example:
Router> enable
Step 2
configure terminal
Enters global configuration mode.
Example:
Router# configure terminal
Step 3
Enters gatekeeper configuration mode.
gatekeeper
Example:
Router(config)# gatekeeper
Step 4
security izct password password {hash dest-alias
|src-alias |src-csa |dest-csa |src-epid
|dst-epid}
Configures the gatekeeper to perform checks on the
alias-address list for all relevant RAS messages.
Example:
Router(config-gk)# security izct password
password hash dest-alias
Step 5
Exits the current mode.
exit
Example:
Router(config-gk)# exit
Verifying Enhanced ARQ and RRQ Security for Gatekeeper Registrations
The following example shows the configuration of a gatekeeper with the Enhanced ARQ and RRQ
Security for Gatekeeper Registrations feature enabled. Note that the aaa alias-address command must
be enabled for the gatekeeper to send the source address and alias-address informatio in the AAA
requests. This command is enabled by default and not visible to users for manual configuration.
Router# show run all | security gatekeeper
Cisco Unified Border Element with Gatekeeper Configuration Guide
30
Configuring Cisco Unified Border Element with Gatekeeper
How to Configure Cisco Unified Border Element with Gatekeeper
gatekeeper
zone local OGK cisco.com 10.10.10.4 invia OGK outvia OGK
zone remote TGK cisco.com 10.10.10.5 1719
zone prefix TGK 54*
zone prefix OGK 63*
security match source-ip
security match alias-address-list
security aaa alias-address
no shutdown
Configuring RAS Retry and Timer
This features allows service providers the ability to control transmit time margins on Cisco gatekeepers
by changing the RAS message timeout LRQ value and message retry counter values.
The ras timeout lrq command configures the number of seconds for the gateway to wait before
resending an RAS message to a gatekeeper. The ras retry command configures the number of times to
resend the RAS message after the timeout period expires. The default values for timeouts and retries are
acceptable in most networks. You can use these commands if you are experiencing problems in RAS
message transmission between gateways and gatekeepers. For example, if you have gatekeepers that are
slow to respond to a type of RAS request, increasing the timeout value and the number of retries
increases the call success rate, preventing lost billing information and unnecessary switchover to an
alternate gatekeeper.
To configure RAS message timeout values and retry counters, perform the following tasks.
SUMMARY STEPS
1.
enable
2.
configure terminal
3.
gatekeeper
4.
ras timeout lrq2
5.
ras retry lrq 1
6.
no shutdown
7.
exit
DETAILED STEPS
Step 1
Command or Action
Purpose
enable
Enables privileged EXEC mode.
•
Enter your password if prompted.
Example:
Router> enable
Step 2
configure terminal
Enters global configuration mode.
Example:
Router# configure terminal
Cisco Unified Border Element with Gatekeeper Configuration Guide
31
Configuring Cisco Unified Border Element with Gatekeeper
How to Configure Cisco Unified Border Element with Gatekeeper
Step 3
Command or Action
Purpose
gatekeeper
Enters gatekeeper configuration mode.
Example:
Router(config)# gatekeeper
Step 4
ras timeout lrq 2
Configures the gatekeeper RAS message timeout values.
Example:
Router(config-gk)# ras timeout lrq 2
Step 5
Configures the gatekeeper RAS message retry value.
ras retry lrq 1
Example:
Router(config-gk)# ras retry lrq 1
Step 6
Enables the gatekeeper.
no shutdown
Example:
Router(config-gk)# no shutdown
Step 7
Exits the current mode.
exit
Example:
Router(config-gk)# exit
Configuring Real-Time Call Type Reporting Through GKTMP
This feature allows Cisco H.323 VoIP gateways to report the call type to a Cisco IOS Gatekeeper at the
end of each call through an RAS DRQ message using an external call routing application through
GKTMP. This allows an external call routing application to consider the call type when it makes
decisions about how to route subsequent calls to the same destination.
To configure the call-type trigger from the gatekeeper to the RouteServer on receipt of the DRQ perform
the following tasks.
SUMMARY STEPS
1.
enable
2.
configure terminal
3.
gatekeeper
4.
server trigger drq
5.
destination-info call-info-type
6.
exit
Cisco Unified Border Element with Gatekeeper Configuration Guide
32
Configuring Cisco Unified Border Element with Gatekeeper
How to Configure Cisco Unified Border Element with Gatekeeper
DETAILED STEPS
Step 1
Command or Action
Purpose
enable
Enables privileged EXEC mode.
•
Enter your password if prompted.
Example:
Router> enable
Step 2
Enters global configuration mode.
configure terminal
Example:
Router# configure terminal
Step 3
Enters gatekeeper configuration mode.
gatekeeper
Example:
Router(config)# gatekeeper
Step 4
Configures the disengage request (DRQ) trigger statically
on the gatekeeper.
server trigger drq
Example:
Router(config-gk)# server trigger drq ZGK2 1
RouteServer 1.1.1.1 10000
Step 5
Specifies the call type filter in the gatekeeper DRQ trigger
submode.
destination-info call-info-type voice
Example:
Router(config-gk_drqtrigger)# destination-info
call-info-type voice
Step 6
Exits the gatekeeper DRQ trigger submode.
exit
Example:
Router(config-gk_drqtrigger)# exit
Examples
The following example shows the configuration to trigger the call type from the gatekeeper to
RouteServer on receipt of a disengage request (DRQ). In this example the DRQ will be sent to a route
server for voice, fax, and modem:
!
gatekeeper
zone local ZGK2 example.com
zone remote DGK example.com 10.5.5.5 1719
zone prefix ZGK2 1...
zone prefix DGK 2...
gw-type-prefix 1#* default-technology
no shutdown
server registration-port 8888
!
server trigger drq ZGK2 1 RouteServer 10.1.1.1 10000
info-only
call-info-type voice
call-info-type fax
call-info-type modem
!
Cisco Unified Border Element with Gatekeeper Configuration Guide
33
Configuring Cisco Unified Border Element with Gatekeeper
How to Configure Cisco Unified Border Element with Gatekeeper
Configuring Alternate Endpoint Call Attempts in RADIUS Call Accounting
Records
This feature controls alternate endpoint hunting based on call disconnect cause codes.Alternate end point
hunt is enabled by default. If you configure this feature you can control (disable) hunting based on call
disconnect cause codes.
To configure alternate endpoint call attempts in RADIUS call accounting records tried in an Cisco UBE,
perform the following steps.
SUMMARY STEPS
1.
enable
2.
configure terminal
3.
voice service {voip | voatm}
4.
no h225 alt-ep hunt [all | cause-code]
DETAILED STEPS
Step 1
Command or Action
Purpose
enable
Enables privileged EXEC mode.
•
Enter your password if prompted.
Example:
Router> enable
Step 2
configure terminal
Enters global configuration mode.
Example:
Router# configure terminal
Step 3
voice service {voip | voatm}
Enters voice service configuration mode and specifies a
voice encapsulation type.
Example:
Router(config)# voice service voip
Step 4
Enters H.323 voice-service configuration mode.
h323
Example:
Router(config-voice-service)# h323
Step 5
no h225 alt-ep hunt [all | cause-code]
Example:
Router(conf-serv-h323)# no h225 alt-ep hunt
user-busy
Disables alternate endpoint hunts based on call disconnect
cause codes.
•
all—Continue hunt for all disconnect cause codes.
•
cause-code—May be entered as standard Q.850
number or as text.
Note
Cisco Unified Border Element with Gatekeeper Configuration Guide
34
Alternate endpoint hunt is enabled for all cause
codes by default. Command will be visible only for
the negated hunt cause codes (with no prefixed).
Configuring Cisco Unified Border Element with Gatekeeper
How to Configure Cisco Unified Border Element with Gatekeeper
Unique Calling Party Information with Alternate Endpoints
This feature enables alternate endpoint capabilities of the Cisco IOS H.323 gatekeeper and voice
gateway to associate a unique calling party number automatic number identification (ANI) with each
alternate endpoint using the GKTMP.
Verifying Gatekeeper Configuration and Operation
To verify gatekeeper configuration and operation, perform the following steps (listed alphabetically) as
appropriate.
Step 1
show gatekeeper circuit
Use this command to view information on calls in progress.
Step 2
show gatekeeper endpoint
Use this command to view information on endpoint registrations.
Step 3
how gatekeeper performance stats
Use this command to view RAS information, including via-zone statistics.
Step 4
show gatekeeper status
Use this command to view call-capacity thresholds.
Step 5
show gatekeeper zone status
Use this command to verify gatekeeper configuration.
Step 6
show running-config | begin gatekeeper
Use this command to verify gatekeeper configuration.
Examples
This section contains the following output examples:
•
Sample Output for the show gatekeeper circuit Command, page 36
•
Sample Output for the show gatekeeper endpoint Command, page 36
•
Sample Output for the show gatekeeper performance stats Command, page 36
•
Sample Output for the show gatekeeper status Command, page 38
•
Sample Output for the show gatekeeper zone status Command, page 38
•
Sample Output for the show running-config Command, page 39
Cisco Unified Border Element with Gatekeeper Configuration Guide
35
Configuring Cisco Unified Border Element with Gatekeeper
How to Configure Cisco Unified Border Element with Gatekeeper
Sample Output for the show gatekeeper circuit Command
Router# show gatekeeper circuit
CIRCUIT INFORMATION
===================
Circuit
Endpoint
Max Calls Avail Calls Resources
---------------------- ----------- --------cisco-default-h323-circuit
Total Endpoints: 1
ipipgw
1000
1000
Available
Note
Zone
----
The word “calls” refers to call legs in some commands and output.
Sample Output for the show gatekeeper endpoint Command
Router# show gatekeeper endpoint
GATEKEEPER ENDPOINT REGISTRATION
================================
CallSignalAddr Port RASSignalAddr
Port Zone Name
--------------- ----- --------------- ----- --------172.19.148.202 1720 172.19.148.202 2052 vepzone
E164-ID: 1025
H323-ID: cjb.office
172.19.148.205 1720 172.19.148.205 55995 vepzone
H323-ID: ipipgw
Voice Capacity Max.= 1000 Avail.= 1000 Current.= 0
172.19.148.208 1720 172.19.148.208 17201 vepzone
E164-ID: 130512344
E164-ID: 1024
H323-ID: vep4
172.19.232.138 1720 172.19.232.138 17201 vepzone
E164-ID: 4203
H323-ID: ipvc-pt900-2
Total number of active registrations = 4
Type
---TERM
H323-GW
TERM
TERM
Sample Output for the show gatekeeper performance stats Command
Table 1 describes the significant RAS via-zone fields shown in the display.
Router# show gatekeeper performance stats
-----Gatekeeper Performance Statistics----Performance statistics captured since: 01:50:17 UTC Sun Mar 3 2002
Gatekeeper level Admission Statistics:
ARQs received: 28
ARQs received from originating endpoints: 14
ACFs sent: 28
ACFs sent to the originating endpoint: 14
ARJs sent: 0
ARJs sent to the originating endpoint: 0
ARJs sent due to overload: 0
Number of concurrent calls: 0
Number of concurrent originating calls: 0
Gatekeeper level Location Statistics:
LRQs received: 0
LRQs sent: 0
LCFs received: 0
Cisco Unified Border Element with Gatekeeper Configuration Guide
36
Flags
-----
Configuring Cisco Unified Border Element with Gatekeeper
How to Configure Cisco Unified Border Element with Gatekeeper
LCFs
LRJs
LRJs
LRJs
sent: 0
received: 0
sent: 0
sent due to overload: 0
Gatekeeper level Registration Statistics:
RRJ due to overload: 0
Total Registered Endpoints: 4
Gatekeeper level Disengage Statistics:
DRQs received: 24
DRQs sent: 0
DCFs received: 0
DCFs sent: 24
DRJs received: 0
DRJs sent: 0
Gatekeeper viazone message counters:
inARQ: 7
infwdARQ: 0
inerrARQ: 0
inLRQ: 0
infwdLRQ: 0
inerrLRQ: 0
outLRQ: 0
outfwdLRQ: 0
outerrLRQ: 0
outARQ: 0
outfwdARQ: 0
outerrARQ: 0
Load balancing events: 0
Table 1
show gatekeeper performance stats Field Descriptions
Field
Description
inLRQ
Message counter associated with the invia keyword. If the invia is a local zone, this
counter identifies the number of LRQs terminated by the local invia gatekeeper.
infwdLRQ
Message counter associated with the invia keyword. If the invia is a remote zone,
this counter identifies the number of LRQs that were forwarded to the remote invia
gatekeeper.
inerrLRQ
Message counter associated with the invia keyword. Number of times the LRQ
could not be processed because the invia gatekeeper ID could not be found. Usually
caused by a misspelled gatekeeper name.
outLRQ
Message counter associated with the outvia keyword. If the outvia is a local zone,
this counter identifies the number of LRQs terminated by the local outvia
gatekeeper. This counter applies only in configurations where no invia gatekeeper
is specified.
outfwdLRQ
Message counter associated with the outvia keyword. If the outvia is a remote
zone, this counter identifies the number of LRQs that were forwarded to the remote
outvia gatekeeper. This counter applies only in configurations where no invia
gatekeeper is specified.
outerrLRQ
Message counter associated with the outvia keyword. Number of times the LRQ
could not be processed because the outvia gatekeeper ID could not be found.
Usually caused by a misspelled gatekeeper name. This counter applies only in
configurations where no invia gatekeeper is specified.
Cisco Unified Border Element with Gatekeeper Configuration Guide
37
Configuring Cisco Unified Border Element with Gatekeeper
How to Configure Cisco Unified Border Element with Gatekeeper
Table 1
show gatekeeper performance stats Field Descriptions (continued)
Field
Description
outARQ
Message counter associated with the outvia keyword. Identifies the number of
originating ARQs handled by the local gatekeeper if the outvia is in the local zone.
outfwdARQ
Message counter associated with the outvia keyword. If the outvia gatekeeper is a
remote zone, this number identifies the number of originating ARQs received by
this gatekeeper that resulted in LRQs being sent to the outvia gatekeeper.
outerrARQ
Message counter associated with the outvia keyword. Number of times the
originating ARQ could not be processed because the outvia gatekeeper ID could
not be found. Usually caused by a misspelled gatekeeper name.
Sample Output for the show gatekeeper status Command
Router# show gatekeeper status
Gatekeeper State: UP
Load Balancing:
DISABLED
Flow Control:
DISABLED
Zone Name:
vepzone
Accounting:
DISABLED
Endpoint Throttling:
DISABLED
Security:
DISABLED
Maximum Remote Bandwidth:
unlimited
Current Remote Bandwidth:
0 kbps
Current Remote Bandwidth (w/ Alt GKs): 0 kbps
Sample Output for the show gatekeeper zone status Command
Router# show gatekeeper zone status
GK name
-------
GATEKEEPER ZONES
================
Domain Name
RAS Address
---------------------
PORT FLAGS
----- -----
vepzone
172.19.148.10 172.19.148.209 1719 LSV
VIAZONE INFORMATION :
invia:vepzone,
outvia:vepzone
intrazone:enabled
BANDWIDTH INFORMATION (kbps) :
Maximum total bandwidth : unlimited
Current total bandwidth : 0
Maximum interzone bandwidth : unlimited
Current interzone bandwidth : 0
Maximum session bandwidth : unlimited
SUBNET ATTRIBUTES :
All Other Subnets : (Enabled)
PROXY USAGE CONFIGURATION :
Inbound Calls from all other zones :
to terminals in local zone vepzone : do not use proxy
to gateways in local zone vepzone : do not use proxy
to MCUs in local zone vepzone : do not use proxy
Outbound Calls to all other zones :
from terminals in local zone vepzone : do not use proxy
from gateways in local zone vepzone : do not use proxy
from MCUs in local zone vepzone : do not use proxy
Cisco Unified Border Element with Gatekeeper Configuration Guide
38
Configuring Cisco Unified Border Element with Gatekeeper
How to Configure Cisco Unified Border Element with Gatekeeper
Sample Output for the show running-config Command
Router# show running-config
.
.
.
gatekeeper
zone local viagk2local1 mcebutest2.example.com 200.1.1.96 invia viagk2 outvia viagk2
enable-intrazone
zone local viagk2 mcebutest.example.com invia viagk2 outvia viagk2 enable-intrazone
zone local viagk2local2 mcebutest2.example.com
zone remote viagk1 mcebutest.example.com 200.1.1.76 1719 invia viagk2 outvia viagk2
zone remote dgk-us mcebutest.example.com 200.1.1.90 1719
zone remote viagk3 mcebutest.example.com 200.1.1.85 1719 invia viagk2 outvia viagk2
zone prefix viagk1 131013720..
zone prefix viagk3 14122351...
send-cisco-circuit-info
gw-type-prefix 7#* default-technology
no use-proxy viagk2local1 default inbound-to terminal
no use-proxy viagk2local1 default outbound-from terminal
no use-proxy viagk2 default inbound-to terminal
no use-proxy viagk2 default outbound-from terminal
no shutdown
Troubleshooting Gatekeeper Configuration and Operation
Caution
Under moderate traffic loads, these debug commands produce a high volume of output.
•
Use the debug voip ipipgw command to debug the Cisco Unified Border Element with Gatekeeper
feature.
•
Use any of the following additional debug commands (listed alphabetically) on the gatekeeper as
appropriate:
– debug gatekeeper call 10
– debug gatekeeper endpoint 10
– debug gatekeeper main 10
– debug gatekeeper zone 10
– debug h225 asn1
– debug ras
Note
For examples of show and debug command output and details on interpreting the output, see the
following resources:
•
Cisco IOS Debug Command Reference, Release 12.3T
•
Cisco IOS Voice Troubleshooting and Monitoring Guide
•
Troubleshooting and Debugging VoIP Call Basics
•
VoIP Debug Commands
Cisco Unified Border Element with Gatekeeper Configuration Guide
39
Configuring Cisco Unified Border Element with Gatekeeper
Configuration Examples for Gatekeepers
Configuration Examples for Gatekeepers
This chapter includes the following configuration examples:
•
Universal Gatekeeper Configurations: Example, page 40
•
Via-Zone Gatekeeper: Example, page 41
Universal Gatekeeper Configurations: Example
The size and complexity of gatekeeper configuration become greater as the number of interoperating
gatekeepers increases in the VoIP network. One solution to minimize the configuration complexity of
the gatekeepers is to maintain a “master list” of remote zones. With this strategy, the master list is applied
to the gatekeeper configuration, and the proper remote zone is changed to be the local zone. For example:
zone
zone
zone
zone
zone
zone
zone
zone
remote
remote
remote
remote
remote
prefix
prefix
prefix
Scotland example.com 10.18.194.165
transAtlantic example.com 10.18.194.183
transPacific example.com 10.18.194.180
USA example.com 10.18.200.135 outvia transPacific
Brazil example.com 10.18.194.179
Scotland 44*
USA 1*
Brazil 55*
The call flow between USA and Scotland now has calls originating from Scotland to the USA going
through a trans-Pacific Cisco UBE and calls from the USA to Scotland going through a trans-Atlantic
Cisco UBE.
To add another example, if you want all calls originated from Scotland to be routed through Cisco UBEs
in the trans-Atlantic zone, the master file is changed as shown in the following example:
zone
zone
zone
zone
zone
zone
zone
zone
remote
remote
remote
remote
remote
prefix
prefix
prefix
transAtlantic example.com 10.18.194.183
transPacific example.com 10.18.194.180
Scotland example.com 10.18.194.165 outvia transAtlantic
USA example.com 10.18.200.135 outvia transAtlantic
Brazil example.com 10.18.194.179
Scotland 44*
USA 1*
Brazil 55*
All of the examples shown illustrate the concept of a master gatekeeper configuration. Also, even though
the USA and Scotland gatekeepers have a via-zone keyword in their configuration, this does not imply
that they have any Cisco UBEs registered to them. Call resolution for Brazil, for example, happens
according to the traditional logic for calls originating from the USA and Scotland.
Cisco Unified Border Element with Gatekeeper Configuration Guide
40
Configuring Cisco Unified Border Element with Gatekeeper
Configuration Examples for Gatekeepers
Via-Zone Gatekeeper: Example
Figure 1 shows an example configuration of the Via-zone Gatekeeper feature.
Figure 1
Via-zone Gatekeeper Feature Topology
Domain A
Cisco VoIP to VoIP
gateway via zone
GKVIA
408 zone
Domain B
323
323
Cisco Unified
Border Element
GK408
GK919
V
V
GW408
72521
GW919
Originating Gateway Configuration: Example
interface Ethernet0/0
ip address 10.16.8.132 255.255.255.0
half-duplex
h323-gateway voip interface
h323-gateway voip id GK408 ipaddr 10.16.8.123 1718
h323-gateway voip h323-id GW408
!
dial-peer voice 919 voip
destination-pattern 919.......
session target ras
!
gateway
Originating Gatekeeper Configuration: Example
gatekeeper
zone local GK408 usa 10.16.8.123
zone remote GKVIA usa 10.16.8.24 1719
zone prefix GKVIA 919*
gw-type-prefix 1#*
no shutdown
Cisco Unified Border Element with Gatekeeper Configuration: Example
!
voice service voip
no allow-connections any to pots
no allow-connections pots to any
Cisco Unified Border Element with Gatekeeper Configuration Guide
41
Configuring Cisco Unified Border Element with Gatekeeper
Configuration Examples for Gatekeepers
allow-connections h323 to h323
h323
ip circuit max-calls 1000
ip circuit default only
!
!
interface FastEthernet0/0
ip address 10.16.8.145 255.255.255.0
ip route-cache same-interface
duplex auto
speed auto
h323-gateway voip interface
h323-gateway voip id GKVIA ipaddr 10.16.8.24 1718
h323-gateway voip h323-id IPIPGW
h323-gateway voip tech-prefix 1#
!
!
dial-peer voice 919 voip
incoming called-number 919.......
destination-pattern 919.......
session target ras
codec transparent
!
gateway
Via-Zone Gatekeeper Configuration: Example
gatekeeper
zone local GKVIA usa 10.16.8.24
zone remote GK919 usa 10.16.8.146 1719 invia GKVIA outvia GKVIA
zone prefix GK919 919*
no shutdown
Terminating Gateway: Example
interface Ethernet0/0
ip address 10.16.8.134 255.255.255.0
half-duplex
h323-gateway voip interface
h323-gateway voip id GK919 ipaddr 10.16.8.146 1718
h323-gateway voip h323-id GW919
h323-gateway voip tech-prefix 919
!
dial-peer voice 919 pots
destination-pattern 919.......
port 1/0:1
!
gateway
Terminating Gatekeeper Configuration: Example
gatekeeper
zone local GK919 usa 10.16.8.146
gw-type-prefix 1#* default-technology
no shutdown
Cisco Unified Border Element with Gatekeeper Configuration Guide
42
Configuring Cisco Unified Border Element with Gatekeeper
Additional References
Additional References
The following sections provide additional references related to the Cisco Unified Border Element with
Gatekeeper.
Note
•
In addition to the references listed below, each chapter provides additional references related to
Cisco Unified Border Element.
•
Some of the products and services mentioned in this guide may have reached end of life, end of sale,
or both. Details are available at http://www.cisco.com/en/US/products/prod_end_of_life.html.
•
The preface and glossary for the entire voice-configuration library suite of documents is listed
below.
Related Documents
Related Topic
Cisco IOS Release 12.4
Document Title
•
Cisco IOS Release 12.4 Configuration Guides
•
Cisco IOS Release 12.4T Configuration Guides
•
Cisco IOS Release 12.4 Command References
•
Cisco IOS Voice Configuration Library
http://www.cisco.com/en/US/docs/ios/12_3/vvf_c/cisco_ios_voice_configura
tion_library_glossary/vcl.htm
Note
Cisco IOS Release 12.3
Cisco IOS Release 12.2
DSP documentation
This website contains the library preface and glossary.
•
Cisco IOS Release 12.3 documentation
•
Cisco IOS voice commands
•
Cisco IOS Voice Troubleshooting and Monitoring Guide
•
Tcl IVR Version 2.0 Programming Guide
•
Cisco IOS Voice, Video, and Fax Configuration Guide, Release 12.2 at
http://www.cisco.com/en/US/docs/ios/12_2/voice/configuration/guide/fvvfax
_c.html
High-Density Packet Voice Feature Card for Cisco AS5350XM and AS5400XM
Universal Gateways
http://www.cisco.com/univercd/cc/td/doc/product/software/ios124/124newft/124l
imit/124x/124xc4/vfc_dsp.htm
GKTMP (GK API) Documents
•
GKTMP Command Reference:
http://www.cisco.com/en/US/docs/ios/12_2/gktmp/gktmpv4_2/gk_cli.htm
•
GKTMP Messages:
http://www.cisco.com/en/US/docs/ios/12_2/gktmp/gktmpv4_2/gk_tmp.html
Cisco Unified Border Element with Gatekeeper Configuration Guide
43
Configuring Cisco Unified Border Element with Gatekeeper
Additional References
Related Topic
Document Title
internet Low Bitrate Codec (iLBC)
Documents
•
Codecs section of the Dial Peer Configuration on Voice Gateway Routers
Guide
http://www.cisco.com/univercd/cc/td/doc/product/software/ios123/123cgcr/v
vfax_c/int_c/dpeer_c/dp_ovrvw.htm#1035124
•
Dial Peer Features and Configuration section of the Dial Peer Configuration
on Voice Gateway Routers Guide
http://www.cisco.com/univercd/cc/td/doc/product/software/ios123/123cgcr/v
vfax_c/int_c/dpeer_c/dp_confg.htm
Cisco Unified Border Element
Configuration Examples
Related Application Guides
•
Local-to-remote network using the IPIPGW
http://www.cisco.com/en/US/tech/tk1077/technologies_configuration_
example09186a00801b0803.shtml
•
Remote-to-local network using the IPIPGW:
http://www.cisco.com/en/US/tech/tk1077/technologies_configuration_examp
le09186a0080203edc.shtml
•
Remote-to-remote network using the IPIPGW:
http://www.cisco.com/en/US/tech/tk1077/technologies_configuration_examp
le09186a0080203edd.shtml
•
Remote-to-remote network using two IPIPGWs:
http://www.cisco.com/en/US/tech/tk1077/technologies_configuration_examp
le09186a0080203edb.shtml
•
Cisco Unified Communications Manager and Cisco IOS Interoperability
Guide
•
Cisco IOS Fax, Modem, and Text Support over IP Configuration Guide
•
“Configuring T.38 Fax Relay” chapter
•
Cisco IOS SIP Configuration Guide
•
Cisco Unified Communications Manager (CallManager) Programming Guides
at:
http://www.cisco.com/en/US/products/sw/voicesw/ps556/products_program
ming_reference_guides_list.html
Related Platform Documents
Related gateway configuration
documentation
•
Quality of Service for Voice over IP at
http://www.cisco.com/en/US/docs/ios/solutions_docs/qos_solutions/QoSVoI
P/QoSVoIP.html
•
Cisco 2600 Series Multiservice Platforms
•
Cisco 2800 Series Integrated Services Routers
•
Cisco 3600 Series Multiservice Platforms
•
Cisco 3700 Series Multiservice Access Routers
•
Cisco 3800 Series Integrated Services Routers
•
Cisco 7200 Series Routers
•
Cisco 7301
Media and Signaling Authentication and Encryption Feature for Cisco IOS H.323
Gateways.
http://www.cisco.com/en/US/docs/ios/12_4t/12_4t11/htsecure.htm
Cisco Unified Border Element with Gatekeeper Configuration Guide
44
Configuring Cisco Unified Border Element with Gatekeeper
Additional References
Related Topic
Cisco IOS NAT Configuration Guide,
Release 12.4T
Troubleshooting and Debugging guides
Document Title
•
Configuring Cisco IOS Hosted NAT Traversal for Session Border Controller
http://www.cisco.com/en/US/docs/ios/12_4t/ip_addr/configuration/guide/htnatsb
c.html
•
Cisco IOS Debug Command Reference, Release 12.4 at
http://www.cisco.com/en/US/docs/ios/debug/command/reference/db_book.ht
ml
•
Troubleshooting and Debugging VoIP Call Basics at
http://www.cisco.com/en/US/tech/tk1077/technologies_tech_note09186a008
0094045.shtml
•
VoIP Debug Commands at
http://www.cisco.com/en/US/docs/routers/access/1700/1750/software/config
uration/guide/debug.html
Standards
Standards
Title
H.323 Version 4 and earlier
H.323 (ITU-T VOIP protocols)
MIBs
MIBs
MIBs Link
None.
To locate and download MIBs for selected platforms, Cisco IOS
releases, and feature sets, use Cisco MIB Locator found at the
following URL: http://www.cisco.com/go/mibs
RFCs
RFCs
Title
RFC 2833
RTP Payload for DTMF Digits, Telephony Tones and Telephony
Signals
RFC 3261
SIP: Session Initiation Protocol
Technical Assistance
Description
Link
The Cisco Technical Support website contains
http://www.cisco.com/techsupport
thousands of pages of searchable technical content,
including links to products, technologies, solutions,
technical tips, and tools. Registered Cisco.com users
can log in from this page to access even more content.
Cisco Unified Border Element with Gatekeeper Configuration Guide
45
Configuring Cisco Unified Border Element with Gatekeeper
Feature Information for Cisco Unified Border Element with Gatekeeper Configuration Guide
Feature Information for Cisco Unified Border Element with
Gatekeeper Configuration Guide
Table 2 lists the features in this module and provides links to specific configuration information. Only
features that were introduced or modified in Cisco IOS Release 12.2(13)T3 or a later release appear in
the table. Table 2 lists only the Cisco IOS software release that introduced support for a given feature in
a given Cisco IOS software release train. Unless noted otherwise, subsequent releases of that Cisco IOS
software release train also support that feature.
Table 2
Feature Information for Cisco Unified Border Element Overview
Feature Name
Release
Feature Information
Cisco UBE Image Consolidation
12.3(7)T
This feature was introduced.
Dynamic Control of Gatekeeper Sequential LRQ
Processing Through GKTMP
12.4(4)T
This feature was introduced.
Enhanced ARQ and RRQ Security for Gatekeeper 12.4(15)XY
Registrations
12.4(20)T
This feature was introduced.
Extended InterZone Clear Token
This feature was introduced.
12.4(15)XZ
12.4(20)T
H.323 Standard Based Hopcount Field in LRQ.
12.4(4)T
This feature was introduced.
In-Service Updates to Gatekeeper Zone Prefix
Configuration
12.4(6)T
This feature was introduced.
RAS Retry and Timer; Sequential LRQ Timer
12.4(4)T
This feature was introduced.
Real-Time Call Type Reporting Through GKTMP 12.4(4)T
This feature was introduced.
Restriction for Video Calls made from a Cisco
Unified Communications Manager to an Cisco
Unified Border Element
12.3(8)T
This restriction was added.
Support for Cisco 7200 and Cisco 7301
12.3(8)T
This feature was introduced.
Support for the Cisco 2801
12.4(4)T
This feature was introduced.
Support for the Cisco 2811, Cisco 2821,
Cisco 2851, Cisco 3825, and Cisco 3845
12.3(11)T
This feature was introduced.
Unique Calling Party Information with Alternate
Endpoints
12.4(6)T
This feature was introduced.
CCDE, CCENT, CCSI, Cisco Eos, Cisco HealthPresence, Cisco IronPort, the Cisco logo, Cisco Lumin, Cisco Nexus, Cisco Nurse Connect ,
Cisco StackPower, Cisco StadiumVision, Cisco TelePresence, Cisco Unified Computing System, Cisco WebEx, DCE, Flip Channels, Flip for Good,
Flip Mino, Flip Video, Flip Video (Design), Flipshare (Design), Flip Ultra, and Welcome to the Human Network are trademarks; Changing the Way
We Work, Live, Play, and Learn, Cisco Store, and Flip Gift Card are service marks; and Access Registrar, Aironet, AsyncOS, Bringing the Meeting
To You, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, CCSP, CCVP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco IOS,
Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity, Collaboration Without Limitation, EtherFast, EtherSwitch,
Event Center, Fast Step, Follow Me Browsing, FormShare, GigaDrive, HomeLink, Internet Quotient, IOS, iPhone, iQuick Study, IronPort, the
IronPort logo, LightStream, Linksys, MediaTone, MeetingPlace, MeetingPlace Chime Sound, MGX, Networkers, Networking Academy,
Network Registrar, PCNow, PIX, PowerPanels, ProConnect, ScriptShare, SenderBase, SMARTnet, Spectrum Expert, StackWise, The Fastest Way to
Increase Your Internet Quotient, TransPath, WebEx, and the WebEx logo are registered trademarks of Cisco Systems, Inc. and/or its affiliates in the
United States and certain other countries.
All other trademarks mentioned in this document or website are the property of their respective owners. The use of the word partner does not imply
a partnership relationship between Cisco and any other company. (0907R)
Cisco Unified Border Element with Gatekeeper Configuration Guide
46
Configuring Cisco Unified Border Element with Gatekeeper
Feature Information for Cisco Unified Border Element with Gatekeeper Configuration Guide
Any Internet Protocol (IP) addresses used in this document are not intended to be actual addresses. Any examples, command display output, and
figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses in illustrative content is unintentional and
coincidental.
© 2008 Cisco Systems, Inc. All rights reserved.
Cisco Unified Border Element with Gatekeeper Configuration Guide
47
Configuring Cisco Unified Border Element with Gatekeeper
Feature Information for Cisco Unified Border Element with Gatekeeper Configuration Guide
Cisco Unified Border Element with Gatekeeper Configuration Guide
48