Feedback
|
Table Of Contents
Understanding the H.248 Feature
Supported Standards, MIBs, and RFCs
Prerequisites for Using this Feature
Installation, Upgrade, and Fallback Procedures
XECfgParm.dat Configuration Examples
H.248 Sigpath Based on UDP Transport
H.248 Sigpath Based on SCTP Transport
For OC3 without Descriptive Text
For STM without Descriptive Text
For T1 without Descriptive Text
For T3 without Descriptive Text
PROV-ADD:H248PATH:NAME—Provision H.248 Signaling Protocol Service (Release 9.7(3))
RTRV-H248:CNTXS:SIGPATH—Retrieve H.248 Sigpath Information (Release 9.7(3))
STA-AUD-H248—Start Audit of H.248 Gateway (Release 9.7(3))
PROV-ADD:IPLNK—Provision H.248 Transport Protocol as UDP (Release 9.7(3))
PROV-ADD:ASSOCIATION—Provision H.248 Transport Protocol as SCTP (Release 9.7(3))
Software Changes for This Feature
OLC: Leg1UnexpectedEventDetected
TLC: Leg1UnexpectedEventDetected
Ingress Packet Information (Tag: 4046)
Egress Packet Information (Tag: 4047)
Ingress Protocol ID (Tag: 4069)
Ingress MGCP DLCX Return Code (Tag: 4087)
Egress MGCP DLCX Return Code (Tag: 4088)
MGCP Script Response String (Tag: 4097)
Originating Leg DSP Statistics (Tag: 4098)
Terminating Leg DSP Statistics (Tag: 4099)
Obtaining Documentation, Obtaining Support, and Security Guidelines
H.248 Protocol
Document Release History
Feature History
This document describes the H.248 feature in the following sections:
•
Understanding the H.248 Feature
•
Installation, Upgrade, and Fallback Procedures
•
XECfgParm.dat Configuration Examples
•
Software Changes for This Feature
•
Obtaining Documentation, Obtaining Support, and Security Guidelines
Understanding the H.248 Feature
The H.248 feature provides a gateway control interface between the PGW 2200 and the VXSM gateways. It supplements the MGCP protocol. This new interface is based on the ITU-SG16/IETF specification of H.248 which defines a decomposed gateway architecture.
This architecture is composed of
•
A media gateway controller (MGC) and the media gateways (MGs)
•
Distributed call control functionality between an MGC (an intelligent entity that manages the establishment and tearing down of calls) and an MG(a simple entity that responds to the MGC requests and independently processes media streams)
System Overview
An H.248 trunking gateway is a PSTN-IP telephony gateway. It interfaces with both the IP telephony network and the PSTN network by passing voice traffic from one network to the other. For the SS7 configuration, signaling bypasses the trunking gateway and directly terminates at the MGC.
Although H.248 is designed to be generic in its support for many different kinds of media, the PGW is mainly designed to act as an MGC and only interwork with trunking gateways. This feature addresses only the functionality of the interworking of the PGW with trunking gateways. Figure 1 shows an overview of this system.
Figure 1 H.248 Protocol in the SS7 Network
Benefits
The following are benefits of this feature:
•
PGW supports H.248 communicating with media gateways.
•
PGW supports H.248 capabilities and procedures as specified in H.248.1 Gateway control protocol: Version 2.
•
PGW supports interworking between the H.248 trunk and the MGCP trunk, SIP trunking, H.323 trunking, ISDN, QSIG, and DPNSS.
•
PGW supports the use of H.248 and MGCP at the same time, that is, one gateway uses H.248 while another gateway uses MGCP. sigPath property GWProtocolVersion decides whether H.248 protocol or MGCP protocol is used.
Restrictions
The following are restrictions for this feature:
•
The number of media gateways (MGs) that can be provisioned on one PGW depends on the platform capability.
•
Up to two terminations can be included in one context, and at least one termination is a physical termination.
•
PGW supports encoding and decoding of messages only in text format.
•
PGW supports sending a message using only a short token.
•
Each message can include only one transaction.
•
PGW does not support a seamless upgrade from MGCP mode to H.248 mode on the same VXSM card.
Supported Standards, MIBs, and RFCs
Standards
This feature supports the following standards:
•
ITU-T H.248.1 Gateway control protocol: Version 2
•
ITU-T H.248.2 Facsimile, Text Conversation, and Call Discrimination packages
•
TU-T H.248.4 Transport over Stream Control Transmission Protocol (SCTP)
•
ITU-T H.248.8 Error codes and service change reason description
•
TU-T H.248.10 Media gateway resource congestion handling package
•
ITU-T H.248.14 Inactivity timer package
MIBs
No new or modified MIBs are supported by this feature.
For more information on the MIBs used in the Cisco MGC software, see the Cisco Media Gateway Controller Software Release 9 Management Information Base Guide at
http://www.cisco.com/iam/PGW_MIBS/index.html
RFCs
This feature supports RFC 2327 SDP: Session Description Protocol, April 1998.
Supported Platforms
The hardware platforms supported for the Cisco MGC software are described in the Cisco Media Gateway Controller Hardware Installation Guide at
http://www.cisco.com/en/US/partner/docs/voice_ip_comm/pgw/9/installation/hardware/hrdwrnst.html
Prerequisites for Using this Feature
The Cisco PGW 2200 must be running Cisco MGC software Release 9.7(3). Prerequisites for this release can be found in the Release Notes for the Cisco Media Gateway Controller Software Release 9.7(3) at
http://www.cisco.com/en/US/partner/docs/voice_ip_comm/pgw/9/release/note/rn973.html
Installation, Upgrade, and Fallback Procedures
Because the VXSM card does not support a seamless gateway upgrade from MGCP mode to H.248 mode on the same card, changing the operation mode on the same gateway can affect service. Follow these steps to change the mode.
PGW side:
1.
Delete the current mgcppath and switchtrnk provisioned for this gateway.
2.
Provision h248path and switchtrnk for this gateway.
VXSM side:
1.
Clear the VXSM card's current configuration.
2.
Configure it into H.248 mode, and various other configurations on the card.
After this, the gateway is ready to work under H.248 mode.
Related Documents
This document contains information that is related to this feature. The documents that contain additional information related to the Cisco Media Gateway Controller (MGC) are at
http://www.cisco.com/en/US/products/hw/vcallcon/ps2027/tsd_products_support_series_home.html
XECfgParm.dat Configuration Examples
Here is an example for H.248 related parameters configuration in XECfgParm.dat.
H248.maxNumH248Links = 500H248.maximumActionsInTransaction=64H248.localMID = cisco.comH248.MgcHeaderAddrType = 2Provisioning Examples
Here are some provisioning examples for this H.248 feature.
H.248 Sigpath Based on UDP Transport
prov-add:EXTNODE:NAME="h248-VXSM-01",DESC="VXSM-01",TYPE="VXSM"prov-add:H248PATH:NAME="h248-sigpath-UDP",DESC="Service to H248",EXTNODE=" h248-VXSM-01"prov-add:IPLNK:NAME="h248-udp-link-1",DESC="UDP link to h248-sigpath-UDP", SVC="h248-sigpath-UDP",IPAddr="IP_Addr1",PORT=2944,PEERADDR="10.74.57.205",PEERPORT=2944,PRI=1
Note
Unlike MGCP, only one UDP link is allowed between PGW and media gateway for H.248 sigPath.
H.248 Sigpath Based on SCTP Transport
prov-add:EXTNODE:NAME="h248-VXSM-02",DESC="VXSM-02",TYPE="VXSM"prov-add:H248PATH:NAME="h248-sigpath-sctp",DESC="Service to H248",EXTNODE=" h248-VXSM-02"prov-add: iproute: name="iproute-h248-1", dest="10.0.0.3", netmask="255.255.255.0", ipaddr="IP_Addr1", nexthop="10.240.1.2",pri=1prov-add: iproute:name="iproute-h248-2", dest="10.0.0.3", netmask="255.255.255.0", ipaddr="IP_Addr2", nexthop="10.240.2.2",pri=2iproute1="iproute_h248_2" to iproute2="iproute_h248_2"Add SS7 Sigpath
prov-add:OPC:NAME="opc",DESC="Own Point Code",NETADDR="1.0.1",NETIND=2,TYPE="TRUEOPC"prov-add:DPC:NAME="sp1",DESC="SP1 Point Code",NETADDR="4.0.1",NETIND=2prov-add:DPC:NAME="sp2",DESC="SP2 Point Code",NETADDR="4.0.2",NETIND=2prov-add:SS7PATH:NAME="ss7svc1",DESC="SS7SigPathtoSP1",MDO="Q761_BASE", CUSTGRPID="1111", SIDE="network",DPC="sp1",OPC="opc",M3UAKEY=""prov-add:SS7PATH:NAME="ss7svc2",DESC="SS7SigPathtoSP2", MDO="Q761_BASE",CUSTGRPID="1111", SIDE="network",DPC="sp2",OPC="opc",M3UAKEY=""prov-add:LNKSET:NAME="lnkset1",DESC="LinkSet to SP1",APC="sp1",PROTO="SS7-ITU",TYPE="IP"prov-add:LNKSET:NAME="lnkset2",DESC="LinkSet to SP2",APC="sp2",PROTO="SS7-ITU",TYPE="IP"prov-add:SS7ROUTE:NAME="route1",DESC="Route to SP1", OPC="opc",DPC="sp1", LNKSET="lnkset1",PRI=1prov-add:SS7ROUTE:NAME="route2",DESC="Route to SP2", OPC="opc",DPC="sp2", LNKSET="lnkset2",PRI=1prov-add:EXTNODE:NAME="sh-2600-3",DESC="SLT-2600-3",TYPE="SLT",ISDNSIGTYPE="N/A"prov-add:SESSIONSET:NAME="c7-2600-3",EXTNODE="sh-2600-3",IPADDR1="IP_Addr1",PORT=7000, PEERADDR1="10.0.3.89", PEERPORT=7000,TYPE="BSMV0"prov-add:C7IPLNK:NAME="c7iplnk1-1",DESC="SS7Link1inLinkSet1",LNKSET="lnkset1",SLC=0,PRI=1, TIMESLOT=0,SESSIONSET="c7-2600-3"prov-add:C7IPLNK:NAME="c7iplnk2-1",DESC="SS7Link1inLinkSet2",LNKSET="lnkset2",SLC=0,PRI=1, TIMESLOT=1,SESSIONSET="c7-2600-3"Add Switchtrunk
prov-add:trnkgrp:name="1111",clli="NULL",svc="ss7svc1",type="TDM_ISUP"prov-ed:trnkgrpprop:name="1111",custgrpid="1111"For OC3 with Descriptive Text
prov-add:switchtrnk:name="1", trnkgrpnum="1111", span="ffff", cic=1, cu="h248-vxsm-01-1",spansize=15, endpoint="DS/OC3_1/T1_7/1"For OC3 without Descriptive Text
prov-add:switchtrnk:name="1", trnkgrpnum="1111", span="ffff", cic=1, cu="h248-vxsm-01-1",spansize=15, endpoint="DS/ 1/7/1"For STM with Descriptive Text
prov-add:switchtrnk:name="16", trnkgrpnum="1111", span="ffff", cic=16, cu="h248-vxsm-01-1",spansize=15, endpoint="DS/STM_1/T1_7/1"For STM without Descriptive Text
prov-add:switchtrnk:name="16", trnkgrpnum="1111", span="ffff", cic=16, cu="h248-vxsm-01-1",spansize=15, endpoint="DS/1/7/1"For T1 with Descriptive Text
prov-add:switchtrnk:name="62", trnkgrpnum="1111", span="ffff", cic=62, cu="h248-vxsm-01-1",spansize=15, endpoint="DS/T1_2/7"For T1 without Descriptive Text
prov-add:switchtrnk:name="62", trnkgrpnum="1111", span="ffff", cic=62, cu="h248-vxsm-01-1",spansize=15, endpoint="DS/2/7"For T3 with Descriptive Text
prov-add:switchtrnk:name="62", trnkgrpnum="1111", span="ffff", cic=62, cu="h248-vxsm-01-1",spansize=15, endpoint="DS/T3_1/T1_2/7"For T3 without Descriptive Text
prov-add:switchtrnk:name="62", trnkgrpnum="1111", span="ffff", cic=62, cu="h248-vxsm-01-1",spansize=15, endpoint="DS/1/2/7"Edit Properties
prov-ed:trnkgrpprop:name="1111",H248GatewayReserveValue="0"
Note
The property H248GatewayReserveValue is deleted in Release 9.7P23 and later.
prov-ed:sigsvcprop:name="h248-vxsm-01-1",GWProtocolVersion="H248 V2"prov-ed:sigsvcprop:name="h248-vxsm-01-1",h248DomainNameRemote="<VXSM.CISCO.COM>"prov-ed:sigsvcprop:name="h248-sigpath-01", h248inactivitytimer="1000"MML Command Reference
This section documents new, modified, or deleted Man-Machine Language (MML) commands. All other MML commands are documented in the Cisco Media Gateway Controller Software Release 9 MML Command Reference at
http://www.cisco.com/en/US/partner/docs/voice_ip_comm/pgw/9/command/reference/mmlref_1.html
New MML Commands
This section contains the MML commands that are new for this feature.
PROV-ADD:H248PATH:NAME—Provision H.248 Signaling Protocol Service (Release 9.7(3))
RTRV-H248:CNTXS:SIGPATH—Retrieve H.248 Sigpath Information (Release 9.7(3))
STA-AUD-H248—Start Audit of H.248 Gateway (Release 9.7(3))
Modified MML Commands
This section contains the MML commands that are modified for this feature.
PROV-ADD:IPLNK—Provision H.248 Transport Protocol as UDP (Release 9.7(3))
PROV-ADD:ASSOCIATION—Provision H.248 Transport Protocol as SCTP (Release 9.7(3))
Software Changes for This Feature
This section describes the software changes in the PGW 2200 to support the H.248 protocol.
Alarms
This section lists the alarms that are added and modified to support this feature. For information on the other alarms for the Cisco MGC software, see the Cisco Media Gateway Controller Software Release 9 Messages Reference Guide at
http://www.cisco.com/en/US/partner/docs/voice_ip_comm/pgw/9/system/message/errmsg.html
OLC: Leg1SeizeChanPackError
Description
An error occurs when PGW contructs a Seize Channel Message from Originating Leg.
Severity
Informational (non-service affecting)
Cause
Some required call context data was not available.
Type
No error
Action
None.
OLC: Leg1ModifyChanPackError
Description
An error occurs when PGW constructs a Modify Channel Message from Originating Leg.
Severity
Informational (non-service affecting)
Cause
Some required call context data was not available.
Type
No error
Action
None
OLC: Leg1DeleteChanPackError
Description
An error occurs when PGW constructs a Delete Connection Message from Originating Leg.
Severity
Informational (non-service affecting)
Cause
Some required call context data was not available.
Type
No error
Action
None
OLC: Leg1RqntChanPackError
Description
An error occurs when PGW constructs a RequestNotify Message from Originating Leg.
Severity
Informational (non-service affecting)
Cause
Some required call context data was not available.
Type
No error
Action
None
TLC: Leg2SeizeChanPackError
Description
An error occurs when PGW constructs a Seize Channel Message from Terminating Leg.
Severity
Informational (non-service affecting)
Cause
Some required call context data was not available.
Type
No error
Action
None
TLC: Leg2ModifyChanPackError
Description
An error occurs when PGW constructs a Modify Channel Message from Terminating Leg.
Severity
Informational (non-service affecting)
Cause
Some required call context data was not available.
Type
No error
Action
None
TLC: Leg2DeleteChanPackError
Description
An error occurs when PGW constructs a Delete Connection Message from Terminating Leg.
Severity
Informational (non-service affecting)
Cause
Some required call context data was not available.
Type
No error
Action
None
TLC: Leg2RqntChanPackError
Description
An error occurs when PGW constructs a RequestNotify Message from Terminating Leg.
Severity
Informational (non-service affecting)
Cause
Some required call context data was not available.
Type
No error
Action
None
OLC: Leg1UnexpectedEventDetected
Description
Gateway reports events that are not PGW-requested for the originating leg.
Severity
Informational (non-service affecting)
Cause
Gateway reports events that are not PGW-requested for the originating leg.
Type
No error
Action
None
TLC: Leg1UnexpectedEventDetected
Description
Gateway reports events that are not PGW-requested for the terminating leg.
Severity
Informational (non-service affecting)
Cause
Gateway reports events that are not PGW-requested for the terminating leg.
Type
No error
Action
None
Properties
The properties in this section are for this feature. For information on other properties for the Cisco MGC software, see the Cisco Media Gateway Controller Software Release 9 Provisioning Guide at
http://www.cisco.com/en/US/partner/docs/voice_ip_comm/pgw/9/provisioning/guide/prvgde.html
Table 1 describes the trunkgroup properties used for this feature.
XECfgParm.dat Parameters
The XECfgParm.dat file configuration parameters added for this feature are in Table 2. For information on the other XECfgParm.dat parameters, see the Cisco Media Gateway Controller Software Release 9 Installation and Configuration Guide at
http://www.cisco.com/en/US/partner/docs/voice_ip_comm/pgw/9/installation/software/SW1/97.html
Billing Interface
This section identifies the call detail record (CDR) data modified for this feature. For billing interface information for the rest of the Cisco MGC software, see the Cisco Media Gateway Controller Software Release 9 Billing Interface Guide at
http://www.cisco.com/en/US/partner/docs/voice_ip_comm/pgw/9/billing/guide/billinf.html
Ingress Packet Information (Tag: 4046)
Tag 4046 contains the packets sent, packets received, packets lost, octets sent, octets received, jitter, and latency information (reserved 1 and 2) from the ingress gateway. For an H.248 call, the subfield definitions are unchanged and the data is filled with the statistics of Network Package (nt) and RTP Package (rtp) in H.248.
Egress Packet Information (Tag: 4047)
Tag 4047 contains the same information as Tag 4046 except that the data is taken from the egress gateway. The mapping is the same as with Tag 4046.
Ingress Protocol ID (Tag: 4069)
The ingress protocol ID is determined from MDL and is used in measurements and billing. New protocol type: "10 = H.248" is added to the definition.
Ingress MGCP DLCX Return Code (Tag: 4087)
Tag 4087 is an indication of MGCP DLCX (Delete Connection) return code value on the ingress gateway. If an H.248 gateway was engaged on the ingress side, this tag is not be logged in to CDR.
Egress MGCP DLCX Return Code (Tag: 4088)
Tag 4088 contains the same information as Tag 4087 except that the information comes from the egress gateway. For the H.248 gateway, this tag is not be logged in to CDR.
MGCP Script Response String (Tag: 4097)
For MGCP script hand-off calls, Tag 4097 records the Notification response string, if any, returned in the O parameter of the MGCP NTFY message. If this call did not receive an MGCP NTFY message, this tag is not logged. As MGCP scripting is not ported to H.248, H.248 calls never generate this CDB.
Originating Leg DSP Statistics (Tag: 4098)
Tag 4098 provides DSP statistics for the originating leg of the call. Because DSP statistics in CDR are not supported for H.248, this tag is not logged in to CDR for the H.248 leg.
Terminating Leg DSP Statistics (Tag: 4099)
Tag 4099 is the same as Tag 4098, except that it concerns the terminating leg.
Obtaining Documentation, Obtaining Support, and Security Guidelines
For information on obtaining documentation, obtaining support, providing documentation feedback, security guidelines, and also recommended aliases and general Cisco documents, see the monthly What's New in Cisco Product Documentation, which also lists all new and revised Cisco technical documentation at:
http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html
Glossary
Table 3 contains expansions of acronyms and technical terms used in this feature module.
Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: www.cisco.com/go/trademarks. Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (1110R)
© 2011 Cisco Systems, Inc. All rights reserved.
Feedback
