|
|
Table Of Contents
Configuring H.323 VoIP Gateway for Cisco Access Platforms
H.323 VoIP Gateway Feature Summary
Additional Keyword for the Session Target Command
Configure Voice Port Parameters
Configure POTS and VoIP Dial Peers
Enable VoIP Gateway Functionality
Configure Gateway Interface Parameters
RADIUS Accounting with Overloaded Session ID
Interactive Voice Response (IVR)
Dial Peer Configuration Restrictions for ISDNRedirect
ISDNRedirect Call Flow Example
aaa authentication login h323 radius
aaa accounting connection h323
Configuring H.323 VoIP Gateway for Cisco Access Platforms
Feature History
H.323 VoIP Gateway Feature Summary
The Cisco AS5300 voice service provider features include enhancements made to the functionality and configuration of both the gateway and the Voice over IP (VoIP) gatekeeper. The architecture of these features provides the Quality of Service (QoS), stability, and functionality necessary for carrier class, real-time IP communications services.
This document contains a basic description of the H.323 VoIP gateway in addition to features required to implement the applications to run VoIP in a service provider environment. The features address the service provider needs to offer security, billing, scaling, and reliability.
The Cisco AS5300 VoIP gateway is a high performance H.323-compliant gateway optimized for VoIP applications. Supporting up to two T1/E1 digital channels, it connects with existing telephones and fax machines through the Public Switched Telephone Network (PSTN), key systems, and PBXs, making the process of placing calls over the IP network transparent to users.
The gateway capability allows the Cisco AS5300 to function as an H.323 endpoint. Therefore, the gateway provides admission control, address lookup and translation, and accounting services.
Benefits
•
Carrier-class voice quality
•
•
•
•
List of Terms
AAA—Authentication, Authorization, and Accounting. AAA is a suite of network security services which provides the primary framework through which access control can be set up on your Cisco router or access server.
ANI—Automatic number identification.
ARQ—Admission request.
CAS—Channel associated signaling.
CCAPI—Call control applications programming interface.
CLI—Command line interface.
CO—Central office.
CPE—Customer premises equipment. Terminating equipment, such as terminals, telephones, and modems, supplied by the telephone company, installed at the customer sites, and connected to the telephone company network.
CSM—Call switching module.
dial peer—An addressable call endpoint. In Voice over IP (V0IP), there are two types of dial peers: POTS and VoIP.
DNS—Domain name system used to address translation to convert H.323 IDs, URLs, or e-mail IDs to IP addresses. DNS is also used to assist in the location of remote gatekeepers and to reverse-map raw IP addresses to host names of administrative domains.
DNIS—Dialed number identification service (the called number).
DSP—Digital signal processor.
DTMF—Dual tone multi-frequency.
E.164—The international public telecommunications numbering plan. A standard set by ITU-T which addresses telephone numbers.
E&M—Ear and mouth RBS signaling.
endpoint—A H.323 terminal or gateway. An endpoint can call and be called. It generates and/or terminates the information stream.
gatekeeper—A gatekeeper maintains a registry of devices in the multimedia network. The devices register with the gatekeeper at startup, and request admission to a call from the gatekeeper.
The gatekeeper is a H.323 entity on the LAN that provides address translation and control access to the LAN for H.323 terminals and gateways. The gatekeeper may provide other services to the H.323 terminals and gateways, such as bandwidth management and locating gateways.
gateway—A gateway allows H.323 terminals to communicate with non-H.323 terminals by converting protocols. A gateway is the point at which a circuit-switched call is encoded and repackaged into IP packets.
A H.323 gateway is an endpoint on the LAN that provides real-time, two-way communications between H.323 terminals on the LAN and other ITU-T terminals in the WAN, or to another H.323 gateway.
H.323—An International Telecommunication Union (ITU-T) standard that describes packet-based video, audio, and data conferencing. H.323 is an umbrella standard that describes the architecture of the conferencing system, and refers to a set of other standards (H.245, H.225.0, and Q.931) to describe its actual protocol.
H.323 RAS—Registration, admission, and status. The RAS signaling function performs registration, admissions, bandwidth changes, status and disengage procedures between the VoIP gateway and the gatekeeper.
HSRP—Hot Standby Routing Protocol. HSRP is a Cisco-proprietary protocol which provides a redundancy mechanism when more than one router is connected to the same segment/subnet of an Ethernet/FDDI/Token Ring network.
IVR—Integrated voice response. When someone dials in, it responds with a prompt to get a personal identification number (PIN), and so on.
LEC—Local exchange carrier.
LRQ—Location request.
MCU—Multipoint control unit
MF—Multi-frequency tones are made of six frequencies that provide 15 two frequency combinations for indication digits 0-9 and KP/ST signals.
multicast—A process of transmitting PDUs from one source to many destinations. The actual mechanism (that is, IP multicast, multi-unicast, and so forth) for this process might be different for LAN technologies.
multipoint-unicast—A process of transferring PDUs (Protocol Data Units) where an endpoint sends more than one copy of a media stream to different endpoints. This might be necessary in networks which do not support multicast.
node—A H.323 entity that uses RAS to communicate with the gatekeeper. For example, an endpoint such as a terminal, proxy, or gateway.
PDU—Protocol data units used by bridges to transfer connectivity information.
POTS—Plain old telephone service. Basic telephone service supplying standard single line telephones, telephone lines, and access to the PSTN.
PSTN—Public switched telephone network. PSTN refers to the local telephone company.
QoS—Quality of service, which refers to the measure of service quality provided to the user.
RAS—Registration, admission, and status protocol. This is the protocol that is used between endpoints and the gatekeeper to perform management functions.
RBS—Robbed bit signaling.
RRQ—Registration request.
SPI—Service provider interface.
TCL—Tool command language.
TDM—Time division multiplexing. Technique in which information from multiple channels can be allocated bandwidth on a single wire based on preassigned time slots. Bandwidth is allocated to each channel regardless of whether the station has data to transmit.
VoIP—Voice over IP. The ability to carry normal telephone-style voice over an IP-based internet with POTS-like functionality, reliability, and voice quality. VoIP is a blanket term which generally refers to Cisco's standards based (for example, H.323) approach to IP voice traffic.
VTSP—Voice telephony service provider.
zone—A collection of all terminals (tx), gateways (GW), and Multipoint Control Units (MCU) managed by a single gatekeeper (GK). A zone includes at least one terminal, and can include gateways or multipoint control units (MCUs). A zone has only one gatekeeper. A zone may be independent of LAN topology and can be comprised of multiple LAN segments which are connected using routes or other devices.
Note
Restrictions
•
•
•
•
Platforms
This feature is supported on the following platforms:
•
•
•
•
Determining Platform Support Through Cisco Feature Navigator
Cisco IOS software is packaged in feature sets that support specific platforms. To get updated information regarding platform support for this feature, access Cisco Feature Navigator. Cisco Feature Navigator dynamically updates the list of supported platforms as new platform support is added for the feature.
Cisco Feature Navigator is a web-based tool that enables you to determine which Cisco IOS software images support a specific set of features and which features are supported in a specific Cisco IOS image. You can search by feature or release. Under the release section, you can compare releases side by side to display both the features unique to each software release and the features in common.
To access Cisco Feature Navigator, 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. Qualified users can establish an account on Cisco.com by following the directions at http://www.cisco.com/register.
Cisco Feature Navigator is updated regularly when major Cisco IOS software releases and technology releases occur. For the most current information, go to the Cisco Feature Navigator home page at the following URL:
Availability of Cisco IOS Software Images
Platform support for particular Cisco IOS software releases is dependent on the availability of the software images for those platforms. Software images for some platforms may be deferred, delayed, or changed without prior notice. For updated information about platform support and availability of software images for each Cisco IOS software release, refer to the online release notes or, if supported, Cisco Feature Navigator.
Perquisites
Before you can configure your platform to serve as an H.323 VoIP gateway, you must first:
•
•
•
Supported MIBS and RFCs
The SNMP MIBS are available on CCO. The CISCO-VOICE-DIAL-CONTROL-MIB supports the QoV and QoS of VoIP calls. Refer to the online support reference listed at the following location:
•
•
•
•
•
•
•
•
Functional Description
The functionality of the H.323 VoIP gateway is dependent on the interaction of the following features:
•
•
Note
Gateway RAS Implementation
The Registration, Admission, and Status (RAS) signaling function performs registration, admissions, status, and disengage procedures between the H.323 VoIP gateway and the H.323 VoIP gatekeeper.
The following additions have been made to basic gateway functionality to implement RAS:
•
•
Note
http://www.cisco.com/univercd/cc/td/doc/product/access/acs_serv/5300/5300swbk/index.htmTwo new fields have been added to the dial-peer entry. The gateway relies on Cisco IOS command line interface commands, outside of gateway configuration mode, to configure handling of the AAA servers.
The following additions have been made to basic gateway functionality to implement RAS:
Technology Prefixes
Technology prefixes are used to distinguish between gateways having specific capabilities within a given zone. In the exchange between the gateway and the gatekeeper, the technology prefix is used to select a gateway after the zone has been selected. You use the tech-prefix dial-peer configuration command to define technology prefixes.
In most cases, there is a dynamic protocol exchange between the gateway and the gatekeeper that enables the gateway to inform the gatekeeper about technology prefixes and where to forward calls. If, for some reason, that dynamic registry feature is not in effect, you can statically configure the gatekeeper to query the gateway for this information by configuring the gw-type-prefix command on the gatekeeper. Use the show gatekeeper gw-type-prefix to display how the gatekeeper has mapped the technology prefixes to local gateways.
For more information about configuring H.323 gatekeepers, refer to Cisco IOS Release 11.3(6) 2 Configuring H.323 VoIP Gatekeeper for Cisco Access Platforms.
Additional Keyword for the Session Target Command
The session target dial-peer command indicates the address of the remote gateway where the call is terminated. A new keyword has been added to the session target command to indicate that the RAS protocol is being used—meaning that a gatekeeper will be consulted to translate the E164 address to an IP address.
You can now define the address of a remote gateway in the following ways:
•
•
•
For more information about this revised command, refer to the AAA Accounting section.
Configuration Task List
To configure a Cisco 3600 or Cisco 2600 series router to perform as an H.323 VoIP gateway using RAS, perform the following tasks:
•
Configure Voice Port Parameters
To configure voice port parameters for an E&M voice port, use the following commands:
For more information about configuring voice ports, refer to the "Configuring Voice Ports" chapter in the Cisco IOS Release 12.0 Voice, Video, and Home Applications Configuration Guide.
Verify Voice Port Parameters
To verify voice port parameters, use the show voice port command.
The following is sample output from the show voice port command for an E&M voice port on the Cisco 3600 series:
router#show voice port 1/0/0E&M Slot is 1, Sub-unit is 0, Port is 0Type of VoicePort is E&MOperation State is UPAdministrative State is UP<--snip-->Voice card specific Info Follows:Signal Type is wink-startOperation Type is 4-wireImpedance is set to 600r OhmE&M Type is 5Dial Type is dtmf<--snip-->For more information about the show voice port command, refer to the Cisco IOS Release 12.0 Voice, Video, and Home Applications Command Reference.
Configure the H.323 Gateway
To configure the H.323 Gateway, you need to perform the tasks:
•
•
•
Configure POTS and VoIP Dial Peers
The first step in configuring the H.323 gateway is to define the applicable POTS and VoIP dial peers. The POTS dial peer informs the system which voice port to direct incoming VoIP calls to and (optionally) defines that RAS-initiated calls will have a technology prefix prepended to the destination telephone number. The VoIP dial peer defines how to direct calls that originate from a local voice port into the VoIP cloud to the session target. The session target indicates the address of the remote gateway where the call is terminated. As mentioned, there are several different ways to define the destination gateway address: by statically configuring the IP address of the gateway, by defining the DNS of the gateway, or by using RAS. If you use RAS, that gateway determines the destination target by querying the RAS gatekeeper.
To configure POTS dial peer for the H.323 gateway, use the following commands:
For more information about POTS dial peers, refer to the Cisco IOS Release 12.0 Voice, Video, and Home Applications Configuration Guide. For more information about any of the commands used to configure VoIP dial peers, refer to the Cisco IOS Release 12.0 Voice, Video, and Home Applications Command Reference.
To configure VoIP dial peer for the H.323 gateway, use the following commands:
For more information about POTS dial peers, refer to the Cisco IOS Release 12.0 Voice, Video, and Home Applications Configuration Guide. For more information about any of the commands used to configure POTS dial peers, refer to the Cisco IOS Release 12.0 Voice, Video, and Home Applications Command Reference.
Verify Dial Peer Configuration
Verify the POTS and VoIP dial peer configuration by using the show dial-peer voice command.
The following example shows output from the show dial-peer voice command for a VoIP dial peer using RAS:
5300-1# show dial-peer voice 1234VoiceOverIpPeer1234tag = 1234, destination-pattern = 1234',answer-address = ',group = 1234, Admin state is up, Operation state is up,incoming called-number = ', connections/maximum = 0/unlimited,application associated:type = voip, session-target = ras',technology prefix: 8#ip precedence = 0, UDP checksum = disabled,session-protocol = cisco, req-qos = controlled-load,acc-qos = best-effort,fax-rate = voice, codec = g729r8,Expect factor = 10, Icpif = 30,VAD = enabled, Poor QOV Trap = disabled,<--snip-->Enable VoIP Gateway Functionality
The next step in configuring an H.323 gateway is to enable VoIP gateway functionality. You do this by using the gateway command.
To enable gateway functionality, use the following commands:
1
configure terminal
Enter global configuration mode.
2
gateway
Enable the VoIP Gateway.
Configure Gateway Interface Parameters
The next step in configuring an H.323 gateway is configure the gateway interface parameters. You do this by first defining which interface will be presented to the VoIP network as this gateway's H.323 interface. Only one interface is allowed to be the gateway interface. You can select either the interface that is connected to the gatekeeper or a loopback interface. The interface that is connected to the gatekeeper is usually a LAN interface (for example, Fast Ethernet, Ethernet, FDDI, or Token-Ring).
After you define the gateway interface, you configure the gateway to discover the gatekeeper either through multicasting or by directing it to a specific host. Finally, you configure the gateway's H.323 identification number and any technology prefixes that this gateway should register with the gatekeeper.
To define the interface to be used as the H.323 gateway interface and configure the H.323 gateway interface parameters, use the following commands, beginning in global configuration mode:
Verify the Gateway Interface Configuration
•
In the following example, gateway GW13.cisco.com has successfully registered itself with gatekeeper GK15.cisco.com:
3640GW.13#show gatewayGateway GW13.cisco.com is registered to Gatekeeper GK15.cisco.com•
In the following example gatekeeper 'GK15.cisco.com' has four tech-prefixes. Prefix 31# is statically defined on the gatekeeper, while 23#, 22#, and 13# have been dynamically registered by gateways.
3640GK.15#show gatekeeper gw-type-prefixGATEWAY TYPE PREFIX TABLE=========================Prefix:31#*Statically-configured gateways (not necessarily currently registered):1.9.53.13:1720Zone:GK15.cisco.com Registered gateways for this prefix:1.9.53.13:1720 GW13Prefix:23#*Zone:GK15.cisco.com Registered gateways for this prefix:1.9.74.23:1720 GW23-c2611Prefix:22#*Zone:GK15.cisco.com Registered gateways for this prefix:1.9.74.22:1720 GW22-c2611Prefix:13#*Zone:GK15.cisco.com Registered gateways for this prefix:1.9.53.13:1720 GW13Tips
•
In the following example, gateway GW13.cisco.com sends a RAS registration request message (RRQ) to gatekeeper GK15.cisco.com at IP address 1.9.53.15. GW13.cisco.com then receives a registration confirmation (RCF) message from the gatekeeper. If there is no response, it could mean that the gatekeeper is offline or improperly addressed. If you receive a reject message (RRJ), it could mean that the gatekeeper is unable to handle another gateway or that the registration information is incorrect.
3640GW.13#debug ras*Mar 13 19:53:34.231: RASlib::ras_sendto:msg length 105 from1.9.53.13:8658 to 1.9.53.15:1719*Mar 13 19:53:34.231: RASLib::RASSendRRQ:RRQ (seq# 36939) sentto 1.9.53.15*Mar 13 19:53:34.247: RASLib::RASRecvData:successfully rcvdmessage of length 105 from 1.9.53.15:1719*Mar 13 19:53:34.251: RASLib::RASRecvData:RCF (seq# 36939) rcvdfrom [1.9.53.15:1719] on sock [0x6168356C•
In the following example, the debug h225 asn1 command displays the actual contents of the RAS registration message exchange between gateway GW13.cisco.com and gatekeeper GK15.cisco.com. The debug h225 asn1 command also displays the tech-prefixes that gateway GW13.cisco.com is registering:
3640GW.13#debug h225 asn1H.225 ASN1 Messages debugging is on3640GW.13#value RasMessage ::= registrationRequest :*Mar 13 20:16:45.295: {*Mar 13 20:16:45.295: requestSeqNum 037001,*Mar 13 20:16:45.295: protocolIdentifier { 0 0 8 2250 0 1 },*Mar 13 20:16:45.295: discoveryComplete TRUE,*Mar 13 20:16:45.295: callSignalAddress*Mar 13 20:16:45.295: {*Mar 13 20:16:45.295: ipAddress :*Mar 13 20:16:45.295: {*Mar 13 20:16:45.295: ip '0109350D'H,*Mar 13 20:16:45.295: port 01720*Mar 13 20:16:45.295: }*Mar 13 20:16:45.295: },*Mar 13 20:16:45.295: rasAddress*Mar 13 20:16:45.295: {*Mar 13 20:16:45.295: ipAddress :*Mar 13 20:16:45.295: {*Mar 13 20:16:45.295: ip '0109350D'H,*Mar 13 20:16:45.299: port 04635*Mar 13 20:16:45.299: }*Mar 13 20:16:45.299: },*Mar 13 20:16:45.299: terminalType*Mar 13 20:16:45.299: {*Mar 13 20:16:45.299: gateway*Mar 13 20:16:45.299: {*Mar 13 20:16:45.299: protocol*Mar 13 20:16:45.299: {*Mar 13 20:16:45.299: voice :*Mar 13 20:16:45.299: {*Mar 13 20:16:45.299: supportedPrefixes*Mar 13 20:16:45.299: {*Mar 13 20:16:45.299: {*Mar 13 20:16:45.299: prefix e164 :"13#"*Mar 13 20:16:45.299: }*Mar 13 20:16:45.299: }*Mar 13 20:16:45.299: }*Mar 13 20:16:45.299: }*Mar 13 20:16:45.299: },*Mar 13 20:16:45.299: mc FALSE,*Mar 13 20:16:45.299: undefinedNode FALSE*Mar 13 20:16:45.299: },*Mar 13 20:16:45.299: terminalAlias*Mar 13 20:16:45.303: {*Mar 13 20:16:45.303: h323-ID :"GW13.cisco.com"*Mar 13 20:16:45.303: },*Mar 13 20:16:45.303: gatekeeperIdentifier "GK15.cisco.com",*Mar 13 20:16:45.303: endpointVendor*Mar 13 20:16:45.303: {*Mar 13 20:16:45.303: vendor*Mar 13 20:16:45.303: {*Mar 13 20:16:45.303: t35CountryCode 0181,*Mar 13 20:16:45.303: t35Extension 00,*Mar 13 20:16:45.303: manufacturerCode 018*Mar 13 20:16:45.303: }*Mar 13 20:16:45.303: }*Mar 13 20:16:45.303: }*Mar 13 20:16:45.303:0CC09088 06000891 4A000180 01000109 350D06B8 01000109 350D121B 0880013C05050100 40460000 01400D00 47005700 31003300 40006300 69007300 63006F002E006300 6F006D1A 0047004B 00310035 002E0063 00690073 0063006F 002E0063006F006D 00B50000 1210C09088 06000891 4A000100 01400D00 47005700 31003300 40006300 6900730063006F00 2E006300 6F006D1A 0047004B 00310035 002E0063 00690073 0063006F002E0063 006F006D 1E003600 30004400 37004500 37003300 43003000 3000300030003000 30003000 46value RasMessage ::= registrationConfirm :*Mar 13 20:16:45.335: {*Mar 13 20:16:45.335: requestSeqNum 037001,*Mar 13 20:16:45.335: protocolIdentifier { 0 0 8 2250 0 1 },*Mar 13 20:16:45.335: callSignalAddress*Mar 13 20:16:45.335: {*Mar 13 20:16:45.335: },*Mar 13 20:16:45.335: terminalAlias*Mar 13 20:16:45.335: {*Mar 13 20:16:45.335: h323-ID :"GW13.cisco.com"*Mar 13 20:16:45.339: },*Mar 13 20:16:45.339: gatekeeperIdentifier "GK15.cisco.com",*Mar 13 20:16:45.339: endpointIdentifier "60D7E73C0000000F"*Mar 13 20:16:45.339: }*Mar 13 20:16:45.339:3640GW.13#Configuration Examples
This section contains the following configuration examples:
•
•
Configuring an H.323 Gateway
The following example shows how to configure a Cisco 3600 series router as an H.323 gateway:
! Configure the voice-port parameters.! This voice-port is an analog E&M-wink port using 4-wire, type 5 interface!voice-port 2/0/0operation 4-wiretype 5!! Setup a pots dial peer to direct calls incoming VoIP calls to the voice-port.! This dial peer defines that the RAS initiated call will be received with a tech! prefix of 13#!dial-peer voice 13200 potsdestination-pattern 13#13200port 2/0/0!! Setup a VoIP dial-peer to direct calls originated from a local voice-port! into the VoIP cloud. In this example, the session target indicates! that the destination target is determined by querying the RAS gatekeeper.! The tech-prefix command means that the H.323 gateway will ask the RAS gatekeeper to! direct calls using the technology prefix of 14#.!dial-peer voice 14 voipdestination-pattern 14...tech-prefix 14#session target ras!! Enable Gateway functionality with global config command.!gateway!! Choose an interface to be this gateway's H.323 interface. In this example, the! gateway is directed toward a specific host. Then define this gateway's H.323 ID, and! configure any tech prefixes that this gateway should register with the gatekeeper.! In this example, gateway GW13 tells gatekeeper GK15 to route any calls with a pattern! than begins with 13# to GW13. Dial-peer 14 expects that some other gateway has! register tech-prefix 14#.!interface Ethernet0/0ip address 172.9.53.13 255.255.255.0h323-gateway voip interfaceh323-gateway voip id GK15.cisco.com ipaddr 172.9.53.15 1719h323-gateway voip h323-id GW13@cisco.comh323-gateway voip tech-prefix 13#!Configuring a RAS Gatekeeper
For RAS to work on an H.323 gateway, you need to configure a corresponding RAS gatekeeper. The following example configures a Cisco 3600 series router as a RAS gatekeeper. For more information about configuring gatekeepers, refer to the Cisco IOS Release 11.3(6)NA2 document, Configuring the Cisco AS5300 for Voice Service Provider Features.
! Define this Ethernet port as the RAS gatekeeper.interface Ethernet0/0ip address 172.9.53.15 255.255.255.0!gatekeeper!! Specify the name of the local zone that this gatekeeper managers. Specify the IP! address that the gatekeeper advertises.zone local GK15.cisco.com cisco.com 172.9.53.15!! Statically define a remote zone and the associated gatekeeper's IP address.zone remote GK21.cisco.com cisco.com 172.9.74.21 1719!! Statically define the E.164 prefixes that a remote zone handles. This causes GK15 to! direct any call with a called number that matches 22* (22 and any number of trailing! digits) to GK21. This is not the same as a tech prefix. If a call comes in with an! E.164 pattern of (220) 555-1234, it will be routed to GK21 because the pattern! matches 22*.zone prefix GK21.cisco.com 22*zone prefix GK21.cisco.com 23*!! Statically define a tech prefix routing. Any call that comes in to the gatekeeper! with a technology prefix of 88# (the * catches any following E.164 address), is! directed to the gateway at IP address 172.9.53.13. This is a static technology prefix! definition. The gateway can also dynamically register its tech-prefixes with the! gatekeeper.gw-type-prefix 88#* gw ipaddr 172.9.53.13 1720!! ACtivate the gatekeeper function by activating the port.no shutdown!AAA Accounting
Authentication, Authorization, and Accounting (AAA) features are required in the VoIP gateway. The standard Cisco AAA accounting functionality is enhanced to collect digits during the call processing process. Processes such as:
•
•
The AAA authentication feature permits RADIUS to be used to authenticate users (typically incoming calls) on the gateway. It is normally used with IVR to check the legitimacy of a prospective gateway user based on an account number (collected by IVR) or based on answer number identification (ANI).
Note
http://www.cisco.com/univercd/cc/td/doc/product/software/ios113ed/113t/113t_3/aaalists.htm.
Note: URLs are subject to change without notice.New AAA commands are described in the Command Reference.
Authentication
Authentication is based on RADIUS and is performed on the gateway (as opposed to the gatekeeper).
User account and PIN information is collected by the IVR application and passed to the AAA interface. The AAA interface then makes a RADIUS authentication request with the given information and returns to the IVR application with a status of success or failure.
RADIUS is an IETF protocol based on UDP. It functions by exchanging a set of attribute/value pairs between the client (for example, a VoIP gateway and a RADIUS server). Standard RADIUS server implementations include CiscoSecure, Cisco UCP, Livingston, and Merit.
Authorization
An authenticated user is authorized. There is no authorization of specific user capabilities for the service provider voice applications.
Accounting
Accounting uses a basic start-stop method and standard RADIUS attributes where possible. Attributes that cannot be mapped to standard RADIUS are packed into the Acct-Session-Id attribute field as '/' separated ASCII string.
Data items are collected for each call leg created on the gateway. A call leg is the internal representation of a connection to the gateway. Each call that is made through the gateway consists of two call legs: one incoming and one outgoing. The call leg information that is emitted by the gateway(s) can be correlated by their connection ID, which is the same for all call legs of a connection.
Standard RADIUS attributes supported are as follows:
•
•
•
•
•
•
•
Nonstandard RADIUS attributes packed into the Acct-Session-Id are as follows:
•
•
•
•
•
•
•
•
RADIUS Accounting with Overloaded Session ID
To take advantage of standard RADIUS implementations that do not support vendor-specific attributes, a new method is defined which embeds the unsupported information elements in the RADIUS Acct-Session-id. The Acct-Session-id field has a maximum length of 256 characters. It is defined to contain the RADIUS account session ID which is a unique identifier that links accounting records associated with the same login session for a user. The internal representation of this field is long; therefore, the value of this session ID can become very large as the number of sessions on a router increases. To support additional fields, we have defined the following string format for this field:
<session id >/<call leg setup time>/<gateway id>/<connection id>/<call origin>/
<call type>/<connect time>/<disconnect time>/<disconnect cause>/<remote ip address>
Note
Usage Guidelines
NTP time formats are displayed as:
%H:%M:%S.%k %Z %tw %tn %td %Ywhere:•
%His hour (00 to 23)•
%Mis minutes (00 to 59)•
%Sis seconds (00 to 59)•
%kis milliseconds (000 to 999)•
%Zis timezone string•
%twis day of week (Saturday through Sunday)•
%tnis month name (January through December)•
%tdis day of month (01 to 31)•
%Yis year including century (for example,1998)Note that because of the limited size of the session id string it is not possible to embed very many information elements in it. Therefore, this feature supports only a limited set of accounting information elements. For implementations that would like to take advantage of more information elements, Cisco's VSA implementation is recommended.
Example 1—Start Record
Client-Id = 172.29.248.123NAS-Port-Type = 0User-Name = "4004"Called-Station-Id = "+111"Calling-Station-Id = "+222"Acct-Status-Type = StartUser-Service-Type = Login-UserAcct-Session-Id = "4/23:21:14.078 UTC Sat Jul 18 1998/ak3620-1.cisco.com/859BF275 D7C80001 0 3AFF4/originate/VoIP///"Acct-Delay-Time = 0Example 2—Stop Record
Client-Id = 172.29.248.123NAS-Port-Type = 0User-Name = "4004"Called-Station-Id = "+111"Calling-Station-Id = "+222"Acct-Status-Type = StopUser-Service-Type = Login-UserAcct-Session-Id = "4/23:21:14.078 UTC Sat Jul 18 1998/ak3620-1.cisco.com/859BF275 D7C80001 0 3AFF4/originate/VoIP/23:21:14.093 UTC Sat Jul 18 1998/23:21:23.084 UTC Sat Jul 18 1998/4" Acct-Input-Octets = 8340Acct-Output-Octets = 8900Acct-Input-Packets = 417Acct-Output-Packets = 445Acct-Session-Time = 9Acct-Delay-Time = 0Example 3—Update Record
Client-Id = 172.29.248.123NAS-Port-Type = 0User-Name = "4004"Called-Station-Id = "+111"Calling-Station-Id = "+222"Acct-Status-Type = 3User-Service-Type = Login-UserAcct-Session-Id = "4/21:54:17.052 UTC Mon Jul 201998/ak3620-1.cisco.com/BF1AC9CA 8DE60006 0 5ED24/originate/VoIP///"Acct-Delay-Time = 0Syslog Accounting
The syslog accounting option exports the information elements associated with each call leg through a system log message. The system log message can be captured by a syslog daemon that is present on the network. The syslog output consists of the following:
server_timestamp gateway_id message_number : message_label : list_of_AV_pairs
Example
%VOIPAAA-5-VOIP_CALL_HISTORY:CallLegType 2,ConnectionId 300094C0 60E0F3A0 60C894C0 60C90000,SetupTime 22:35:22.023UTC Tue Aug 11 1998, PeerAddress 999, PeerSubAddress , DisconnectCause 10 ,DisconnectText normal call clearing., ConnectTime 22:35:24.027 UTC Tue Aug 11 1998,DisconnectTime 22:35:29.028 UTC Tue Aug 11 1998, CallOrigin 1, ChargedUnits 0, InfoType 2,TransmitPackets 0, TransmitBytes 0, ReceivePackets 0, ReceiveBytes 0Example AAA Configuration
The authentication command line creates a method list named H.323 with RADIUS being its only member.
Note
Also note that the accounting command line looks like a regular RADIUS accounting command line for connection accounting. Connection accounting has to be globally enabled using this command line. Start-stop or stop only methods may be used.
The Cisco IOS software AAA user interface can be configured to use the H.323 accounting method as follows.
Tips
•
•
•
aaa new-modelaaa authentication local-overrideaaa authentication login default radius!gw-accounting h323!radius-server host 10.90.1.1 auth-port 1645 acct-port 1646radius-server key gteInteractive Voice Response (IVR)
This application provides basic Interactive Voice Response (IVR) capabilities necessary to collect caller Personal Identification Numbers (PINs), passwords, and destination phone numbers. IVR consists of simple voice prompting and digit collection to gather caller information for authenticating the user and identifying the destination.
Simple IVR allows the use of one of several interactive voice response scripts which are embedded in Cisco IOS software. The ability to modify the embedded scripts is not yet available. However, the audio files (for the prompts) can be modified for the user.
The user receives a voice-prompt instruction to enter a specific type of information (for example, a PIN number). After playing the voice prompt, the IVR feature starts the process of collecting the pre-determined number of touch tones (digit collection).
The IVR application then specifies a sequence of voice prompts and touch-tone collection instructions. IVR applications can be assigned to specific ports or invoked based on DNIS. An IP/PSTN gateway can have several different IVR applications to accommodate many different gateway services; and the IVR applications can be customized to present different interfaces to the caller. The functionality includes the ability to do the following:
•
•
•
•
•
IVR Application Field
The application field is used to indicate the application to which incoming calls should be delivered. This field is applicable to the dial-peer of the POTS-encapsulation type only. The application field, in the inbound dial-peer, is used to indicate the application that this incoming call should be delivered to. Examples of applications entered in this field are the default session application and the IVR application.
A brief description of the IVR application scripts follow:
•
•
•
•
•
•
This script is similar to clid_authen_col_npw, but it allows two retries (3 tries total) for entering the account and password. For each of the two retries, it plays a special retry message.
•
This is similar to clid_col_npw_3, but it does not collect a PIN number. Instead, it uses the collected account number with a NULL password for authentication.
ANI Authorization
Based on authentication of the ANI and DNIS for the call, the user is either denied service (with an appropriate voice message) or prompted for an account number and PIN if authentication fails. If authentication succeeds (or subsequent authentication with the supplied account/PIN succeeds), the user is prompted for the destination phone number, and the call is placed.
Fax Hop On/Off
Fax hop on/off is a specialized IVR application to support the use of redialer boxes in fax applications. Redialers are small units which connect between a fax machine and a telephone line, intercept the phone number dialed by the fax machine, place an outgoing call to another phone number (in this case, that of the voice gateway), and then forward the destination number intercepted from the fax machine to the gateway when prompted. Optionally, an account number can be included to identify the caller's organization for authentication and billing purposes.
ISDN Redirect Number Support
The purpose of this feature is to support the redirecting call feature of the VoIP gateway. The redirecting number is an optional field of the Q.931 Setup message.
When a local exchange carrier (LEC) switch detects an incoming call that is destined for a busy or nonanswering party, the switch formulates a Q.931 Setup message with the Redirecting Number field set to the originally called number, and sends it to the gateway. The called party number of the Setup message is set to one of the service access numbers dialed number identification service (DNIS) of the gateway.
If a redirect number is present on an incoming call, it is used in place of the called number (DNIS).
Dial Peer Configuration Restrictions for ISDNRedirect
The dial peer configuration for ISDN redirect involves setting up two audio scripts:
•
•
Incoming Dial Peer
To process incoming ISDN voice calls, incoming dial peers need to be configured. The dialed number identification service (DNIS) number of the incoming call is used to match the DNIS number field of the incoming dial peer. The direct-inward-dial flag of the dial peer determines whether a second dial tone is given to the caller to collect the target destination number. For this Cisco service provider feature, the DNIS is set to the access phone number of the Gateway, and the direct-inward-dial flag is set to TRUE.
Outgoing Dial Peer
The outgoing dial peer is selected based on the DNIS number of the incoming call. The outgoing dial peer indicates the session target of the outgoing call.
ISDNRedirect Call Flow Example
•
•
•
•
•
•
•
•
•
•
remote endpoint/gateway matches outgoing (telephony) dial-peer with destination pattern B
Rotary Call Pattern
The Rotary Calling Pattern feature provides the ability, under certain circumstances, to route an incoming call arriving via a telephony interface back out via another telephony interface. This is primarily used to continue to provide service during network failures.
Call establishment via Rotary Call Pattern is supported via rotary group support of dial peers, where multiple dial peers may match a given destination phone number, and the dialing number will be selected in sequence. Support for Rotary Call Patterns of calls active at the time of a network failure will not be provided in the first release, which is 11.3(6)NA2.
In prior releases of VoIP, if you wanted the system to search through several destination numbers when a given number was dialed, you needed to configure those dial peers with the same destination pattern. Now with the Rotary Call Pattern feature, if you want the destinations to be tried in a certain order, you can assign order preference (via the preference command) to the dial peers.
For example, if you wish a call processing sequence to go to destination A first, then destination B second, and then to destination C, you would assign preference to the destinations in the following order (0 being the highest priority):
•
•
•
Rotary Call Functionality
If there are several dial peers that match a particular destination pattern, the system attempts to place a call to the one with the highest preference. If the call cannot be completed because of a system outage (for example, the gatekeeper or gateway cannot be contacted), the Rotary call feature performs the following tasks:
•
•
•
Command Reference
This section documents new or modified commands. All other commands used with this feature are documented in the Cisco IOS Release 11.3 command reference.
•
•
•
•
aaa authentication login h323 radius
The aaa authentication login h323 radius command is used to define a method list called H.323 with RADIUS as a method. Enter the no form of this command to restore the default.
authentication login h323 radius
no authentication login h323 radius
Syntax Description
This command has no key words or arguments.
Default
[no] authentication login h323 radius.
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3(6)NA2.
This command was implemented on the Cisco AS5850 in the Cisco IOS Release 12.2(2)XB1.
This command was integrated into Cisco IOS Release 12.2(11)T.
This command line registers the H.323 method list (also referred to as h323 service) which has RADIUS as its only method in the router. The VoIP calls send all their authentication requests through the H.323 service. If this line does not exist in the router configuration VoIP authentication will not take place.
A significant difference in the usage of this command is that with Cisco IOS release 11.3(T) the name of the method list is flexible and can be changed by the user. However, when using method list for configuring AAA with the VoIP service provider software, the method list is a specific name that you should not change.
The way method lists work in Cisco IOS software is that a list is defined using the aaa authentication login h323 radius command, and is then applied to an interface. For voice authentication, we never apply this list to any interface. When enabled, using this command applies to all voice interfaces. The function of this command is activated through the IVR application.
aaa accounting connection h323
This command is used to define the accounting method list "H.323" with RADIUS as a method and with either stop-only or start-stop accounting options.
aaa accounting connection h323 {stop-only | start-stop} radius
no aaa accounting connection h323 {stop-only | start-stop} radius
Syntax Description
stop-only | start-stop
Start-only or stop-only accounting options.
radius
RADIUS is used as the method.
Default
[no] aaa accounting connection h323.
Example
aaa accounting connection h323 {none | start-stop | stop-only | wait-start} radius
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3(6)NA2.
This command was implemented on the Cisco AS5850 in the Cisco IOS Release 12.2(2)XB1.
This command was integrated into Cisco IOS Release 12.2(11)T.
The method list has to be called "h323" and is activated for all voice interfaces.
This command line tells the system to create a method list called H.323 which has start-stop radius as its method. The h323 method list is static and is applied by default to all voice interfaces if the gw-accounting h323 command is also activated.
application
The application command selects the session application for Interactive Voice Response. This command is entered during the configuration of the dial peers.
application name
Syntax Description
Default
None. The call will be handed to the predefined session application.
Command Mode
Dial peer configuration mode
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3(6)NA2.
This command was implemented on the Cisco AS5850 in the Cisco IOS Release 12.2(2)XB1.
This command was integrated into Cisco IOS Release 12.2(11)T.
Example:
application clid_authen_collect, CallID 90 got event IVR_EV-CALL_SETUP_IND:: ivr action: IVR_ACT_CALL_SETUP_ACK:: ivr action: IVR_ACT_CALL_PROCEEDING:: ivr action: IVR_ACT_CALL_CONNECT: ivr action: IVR_ACT_CALL_PROCEEDING:: ivr action: IVR_ACT_CALL_CONNECTaudio-prompt load
Use the audio-prompt load command to refresh the .au (audio) file in the memory. This is the file which contains the announcement prompt for the caller. The router will only load the .au file when the script initially plays that prompt, or on the router restart. If the .au file is changed, the user must run this EXEC command to reread the file. This will generate an error message if the file is not accessible, or if there is a format error.
audio-prompt load name
Syntax Description
Default
None.
Command Mode
Privileged EXEC
Usage Guidelines
This command first appears in Cisco IOS Release 11.3(6)NA2.
This command was implemented on the Cisco AS5850 in the Cisco IOS Release 12.2(2)XB1.
This command was integrated into Cisco IOS Release 12.2(11)T.
•
•
•
•
•
•
Example
audio-prompt load flash:enter_pin.au
gateway
To enable the H.323 VoIP gateway, use the gateway global configuration command. Use the no form of this command to unregister this gateway with the gatekeeper.
gateway
no gatewaySyntax Description
This command has no keywords or arguments.
Default
The gateway is unregistered.
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3(6)NA2.
This command was implemented on the Cisco AS5850 in the Cisco IOS Release 12.2(2)XB1.
This command was integrated into Cisco IOS Release 12.2(11)T.
Use the gateway command to enable H.323 VoIP gateway functionality. After you enable the gateway, it will attempt to discover a gatekeeper by using the H.323 RAS GRQ message.
•
•
•
gw-accounting
The gw-accounting command is used to enable or disable gateway specific accounting.
gw-accounting [h323 | syslog]
no gw-accounting [h323 | syslog]
Syntax Description
h323
H.323 method uses RADIUS to output accounting CDRs.
syslog
Syslog uses the system logging facility to output CDRs.
Default
[no] gw-accounting [h323 | syslog].
Command Mode
Global configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3(6)NA2.
This command was implemented on the Cisco AS5850 in the Cisco IOS Release 12.2(2)XB1.
This command was integrated into Cisco IOS Release 12.2(11)T.
•
•
•
h323-gateway voip h323-id
To configure the H.323 name of the gateway identifying this gateway to its associated gatekeeper, use the h323-gateway voip h.323-id interface configuration command. Use the no form of this command to disable this defined gateway name.
h323-gateway voip h323-id interface-id
no h323-gateway voip h323-id interface-idSyntax Description
Default
No gateway identification is defined.
Command Mode
Interface configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3(6)NA2.
This command was implemented on the Cisco AS5850 in the Cisco IOS Release 12.2(2)XB1.
This command was integrated into Cisco IOS Release 12.2(11)T.
Example
The following example configures Ethernet interface 0/0 as the gateway interface. In this example, the gateway ID is GW13@cisco.com.
interface Ethernet0/0ip address 172.9.53.13 255.255.255.0h323-gateway voip interfaceh323-gateway voip id GK15.cisco.com ipaddr 172.9.53.15 1719h323-gateway voip h323-id GW13@cisco.comh323-gateway voip tech-prefix 13#Related Commands
h323-gateway voip id
h323-gateway voip interface
h323-gateway voip tech-prefix 13#h323-gateway voip id
To define the name and location of the gatekeeper for this gateway, use the h323-gateway voip id interface configuration command. Use the no form of this command to disable this gatekeeper identification.
h323-gateway voip id gatekeeper-id {ipaddr ip-address [port-number] | multicast}
no h323-gateway voip id gatekeeper-id {ipaddr ip-address [port-number] | multicast}Syntax Description
Default
No gatekeeper identification is defined.
Command Mode
Interface configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3(6)NA2.
This command was implemented on the Cisco AS5850 in the Cisco IOS Release 12.2(2)XB1.
This command was integrated into Cisco IOS Release 12.2(11)T.
This command tells the H.323 gateway associated with this interface which H.323 gatekeeper to talk to and where to locate it. The gatekeeper ID configured here must exactly match the gatekeeper ID in the gatekeeper configuration.
Example
The following example configures Ethernet interface 0/0 as the gateway interface. In this example, the gatekeeper ID is GK15.cisco.com and its IP address is 172.9.53.15 (using port 1719).
interface Ethernet0/0ip address 172.9.53.13 255.255.255.0h323-gateway voip interfaceh323-gateway voip id GK15.cisco.com ipaddr 172.9.53.15 1719h323-gateway voip h323-id GW13@cisco.comh323-gateway voip tech-prefix 13#Related Commands
h323-gateway voip h323-id
h323-gateway voip interface
h323-gateway voip tech-prefix 13#h323-gateway voip interface
To configure this interface as an H.323 interface, use the h323-gateway voip interface configuration command. Use the no form of this command to disable H.323 functionality for this interface.
h323-gateway voip interface
no h323-gateway voip interfaceSyntax Description
This command has no arguments or keywords.
Default
Disabled
Command Mode
Interface configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3(6)NA2.
This command was implemented on the Cisco AS5850 in the Cisco IOS Release 12.2(2)XB1.
This command was integrated into Cisco IOS Release 12.2(11)T.
Example
The following example configures Ethernet interface 0.0 as the gateway interface. In this example, the h323-gateway voip interface command configures this interface as an H.323 interface.
interface Ethernet0/0ip address 172.9.53.13 255.255.255.0h323-gateway voip interfaceh323-gateway voip id GK15.cisco.com ipaddr 172.9.53.15 1719h323-gateway voip h323-id GW13@cisco.comh323-gateway voip tech-prefix 13#Related Commands
h323-gateway voip h323-id
h323-gateway voip id
h323-gateway voip tech-prefix 13#h323-gateway voip tech-prefix
To define the technology prefix that the gateway will register with the gatekeeper, use the h323-gateway voip tech-prefix interface configuration command. Use the no form of this command to disable this defined technology prefix.
h323-gateway voip tech-prefix prefix
no h323-gateway voip tech-prefix prefixSyntax Description
Default
Disabled
Command Mode
Interface configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3(6)NA2.
This command was implemented on the Cisco AS5850 in the Cisco IOS Release 12.2(2)XB1.
This command was integrated into Cisco IOS Release 12.2(11)T.
This command defines a technology prefix that the gateway will then register with the gatekeeper. Technology prefixes can be used as a discriminator so that the gateway can tell the gatekeeper that a certain technology is associated with a particular call (for example, 15# could mean a fax transmission), or it can be used like an area code for more generic routing. No standard currently defines what the numbers in a technology prefix mean. By convention, technology prefixes are designated by a pound (#) symbol as the last character.
Note
Example
The following example configures Ethernet interface 0.0 as the gateway interface. In this example, the technology prefix is defined as 13#.
interface Ethernet0/0ip address 172.9.53.13 255.255.255.0h323-gateway voip interfaceh323-gateway voip id GK15.cisco.com ipaddr 172.9.53.15 1719h323-gateway voip h323-id GW13@cisco.comh323-gateway voip tech-prefix 13#Related Commands
h323-gateway voip id
h323-gateway voip interface
h323-gateway voip h323-idpreference
The preference command is used to indicate the preference order for matching dial peers in a rotary group.
preference number
Syntax Description
Default
No preference is set.
Command Mode
dial-peer configuration mode
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3(6)NA2. Use this command when configuring the Rotary call pattern feature.
This command was implemented on the Cisco AS5850 in the Cisco IOS Release 12.2(2)XB1.
This command was integrated into Cisco IOS Release 12.2(11)T.
•
•
Examples
The following examples show different dial peer configurations using the preference command:
•
Dialpeer destpat preference session-target1 4085271048 0 (highest) jmmurphy-voip2 408527 0 sj-voip3 408527 1 (lower) backup-sj-voip4 .......... 1 0:D (interface)5 .......... 0 anywhere-voipIf the called number is 4085271048, the order of attempts will be 1,2,3,5,4.
•
Dialpeer destpat preference1 408527 02 4085271048 13 4085271 04 ..............4085271.........0The number dialed is 4085271048, the order will be 2, 3, 4, 1. If there are equal priority dial peers, the order is determined randomly.
session target
The session target command is used to identify the IP address of the destination gatekeeper. The field indicating if the RAS protocol is being used has been added. Enter the no form of this command to restore the default condition.
session target ras
session target {ipv4:destination-address | dns:[$s$. | $d$. | $e$. | $u$.] host-name | loopback:rtp | loopback:compressed | loopback:uncompressed | ras}
no session targetSyntax Description
Default
The default for this command is enabled with no IP address or domain name defined.
Command Mode
Dial-peer configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3(1)T.
This command was implemented on the Cisco AS5850 in the Cisco IOS Release 12.2(2)XB1.
This command was integrated into Cisco IOS Release 12.2(11)T.
Use the session target command to specify a network-specific address or domain name for a dial peer. Whether you select a network-specific address or a domain name depends on the session protocol you select.
The session target loopback command is used for testing the voice transmission path of a call. The loopback point will depend on the call origination and the loopback type selected.
The session target dns command can be used with or without the specified wildcards. Using the optional wildcards can reduce the number of VoIP dial peer session targets you need to configure if you have groups of numbers associated with a particular router.
Use the session target ras command to specify that the RAS protocol is being used to determine the IP address of the session target.
Examples
The following example configures a session target using DNS for a host, "voice_router," in the domain "cisco.com":
dial-peer voice 10 voipsession target dns:voice_router.cisco.comThe following example configures a session target using DNS, with the optional $u$. wildcard. In this example, the destination pattern has been configured to allow for any four-digit extension, beginning with the numbers 1310222. The optional wildcard $u$. indicates that the router will use the unmatched portion of the dialed number—in this case, the four-digit extension, to identify the dial peer. As in the previous example, the domain is "cisco.com."
dial-peer voice 10 voipdestination-pattern 1310222....session target dns:$u$.cisco.comThe following example configures a session target using dns, with the optional $d$. wildcard. In this example, the destination pattern has been configured for 13102221111. The optional wildcard $d$. indicates that the router will use the destination pattern to identify the dial peer in the "cisco.com" domain.
dial-peer voice 10 voipdestination-pattern 13102221111session target dns:$d$.cisco.comThe following example configures a session target using DNS, with the optional $e$. wildcard. In this example, the destination pattern has been configured for 12345. The optional wildcard $e$. indicates that the router will reverse the digits in the destination pattern, add periods between the digits, and then use this reverse-exploded destination pattern to identify the dial peer in the "cisco.com" domain.
dial-peer voice 10 voipdestination-pattern 12345session target dns:$e$.cisco.comThe following example configures a session target using RAS:
dial-peer voice 11 vofrdestination-pattern 13102221111session target rasRelated Commands
destination-pattern
session protocolshow call application voice
The show call application voice command defines the names of the audio files the script will play, the operation of the abort keys, what prompts are used and caller interaction.
show call application voice [name | summary]
no show call application voice [name | summary]
Syntax Description
Default
no show call application voice [name | summary]
Command Mode
Privileged EXEC (also called enable mode)
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3(6)NA2.
This command was implemented on the Cisco AS5850 in the Cisco IOS Release 12.2(2)XB1.
This command was integrated into Cisco IOS Release 12.2(11)T.
•
•
•
Example Display
show call application voice clid_authen_collect
sblab115>show call application voice clid_authen_collectApplication clid_authen_collect has 10 states with 0 calls activeState start has 1 actions and 5 eventsDo Action IVR_ACT_AUTHENTICATE. accountName=ani, pinName=dnisIf Event IVR_EV_DEFAULT goto state endIf Event IVR_EV_CALL_DIGIT do nothingIf Event IVR_EV_CALL_SETUP_IND do action IVR_ACT_CALL_SETUP_ACKand goto state startIf Event IVR_EV_AAA_SUCCESS goto state collect_destIf Event IVR_EV_AAA_FAIL goto state get_accountState end has 1 actions and 3 eventsDo Action IVR_ACT_END.If Event IVR_EV_DEFAULT goto state endIf Event IVR_EV_CALL_DIGIT do nothingIf Event IVR_EV_CALL_DISCONNECT_DONE do action IVR_ACT_CALL_DESTROYand do nothingState get_account has 4 actions and 7 eventsDo Action IVR_ACT_PLAY.URL: flash:enter_account.auallowInt=1, pContent=0x60E4C564Do Action IVR_ACT_ABORT_KEY. abortKey=*Do Action IVR_ACT_TERMINATION_KEY. terminationKey=#Do Action IVR_ACT_COLLECT_PATTERN. Pattern account is .+If Event IVR_EV_DEFAULT goto state endIf Event IVR_EV_CALL_DIGIT do nothingIf Event IVR_EV_PAT_COL_SUCCESS goto state get_pinpatName=accountIf Event IVR_EV_ABORT goto state get_accountIf Event IVR_EV_PLAY_COMPLETE do nothingIf Event IVR_EV_TIMEOUT goto state get_account count=0If Event IVR_EV_PAT_COL_FAIL goto state get_accountState get_pin has 4 actions and 7 eventsDo Action IVR_ACT_PLAY.URL: flash:enter_pin.auallowInt=1, pContent=0x0Do Action IVR_ACT_ABORT_KEY. abortKey=*Do Action IVR_ACT_TERMINATION_KEY. terminationKey=#Do Action IVR_ACT_COLLECT_PATTERN. Pattern pin is .+If Event IVR_EV_DEFAULT goto state endIf Event IVR_EV_CALL_DIGIT do nothingIf Event IVR_EV_PAT_COL_SUCCESS goto state authenticatepatName=pinIf Event IVR_EV_PLAY_COMPLETE do nothingIf Event IVR_EV_ABORT goto state get_accountIf Event IVR_EV_TIMEOUT goto state get_pin count=0If Event IVR_EV_PAT_COL_FAIL goto state get_pinState authenticate has 1 actions and 5 eventsDo Action IVR_ACT_AUTHENTICATE. accountName=account, pinName=pinIf Event IVR_EV_DEFAULT goto state endIf Event IVR_EV_CALL_DIGIT do nothingIf Event IVR_EV_AAA_SUCCESS goto state collect_destIf Event IVR_EV_TIMEOUT do nothing count=0If Event IVR_EV_AAA_FAIL goto state authenticate_failState collect_dest has 4 actions and 8 eventsDo Action IVR_ACT_PLAY.URL: flash:enter_destination.auallowInt=1, pContent=0x0Do Action IVR_ACT_ABORT_KEY. abortKey=*Do Action IVR_ACT_TERMINATION_KEY. terminationKey=#Do Action IVR_ACT_COLLECT_DIALPLAN.If Event IVR_EV_DEFAULT goto state endIf Event IVR_EV_CALL_DIGIT do nothingIf Event IVR_EV_PLAY_COMPLETE do nothingIf Event IVR_EV_ABORT goto state collect_destIf Event IVR_EV_TIMEOUT goto state collect_dest count=0If Event IVR_EV_DIAL_COL_SUCCESS goto state place_callIf Event IVR_EV_DIAL_COL_FAIL goto state collect_destIf Event IVR_EV_TIMEOUT goto state collect_dest count=0State place_call has 1 actions and 4 eventsDo Action IVR_ACT_PLACE_CALL.destination= called=calling= account=If Event IVR_EV_DEFAULT goto state endIf Event IVR_EV_CALL_DIGIT do nothingIf Event IVR_EV_CALL_UP goto state activeIf Event IVR_EV_CALL_FAIL goto state place_failState active has 0 actions and 2 eventsIf Event IVR_EV_DEFAULT goto state endIf Event IVR_EV_CALL_DIGIT do nothingState authenticate_fail has 1 actions and 2 eventsDo Action IVR_ACT_PLAY.URL: flash:auth_failed.auallowInt=0, pContent=0x0If Event IVR_EV_DEFAULT goto state endIf Event IVR_EV_CALL_DIGIT do nothingState place_fail has 1 actions and 2 eventsDo Action IVR_ACT_PLAY_FAILURE_TONE.If Event IVR_EV_DEFAULT goto state endIf Event IVR_EV_CALL_DIGIT do nothingsblab115>show call application voice clid_authen_collectApplication clid_authen_collect has 10 states with 0 calls activeState start has 1 actions and 5 eventsDo Action IVR_ACT_AUTHENTICATE. accountName=ani, pinName=dnisIf Event IVR_EV_DEFAULT goto state endIf Event IVR_EV_CALL_DIGIT do nothingIf Event IVR_EV_CALL_SETUP_IND do action IVR_ACT_CALL_SETUP_ACKand goto state startIf Event IVR_EV_AAA_SUCCESS goto state collect_destIf Event IVR_EV_AAA_FAIL goto state get_accountState end has 1 actions and 3 eventsDo Action IVR_ACT_END.If Event IVR_EV_DEFAULT goto state endIf Event IVR_EV_CALL_DIGIT do nothingIf Event IVR_EV_CALL_DISCONNECT_DONE do action IVR_ACT_CALL_DESTROYand do nothingState get_account has 4 actions and 7 eventsDo Action IVR_ACT_PLAY.URL: flash:enter_account.auallowInt=1, pContent=0x60E4C564Do Action IVR_ACT_ABORT_KEY. abortKey=*Do Action IVR_ACT_TERMINATION_KEY. terminationKey=#Do Action IVR_ACT_COLLECT_PATTERN. Pattern account is .+If Event IVR_EV_DEFAULT goto state endIf Event IVR_EV_CALL_DIGIT do nothingIf Event IVR_EV_PAT_COL_SUCCESS goto state get_pinpatName=accountIf Event IVR_EV_ABORT goto state get_accountIf Event IVR_EV_PLAY_COMPLETE do nothingIf Event IVR_EV_TIMEOUT goto state get_account count=0If Event IVR_EV_PAT_COL_FAIL goto state get_accountState get_pin has 4 actions and 7 eventsDo Action IVR_ACT_PLAY.URL: flash:enter_pin.auallowInt=1, pContent=0x0Do Action IVR_ACT_ABORT_KEY. abortKey=*Do Action IVR_ACT_TERMINATION_KEY. terminationKey=#Do Action IVR_ACT_COLLECT_PATTERN. Pattern pin is .+If Event IVR_EV_DEFAULT goto state endIf Event IVR_EV_CALL_DIGIT do nothingIf Event IVR_EV_PAT_COL_SUCCESS goto state authenticatepatName=pinIf Event IVR_EV_PLAY_COMPLETE do nothingIf Event IVR_EV_ABORT goto state get_accountIf Event IVR_EV_TIMEOUT goto state get_pin count=0If Event IVR_EV_PAT_COL_FAIL goto state get_pinState authenticate has 1 actions and 5 eventsDo Action IVR_ACT_AUTHENTICATE. accountName=account, pinName=pinIf Event IVR_EV_DEFAULT goto state endIf Event IVR_EV_CALL_DIGIT do nothingIf Event IVR_EV_AAA_SUCCESS goto state collect_destIf Event IVR_EV_TIMEOUT do nothing count=0If Event IVR_EV_AAA_FAIL goto state authenticate_failState collect_dest has 4 actions and 8 eventsDo Action IVR_ACT_PLAY.URL: flash:enter_destination.auallowInt=1, pContent=0x0Do Action IVR_ACT_ABORT_KEY. abortKey=*Do Action IVR_ACT_TERMINATION_KEY. terminationKey=#Do Action IVR_ACT_COLLECT_DIALPLAN.If Event IVR_EV_DEFAULT goto state endIf Event IVR_EV_CALL_DIGIT do nothingIf Event IVR_EV_PLAY_COMPLETE do nothingIf Event IVR_EV_ABORT goto state collect_destIf Event IVR_EV_TIMEOUT goto state collect_dest count=0If Event IVR_EV_DIAL_COL_SUCCESS goto state place_callIf Event IVR_EV_DIAL_COL_FAIL goto state collect_destIf Event IVR_EV_TIMEOUT goto state collect_dest count=0State place_call has 1 actions and 4 eventsDo Action IVR_ACT_PLACE_CALL.destination= called=calling= account=If Event IVR_EV_DEFAULT goto state endIf Event IVR_EV_CALL_DIGIT do nothingIf Event IVR_EV_CALL_UP goto state activeIf Event IVR_EV_CALL_FAIL goto state place_failState active has 0 actions and 2 eventsIf Event IVR_EV_DEFAULT goto state endIf Event IVR_EV_CALL_DIGIT do nothingState authenticate_fail has 1 actions and 2 eventsDo Action IVR_ACT_PLAY.URL: flash:auth_failed.auallowInt=0, pContent=0x0If Event IVR_EV_DEFAULT goto state endIf Event IVR_EV_CALL_DIGIT do nothingState place_fail has 1 actions and 2 eventsDo Action IVR_ACT_PLAY_FAILURE_TONE.If Event IVR_EV_DEFAULT goto state endIf Event IVR_EV_CALL_DIGIT do nothingshow gateway
The show gateway command is used to display the current gateway status.
show gateway
no show gatewaySyntax Description
This command has no keywords or arguments.
Default
no show gateway
Command Mode
Privileged EXEC (also called enable mode)
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3(6)NA2.
This command was implemented on the Cisco AS5850 in the Cisco IOS Release 12.2(2)XB1.
This command was integrated into Cisco IOS Release 12.2(11)T.
Example Output
gte-as5300-2#show gatewayGateway voip2@vm1lab is registered to Gatekeeper gk1.vm1labtech-prefix
The tech-prefix command is used to specify a particular technology prefix be prepended to the destination pattern of a specific dial peer, use the tech-prefix dial-peer configuration command. Use the no form of this command to disabled the defined technology prefix for this dial peer.
tech-prefix number
no tech-prefix numberSyntax Description
Default
No technology prefix is defined.
Command Mode
Dial-peer configuration
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3(6)NA2.
This command was implemented on the Cisco AS5850 in the Cisco IOS Release 12.2(2)XB1.
This command was integrated into Cisco IOS Release 12.2(11)T.
Technology prefixes are used to distinguish between gateways having specific capabilities within a given zone. In the exchange between the gateway and the gatekeeper, the technology prefix is used to select a gateway after the zone has been selected. Use the tech-prefix command to define technology prefixes.
Technology prefixes can be used as a discriminator so that the gateway can tell the gatekeeper that a certain technology is associated with a particular call (for example, 15# could mean a fax transmission), or it can be used like an area code for more generic routing. No standard defines what the numbers in a technology prefix mean; by convention, technology prefixes are designated by a pound (#) symbol as the last character.
In most cases, there is a dynamic protocol exchange between the gateway and the gatekeeper that enables the gateway to inform the gatekeeper about technology prefixes and where to forward calls. If, for some reason, that dynamic registry feature is not in effect, you can statically configure the gatekeeper to query the gateway for this information by configuring the gw-type-prefix command on the gatekeeper. Use the show gatekeeper gw-type-prefix to display how the gatekeeper has mapped the technology prefixes to local gateways.
Note
Examples
The following example defines a technology prefix of 14# for the specified dial peer. In this example, the technology prefix means that the H.323 gateway will ask the RAS gatekeeper to direct calls using the technology prefix of 14#.
dial-peer voice 10 voipdestination-pattern 14...tech-prefix 14#Related Commands
gw-type-prefix
show gatekeeper gw-type-prefixDebug Commands
This section describes the following debug commands:
debug cch323 h225
The debug cch323 h225 command provides the trace of the state transition of the H.225 state machine based on the processed events. The no form of this command disables debugging output.
debug cch323 h225
no debug cch323 h225
Syntax Description
This command has no keywords or arguments.
Default
Disabled
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3(6)NA2.
This command was implemented on the Cisco AS5850 in the Cisco IOS Release 12.2(2)XB1.
This command was integrated into Cisco IOS Release 12.2(11)T.
State Descriptions
The state definitions of the different states of the H.225 state machine are as follows:
•
•
•
•
•
•
•
•
Events Description
The event definitions of the different events of the H.225 state machine are as follows:
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
Example
20:59:17:Set new event H225_EVENT_SETUP20:59:17:H225 FSM:received event H225_EVENT_SETUP while at state H225_IDLE20:59:17:Changing from H225_IDLE state to H225_SETUP state20:59:17:cch323_h225_receiver:received msg of type SETUPCFM_CHOSEN20:59:17:H225 FSM:received event H225_EVENT_SETUP_CFM_IND while at stateH225_SETUP20:59:17:Changing from H225_SETUP state to H225_ACTIVE state20:59:17:Set new event H225_EVENT_H245_SUCCESS20:59:17:H225 FSM:received event H225_EVENT_H245_SUCCESS while at stateH225_ACTIVE20:59:20:Set new event H225_EVENT_RELEASE20:59:20:H225 FSM:received event H225_EVENT_RELEASE while at stateH225_ACTIVE20:59:20:Changing from H225_ACTIVE state to H225_WAIT_FOR_DRQ state20:59:20:Set new event H225_EVENT_RAS_SUCCESS20:59:20:H225 FSM:received event H225_EVENT_RAS_SUCCESS while at stateH225_WAIT_FOR_DRQ20:59:20:Changing from H225_WAIT_FOR_DRQ state to H225_IDLE statedebug cch323 h245
The debug cch323 h245 command provides the trace of the state transition of the H.245 state machine based on the processed events. The no form of this command disables debugging output.
debug cch323 h245
no debug cch323 h245
Syntax Description
This command has no keywords or arguments.
Default
Disabled
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3(6)NA2.
This command was implemented on the Cisco AS5850 in the Cisco IOS Release 12.2(2)XB1.
This command was integrated into Cisco IOS Release 12.2(11)T.
The H.245 state machines include the following three state machines:
•
•
•
State Definitions
The definitions are listed:
•
•
•
•
•
•
•
•
•
Event definitions
•
•
•
•
•
•
•
•
•
•
•
•
Example
20:58:23:Changing to new event H245_EVENT_MSD20:58:23:H245 MS FSM:received event H245_EVENT_MSD while at stateH245_MS_NONE20:58:23:changing from H245_MS_NONE state to H245_MS_WAIT state20:58:23:Changing to new event H245_EVENT_CAP20:58:23:H245 CAP FSM:received event H245_EVENT_CAP while at stateH245_CAP_NONE20:58:23:changing from H245_CAP_NONE state to H245_CAP_WAIT state20:58:23:cch323_h245_receiver:received msg of typeM_H245_MS_DETERMINE_INDICATION20:58:23:Changing to new event H245_EVENT_MS_IND20:58:23:H245 MS FSM:received event H245_EVENT_MS_IND while at stateH245_MS_WAIT20:58:23:cch323_h245_receiver:received msg of typeM_H245_CAP_TRANSFER_INDICATION20:58:23:Changing to new event H245_EVENT_CAP_IND20:58:23:H245 CAP FSM:received event H245_EVENT_CAP_IND while at stateH245_CAP_WAIT20:58:23:cch323_h245_receiver:received msg of typeM_H245_MS_DETERMINE_CONFIRM20:58:23:Changing to new event H245_EVENT_MS_CFM20:58:23:H245 MS FSM:received event H245_EVENT_MS_CFM while at stateH245_MS_WAIT20:58:23:changing from H245_MS_WAIT state to H245_MS_DONE state0:58:23:cch323_h245_receiver:received msg of type M_H245_CAP_TRANSFER_CONFIRM20:58:23:Changing to new event H245_EVENT_CAP_CFM20:58:23:H245 CAP FSM:received event H245_EVENT_CAP_CFM while at stateH245_CAP_WAIT20:58:23:changing from H245_CAP_WAIT state to H245_CAP_DONE state20:58:23:Changing to new event H245_EVENT_OLC20:58:23:H245 OLC FSM:received event H245_EVENT_OLC while at stateH245_OLC_NONE20:58:23:changing from H245_OLC_NONE state to H245_OLC_WAIT state20:58:23:cch323_h245_receiver:received msg of typeM_H245_UCHAN_ESTABLISH_INDICATION20:58:23:Changing to new event H245_EVENT_OLC_IND20:58:23:H245 OLC FSM:received event H245_EVENT_OLC_IND while at stateH245_OLC_WAIT20:58:23:cch323_h245_receiver:received msg of type M_H245_UCHAN_ESTAB_ACK20:58:23:Changing to new event H245_EVENT_OLC_CFM20:58:23:H245 OLC FSM:received event H245_EVENT_OLC_CFM while at stateH245_OLC_WAIT20:58:23:changing from H245_OLC_WAIT state to H245_OLC_DONE statedebug cch323 ras
The debug cch323 ras command provides the trace of the state transition of the RAS state machine based on the processed events.The no form of this command disables debugging output.
debug cch323 ras
no debug cch323 ras
Syntax Description
This command has no keywords or arguments.
Default
Disabled
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3(6)NA2.
This command was implemented on the Cisco AS5850 in the Cisco IOS Release 12.2(2)XB1.
This command was integrated into Cisco IOS Release 12.2(11)T.
RAS operates in two state machines. One global state machine controls the overall RAS operation of the Gateway. The other state machine is a per call state machine that controls the active calls.
State definitions
The state definitions of the different states of the RAS state machine follow:
•
•
•
•
•
•
•
•
Event Definitions
These are the event definitions of the different states of the RAS state machine:
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
Example
20:58:49:Changing to new event CCH323_RAS_EVENT_SEND_RRQcch323_run_ras_sm:received event CCH323_RAS_EVENT_SEND_RRQ while at CCH323_RAS_STATE_IDLE statecch323_run_ras_sm:changing to CCH323_RAS_STATE_RRQ statecch323_ras_receiver:received msg of type RCF_CHOSENcch323_run_ras_sm:received event CCH323_RAS_EVENT_RCF while at CCH323_RAS_STATE_RRQ statecch323_run_ras_sm:changing to CCH323_RAS_STATE_IDLE state20:58:59:cch323_percall_ras_sm:received event CCH323_RAS_EVENT_NEWCALL while at CCH323_RAS_STATE_IDLE state20:58:59:cch323_percall_ras_sm:changing to new state CCH323_RAS_STATE_ARQcch323_ras_receiver:received msg of type ACF_CHOSEN20:58:59:cch323_percall_ras_sm:received event CCH323_RAS_EVENT_ACF while atCCH323_RAS_STATE_ARQ state20:58:59:cch323_percall_ras_sm:changing to new stateCCH323_RAS_STATE_ACTIVE20:59:02:cch323_percall_ras_sm:received event CCH323_RAS_EVENT_CALLDISC whileat CCH323_RAS_STATE_ACTIVE state20:59:02:cch323_percall_ras_sm:changing to new state CCH323_RAS_STATE_DRQcch323_ras_receiver:received msg of type DCF_CHOSEN20:59:02:cch323_percall_ras_sm:received event CCH323_RAS_EVENT_DCF while atCCH323_RAS_STATE_DRQ state20:59:02:cch323_percall_ras_sm:changing to new state CCH323_RAS_STATE_IDLE20:59:04:cch323_percall_ras_sm:received event CCH323_RAS_EVENT_IRR while atCCH323_RAS_STATE_ACTIVE state20:59:04:cch323_percall_ras_sm:changing to new stateCCH323_RAS_STATE_ACTIVEdebug h225
Use the debug h225 command to display additional information about the actual contents of H.225 RAS messages. Use the no form of this command to disable debug output.
debug h225 {asn1 | events}
no debug voip aaaSyntax Description
Default
Disabled
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3(6)NA2.
This command was implemented on the Cisco AS5850 in the Cisco IOS Release 12.2(2)XB1.
This command was integrated into Cisco IOS Release 12.2(11)T.
Both versions of the debug H225 command display information about H.225 messages. H.225 messages are used to exchange RAS information between gateways and gatekeepers as well as to exchange Q.931 information between gateways.
The debug h225 events command displays key Q.931 events that occur when placing a H.323 call from one gateway to another. Q.931 events are carried in H.225 messages. This command enables you to monitor Q.931 state changes such as setup, alert, connected, and released.
Note
The debug h225 asn1command displays the ASN.1 contents of any H.225 message sent or received that contains ASN.1 content. Not all H.225 messages contain ASN.1 content. Some messages contain both Q.931 information and ASN.1 information; if you enter this command, only ASN.1 information will be displayed.
Sample Output
The following sample output for the debug h225 events command shows a call being placed from gateway GW13 to gateway GW14. Before the call was placed, the gateway exchanged RAS messages with the gatekeeper. Because RAS messages do not contain Q.931 information, these messages do not appear in this output.
3640GW.13# debug h225 eventsH.225 Event Messages debugging is on3640GW.13#*Mar 2 02:47:14.689: H225Lib::h225TConn:connect in progress on socket [2]*Mar 2 02:47:14.689: H225Lib::h225TConn:Q.931 Call State is initialized to be [Null].*Mar 2 02:47:14.697:Hex representation of the SETUP TPKT to send.0300004D080200DC05040380C0A36C0991313323313333303070099131342331343330307E00260500 80060008914A000102004B1F5E5D8990006C0000000005BF7454000C0700000000000000*Mar 2 02:47:14.701:*Mar 2 02:47:14.701: H225Lib::h225SetupRequest:Q.931 SETUP sent from socket [2]*Mar 2 02:47:14.701: H225Lib::h225SetupRequest:Q.931 Call State changed to [Call Initiated].*Mar 2 02:47:14.729:Hex representation of the received TPKT03000021080280DC013401017E0012050340060008914A000100000109350E2B28*Mar 2 02:47:14.729:*Mar 2 02:47:14.729: H225Lib::h225RecvData:Q.931 ALERTING received from socket [2]*Mar 2 02:47:14.729: H225Lib::h225RecvData:Q.931 Call State changed to [Call Delivered].*Mar 2 02:47:17.565:Hex representation of the received TPKT03000034080280DC07040380C0A37E0023050240060008914A0001000109350E2B2802004B1F5E5D899 0006C0000000005BF7454*Mar 2 02:47:17.569:*Mar 2 02:47:17.569: H225Lib::h225RecvData:Q.931 CONNECT received from socket [2]*Mar 2 02:47:17.569: H225Lib::h225RecvData:Q.931 Call State changed to [Active].*Mar 2 02:47:23.273:Hex representation of the received TPKT0300001A080280DC5A080280107E000A050500060008914A0001*Mar 2 02:47:23.273:*Mar 2 02:47:23.273: H225Lib::h225RecvData:Q.931 RELEASE COMPLETE received from socket [2]*Mar 2 02:47:23.273: H225Lib::h225RecvData:Q.931 Call State changed to [Null].*Mar 2 02:47:23.293:Hex representation of the RELEASE COMPLETE TPKT to send.0300001A080200DC5A080280107E000A050500060008914A0001*Mar 2 02:47:23.293:*Mar 2 02:47:23.293: H225Lib::h225TerminateRequest:Q.931 RELEASE COMPLETE sent from socket [2]. Call state changed to [Null].*Mar 2 02:47:23.293: H225Lib::h225TClose:TCP connection from socket [2] closedThe following output shows the same call being placed from gateway GW13 to gateway GW14 using the debug h225 asn1 command. The output is very long but you can track the following information:
•
•
•
•
•
•
•
•
•
3640GW.13# debug h225 asn1H.225 ASN1 Messages debugging is on3640GW.13#value RasMessage ::= admissionRequest :*Mar 2 02:48:18.445: {*Mar 2 02:48:18.445: requestSeqNum 03320,*Mar 2 02:48:18.445: callType pointToPoint :NULL,*Mar 2 02:48:18.445: callModel direct :NULL,*Mar 2 02:48:18.445: endpointIdentifier "60D6BA4C00000001",*Mar 2 02:48:18.445: destinationInfo*Mar 2 02:48:18.445: {*Mar 2 02:48:18.445: e164 :"14#14300"*Mar 2 02:48:18.445: },*Mar 2 02:48:18.449: srcInfo*Mar 2 02:48:18.449: {*Mar 2 02:48:18.449: e164 :"13#13300"*Mar 2 02:48:18.449: },*Mar 2 02:48:18.449: bandWidth 0640,*Mar 2 02:48:18.449: callReferenceValue 0224,*Mar 2 02:48:18.449: conferenceID '4B1F5E5D899000720000000005C067A4'H,*Mar 2 02:48:18.449: activeMC FALSE,*Mar 2 02:48:18.449: answerCall FALSE*Mar 2 02:48:18.449: }*Mar 2 02:48:18.449:25800CF7 00F00036 00300044 00360042 00410034 00430030 00300030 0030003000300030 00310103 80470476 33010380 46046633 40028000 E04B1F5E 5D89900072000000 0005C067 A40029000CF7 40028000 0109350E 06B80077value RasMessage ::= admissionConfirm :*Mar 2 02:48:18.469: {*Mar 2 02:48:18.469: requestSeqNum 03320,*Mar 2 02:48:18.469: bandWidth 0640,*Mar 2 02:48:18.469: callModel direct :NULL,*Mar 2 02:48:18.469: destCallSignalAddress ipAddress :*Mar 2 02:48:18.469: {*Mar 2 02:48:18.469: ip '0109350E'H,*Mar 2 02:48:18.469: port 01720*Mar 2 02:48:18.469: },*Mar 2 02:48:18.469: irrFrequency 0120*Mar 2 02:48:18.473: }*Mar 2 02:48:18.473:value H323-UserInformation ::=*Mar 2 02:48:18.481:{*Mar 2 02:48:18.481: h323-uu-pdu*Mar 2 02:48:18.481: {*Mar 2 02:48:18.481: h323-message-body setup :*Mar 2 02:48:18.481: {*Mar 2 02:48:18.481: protocolIdentifier { 0 0 8 2250 0 1 },*Mar 2 02:48:18.481: sourceInfo*Mar 2 02:48:18.481: {*Mar 2 02:48:18.481: terminal*Mar 2 02:48:18.481: {*Mar 2 02:48:18.481: },*Mar 2 02:48:18.481: mc FALSE,*Mar 2 02:48:18.481: undefinedNode FALSE*Mar 2 02:48:18.481: },*Mar 2 02:48:18.481: activeMC FALSE,*Mar 2 02:48:18.481: conferenceID '4B1F5E5D899000720000000005C067A4'H,*Mar 2 02:48:18.481: conferenceGoal create :NULL,*Mar 2 02:48:18.485: callType pointToPoint :NULL,*Mar 2 02:48:18.485: sourceCallSignalAddress ipAddress :*Mar 2 02:48:18.485: {*Mar 2 02:48:18.485: ip '00000000'H,*Mar 2 02:48:18.485: port 00*Mar 2 02:48:18.485: }*Mar 2 02:48:18.485: }*Mar 2 02:48:18.485: }*Mar 2 02:48:18.485:}*Mar 2 02:48:18.485:00800600 08914A00 0102004B 1F5E5D89 90007200 00000005 C067A400 0C07000000000000 00value H323-UserInformation ::=*Mar 2 02:48:18.525:{*Mar 2 02:48:18.525: h323-uu-pdu*Mar 2 02:48:18.525: {*Mar 2 02:48:18.525: h323-message-body alerting :*Mar 2 02:48:18.525: {*Mar 2 02:48:18.525: protocolIdentifier { 0 0 8 2250 0 1 },*Mar 2 02:48:18.525: destinationInfo*Mar 2 02:48:18.525: {*Mar 2 02:48:18.525: mc FALSE,*Mar 2 02:48:18.525: undefinedNode FALSE*Mar 2 02:48:18.525: },*Mar 2 02:48:18.525: h245Address ipAddress :*Mar 2 02:48:18.525: {*Mar 2 02:48:18.525: ip '0109350E'H,*Mar 2 02:48:18.525: port 011050*Mar 2 02:48:18.525: }*Mar 2 02:48:18.525: }*Mar 2 02:48:18.525: }*Mar 2 02:48:18.525:}*Mar 2 02:48:18.525:value H323-UserInformation ::=*Mar 2 02:48:22.753:{*Mar 2 02:48:22.753: h323-uu-pdu*Mar 2 02:48:22.753: {*Mar 2 02:48:22.753: h323-message-body connect :*Mar 2 02:48:22.753: {*Mar 2 02:48:22.753: protocolIdentifier { 0 0 8 2250 0 1 },*Mar 2 02:48:22.753: h245Address ipAddress :*Mar 2 02:48:22.753: {*Mar 2 02:48:22.753: ip '0109350E'H,*Mar 2 02:48:22.753: port 011050*Mar 2 02:48:22.753: },*Mar 2 02:48:22.753: destinationInfo*Mar 2 02:48:22.753: {*Mar 2 02:48:22.753: terminal*Mar 2 02:48:22.753: {*Mar 2 02:48:22.753: },*Mar 2 02:48:22.757: mc FALSE,*Mar 2 02:48:22.757: undefinedNode FALSE*Mar 2 02:48:22.757: },*Mar 2 02:48:22.757: conferenceID '4B1F5E5D899000720000000005C067A4'H*Mar 2 02:48:22.757: }*Mar 2 02:48:22.757: }*Mar 2 02:48:22.757:}*Mar 2 02:48:22.757:value H323-UserInformation ::=*Mar 2 02:48:27.109:{*Mar 2 02:48:27.109: h323-uu-pdu*Mar 2 02:48:27.109: {*Mar 2 02:48:27.109: h323-message-body releaseComplete :*Mar 2 02:48:27.109: {*Mar 2 02:48:27.109: protocolIdentifier { 0 0 8 2250 0 1 }*Mar 2 02:48:27.109: }*Mar 2 02:48:27.109: }*Mar 2 02:48:27.109:}*Mar 2 02:48:27.109:value RasMessage ::= disengageRequest :*Mar 2 02:48:27.117: {*Mar 2 02:48:27.117: requestSeqNum 03321,*Mar 2 02:48:27.117: endpointIdentifier "60D6BA4C00000001",*Mar 2 02:48:27.117: conferenceID '4B1F5E5D899000720000000005C067A4'H,*Mar 2 02:48:27.121: callReferenceValue 0224,*Mar 2 02:48:27.121: disengageReason normalDrop :NULL*Mar 2 02:48:27.121: }*Mar 2 02:48:27.121:3C0CF81E 00360030 00440036 00420041 00340043 00300030 00300030 0030003000300031 4B1F5E5D 89900072 00000000 05C067A4 00E020400CF8value RasMessage ::= disengageConfirm :*Mar 2 02:48:27.133: {*Mar 2 02:48:27.133: requestSeqNum 03321*Mar 2 02:48:27.133: }*Mar 2 02:48:27.133:value H323-UserInformation ::=*Mar 2 02:48:27.133:{*Mar 2 02:48:27.133: h323-uu-pdu*Mar 2 02:48:27.133: {*Mar 2 02:48:27.133: h323-message-body releaseComplete :*Mar 2 02:48:27.133: {*Mar 2 02:48:27.133: protocolIdentifier { 0 0 8 2250 0 1 }*Mar 2 02:48:27.133: }*Mar 2 02:48:27.133: }*Mar 2 02:48:27.133:}*Mar 2 02:48:27.133:05000600 08914A00 01.debug ras
Use the debug voip ccapi command to display the types and addressing of RAS messages sent and received. The debug output lists the message type using mnemonics defined in ITU-T specification H.225. Use the no form of this command to disable debug output.
debug ras
no debug rasSyntax Description
This command has no keywords or arguments.
Default
Disabled
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3(6)NA2.
This command was implemented on the Cisco AS5850 in the Cisco IOS Release 12.2(2)XB1.
This command was integrated into Cisco IOS Release 12.2(11)T.
Use the debug ras command to display the types and addressing of RAS messages sent and received. The debug output lists the message type using mnemonics defined in ITU-T specification H.225.
Sample Output
In the following output, gateway GW13.cisco.com sends a RAS registration request message (RRQ) to gatekeeper GK15.cisco.com at IP address 172.9.53.15. GW13.cisco.com then receives a registration confirmation (RCF) message from the gatekeeper. If there is no response, it could mean that the gatekeeper is offline or improperly addressed. If you receive a reject message (RRJ), it could mean that the gatekeeper is unable to handle another gateway or that the registration information is incorrect.
3640GW.13#debug ras*Mar 13 19:53:34.231: RASlib::ras_sendto:msg length 105 from172.9.53.13:8658 to 1.9.53.15:1719*Mar 13 19:53:34.231: RASLib::RASSendRRQ:RRQ (seq# 36939) sentto 172.9.53.15*Mar 13 19:53:34.247: RASLib::RASRecvData:successfully rcvdmessage of length 105 from 172.9.53.15:1719*Mar 13 19:53:34.251: RASLib::RASRecvData:RCF (seq# 36939) rcvdfrom [172.9.53.15:1719] on sock [0x6168356Cdebug voip aaa
The debug voip aaa command is used to enable or disable debugging messages for gateway aaa to be output to the system console.
debug voip aaa
no debug voip aaa
Syntax Description
This command has no keywords or arguments.
Command Mode
global exec
Default
Disabled
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3(6)NA2.
This command was implemented on the Cisco AS5850 in the Cisco IOS Release 12.2(2)XB.
This command was integrated into Cisco IOS Release 12.2(11)T.
debug voip ccapi
The debug voip ccapi command is used for debugging the call control API.
debug voip ccapi
no debug voip ccapi
Syntax Description
This command has no keywords or arguments.
Default
Disabled
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3(6)NA2.
This command was implemented on the Cisco AS5850 in the Cisco IOS Release 12.2(2)XB1.
This command was integrated into Cisco IOS Release 12.2(11)T.
Sample Output
sblab160#show debugvoip:voip ccAPI function enter/exit debugging is onOct 9 17:39:20.267:cc_api_call_setup_ind (vdbPtr=0x60ED5134,callInfo={called=3001, calling=4004, fdest=0 peer_tag=1},callID=0x6104B374)Oct 9 17:39:20.275:cc_process_call_setup_ind (event=0x60D45CF0) handedcall to app "sess"Oct 9 17:39:20.279:ccAppInitialize (name=App for callId 3, appHandle=0x6103DD44)Oct 9 17:39:20.279:ccCallSetContext (callID=0x3, context=0x6103DD3C)Oct 9 17:39:20.279:ccCallSetupAck (callID=0x3)Oct 9 17:39:20.279:ccGenerateTone (callID=0x3 tone=8)Oct 9 17:39:20.279:ccCallApp (callID=0x3)Oct 9 17:39:20.279:ccCallSetContext (callID=0x3, context=0x60DC4594)00:11:31:%RADIUS-6-SERVERALIVE:Radius server 171.69.184.73 isrespondingagain (previously dead).Oct 9 17:39:22.808:cc_api_call_digit (vdbPtr=0x60ED5134, callID=0x3,digit=1, mode=0)Oct 9 17:39:23.069:cc_api_call_digit (vdbPtr=0x60ED5134, callID=0x3,digit=1, mode=0)Oct 9 17:39:23.399:cc_api_call_digit (vdbPtr=0x60ED5134, callID=0x3,digit=5, mode=0)Oct 9 17:39:23.652:cc_api_call_digit (vdbPtr=0x60ED5134, callID=0x3,digit=1, mode=0)Oct 9 17:39:24.041:cc_api_call_digit (vdbPtr=0x60ED5134, callID=0x3,digit=0, mode=0)Oct 9 17:39:24.294:cc_api_call_digit (vdbPtr=0x60ED5134, callID=0x3,digit=0, mode=0)Oct 9 17:39:24.294:ccCallAppReturn (callID=0x3)Oct 9 17:39:24.294:ccCallApp (callID=0x3)Oct 9 17:39:24.294:ccCallSetContext (callID=0x3, context=0x6105DC90)Oct 9 17:39:24.294:ccCallProceeding (callID=0x3, prog_ind=0x0)Oct 9 17:39:24.294:ccCallSetupRequest (peer=0x60FE4068, dest=,params=0x6105DB70 mode=0, *callID=0x60D50978)Oct 9 17:39:24.294:callingNumber=4004, calledNumber=115100,redirectNumber=Oct 9 17:39:24.294:accountNumber=, finalDestFlag=0,guid=3c85.5d28.2861.0004.0000.0000.000a.8dfcOct 9 17:39:24.294:peer_tag=115Oct 9 17:39:24.294:ccIFCallSetupRequest:(vdbPtr=0x60D4A268, dest=,callParams={called=115100, calling=4004, fdest=0, voice_peer_tag=115},mode=0x0)Oct 9 17:39:24.294:ccCallSetContext (callID=0x4, context=0x6105DD78)Oct 9 17:39:26.350:cc_api_call_alert(vdbPtr=0x60D4A268, callID=0x4,prog_ind=0x8, sig_ind=0x0)Oct 9 17:39:26.350:ccCallAlert (callID=0x3, prog_ind=0x8, sig_ind=0x0)Oct 9 17:39:26.350:ccConferenceCreate (confID=0x60D509C8, callID1=0x3,callID2=0x4, tag=0x0)Oct 9 17:39:26.350:cc_api_bridge_done (confID=0x1, srcIF=0x60D4A268,srcCallID=0x4, dstCallID=0x3, disposition=0, tag=0x0)Oct 9 17:39:26.350:cc_api_bridge_done (confID=0x1, srcIF=0x60ED5134,srcCallID=0x3, dstCallID=0x4, disposition=0, tag=0x0)Oct 9 17:39:26.350:cc_api_caps_ind (dstVdbPtr=0x60D4A268,dstCallId=0x4,srcCallId=0x3, caps={codec=0x7, fax_rate=0x7F, vad=0x3})Oct 9 17:39:26.350:cc_api_caps_ind (dstVdbPtr=0x60ED5134,dstCallId=0x3,srcCallId=0x4, caps={codec=0x4, fax_rate=0x2, vad=0x2})Oct 9 17:39:26.350:cc_api_caps_ack (dstVdbPtr=0x60ED5134,dstCallId=0x3,srcCallId=0x4, caps={codec=0x4, fax_rate=0x2, vad=0x2})Oct 9 17:39:26.350:cc_api_caps_ack (dstVdbPtr=0x60D4A268,dstCallId=0x4,srcCallId=0x3, caps={codec=0x4, fax_rate=0x2, vad=0x2})Oct 9 17:39:26.430:cc_api_call_connected(vdbPtr=0x60D4A268,callID=0x4)Oct 9 17:39:26.430:ccCallConnect (callID=0x3)Oct 9 17:39:26.430:ccCallAppReturn (callID=0x3)Oct 9 17:39:26.430:ccCallSetContext (callID=0x4, context=0x6103DD3C)Oct 9 17:39:30.683:cc_api_call_disconnected(vdbPtr=0x60D4A268,callID=0x4, cause=0x10)Oct 9 17:39:30.683:ccCallDisconnect (callID=0x4, cause=0x10 tag=0x0)Oct 9 17:39:30.683:ccConferenceDestroy (confID=0x1, tag=0x0)Oct 9 17:39:30.687:cc_api_bridge_done (confID=0x1, srcIF=0x60D4A268,srcCallID=0x4, dstCallID=0x3, disposition=0 tag=0x0)Oct 9 17:39:30.727:cc_api_call_disconnect_done(vdbPtr=0x60D4A268,callID=0x4, disp=0, tag=0x0)Oct 9 17:39:30.727:cc_api_bridge_done (confID=0x1, srcIF=0x60ED5134,srcCallID=0x3, dstCallID=0x4, disposition=0 tag=0x0)Oct 9 17:39:30.727:ccCallDisconnect (callID=0x3, cause=0x10 tag=0x0)Oct 9 17:39:30.779:cc_api_call_disconnect_done(vdbPtr=0x60ED5134,callID=0x3, disp=0, tag=0x0)00:11:42:%LINK-3-UPDOWN:Interface Serial0:18, changed state to downdebug voip ivr
The debug voip ivr command is used to debug the IVR application. IVR debug messages will be displayed when a call is being actively handled by the IVR scripts. Error output should only occur if something is not working or an error condition has been raised. States output supplies information about the current status of the IVR script and the different events which are occurring in that state.
debug voip ivr [states | error | all]
no debug voip ivr [states | error | all]
Syntax Description
This command has no keywords or arguments.
Default
Disabled
Command Mode
Privileged EXEC
Usage Guidelines
This command first appeared in Cisco IOS Release 11.3(6)NA2.
This command was implemented on the Cisco AS5850 in the Cisco IOS Release 12.2(2)XB1.
This command was integrated into Cisco IOS Release 12.2(11)T.
There are two types of messages:
•
•
Posted: Tue Jun 5 22:47:18 PDT 2007
All contents are Copyright © 1992--2007 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.
