|
|
This feature module describes the Cisco H.323 Voice over IP (VoIP) architecture combined with SS7 signaling functionality for the Cisco AS5300. It includes information on the benefits of the new feature, supported platforms, related documents, and more.
This document includes the following sections:
The Cisco H.323 VoIP with SS7 feature provides SS7 connectivity for voice gateways by using the signaling controller as a protocol translator to control the gateway using the ISDN Q.931 protocol. This feature interacts over the IP network with other Cisco H.323 VoIP with SS7 solutions functioning as an end-to-end SS7 voice network. In addition, it can communicate with other H.323 endpoints, including gateways using non-SS7 signaling such as ISDN PRI and channelized T1.
The access gateway terminates the PSTN trunks, also referred to as bearer channels, that carry the call traffic. The PSTN trunks terminate into either T1 or E1 PRI interfaces on the gateway. In addition, the access gateway performs call control (including originating and terminating call processing/signaling). The gateway referred to in this document is the Cisco AS5300.
 |
Note Some product labels and packaging might use the term telephony controller. Any references to the telephony controller apply to the signaling controller. |
The following enhancements to dial peer configuration lower complexity of dial planning and reduces the amount of effort in creating dial peer entries:
| Symbol | Description | Regular Expression/ Dial Peer |
|---|---|---|
| % | Indicates a previous digit/pattern occurred zero or multiple times; similar to a wild card "*" used in a regular expression rule. | Yes / Yes |
| + | Indicates a sequence one or more matches of the pattern. | Yes / Yes1 |
| ? | Indicates a pattern followed by "?" matching zero or one time. | Yes / Yes |
| . | Indicates a single character. | Yes / Yes |
| [ ] | Indicates a range. A range is a sequence of characters enclosed in "[ ]" and only numeric characters "0" - "9" is allowed in the range; similar to a regular expression rule. | Yes / Yes |
| ( ) | Indicates a pattern. | Yes / Yes |
Reduced Number of Dial Peers
Currently, dial peer configuration needs multiple dial peers to support a dialing plan. This feature reduces the amount of effort in producing dial peer entries, improves VoIP system performance significantly because of less dial peer search, and uses less memory.
Digit Manipulation
When a called number is received and matched to a POTS dial peer, the matched digits are stripped and the remaining digits are forwarded to the voice interface. A new command called the digit strip makes this default behavior an option. This means you can easily get caller ID and restriction information, and you also don't have to make long-distance calls between small, neighboring countries.
Configuring the Cisco AS5300 for Dial Access and Voice-over-IP
Cisco H.323 VoIP with SS7 Configuration Options and Components
This feature is supported on the following platform:
Standards
No new or modified standards are supported by this feature.
MIBs
No new or modified MIBs are supported by this feature.
For descriptions of supported MIBs and how to use MIBs, see the Cisco MIB web site on CCO at http://www.cisco.com/public/sw-center/netmgmt/cmtk/mibs.shtml.
RFCs
No new or modified RFCs are supported by this feature.
Before you can configure your platform to serve as an H.323 VoIP gateway, you must first:
To configure a Cisco AS5300 to perform as an H.323 VoIP gateway using RAS, perform the following tasks:
Numbering-type matching is used in dial-peer configuration mode to match on a number type for a dial peer call leg.
To configure numbering-type matching using the numbering-type command in dial-peer configuration mode, enter the following commands starting in global configuration mode:
| Step | Command | Purpose |
|---|---|---|
1. | Router# configure terminal | Enters global configuration mode. |
2. | Router(config)# dial-peer voice 100 pots | Enters the dial peer configuration mode to configure a VoIP or POTS peer. |
3. | Router(config-dial-peer)# numbering-type international | Specifies number type. Number types are:
|
When a called number is received and matched to a POTS dial peer, the matched digits are stripped and the remaining digits are forwarded to the voice interface. A new command called the digit strip option makes this behavior an option. Digit stripping is enabled by default.
To disable digit strip for a dial peer, enter the following commands in global configuration mode:
| Step | Command | Purpose | ||
|---|---|---|---|---|
1. | 5300(config)# dial-peer voice 100 pots 5300(config-dial-peer)# destination-pattern 525... 5300(config-dial-peer)# direct-inward dial 5300(config-dial-peer)# no digit strip 5300(config-dial-peer)# port0:D | Enters the dial peer configuration mode to configure a POTs peer.
| ||
2. | 5300(config-dial-peer)# no digit strip | Disables digit strip. |
A dial peer defines the characteristics associated with a call leg. Dial peers are used to apply attributes to call legs and to identify call origin and destination. Attributes applied to a call leg include QoS, codec, VAD, and fax rate. A call leg is a discrete segment of a call connection that lies between two points in the connection. All of the call legs for a particular connection have the same connection ID.
There are two different types of dial peers:
A POTS dial peer points to a voice-port on the router, and the destination of a VoIP dial peer points to the destination IP address of the voice-router that terminates the call.
Complete the following procedures to configure call legs using the translation-rule command:
 |
TimeSaver You should configure your translation rules before you apply rules to your dial peer call legs. |
| Step | Command | Purpose |
|---|---|---|
1. | 5300(config)# translation-rule 5 | Defines a translation-rule tag number and enters translation-rule configuration mode. All subsequent commands that you enter in this mode before you exit will apply to this translation-rule tag. |
2. | 5300(config-translate)# rule 1 213% 510 national international | Specifies translation rules. This command can be entered multiple times and is applied to the translation-rule defined in Step 1. |
|
Note Applying translation rules to more than one dial peer call leg in your end-to-end call is not recommended. |
Step 2 To apply a rule to an inbound POTS call leg, enter the following commands in global configuration mode:
| Step | Command | Purpose |
|---|---|---|
1. | Router(config)# voice-port 0:D | Specifies the voice port. |
2. | Router(config-voiceport)# translate called 5 | Specifies the translation tag for inbound called or calling number. |
Step 3 To apply a rule to an outbound VoIP call leg, enter the following commands in global configuration mode:
| Step | Command | Purpose |
|---|---|---|
1. | Router(config)# dial-peer voice 100 voip | Enters the dial-peer configuration mode to configure a VoIP peer. |
2. | Router(config-dial-peer)# session target ipv:10.1.2.2 | Specifies a destination IP address for this dial peer. |
3. | Router(config-voiceport)# translate-outgoing calling 5 | Translates outbound calling number. |
Step 4 To apply a rule to a VoIP call that originates from an H.323 node, enter the following global command:
|
Note There can only be one global voip-incoming translation-rule. |
| Step | Command | Purpose |
|---|---|---|
1. | Router(config)# voip-incoming translation-rule called 5 | Specifies the translation tag for the VoIP inbound call leg. |
Step 5 To apply a translation rule to an outbound POTS call leg, enter the following commands in global configuration mode:
| Step | Command | Purpose |
|---|---|---|
1. | Router(config)# dial-peer voice 100 pots | Enters the dial-peer configuration mode to configure a POTS dial peer. |
2. | Router(config-dial-peer)# port 0:D | Specifies the voice port. |
3. | Router(config-dial-peer)# translate-outgoing called 5 | Specifies the translation tag for inbound called or calling number. |
Step 6 Enter the test translation-rule command.
Router# test translation-rule translation-rule 21 Rule 1 527.% 1408527 subscriber international Rule 2 7.% 1408527 abbreviated international Router#test translation-rule 21 45678 abbreviated Router# *Jan 19 16:39:14.578:The replace number 45614085278 Router#
This section contains the following configuration examples:
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/0 operation 4-wire type 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 pots destination-pattern 13#13200 port 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 voip destination-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/0 ip address 172.9.53.13 255.255.255.0 h323-gateway voip interface h323-gateway voip id GK15.cisco.com ipaddr 172.9.53.15 1719 h323-gateway voip h323-id GW13@cisco.com h323-gateway voip tech-prefix 13# !
For RAS to work on an H.323 gateway, you need to configure a corresponding RAS gatekeeper. The following example shows a Cisco 3600 series router configured 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/0 ip 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 !
| Command | Purpose |
|---|---|
5300# show translation-rule name-tag | Displays information about the rules that have been configured for a specific translation name. |
This section documents new or modified commands. All other commands used with this feature are documented in the Cisco IOS Release 12.0 command reference publications.
In Cisco IOS Release 12.0(1)T or later, you can search and filter the output for show and more commands. This functionality is useful when you need to sort through large amounts of output, or if you want to exclude output that you do not need to see.
To use this functionality, enter a show or more command followed by the "pipe" character (|), one of the keywords begin, include, or exclude, and an expression that you want to search or filter on:
Following is an example of the show atm vc command in which you want the command output to begin with the first line where the expression "PeakRate" appears:
For more information on the search and filter functionality, refer to the Cisco IOS Release 12.0(1)T feature module titled CLI String Search.
To match on a number type for a dial peer call leg, use the numbering-type command.
numbering-type { international | abbreviated | national | network | reserved | subscriber | unknown }
Syntax Description
numbering-type Specifies number type for the VoIP or POTS dial peer. Number types are:
Command Modes
Dial peer configuration mode.
Command History
12.0(7)XR1 This command was introduced.
Release
Modification
Examples
The following example shows to configure the POTS dial peer for network usage:
5300(config)# dial-peer voice 100 pots 5300(config-dial-peer)# numbering-type network
Related Commands
show translation-rule Displays the contents of all the rules that have been configured for a specific translation name. test translation-rule Tests the execution of the translation rules on a specific name-tag. translation-rule Applies a translation rule to a calling party number or a called party number for both incoming and outgoing calls voip-incoming translation-rule Captures calls that originate from H.323-compatible clients.
Command
Description
To display the contents of all the rules that have been configured for a specific translation name, use the show translation-rule global configuration command.
show translation-rule { name-tag }
Syntax Description
name-tag The tag number by which the rule set will be referenced. This is an arbitrarily chosen number. Range is 1 through 2147483647.
Command Modes
Privileged EXEC.
Command History
12.0(7)XR1 This command was introduced.
Release
Modification
Usage Guidelines
This command gives detailed information about the configured rules under this rule name. If the name tag is not entered, a complete display of all the configured rules will be shown.
Examples
The following example shows output for the show translation-rule command:
Router# sh translation-rule
Translation rule address:0x61AB94F8
Tag name:21
Translation rule in_used 1
**** Xrule rule table *******
Rule :1
in_used state:1
Match pattern:527.%
Sub pattern:1408527
Match type:subscriber
Sub type:international
**** Xrule rule table *******
Rule :2
in_used state:1
Match pattern:8.%
Sub pattern:1408527
Match type:abbreviated
Sub type:international
Translation rule address:0x61C2E6D4
Tag name:345
Translation rule in_used 1
**** Xrule rule table *******
Rule :1
in_used state:1
Match pattern:.%527.%
Sub pattern:7
Match type:ANY
Sub type:abbreviated
Related Commands
numbering-type Specifies number type for the VoIP or POTS dial peer. test translation-rule Tests the execution of the translation rules on a specific name-tag. translation-rule Applies a translation rule to a calling party number or a called party number for both incoming and outgoing calls voip-incoming translation-rule Captures calls that originate from H.323-compatible clients.
Command
Description
To test the execution of the translation rules on a specific name tag, use the test translation-rule global configuration command. To disable, use the no form of this command.
test translation-rule name-tag input-number [ input-numbering-type ]
no test translation-rule name-tag input-number [ input-numbering-type ]
Syntax Description
name-tag The tag number by which the rule set will be referenced. This is an arbitrarily chosen number. Range is 1 through 2147483647. input-number The input string of digits for which a pattern matching is performed. input-numbering-type Optional command. The choices for this field are international, national, subscriber, abbreviated, unknown, and any.
Defaults
No default behavior or values.
Command Modes
Global configuration.
Command History
12.0(7)XR1 This command was introduced.
Release
Modification
Examples
The following example shows output for the test translation-rule command:
5300# translation-rule 21 Rule 1 527.% 1408527 subscriber international Rule 2 8.% 1408527 abbreviated international 5300# test translation-rule 21 45678 abbreviated 5300# *Jan 19 16:39:14.578:The replace number 45614085278 5300#
Related Commands
numbering-type Specifies number type for the VoIP or POTS dial peer. show translation-rule Displays the contents of all the rules that have been configured for a specific translation name. translation-rule Applies a translation rule to a calling party number or a called party number for both incoming and outgoing calls voip-incoming translation-rule Captures calls that originate from H.323-compatible clients.
Command
Description
To apply a translation rule to a calling party number or a called party number for both incoming and outgoing calls, use the translation-rule global configuration command. To disable, use the no form of this command.
Syntax Description
name-tag The tag number by which the rule set will be referenced. This is an arbitrarily chosen number. Range is 1 through 2147483647. precedence The order in which the rules are to be applied and executed. Range 1 through 10. input-searched-pattern The input string of digits for which a pattern matching is performed. substituted-pattern The replacement digit string that results after a pattern matching is performed. Regular expressions are used to carry out this process. match-type Optional command. The choices for this field are international, national, subscriber, abbreviated, unknown, and any. substituted-type Optional command. The choices for this field are international, national, subscriber, abbreviated, and unknown.
Defaults
No default behavior or values.
Command Modes
Global configuration.
Command History
12.0(7)XR1 This command was introduced.
Release
Modification
Usage Guidelines
When configuring your dial peers, you are provided with an option called the translation rule. This rule applies a translation rule to a calling party number [Automatic Number Identification (ANI)] or a called party number [Dial Number Information Service (DNIS)] for both incoming and outgoing calls within Cisco H.323 voice-enabled gateways. Also, the rule allows translation of the type of number.
Examples
The following example applies a translation-rule. If a called number starts with 5272205 or 72205, then the translation-rule 21 will use the rule command to forward the number to 14085272205 instead.
5300(config)# translation-rule 21 5300(translation-rule)# rule 1 527.% 1408527 subscriber international 5300(translation-rule)# rule 2 8.% 1408527 abbreviated international
In the next example, if a called number is either 14085272205 or 014085272205, then after the execution of the translation-rule 345, the forwarding digits will be 72205. If the match-type is configured and the type is not "unknown," then the dial peer matching will be required to match input string numbering type.
5300(config)# translation-rule 345 5300(translation-rule)# rule 1 .%527.% 7 any abbreviated
Related Commands
numbering-type Specifies number type for the VoIP or POTS dial peer. show translation-rule Displays the contents of all the rules that have been configured for a specific translation name. test translation-rule Tests the execution of the translation rules on a specific name-tag. voip-incoming translation-rule Captures calls that originate from H.323-compatible clients.
Command
Description
For calls that originate from H.323-compatible clients, use the voip-incoming translation-rule global configuration command. To disable, use the no form of this command.
voip-incoming translation-rule name-tag { calling-number | called-number }
no voip-incoming translation-rule name-tag { calling-number | called-number }
Syntax Description
name-tag The tag number by which the rule set will be referenced. This is an arbitrarily chosen number. Range is 1 through 2147483647. calling-number The ANI number, or the number of the calling party. called-number The DNIS (Dial Number Information Service) number, or the number of the called party.
Defaults
No default behavior or values.
Command Modes
Global configuration.
Command History
12.0(7)XR1 This command was introduced.
Release
Modification
Usage Guidelines
With this command, all IP-based calls will be captured and handled, depending on either the calling or called number to the specified tag-name.
Examples
The following example identifies the rule set for calls that originate from H.323-compatible clients:
5300(config)# voip-incoming translation-rule 5 called
Related Commands
numbering-type Specifies number type for the VoIP or POTS dial peer. show translation-rule Displays the contents of all the rules that have been configured for a specific translation name. test translation-rule Tests the execution of the translation rules on a specific name-tag. translation-rule Applies a translation rule to a calling party number or a called party number for both incoming and outgoing calls
Command
Description
There are no new or modified debug commands for this feature.
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 Application Programming Interface
CLI---Command Language Interpreter. The basic Cisco IOS configuration and management interface.
dial peer---An addressable call endpoint. In Voice over IP (VoIP), 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.
endpoint---An 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 an H.323 entity on the LAN that provides address translation and controls 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.
IVR---Integrated voice response. When someone dials in, it responds with a prompt to get a personal identification number (PIN), and so on.
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.
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.
SS7---Signaling System #7
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.
Posted: Fri Jan 21 14:07:49 PST 2000
Copyright 1989 - 2000©Cisco Systems Inc.