Вы находитесь на странице: 1из 1110
Preface This preface describes the objectives and organization of this guide and explains how to

Preface

Preface This preface describes the objectives and organization of this guide and explains how to find

This preface describes the objectives and organization of this guide and explains how to find additional information on related products and services. This preface contains the following sections:

Guide Revision History, page 1

Objectives, page 5

Intended Audience, page 5

Organization, page 6

Related Documentation, page 8

Conventions, page 9

Configuration Guides, Command References, and Supplementary Resources, page 10

Obtaining Documentation and Submitting a Service Request, page 16

Guide Revision History

The Guide Revision History records technical changes to this guide. The table shows the software release number and guide revision number for the change, the date of the change, and a brief summary of the change.

Cisco IOS

     

Release.

Part Number

Publication Date

Change Summary

Cisco IOS

OL-19820-15

November, 2013

The following features were added:

XE Release

Blended Transcoding

3.11S

Cisco IOS

OL-19820-14

November, 2012

The following features were added:

XE Release

AMR-WB

3.8S

 

Cisco IOS

OL-19820-13

July, 2012

The following features were added:

XE Release

3.7S

H.248 Border Access Controller Support

IMS Rf Billing Interfaces

Cisco IOS

OL-19820-12

March 29, 2012

The following features were added:

XE Release

3.6S

Common IP Address Media Bypass

Via Header Passthrough

Text Part Number:

Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model

Text Part Number: Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model OL-19820-15 1

OL-19820-15

1

Cisco IOS OL-19820-11 November 28, 2011 The following features were added: XE Release • Alarm-Related

Cisco IOS

OL-19820-11

November 28, 2011

The following features were added:

XE Release

Alarm-Related Enhancements

3.5S

CAC-Related Enhancements

Call Log Correlation

Flexible Media Routing

Cisco IOS

OL-19820-10

July 25, 2011

The following features were added:

XE Release

3.4S

Limiting Resource Usage

QoS Demarcation Enhancements

SDP Editing Using Script-Based Editors

SRTP Support for RTCP Multiplexed with RTP and for SSRC-Based Multiplexing

Cisco IOS

OL-19820-09

March 18, 2011

The following features were added:

XE Release

3.3S

SIP Header Manipulation Enhancements

Support for H.239

Voice Transcoding Per Adjacency Statistics

Message, Policy, and Subscriber Statistics Enhancements

SPA DSP: Call Recovery

Flow Statistics QoS Enhancements

Selective Radius Billing

Alternative Contact Rewriting

BFCP Support

Limited H.323 ID Routing and Passthrough Support

Support to the Cisco ASR 1006 Series Router and Cisco ASR 1013 Series Router

Interchassis-Intrachassis Conversion

Series Router • Interchassis-Intrach assis Conversion Cisco Unified Border Element (SP Edition) Configuration

Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model

2

OL-19820-15

Cisco IOS OL-19820-08 November 24, 2010 The following features were added: XE Release • SPA

Cisco IOS

OL-19820-08

November 24, 2010

The following features were added:

XE Release

SPA DSP Services

3.2S

Emergency and Security Enhancements

SIP trust model includes H.323 Interface

Emergency Call statistics

SBC Calls Support using IPSec Tunnels

ASR1001 Support

XML based billing

SIP Interworking Enhancements

Event Header in Publish Method

Source Number Editing during Number analysis

Privacy Service

Option Ping Enhancements

Multiple SBC media bypass

Add Expires Header to Register Message

Absence of Username Support in Request URI

Analysis, Routing, and Policy Enhancements

Copy and Swap Procedure

Multiple CAC Averaging Periods

Administrative Domains

Blacklist Alerts

Media Interworking Enhancements

MGX Assisted DTMF Interworking

Codec Preference and Re-Ordering

Per-Adjacency Codec String Interworking

Media Address Pool Support

PKI High Availability Support

Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model

PKI High Availability Support Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model OL-19820-15 3

OL-19820-15

3

Cisco IOS OL-19820-07 July 30, 2010 The following features were added: XE Release • IMS

Cisco IOS

OL-19820-07

July 30, 2010

The following features were added:

XE Release

IMS Rx and Diameter

3.1S

ENUM Client feature

Customized System Error Messages

SRTP to RTP Interworking and SRTP Passthrough

Media Bandwidth Policy

SDP on 200 Invite

Memory Alerting

SIP Destination ID and SIP Source ID

Support for Asymmetric Payload Types

IP IPv6/VRF Feature

DTMF Method Interworking and ACCEPT Header Handling

CALEA IRI Interface Support feature

Redundant Peer Addresses

Per Subscriber Delete

Cisco IOS

OL-19820-06

July 08,2010

Endpoint information in PacketCable billing records was added.

XE Release

2.6.2

 

Cisco IOS

OL-19820-05

April, 2010

Adjacency information in PacketCable Billing Records was added.

XE Release

2.6.1

 

Cisco IOS

OL-19820-04

February 26, 2010

IPv6 support including IPv4 to IPv6 and IPv6 to IPv6 Interworking, Dynamic Codec Configuration, multiple audio and video codec support, H.323 support for Clear Channel calls, SIP-I Support and SIP Non-SDP Body Filtering, Unsignaled (granular-level) Secure Media, Configurable Mutual TLS Authentication per Interface, TLS Transport Parameter in Record-Router Header, Source Number Analysis, and Interoperability for SIP Authentication features were added.

XE Release

2.6

Cisco IOS

OL-19820-03

January 27, 2010

H.323 Extra TCS Codecs support was added.

XE Release

2.5.1

Extra TCS Codecs support was added. XE Release 2.5.1 Cisco Unified Border Element (SP Edition) Configuration

Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model

4

OL-19820-15

Cisco IOS OL-19820-02 November 25, 2009 H.323 support, H.323-SIP interworking features, H.323 call routing,

Cisco IOS

OL-19820-02

November 25, 2009

H.323 support, H.323-SIP interworking features, H.323 call routing, Transcoding support, multiple SIP features, 100rel interworking, SIP IP-FQDN URI translation, Contact Username Passthrough, IP Realm support, customized offer for late-to-early media, regular expression based routing, support for external server, call duration monitoring, signaling congestion handling, support for P-visited-network-ID, and other features were added in this release. See the Feature History Table in each chapter for supported features.

XE Release

2.5

Cisco IOS

OL-19820-01

June 26, 2009

This guide introduced the unified model and a new unified feature set on the Cisco Unified Border Element (SP Edition). See the Feature History Table in each chapter for supported features.

The name Cisco Unified Border Element (SP Edition) replaced the Integrated Session Border Controller name.

XE Release

2.4

Objectives

This guide describes the Integrated Session Border Controller functions, features, restrictions, and configuration tasks for the Cisco ASR 1000 Series Aggregation Services Routers. It is not intended as a comprehensive guide to all of the software features that can be run using the Cisco ASR 1000 Series Routers, but only the Integrated Session Border Controller software specific to these Routers.

For information on general Cisco IOS software features that are also available on the Cisco ASR 1000 Series Routers, see the feature module or the technology guide for that software feature.

Intended Audience

This guide is intended for the following people:

Experienced service provider administrators

Cisco telecommunications management engineers

Customers who use and manage Cisco ASR 1000 Series Routers

Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model

Cisco ASR 1000 Series Routers Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model OL-19820-15

OL-19820-15

5

Organization This guide contains the following chapters and appendixes: Section Title Description Part 1

Organization

This guide contains the following chapters and appendixes:

Section

Title

Description

Part 1

Basics

This part contains the following modules:

Cisco Unified Border Element (SP Edition) Overview

Configuring Cisco Unified Border Element (SP Edition)

Media Address Pools

Implementing Multi-VRF on Cisco Unified Border Element (SP Edition)

Implementing Adjacencies on Cisco Unified Border Element (SP Edition)

Implementing Cisco Unified Border Element (SP Edition) Policies

Call Duration Monitoring

IP Realm Support

Managing Emergency Calls

Part 2

Service

This part contains the following modules:

Unexpected Source Address Alerting

DoS Prevention and Dynamic Blacklisting

Part 3

Dual Tone Multifrequency (DTMF)

This part contains the following module:

Implementing Interworking DTMF

Part 4

Redundancy-High

This part contains the following modules:

Availability

Cisco Unified Border Element (SP Edition) Redundancy—High Availability Support

Interchassis High Availability

Part 5

Media

This part contains the following modules:

Fax Support

Codec Handling, page 1

SDP Bandwidth Field Features

SDP Handling

Flexible Media Routing

• SDP Handling • Flexible Media Routing Cisco Unified Border Element (SP Edition) Configuration

Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model

6

OL-19820-15

Section Title Description Part 6 Session Initiation Protocol (SIP) This part contains the following

Section

Title

Description

Part 6

Session Initiation Protocol (SIP)

This part contains the following modules:

Inherit Profiles for Non-IMS Adjacencies

 

Cisco Unified Border Element (SP Edition) Registration Features

SIP Message Manipulation

Signaling Congestion Handling

SIP IP-FQDN URI Translation

SIP Tel URI Support

SIP Timer

SIP Configuration Flexibility

SIP Renegotiation

100rel Interworking Support

Customized System Error Messages

BFCP Support

Part 7

H.323

This part contains the following modules:

H.323 Support

H.323 to SIP Interworking

Support for H.239

Part 8

Billing

This part contains the following modules:

Implementing Billing on Cisco Unified Border Element (SP Edition)

Billing Support

Part 9

Secure Real-Time Transport Protocol (SRTP)

This part contains the following module:

Secure Media and SRTP Passthrough

Part 10

Quality of Service (QoS)

This part contains the following module:

Implementing QoS (Marking)

Part 11

Transcoding

This part contains the following modules:

Implementing Transcoding

Cisco Unified Border Element (SP Edition)—SPA DSP Services

Part 12

Management and

This part contains the following modules:

Operations

Tracking Policy Failure Statistics

Implementing SNMP

Logging Support

Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model

SNMP • Logging Support Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model OL-19820-15 7

OL-19820-15

7

Section Title Description Part 13 Service This part contains the following modules: • SIP 3xx

Section

Title

Description

Part 13

Service

This part contains the following modules:

SIP 3xx Redirect Responses

SIP Call Hold

SIP Call Transfer

SIP Authentication

Late-to-Early Media Interworking

Early Media

SIP Instant Messaging

Integration of Resource Management and SIP

ENUM Client

Part 14

IPv6

This part contains the following module:

IPv6 Support

Part 15

IP Multimedia Subsystem (IMS)

This part contains the following modules:

P-CSCF Support

 

IBCF Processing Support

IMS Rx, Diameter, and IMS Rf

Part 16

CALEA IRI Interface Support

This part contains the following module:

CALEA IRI Interface Support

Appendix

Appendix A

End-to-End Cisco Unified Border Element (SP Edition) Configuration Example

 

Appendix B

SIP Compliance and Interoperability

 

Appendix C

XML Billing Schema

Related Documentation

This section refers you to other documentation that might also be useful as you configure your Cisco ASR 1000 Series Routers. The documentation listed below is available on Cisco.com.

For information on Cisco Unified Border Element (SP Edition) commands, see the Cisco Unified Border Element (SP Edition) Command Reference: Unified Model at:

For information on the Cisco Unified Border Element (SP Edition) distributed model, see the:

Cisco Unified Border Element (SP Edition) Configuration Guide: Distributed Model at:

tml

Cisco Unified Border Element (SP Edition) Command Reference: Distributed Model at:

For information on the Cisco Unified Border Element (SP Edition) examples, see the Cisco Unified Border Element (SP Edition) Configuration Profile Examples at:

Cisco Unified Border Element (SP Edition) Configuration

Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model

8

OL-19820-15

For other related command documentation, see the: • Cisco IOS command reference books for the

For other related command documentation, see the:

Cisco IOS command reference books for the new Cisco ASR 1000 Series Router commands and commands in existing Cisco IOS features for this release at the following link:

Command Lookup Tool for information about Cisco IOS commands in general or a Cisco IOS master commands list at the following link:

For Quick Start guides and installation documentation for the Cisco ASR 1000 Series Router, see the hardware documentation that was provided as a part of this release at:

For information on new software features, see the:

Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide

Cisco IOS XE release notes

For further information, see the Cisco ASR 1000 Series Aggregation Services Routers Documentation Roadmap at:

Documentation for the Cisco IOS XE configuration guides and feature modules can be found at:

Conventions

This document uses the following conventions:

Convention

Indication

bold font

Commands and keywords and user-entered text appear in bold font.

italic font

Document titles, new or emphasized terms, and arguments for which you supply values are in italic font.

[

]

Elements in square brackets are optional.

{x | y | z}

Required alternative keywords are grouped in braces and separated by vertical bars.

[x

| y | z]

Optional alternative keywords are grouped in brackets and separated by vertical bars.

string

A nonquoted set of characters. Do not use quotation marks around the string or the string will include the quotation marks.

courier font

Terminal sessions and information the system displays appear in courier font.

<

>

Nonprinting characters such as passwords are in angle brackets.

[

]

Default responses to system prompts are in square brackets.

!, #

An exclamation point (!) or a pound sign (#) at the beginning of a line of code indicates a comment line.

Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model

code indicates a comment line. Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model OL-19820-15

OL-19820-15

9

Note Tip Caution Timesaver Means reader take note . Means the following information will help
Note Tip Caution Timesaver Means reader take note . Means the following information will help

Note

Note Tip Caution Timesaver Means reader take note . Means the following information will help you

Tip

Note Tip Caution Timesaver Means reader take note . Means the following information will help you

Caution

Note Tip Caution Timesaver Means reader take note . Means the following information will help you

Timesaver

Note Tip Caution Timesaver Means reader take note . Means the following information will help you

Means reader take note.

Means the following information will help you solve a problem.

Means reader be careful. In this situation, you might perform an action that could result in equipment

damage or loss of data.

Means the described action saves time. You can save time by performing the action described in

the paragraph.

Warning Means reader be warned . In this situation, you might perform an action that
Warning Means reader be warned . In this situation, you might perform an action that
Warning Means reader be warned . In this situation, you might perform an action that

Warning

Means reader be warned. In this situation, you might perform an action that could result in

bodily injury.

 
 

Configuration Guides, Command References, and Supplementary Resources

Table 1 lists, in alphabetical order, Cisco IOS XE software configuration guides and command references, including brief descriptions of the contents of the documents. The command references contain commands for both Cisco IOS software and Cisco IOS XE software, for all releases. The command references support many different software releases and platforms. Your Cisco IOS XE software release or platform may not support all these technologies.

Table 2 lists documents and resources that supplement the Cisco IOS XE 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.

For additional information about configuring and operating specific networking devices, and to access Cisco IOS documentation, go to the Product/Technologies Support area of Cisco.com at the following location:

Table 1

Cisco IOS XE Configuration Guides and Command References

Configuration Guide and Command Reference Titles

Features/Protocols/Technologies

Cisco ASR 1000 Series Aggregation Services Routers SIP and SPA Software Configuration Guide

Configuration and troubleshooting of SPA interface processors (SIPs) and shared port adapters (SPAs) that are supported on the Cisco ASR 1000 Series Router.

Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide

Overview of software functionality that is specific to the Cisco ASR 1000 Series Aggregation Services Routers.

to the Cisco ASR 1000 Series Aggregation Services Routers. Cisco Unified Border Element (SP Edition) Configuration

Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model

10

OL-19820-15

Table 1 Cisco IOS XE Configuration Guides and Command References (continued) Configuration Guide and Command

Table 1

Cisco IOS XE Configuration Guides and Command References (continued)

Configuration Guide and Command Reference Titles

Features/Protocols/Technologies

Cisco IOS XE Access Node Control Protocol Configuration Guide

Communication protocol between digital subscriber line access multiplexers (DSLAMs) and a broadband remote access server (BRAS).

Cisco IOS Access Node Control Protocol Command Reference

Cisco IOS XE Asynchronous Transfer Mode Configuration Guide

LAN ATM, multiprotocol over ATM (MPoA), and WAN ATM.

Cisco IOS Asynchronous Transfer Mode Command Reference

Cisco IOS XE Broadband Access Aggregation and DSL Configuration Guide

PPP over Ethernet (PPPoE).

Cisco IOS Broadband Access Aggregation and DSL Command Reference

Cisco IOS XE Carrier Ethernet Configuration Guide

IEEE 802.3ad Link Bundling; Link Aggregation Control Protocol (LACP) support for Ethernet and Gigabit Ethernet links and EtherChannel bundles; LACP support for stateful switchover (SSO), in service software upgrade (ISSU), Cisco nonstop forwarding (NSF), and nonstop routing (NSR) on Gigabit EtherChannel bundles; and IEEE 802.3ad Link Aggregation MIB.

Cisco IOS Carrier Ethernet Command Reference

Cisco IOS XE Configuration Fundamentals Configuration Guide

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 XE DECnet Configuration Guide

DECnet protocol.

Cisco IOS DECnet Command Reference

Cisco IOS XE Dial Technologies Configuration Guide

Asynchronous communications, dial backup, dialer technology, Multilink PPP (MLP), PPP, and virtual private dialup network (VPDN).

Cisco IOS Dial Technologies Command Reference

Easy Virtual Network Configuration Guide

Easy Virtual Network (EVN) is an IP-based virtualization technology that provides end-to-end virtualization of the network. With EVN, you can use a single IP infrastructure to provide separate virtual networks whose traffic paths remain isolated from each other.

Easy Virtual Network Command Reference

Cisco IOS XE High Availability Configuration Guide

A

variety of high availability (HA) features and technologies

Cisco IOS High Availability Command Reference

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 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, and session state monitoring.

Cisco IOS Intelligent Services Gateway Command Reference

Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model

Gateway Command Reference Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model OL-19820-15 11

OL-19820-15

11

Table 1 Cisco IOS XE Configuration Guides and Command References (continued) Configuration Guide and Command

Table 1

Cisco IOS XE Configuration Guides and Command References (continued)

Configuration Guide and Command Reference Titles

Features/Protocols/Technologies

Cisco IOS XE Interface and Hardware Component Configuration Guide

LAN interfaces, logical interfaces, serial interfaces, virtual interfaces, and interface configuration.

Cisco IOS Interface and Hardware Component Command Reference

Cisco IOS XE IP Addressing Services Configuration Guide

IP addressing, Address Resolution Protocol (ARP), Network Address Translation (NAT), Domain Name System (DNS), Dynamic Host Configuration Protocol (DHCP), and Next Hop Address Resolution Protocol (NHRP).

Cisco IOS IP Addressing Services Command Reference

Cisco IOS XE IP Application Services Configuration Guide

Enhanced Object Tracking (EOT), Gateway Load Balancing Protocol (GLBP), Hot Standby Router Protocol (HSRP), IP Services, TCP, Web Cache Communication Protocol (WCCP), User Datagram Protocol (UDP), and Virtual Router Redundancy Protocol (VRRP).

Cisco IOS IP Application Services Command Reference

Cisco IOS XE IP Multicast Configuration Guide

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).

Cisco IOS IP Multicast Command Reference

Cisco IOS XE IP Routing: BFD Configuration Guide

Bidirectional forwarding detection (BFD).

Cisco IOS XE IP Routing: BGP Configuration Guide

Border Gateway Protocol (BGP), multiprotocol BGP, multiprotocol BGP extensions for IP multicast.

Cisco IOS IP Routing: BGP Command Reference

Cisco IOS XE IP Routing: EIGRP Configuration Guide

Enhanced Interior Gateway Routing Protocol (EIGRP).

Cisco IOS IP Routing: EIGRP Command Reference

Cisco IOS XE IP Routing: ISIS Configuration Guide

Intermediate System-to-Intermediate System (IS-IS).

Cisco IOS IP Routing: ISIS Command Reference

Cisco IOS XE IP Routing: ODR Configuration Guide

On-Demand Routing (ODR).

Cisco IOS IP Routing: ODR Command Reference

Cisco IOS XE IP Routing: OSPF Configuration Guide

Open Shortest Path First (OSPF).

Cisco IOS IP Routing: OSPF Command Reference

Cisco IOS XE IP Routing: Protocol-Independent Configuration Guide

IP routing protocol-independent features and commands. Generic policy-based routing (PBR) features and commands are included.

Cisco IOS IP Routing: Protocol-Independent Command Reference

Cisco IOS XE IP Routing: RIP Configuration Guide

Routing Information Protocol (RIP).

Cisco IOS IP Routing: RIP Command Reference

Cisco IOS XE IP SLAs Configuration Guide

Cisco IOS IP Service Level Agreements (IP SLAs).

Cisco IOS IP SLAs Command Reference

Cisco IOS XE IP Switching Configuration Guide

Cisco Express Forwarding.

Cisco IOS IP Switching Command Reference

• Cisco IOS IP Switching Command Reference Cisco Unified Border Element (SP Edition) Configuration

Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model

12

OL-19820-15

Table 1 Cisco IOS XE Configuration Guides and Command References (continued) Configuration Guide and Command

Table 1

Cisco IOS XE Configuration Guides and Command References (continued)

Configuration Guide and Command Reference Titles

Features/Protocols/Technologies

Cisco IOS XE IPv6 Configuration Guide

For a list of IPv6 features, protocols, and technologies, go to the IPv6 “Start Here” document at the following URL:

Cisco IOS IPv6 Command Reference

Cisco IOS XE ISO CLNS Configuration Guide

ISO Connectionless Network Service (CLNS).

Cisco IOS ISO CLNS Command Reference

Cisco IOS XE LAN Switching Configuration Guide

VLANs and multilayer switching (MLS).

Cisco IOS LAN Switching Command Reference

Cisco IOS XE 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 Multiprotocol Label Switching Command Reference

Cisco IOS XE NetFlow Configuration Guide

Network traffic data analysis, aggregation caches, and export features.

Cisco IOS NetFlow Command Reference

Cisco IOS XE Network Management Configuration Guide

Basic system management, system monitoring and logging, Cisco IOS Scripting with Tool Control Language (Tcl), Cisco networking services (CNS), Embedded Event Manager (EEM), Embedded Syslog Manager (ESM), HTTP, Remote Monitoring (RMON), and SNMP.

Cisco IOS Network Management Command Reference

Cisco IOS XE Novell IPX Configuration Guide

Novell Internetwork Packet Exchange (IPX) protocol.

Cisco IOS Novell IPX Command Reference

Cisco IOS XE Optimized Edge Routing Configuration Guide

Optimized edge routing (OER) monitoring and automatic route optimization and load distribution for multiple connections between networks.

Cisco IOS Optimized Edge Routing Command Reference

Cisco IOS XE Performance Routing Configuration Guide

Performance Routing (PfR) provides additional intelligence to classic routing technologies to track the performance of, or verify the quality of, a path between two devices over a WAN infrastructure in order to determine the best egress or ingress path for application traffic.

Cisco IOS Performance Routing Command Reference

Cisco IOS XE Quality of Service Solutions Configuration Guide

Class-based weighted fair queueing (CBWFQ), low latency queueing (LLQ), Modular Quality of Service (QoS) Command-Line Interface (CLI) (MQC), Network-Based Application Recognition (NBAR), priority queueing, Multilink PPP (MLP) for QoS, header compression, Resource Reservation Protocol (RSVP), weighted fair queueing (WFQ), and weighted random early detection (WRED).

Cisco IOS Quality of Service Solutions Command Reference

Cisco IOS Security Command Reference

Access control lists (ACLs); authentication, authorization, and accounting (AAA); firewalls; IP security and encryption; neighbor router authentication; network access security; public key infrastructure (PKI); RADIUS; and TACACS+.

Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model

(PKI); RADIUS; and TACACS+. Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model OL-19820-15 13

OL-19820-15

13

Table 1 Cisco IOS XE Configuration Guides and Command References (continued) Configuration Guide and Command

Table 1

Cisco IOS XE Configuration Guides and Command References (continued)

Configuration Guide and Command Reference Titles

Features/Protocols/Technologies

Cisco IOS XE Security Configuration Guide: Secure Connectivity

Internet Key Exchange (IKE) for IPsec VPNs; security for VPNs with IPsec; VPN availability features (reverse route injection, IPsec preferred peer, and real-time resolution for the IPsec tunnel peer); IPsec data plane features; IPsec management plane features; Public Key Infrastructure (PKI); Dynamic Multipoint VPN (DMVPN); Easy VPN; and Cisco Group Encrypted Transport VPN (GET VPN).

Cisco IOS XE Security Configuration Guide: Securing the Control Plane

Control Plane Policing, Neighborhood Router Authentication.

Cisco IOS XE Security Configuration Guide: Securing the Data Plane

Access Control Lists (ACLs); Firewalls: Context-Based Access Control (CBAC) and Zone-Based Firewall; Cisco IOS Intrusion Prevention System (IPS); Flexible Packet Matching; Unicast Reverse Path Forwarding (uRPF); Threat Information Distribution Protocol (TIDP) and TMS.

Cisco IOS XE Security Configuration Guide: Securing User Services

AAA (includes Network Admission Control [NAC]); Security Server Protocols (RADIUS and TACACS+); Secure Shell (SSH); Secure Access for Networking Devices (includes Autosecure and Role-Based CLI access); Lawful Intercept.

Cisco IOS XE Service Advertisement Framework Configuration Guide

Cisco Service Advertisement Framework.

Cisco IOS Service Advertisement Framework Command Reference

Cisco IOS XE VPDN Configuration Guide

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, and tunnel authentication via RADIUS on tunnel terminator.

Cisco IOS VPDN Command Reference

Cisco IOS XE Wide-Area Networking Configuration Guide

Frame Relay; L2VPN Pseudowire Redundancy; and Media-Independent PPP and Multilink PPP.

Cisco IOS Wide-Area Networking Command Reference

• Cisco IOS Wide-Area Networking Command Reference Cisco Unified Border Element (SP Edition) Configuration

Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model

14

OL-19820-15

Table 1 Cisco IOS XE Configuration Guides and Command References (continued) Configuration Guide and Command

Table 1

Cisco IOS XE Configuration Guides and Command References (continued)

Configuration Guide and Command Reference Titles

Features/Protocols/Technologies

Cisco Unified Border Element (Enterprise) Configuration Guide

The Cisco Unified Border Element (Enterprise) on the Cisco ASR 1000 brings a scalable option for enterprise customers. Running as a process on the Cisco ASR 1000 and utilizing the high-speed RTP packet processing path, the Cisco Unified Border Element (Enterprise) is used as an IP-to-IP gateway by enterprises and commercial customers to interconnect SIP and H.323 voice and video networks. The Cisco UBE (Enterprise) provides a network-to-network demarcation interface for signaling interworking, media interworking, address and port translations, billing, security, quality of service (QoS), and bandwidth management.

Cisco IOS Voice Command Reference

Cisco Unified Border Element (SP Edition) Configuration Guide: Distributed Model

The Cisco Unified Border Element (SP Edition) is a session border controller (SBC) that is VoIP-enabled and deployed at the edge of networks. For Cisco IOS XE Release 2.3 and earlier releases, Cisco Unified Border Element (SP Edition) is supported only in the distributed mode. Operating in the distributed mode, the SBC is a toolkit of functions that can be used to deploy and manage VoIP services, such as signaling interworking, network hiding, security, and quality of service.

Cisco Unified Border Element (SP Edition) Command Reference: Distributed Model

Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model

The Cisco Unified Border Element (SP Edition) is a highly scalable, carrier-grade session border controller (SBC) that is designed for service providers and that is generally deployed at the border of the enterprise or SP networks to enable the easy deployment and management of VoIP services. Cisco Unified Border Element (SP Edition) is integrated into Cisco routing platforms and can use a large number of router functions to provide a very feature-rich and intelligent SBC application. Formerly known as Integrated Session Border Controller, Cisco Unified Border Element (SP Edition) provides a network-to-network demarcation interface for signaling interworking, media interworking, address and port translations, billing, security, quality of service, call admission control, and bandwidth management.

For Cisco IOS XE Release 2.4 and later releases, Cisco Unified Border Element (SP Edition) can operate in two modes or deployment models: unified and distributed. The configuration guide documents the features in the unified mode.

Cisco Unified Border Element (SP Edition) Command Reference: Unified Model

Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model

Reference: Unified Model Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model OL-19820-15 15

OL-19820-15

15

Table 2 lists documents and resources that supplement the Cisco IOS XE software configuration guides

Table 2 lists documents and resources that supplement the Cisco IOS XE software configuration guides and command references.

Table 2

Cisco IOS XE Software Supplementary Documents and Resources

Document Title or Resource

Description

Cisco IOS Master Command List, All Releases

Alphabetical list of all the commands documented in all Cisco IOS XE software releases.

Cisco IOS Debug Command Reference

Alphabetical list of debug commands including brief descriptions of use, command syntax, and usage guidelines.

Cisco IOS XE system messages

List of Cisco IOS XE system messages and descriptions. System messages may indicate problems with your system, may be informational only, or may help diagnose problems with communications lines, internal hardware, or the system software.

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 XE software releases.

MIBs

Files used for network monitoring. To locate and download MIBs for selected platforms, Cisco IOS XE software releases, and feature sets, use Cisco MIB Locator at the following URL:

RFCs

Standards documents maintained by the Internet Engineering Task Force (IETF) that Cisco IOS XE documentation references where applicable. The full text of referenced RFCs may be obtained at the following URL:

Obtaining Documentation and Submitting a Service Request

For information on obtaining documentation, submitting a service request, and gathering additional information, see the monthly What’s New in Cisco Product Documentation, which also lists all new and revised Cisco technical documentation, at:

Subscribe to the What’s New in Cisco Product Documentation as a Really Simple Syndication (RSS) feed and set content to be delivered directly to your desktop using a reader application. The RSS feeds are a free service and Cisco currently supports RSS version 2.0.

a free service and Cisco currently supports RSS version 2.0. Cisco Unified Border Element (SP Edition)

Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model

16

OL-19820-15

1 CHAPTER
1
CHAPTER

Using the Command-Line Interface in Cisco IOS XE Software

Using the Command-Line Interface in Cisco IOS XE Software This chapter provides basic information about the

This chapter provides basic information about the command-line interface (CLI) in 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 1-17

Using the CLI, page 1-18

Saving Changes to a Configuration, page 1-27

Additional Information, page 1-28

For more information about using the CLI, see “Part 1: Using the Cisco IOS Command-Line Interface (CLI)” of Cisco IOS XE Configuration Fundamentals Configuration Guide.

For information about the software documentation set, see the “About 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/go/techdocs.

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.

Changing the Default Settings for a Console or AUX Port

There are only two settings that you can change on a console port or an AUX port:

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.

example, by adding a password or changing the timeout value. Note The AUX port on the

Note

The AUX port on the Route Processor (RP) installed in a Cisco ASR 1000 series router does not serve any useful customer purpose and should be accessed only under the advisement of a customer support

representative.

under the advisement of a customer support representative. Cisco Unified Border Element (SP Edition) Configuration

Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model

support representative. Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model OL-19820-15 1-17

OL-19820-15

1-17

Using the CLI

Chapter 1

Using the Command-Line Interface in Cisco IOS XE Software

Using the CLI

This section describes the following topics:

Understanding Command Modes, page 1-18

Using the Interactive Help Feature, page 1-21

Understanding Command Syntax, page 1-22

Understanding Enable and Enable Secret Passwords, page 1-23

Using the Command History Feature, page 1-24

Abbreviating Commands, page 1-25

Using Aliases for CLI Commands, page 1-25

Using the no and default Forms of Commands, page 1-26

Using the debug Command, page 1-26

Filtering Output Using Output Modifiers, page 1-26

Understanding CLI Error Messages, page 1-27

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-1 lists common command modes with associated CLI prompts, access and exit methods, and a brief description of how each mode is used.

Table 1-1

CLI Command Modes

Command

       

Mode

Access Method

Prompt

Exit Method

Mode Usage

User EXEC

Log in.

Router>

Issue the logout or exit command.

Change terminal settings.

Perform basic tests.

 

Display device status.

Privileged

From user EXEC mode, issue the enable command.

Router#

Issue the disable command or the exit command to return to user EXEC mode.

Issue show and debug commands.

EXEC

Copy images to the device.

   

Reload the device.

Manage device

configuration files.

Manage device file systems.

Global

From privileged EXEC mode, issue the configure terminal command.

Router(config)#

Issue the exit command or the end command to return to privileged EXEC mode.

Configure the device.

configuration

EXEC mode. Configure the device. configuration Cisco Unified Border Element (SP Edition) Configuration

Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model

1-18

OL-19820-15

Chapter 1

Using the Command-Line Interface in Cisco IOS XE Software

Using the CLI

Table 1-1

CLI Command Modes (continued)

Command

       

Mode

Access Method

Prompt

Exit Method

Mode Usage

Interface

From global configuration mode, issue the interface command.

Router(config-if)#

Issue the exit command to return to global configuration mode or the end command to return to privileged EXEC mode.

 

configuration

Configure individual interfaces.

Line

From global configuration mode, issue the line vty or line console command.

Router(config-line)#

Issue the exit command to return to global configuration mode or the end command to return to privileged EXEC mode.

 

configuration

Configure individual terminal lines.

Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model

individual terminal lines. Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model OL-19820-15 1-19

OL-19820-15

1-19

Using the CLI

Chapter 1

Using the Command-Line Interface in Cisco IOS XE Software

Table 1-1

CLI Command Modes (continued)

Command

       

Mode

Access Method

Prompt

Exit Method

Mode Usage

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 # >

 

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.

The # symbol represents the line number and increments at each prompt.

Issue the continue command.

 

Perform password recovery when a CTRL-Break sequence is issued within 60 seconds of a power-on or reload event.

Diagnostic

The router boots or enters diagnostic mode in the following scenarios. When a

Router(diag)#

If a Cisco IOS XE process failure is the reason for entering diagnostic mode, the

Inspect various states on the router, including the Cisco IOS XE state.

Replace or roll back the configuration.

Cisco IOS XE process or processes fail, in most scenarios the router will reload.

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.

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 use a method that is configured to connect to the Cisco IOS XE 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.

Provide methods of restarting the Cisco IOS XE software or other processes.

Reboot hardware, such as the entire router, an RP, an ESP, a SIP, a SPA, or other hardware components.

Transfer files into or off of the router using remote access methods such as FTP, TFTP, and SCP.

using remote access methods such as FTP, TFTP, and SCP. Cisco Unified Border Element (SP Edition)

Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model

1-20

OL-19820-15

Chapter 1

Using the Command-Line Interface in 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

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

.

.

.

rommon 2 >

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#

Router(config-line)# exit Router(config)# end Router# Note A keyboard alternative to the end command is Ctrl-Z.

Note

A keyboard alternative to the end command is Ctrl-Z.

Note A keyboard alternative to the end command is Ctrl-Z. Using the Interactive Help Feature The

Using the Interactive Help Feature

The CLI includes an interactive Help feature. Table 1-2 describes how to use the Help feature.

Table 1-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).

Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model

and the question mark). Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model OL-19820-15 1-21

OL-19820-15

1-21

Using the CLI

Chapter 1

Using the Command-Line Interface in Cisco IOS XE Software

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

Create a temporary access-List entry

access-profile

Apply user-profile to interface

access-template

Create a temporary access-List entry

alps

ALPS exec commands

archive

manage archive files

<snip>

partial command?

Router(config)# zo? zone zone-pair

partial command<Tab>

Router(config)# we<Tab> webvpn

command ?

Router(config-if)# pppoe ?

enable

max-sessions Maximum PPPOE sessions

Enable pppoe

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 1-3 describes these conventions.

command elements. Table 1-3 describes these conventions. Cisco Unified Border Element (SP Edition) Configuration

Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model

1-22

OL-19820-15

Chapter 1

Using the Command-Line Interface in Cisco IOS XE Software

Using the CLI

Table 1-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

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:

Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model

global configuration mode: Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model OL-19820-15 1-23

OL-19820-15

1-23

Using the CLI

Chapter 1

Using the Command-Line Interface in Cisco IOS XE Software

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.

spaces ar e ignored, but trailing spaces are recognized. Note Both password commands have numeric keywords

Note

ar e ignored, but trailing spaces are recognized. Note Both password commands have numeric keywords that

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.

were the numeric keyword and not as part of your password. When both passwords are set,

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 the following:

Using the Command History Feature

The command history feature saves the commands that 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:

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.

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.

key sequence to recall successively more recent commands. Note The arrow keys function only on ANSI-compatible

Note

The arrow keys function only on ANSI-compatible terminals such as the VT100.

only on ANSI-compatible terminals such as the VT100. Cisco Unified Border Element (SP Edition) Configuration
only on ANSI-compatible terminals such as the VT100. Cisco Unified Border Element (SP Edition) Configuration

Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model

1-24

OL-19820-15

Chapter 1

Using the Command-Line Interface in Cisco IOS XE Software

Using the CLI

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 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.

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 1-4 shows the default command aliases.

Table 1-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

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.

Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model

. Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model OL-19820-15 1-25

OL-19820-15

1-25

Using the CLI

Chapter 1

Using the Command-Line Interface in Cisco IOS XE Software

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 to 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. To see what default commands are available on your system, enter default ? in the appropriate command mode of the command-line interface.

The no form is documented in the command pages of Cisco IOS command references. The default form is generally documented in the command pages only when the default form performs a function different than that of the plain and no forms of the command.

Command pages often include a “Command Default” section as well. The “Command Default” section documents the state of the configuration if the command is not used (for configuration commands) or the outcome of using the command if none of the optional keywords or arguments is specified (for EXEC commands).

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 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
. Caution Debugging is a high priority and high CPU

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.

affect network performance or user access or response times. Filtering Output Using Output Modifiers Many commands

Filtering Output Using Output Modifiers

Many commands produce lengthy output that may use several screens to display. You can use output modifiers to filter this output to show only the information that you want to see.

The following three output modifiers are available:

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.

lines in which a match of the regular expression is found. Cisco Unified Border Element (SP

Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model

1-26

OL-19820-15

Chapter 1

Using the Command-Line Interface in Cisco IOS XE Software

Saving Changes to a Configuration

exclude regular-expression—Displays all lines except those in which a match of the regular expression is found.

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 1-5 shows the common CLI error messages.

Table 1-5

Common CLI Error Messages

Error Message

Meaning

How to Get Help

%

Ambiguous command:

You did not enter enough characters for the command to be recognized.

Reenter the command followed by a space and a question mark (?). The keywords that you are allowed to enter for the command appear.

“show con”

% Incomplete command.

You did not enter all the keywords or values required by the command.

Reenter the command followed by a space and a question mark (?). The keywords that you are allowed to enter for the command appear.

% Invalid input detected at “^”

You entered the command incorrectly. The caret (^) marks the point of the error.

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.

marker.

For more system error messages, see Cisco IOS XE System Messages.

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.

Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model

turned off or interrupted. Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model OL-19820-15 1-27

OL-19820-15

1-27

Additional Information

Chapter 1

Using the Command-Line Interface in Cisco IOS XE Software

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

“Part 1: Using the Cisco IOS Command-Line Interface (CLI)” of the Cisco IOS XE Configuration Fundamentals Configuration Guide

or

“Using Cisco IOS XE Software” chapter of the Cisco ASR 1000 Series Aggregation Services Routers Software Configuration Guide

Cisco Product Support Resources

Support area on Cisco.com (also search for documentation by task or product)

Software Download Center (downloads; tools; licensing, registration, advisory, and general information) (requires Cisco.com user ID and password)

Error Message Decoder, a tool to help you research and resolve error messages for Cisco IOS XE software

Command Lookup Tool, a tool to help you find detailed descriptions of Cisco IOS XE commands (choose Select an index: IOS > Select a release: All IOS Commands) (requires Cisco.com user ID and password)

Output Interpreter, a troubleshooting tool that analyzes command output of supported show commands

Cisco Unified Border Element (SP Edition) Configuration

Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model

1-28

OL-19820-15

2 CHAPTER
2
CHAPTER

Cisco Unified Border Element (SP Edition) Overview

CHAPTER Cisco Unified Border Element (SP Edition) Overview This chapter presents an overview of Cisco Unified

This chapter presents an overview of Cisco Unified Border Element (SP Edition) on the Cisco ASR 1000 Series Aggregation Services Routers—its signaling and media functions, unified and distributed deployment models, supported features, and supported MIBs.

Cisco Unified Border Element (SP Edition) was formerly known as Integrated Session Border Controller and may be commonly referred to in this document as the session border controller (SBC).

Contents

Cisco Unified Border Element (SP Edition) on the Cisco ASR 1000 Series Routers, page 2-1

Cisco Unified Border Element (SP Edition) on the Cisco ASR 1001 Series Routers, page 2-5

Supported MIBs, page 2-5

Cisco Unified Border Element (SP Edition) on the Cisco ASR 1000 Series Routers

Cisco Unified Border Element (SP Edition) enables direct IP-to-IP interconnect between multiple administrative domains for session-based services providing protocol interworking, security, and admission control and management. Cisco Unified Border Element (SP Edition) is a voice over IP (VoIP) device that sits on the border of a network and controls call admission to that network.

Cisco Unified Border Element (SP Edition) protects the interior of the network from excessive call load and malicious traffic. Cisco Unified Border Element (SP Edition) provides additional functions such as media bridging and billing services.

Cisco Unified Border Element (SP Edition) is integrated into the Cisco IOS Software and does not require any additional hardware to run.

The SBC service includes two functional areas:

Signaling SBC function—Managed by the signaling border element (SBE), controls access of VoIP signaling messages to the core of the network, and manipulates the contents of these messages. It does this by acting as a Session Initiation Protocol (SIP) back-to-back user agent (B2BUA).

Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model

user agent (B2BUA). Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model OL-19820-15 2-1

OL-19820-15

2-1

Cisco Unified Border Element (SP Edition) on the Cisco ASR 1000 Series Routers

Chapter 2

Cisco Unified Border Element (SP Edition) Overview

Media SBC function—Managed by the data border element (DBE), controls access of media packets to the network, provides differentiated services and quality of service (QoS) for different media streams, and prevents service theft. It does this by acting as a real-time transport protocol (RTP) proxy.

For Cisco IOS XE Release 2.4, Cisco Unified Border Element (SP Edition) can operate in two modes or deployment models:

Unified—In the unified model, both the SBE and DBE logical entities co-exist on the same network element. In this model, the signaling entity controls the media local to the router. Simply put, the SBE handles the SIP and H.323 packets and the DBE handles the RTP and RTCP packets.

Distributed—In the distributed model, the SBE and the DBE entities reside on two different network elements. Logically, each of the SBE entities controls multiple DBE elements, and each DBE could be controlled by multiple SBE entities. The SBE interacts with the DBE entities using a session controller interface (SCI). The SCI interface supports the H.248 protocol.

In this model, the bearer always flows through the DBE, and the SBE participates only in the signaling flow. This model is typically used in conjunction with a third-party SBE that supports the DBE H.248 profile.

with a third-party SBE that supports the DBE H.248 profile. Note It is important to note
with a third-party SBE that supports the DBE H.248 profile. Note It is important to note

Note

a third-party SBE that supports the DBE H.248 profile. Note It is important to note that

It is important to note that the DBE configuration is still required when running in the unified model

because the DBE configuration provides the information necessary for the RTP media to flow.

Note

For Cisco IOS XE Release 2.3 and earlier, the SBC supports only DBEs in the distributed model.

the SBC supports only DBEs in the distributed model. Cisco Unified Border Element (SP Edition) Configuration
the SBC supports only DBEs in the distributed model. Cisco Unified Border Element (SP Edition) Configuration

Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model

2-2

OL-19820-15

Chapter 2

Cisco Unified Border Element (SP Edition) Overview

Cisco Unified Border Element (SP Edition) on the Cisco ASR 1000 Series Routers

Figure 2-1 illustrates the unified mode. Figure 2-2 illustrates the relationships between SBEs, DBEs, and other network elements.

Figure 2-1 Relationships Between SBEs/DBEs and Other Network Elements in the Unified Model UM V
Figure 2-1
Relationships Between SBEs/DBEs and Other Network Elements in the Unified
Model
UM
V
SBE/
DBE
V UM
UM
V
Signaling
Media
PSTN
280718

Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model

Media PSTN 280718 Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model OL-19820-15 2-3

OL-19820-15

2-3

Cisco Unified Border Element (SP Edition) on the Cisco ASR 1000 Series Routers

Chapter 2

Cisco Unified Border Element (SP Edition) Overview

Figure 2-2

Relationships Between SBEs/DBEs and Other Network Elements in the Distributed Model

DBE location 1 V V Adjacency 1 Adjacency 2 V DBE SBE location 2 Adjacency
DBE
location 1
V
V
Adjacency 1
Adjacency 2
V
DBE
SBE
location 2
Adjacency 3
V
DBE
location 3
V
V
Softswitch
Signaling
Media
PSTN
In this diagram, adjacencies 1, 2, and 3 have been
associated with the respective DBE locations. The first
(double line) call comes in over adjacency 1 and is
routed over adjacency 3. The second (single line) call
comes over adjacency 2 and is routed over adjacency 3.
The SBE picks a DBE from the appropriate location to
process the call media.
149593
the appropriate location to process the call media. 149593 Cisco Unified Border Element (SP Edition) Configuration

Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model

2-4

OL-19820-15

Chapter 2

Cisco Unified Border Element (SP Edition) Overview

Cisco Unified Border Element (SP Edition) on the Cisco ASR 1001 Series Routers

Cisco Unified Border Element (SP Edition) on the Cisco ASR 1001 Series Routers

Table 2-1 list the scaling and performance that is supported on the Cisco ASR 1001 Series Routers.

Table 2-1

Scaling and Performance Supported on Cisco ASR 1001 Series Routers

     

QFP

Degradation

Reasons for

     

Platform

HT=180

RP CPU

CPU

CPS %

Congestion

Memory Setup

Throughput Value

Feature

ASR 1001 1 RU

CPS=60

33%

40%

NA

Memory

Default

5000K

NA

ASR 1001 1 RU

CPS=57

66%

78%

NA

Memory

Default

2500L

NA

Supported MIBs

The following MIBs are supported Cisco IOS XE Release 2.4 and later for the SBC on the Cisco ASR 1000 Series Router:

CISCO-SESSION-BORDER-CONTROLLER-EVENT-MIB

CISCO-SESSION-BORDER-CONTROLLER-CALL-STATS-MIB

For more information about MIB support on a Cisco ASR 1000 Series Routers, refer to the Cisco ASR 1000 Series Aggregation Services Routers MIB Specifications Guide at:

To locate and download MIBs for selected platforms, Cisco IOS releases, and feature sets, use Cisco MIB Locator found at:

If Cisco MIB Locator does not support the MIB information that you need, you can also obtain a list of supported MIBs and download MIBs from the Cisco MIBs page at:

To access Cisco MIB Locator, you must have an account on Cisco.com. If you have forgotten or lost your account information, send a blank e-mail to cco-locksmith@cisco.com. An automatic check will verify that your e-mail address is registered with Cisco.com. If the check is successful, account details with a new random password will be e-mailed to you.

Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model

will be e-mailed to you. Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model OL-19820-15

OL-19820-15

2-5

Supported MIBs

Chapter 2

Cisco Unified Border Element (SP Edition) Overview

2 Cisco Unified Bord er Element (SP Edition) Overview Cisco Unified Border Element (SP Edition) Configuration

Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model

2-6

OL-19820-15

3 CHAPTER
3
CHAPTER

Configuring Cisco Unified Border Element (SP Edition)

Configuring Cisco Unified Border Element (SP Edition) This chapter describes how to configure the data border

This chapter describes how to configure the data border element (DBE) and signaling border element (SBE) for Cisco Unified Border Element (SP Edition).

Note that the DBE configuration is still required when running in the unified model because the DBE configuration provides the information necessary for the RTP media to flow.

Cisco Unified Border Element (SP Edition) was formerly known as Integrated Session Border Controller and may be commonly referred to in this document as the session border controller (SBC).

For a complete description of the commands used in this chapter, refer to the Cisco Unified Border Element (SP Edition) Command Reference: Unified Model at:

For information about all Cisco IOS commands, use the Command Lookup Tool at http://tools.cisco.com/Support/CLILookup or a Cisco IOS master commands list.

Configuring Unified Model

This section contains the following information on configuring the unified model:

Configuring SBE in the Unified Model, page 3-1

Memory Alerting, page 3-10

Configuring Memory Alerting, page 3-11

Configuring DBE in the Unified Model, page 3-12

Image Upgrade Procedure for Cisco Unified Border Element (SP Edition), page 3-14

Configuring SBE in the Unified Model

This section describes how to configure a SBE on a Cisco ASR 1000 Series Routers:

Prerequisites

In the unified mode, you must configure the SBE before the DBE.

Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model

the SBE before the DBE. Cisco Unified Border Element (SP Edition) Configuration Guide: Unified Model OL-19820-15

OL-19820-15

3-1

Configuring Unified Model

Chapter 3

Configuring Cisco Unified Border Element (SP Edition)

You need to configure blacklisting to override default blacklisting thresholds when the SBE is configured and before you start using Cisco Unified Border Element (SP Edition). See the Dynamic Blacklisting Behavior, page 12-5 for configuration information.

When running Cisco Unified Border Element (SP Edition) with 500 or more active calls, configure the huge buffer size to 65535 bytes with the buffer huge size 65535 command. The increased buffer size is required because by default Cisco IOS software sets the “huge” buffer size to be 18084 bytes, which is not large enough for audit responses when there are more than 500 active calls.

Configuration Tip

We strongly recommend you use different addresses for signaling and media addresses to avoid scenarios where reservation for media port range can prevent call signaling packets from reaching the route processor (RP). In this scenario, if the SBC attempts to receive a call using a port that has been reserved by the SBC for media, packets will be dropped, rather than forwarded to the RP. This type of scenario is more likely to occur for H.323 and SIP calls using TCP transport.

SUMMARY STEPS

1. configure

2. sbc sbc-name

3. sbe

4. adjacency sip adjacency-name

5. signaling-address ipv4 ipv4_IP_address

6. signaling-port port_num

7. remote-address ipv4 ip-address ip-mask

8. signaling-peer peer_name

9. signaling-peer-port port_num

10. attach

11. exit

12. adjacency sip adjacency-name

13. signaling-address ipv4 ipv4_IP_address

14. signaling-port port_num

15. remote-address ipv4 ip-address ip-mask

16. signaling-peer peer_name

17. signaling-peer-port port_num

18. attach

19. call-policy-set policy-set-id

20.