sip-i protocol feature module - · pdf filesip-i protocol feature module feature overview 3...

Americas Headquarters:Cisco Systems, Inc., 170 West Tasman Drive, San Jose, CA 95134-1706 USA

© 2008–2009 Cisco Systems, Inc. All rights reserved.

SIP-I Protocol Feature Module

Document Release History

Feature History

This document describes the SIP-I Protocol feature and includes the following sections:

• Feature Overview, page 2

• Supported Standards, MIBs, and RFCs, page 6

• Provisioning Tasks, page 6

• Provisioning Examples, page 13

• MML Command Reference, page 15

• Software Changes for This Feature, page 17

• Troubleshooting the Feature, page 27

• Obtaining Documentation, Obtaining Support, and Security Guidelines, page 31

• Mapping Details, page 31

• Glossary, page 37

Publication Date Comments

July 2009 Added mapping details from the ISUP connected number parameter to the SIP P-Asserted-Identity header.

February 2009 Updated for the Russian SIP-I support.

November 2008 Initial release of document.

Release Modification

9.8(1) Added support for Russian SIP-I.

9.8(1) The SIP-I Protocol feature was introduced on the Cisco PGW 2200 Softswitch.

SIP-I Protocol Feature ModuleFeature Overview

2SIP-I Protocol Support

Feature OverviewSIP-I (SIP with encapsulated ISUP) is an ITU-defined SIP extension which allows IP networks to provide services that are supported by ISUP networks, for example, malicious call identification. The feature allows the Cisco PGW 2200 Softswitch to interwork between SIP-I and ISUP, and also to interwork between SIP-I and other protocols such as SIP, H.323, PRI, and QSIG. Where PSTN services are required in IP networks, SIP trunks with SIP-I support can be the preferred method for supplying these services, because the ISUP content is encapsulated in SIP message headers.

The SIP-I Protocol feature is useful in a next-generation network (NGN) emulation model, where the Cisco PGW 2200 Softswitch, working with the Cisco BTS 10200 Class 5 softswitch in a SIP solution, communicates with other NGNs using SIP-I. This new feature is also useful for bridging existing PSTN networks without TDM interconnections being required.

This feature introduces a SIP-I interface license. For more information about the SIP-I interface license on the Cisco PGW 2200 Softswitch, see the Licensing Features for the Cisco PGW 2200 Softswitch at

http://www.cisco.com/en/US/docs/voice_ip_comm/pgw/9/feature/module/9.7_3_/FlexLM.html

See the following lists of ISUP services interworking and transmitting with SIP-I on the Cisco PGW 2200 Softswitch.

Supported ISUP Services Interworking with SIP-I (Profile C)/SIP (Profile B)

• Malicious Call Identification (MCID)(SIP-I only)

• Call Diversion (CFB, CFNR, CFU, CD)

• Connected Line Presentation and Restriction (COLP/COLR)

• Calling Line Presentation and Restriction (CLIP/CLIR)

• Number Portability (NP)

• Call Hold (HOLD)

• Terminal Portability (TP)

• B-controlled Release (CCL) (for Russian SIP-I only)

• Call Offering (ACM/SUS/RNG) (for Russian SIP-I only)

Supported ISUP Services Transiting with SIP-I

• SUB-addressing (SUB)

• Malicious Call Identification (MCID)

• Call Waiting (CW)

• Call Diversion (CFB, CFNR, CFU, CD)

• Conference Calling (CONF)

• Three Party (3PTY)

• Explicit Call Transfer (ECT)

• User-to-User Service (UUS)

• Direct-Dialling-In (DDI)

• Connected Line Presentation and Restriction (COLP/COLR)

• Calling Line Presentation and Restriction (CLIP/CLIR)

• Completion of Calls to Busy Subscriber (CCBS)

http://www.cisco.com/en/US/docs/voice_ip_comm/pgw/9/feature/module/9.7_3_/FlexLM.html



• Number Portability (NP)

Figure 1 shows how service providers interwork the ISUP services using this SIP-I Protocol feature. In this figure, PGW B interconnects different ISUP variants and other protocols like ISDN, DPNSS, and EISUP on the SIP trunk with SIP-I support.

Figure 1 Interworking Between Service Providers with SIP-I

Figure 2 shows the SIP-I being used on multiple incoming SIP trunk groups. In this figure, Cisco PGW 2200 Softswitches interwork ISUP variants, ISDN, SIP, HSI (EISUP), DPNSS, and EISUP using multiple incoming SIP trunk groups on which different SIP-I versions are provisioned. PGW A interworks TDM, SIP, and H.323 protocols to SIP-I. PGW B interconnects SIP-I variants to the TDM, SIP, and H.323 protocols on multiple incoming SIP trunk groups with SIP-I support.

UKISUP MGC B

GERMANISUP MGC C

ISDN

PGW ADPNSS

EISUP

ANSIISUP MGC A

UKISUP UK

GERMANISUP GERMAN

SIP/SIP-I/SIP-GTD SIP

ANSIISUP ANSI

ISDN ISDN

DPNSSDPNSS

EISUP EISUP

EISUP HSI(EISUP)

2808

71

FINNISHISUP FINNISH

RUSSIANISUP RUSSIAN

PGW B

FINNISHISUP MGC D

RUSSIANISUP MGC E

SIP-Iversion=ansi00base=ansi00

SIP-Iversion=isupv3-uk

base=etsi356

SIP/SIP-I/SIP-GTD

SIP-Iversion=q761german

base=itu92+

SIP-Iversion=isupv2-finnish96

base=etsi356

SIP-Iversion=Q761_97VER_RUSS

base=itu92+

5060



Figure 2 SIP-I Used on Multiple Incoming SIP Trunk Groups

Figure 3 shows the SIP-I being used on a single incoming SIP trunk group. In this figure, Cisco PGW 2200 Softswitches interwork ISUP variants, ISDN, SIP, HSI (EISUP), DPNSS, and EISUP using a single incoming SIP trunk group which has SIP-I support. This single incoming SIP trunk group of PGW B dynamically adapts to the incoming SIP-I message version.

2808

72

UKISUPUK

GERMANISUPGERMAN

SIP/SIP-I/SIP-GTDSIP

ANSIISUPANSI

ISDNISDN

DPNSSDPNSS

EISUPEISUP

EISUPHSI(EISUP)

FINNISHISUPFINNISH

RUSSIANISUPRUSSIAN

PGWA

UKISUP UK

GERMANISUP GERMAN


ANSIISUP ANSI

ISDN ISDN

DPNSSDPNSS

EISUP EISUP

EISUP HSI(EISUP)

FINNISHISUP FINNISH

RUSSIANISUP RUSSIAN

PGWB

Route

6060SIP-Iversion=ansi00base=ansi00

7060SIP-Iversion=isupv3-uk

base=etsi356

5060SIP

9060SIP-Iversion=isupv2-finnish96

base=etsi356

4060SIP-Iversion=Q761_97VER_RUSS

base=itu92+

8060SIP-Iversion=q761german

base=itu92+



Figure 3 SIP-I Used on a Single Incoming SIP Trunk Group

BenefitsThe feature allows service providers to offer a complete VoIP interconnection which can handle PSTN services that the traditional TDM ISUP interconnection supports. Among all the IP interconnection forms (such as SIP, SIP-I, and H.323), SIP-I interconnections can be the destination of choice if service providers require PSTN service interworking.

The Cisco PGW 2200 Softswitch supports ITU, ANSI, German, UK, Finnish, and Russian ISUP encapsulated in SIP-I messages, which allows a high degree of interworking for many services across a SIP-I configured link.You can provision the closest base or the closest country-specific SIP-I variant if you are using SIP-I for other ISUP variants. The service interoperability level between SIP-I and other protocols such as SIP, H.323, PRI, and QSIG, is lower than the interoperability level between SIP-I and ISUP, but is nearly equivalent to the interoperability level between those protocols and ISUP today.

PrerequisitesThe Cisco PGW 2200 Softswitch must be running Cisco PGW 2200 Softswitch software Release 9.8(1). Prerequisites for this release can be found in the Release Notes for Cisco PGW 2200 Softswitch Release 9.8(1) at

http://www.cisco.com/en/US/partner/docs/voice_ip_comm/pgw/9/release/note/rn981.html.

2808

74

5060

SIP-Iversion=ansi00base=ansi00

SIP-Iversion=isupv3-uk

base=etsi356

SIP

SIP-Iversion=q761german

base=itu92+

SIP-Iversion=isupv2-finnish96

base=etsi356

UKISUPUK

GERMANISUPGERMAN

SIP/SIP-I/SIP-GTDSIP

ANSIISUPANSI

ISDNISDN

DPNSSDPNSS

EISUPEISUP

EISUPHSI(EISUP)

FINNISHISUPFINNISH

RUSSIANISUPRUSSIAN PGW

A

Route

PGWB

UKISUP UK

GERMANISUP GERMAN


ANSIISUP ANSI

ISDN ISDN

DPNSSDPNSS

EISUP EISUP

EISUP HSI(EISUP)

FINNISHISUP FINNISH

RUSSIANISUP RUSSIAN

SIP-Iversion=Q761_97VER_RUSS

base=itu92+

http://www.cisco.com/en/US/partner/docs/voice_ip_comm/pgw/9/release/note/rn973.html

SIP-I Protocol Feature ModuleProvisioning Tasks


Restrictions or LimitationsThe SIP-I Protocol feature has the following limitations:

• Currently the Cisco PGW 2200 Softswitch does not support SIP precondition (the ability to require that the SIP participant reserve network resources before continuing with the session).

• Currently the Cisco PGW 2200 Softswitch supports only en-bloc signaling on the SIP side for SIP-I. The Cisco PGW 2200 Softswitch supports overlap signaling on the TDM ISUP side.

Related DocumentsThis document contains information that is strictly related to this feature. The documents that contain additional information related to the Cisco PGW 2200 Softswitch are at

http://www.cisco.com/en/US/products/hw/vcallcon/ps2027/tsd_products_support_series_home.html.

Supported Standards, MIBs, and RFCs

Standards

This feature is in compliance with the following standards:

• ITU-T Recommendation Q.1912.5 (2004) Interworking between Session Initiation Protocol (SIP) and ISDN User Part

• ETSI EN 383 001: Telecommunications and Internet Converged Services and Protocols for Advanced Networking (TISPAN); Interworking between Session Initiation Protocol (SIP) and ISDN User Part (ISUP) [ITU-T Recommendation Q.1912.5, modified]

• T1.679-2004: Interworking between Session Initiation Protocol (SIP) and ISDN User Part

• ND1017-2006: Interworking between Session Initiation Protocol (SIP) and UK ISDN User Part (UK ISUP)

• Ficora GFI 0301: Guidelines for Implementation ISUP-SIP Interworking Profile C (Finland ISUP)

MIBs

No new or modified MIBs are introduced by this feature.

For more information on the MIBs used in the Cisco PGW 2200 Softswitch software, see the Cisco PGW 2200 Softswitch Release 9 Management Information Base Guide at the following URL.

http://www.cisco.com/iam/PGW_MIBS/index.html

Provisioning TasksThis section describes how to provision this feature and includes four parts:

• Provisioning an Incoming SIP Trunk Group, page 7

• Provisioning an Outgoing SIP Trunk Group, page 9

• Enabling the Route Preference, page 11

• Additional Provisioning for Finnish SIP-I, page 11

http://www.cisco.com/iam/PGW_MIBS/index.html

http://www.cisco.com/en/US/products/hw/vcallcon/ps2027/tsd_products_support_series_home.html



Provisioning an Incoming SIP Trunk Group

SIP-I Version Name and ISUP Variant Mapping

The Cisco PGW 2200 Softswitch uses the version subparameter in the Content-Type header of a SIP-I INVITE message to identify SIP-I variants. In order to specify the SIP-I variants supported on the incoming trunk groups, you can add a file, sipIVersion.dat, through MML commands, and associate it with the incoming trunk group SIP profiles. The following provisioning example is applicable to specific networks.

Add Mapping Entries in sipIVersion.dat File

prov-add:sipiversion:profilename="BT",version="X-UKISUP",mdo="ISUPV3_UK_SIPI"prov-add:sipiversion:profilename="BT",version="etsi356",mdo="ISUPV3_UK_SIPI"prov-add:sipiversion:profilename="BT",version="itu-t92+",mdo="Q761_99VER_BASE_SIPI"prov-add:sipiversion:profilename="US",version="itu-t92+",mdo="Q761_99VER_BASE_SIPI"prov-add:sipiversion:profilename="US",version="ansi00",mdo="ANSISS7_STANDARD_SIPI"prov-add:sipiversion:profilename="GERMAN",version="isupv2-german",mdo="ISUPV2_GERMAN_SIPI"prov-add:sipiversion:profilename="FINNISH",version="isupv2-finnish96",mdo="ISUPV2_FINNISH96_SIPI"prov-add:sipiversion:profilename="RUSSIAN",version="Q761_97VER_RUSS",mdo="Q761_97VER_RUSS_SIPI"

The commands listed in the preceding example generate the following SIP-I mapping table.

Edit a Mapping Entry

prov-ed:sipiversion:profilename="BT",version="etsi356",mdo="ISUPV3_UK_SIPI"

Retrieve a Mapping Entry

prov-rtrv:sipiversion:profilename="BT",version="etsi356"

Delete a Mapping Entry

prov-dlt:sipiversion:profilename="BT",version="etsi356"

SIP-I Mapping Profile Name SIP-I Version in Content-Type SIP-I Variant

BT X-UKISUP ISUPV3_UK_SIPI

BT etsi356 ISUPV3_UK_SIPI

BT itu-t92+ Q761_99VER_BASE_SIPI

US itu-t92+ Q761_99VER_BASE_SIPI

US asnsi00 ANSISS7_STANDARD_SIPI

GERMAN isupv2-german ISUPV2_GERMAN_SIPI

FINNISH isupv2-finnish96 ISUPV2_FINNISH96_SIPI

RUSSIAN Q761_97VER_RUSS Q761_97VER_RUSS_SIPI



Add a SIP Profile

prov-add:profile:name="sipi-in",type="SIPPROFILE",sipmimebodysupport="4"

Note To support both SIP and SIP-I on the incoming trunk group and support SIP-I on the outgoing trunk group, the Cisco PGW 2200 Softswitch requires the property sipMimeBodySupport to be set to 4.

For detailed property information, see the “Properties” section on page 18.

Attach the SIP-I Mapping Profile to the SIP Profile

prov-ed:profile:name="sipi-in",sipiingressversionmap="BT"

Note You attach the SIP-I mapping profile BT to the SIP profile sipi-in by the preceding command. According to the preceding SIP-I mapping table, the incoming trunk group supports three SIP-I versions of the SIP-I mapping profile BT in Content-Type of the SIP-I messages.

(Optional) Attach the ISUP TMR Profile to the SIP Profile

prov-add:profile:name="isup01",type="ISUPTMRPROFILE",t6="120000", variant="etsi356",t2="180000",t9="60000",t33="12000",validation="OFF"prov-ed:profile:name="sipi-in",isuptmrprofile="isup01"

Attach the SIP Profile to the Trunk Group

prov-add:trnkgrpprof:name=”2000”,profile=”sipi-in”

Incoming SIP-I Message Processing

Figure 4 shows how Cisco PGW 2200 Softswitch starts a SIP-I variant to process a specific SIP-I message on the incoming SIP trunk group based on your provisioning. From the source IP of the incoming SIP-I message, Cisco PGW 2200 Softswitch selects the trunk group 2000. With the selected trunk group, Cisco PGW 2200 Softswitch selects a SIP-I mapping profile according to the value of the property sipMimeBodaySupport and the property SipIIngressVersionMap. Based on the selected SIP-I mapping profile and the Content-Type field in the SIP-I message, Cisco PGW 2200 Softswitch starts ISUPV3_UK_SIPI as the SIP-I variant to process the incoming SIP-I message.



Figure 4 Processing SIP-I Messages on the Incoming SIP Trunk Group

Provisioning an Outgoing SIP Trunk Group

Add a SIP Profile

prov-add:profile:name="sipi-out",type="SIPPROFILE",sipmimebodaysupport="4"

Note To support both SIP and SIP-I on the incoming trunk group and support SIP-I on the outgoing trunk group, the Cisco PGW 2200 Softswitch requires the property sipMimeBodySupport to be set to 4.

For detailed property information, see the “Properties” section on page 18.

Provision the SIP-I Version on the SIP Profile

prov-ed:profile:name="sipi-out",sipiegressisupversion="isupv2-german"

Provision the SIP-I Variant on the SIP Profile

prov-ed:profile:name="sipi-out",sipiegressmdo="ISUPV2_GERMAN_SIPI"

Content-Type:application/isup;version=etsi356;base=etsi356

Encapsulated ISUPMessage IAM

INVITE

IP 10.0.5.1

10.0.5.1 5060 2000

10.0.5.2 5060 3000

10.0.6.1 5060 4000

10.0.6.2 5060 5000

Source IP Listening Trunk Port Group

2000 4 BT

3000 3 or 4 GERMAN

4000 3 or 4 GERMAN

5000 3 or 4 GERMAN

Trunk sipMimeBodySupport SiplingressVersionMapGroup

BT X-UKISUP ISUPV3_UK_SIPI

BT etsi356 ISUPV3_UK_SIPI

BT itu-t92 Q761_99VER_BASE_SIPI

US itu-t92 Q761_99VER_BASE_SIPI

SIP-IMappingProfile

SIP-IVersion

SIP-IVariant

12

2808

51

3A

3B

4 DecodeencapsulatedISUP message asISUPV3_UK



Provision the Handling Property on the SIP Profile

prov-ed:profile:name="sipi-out",sipiegresshandling="2"

Note To always add “handling=required” to the Content-Disposition header of the INVITE message, the Cisco PGW 2200 Softswitch requires the property SipIEgressHandling to be set to 2.

For detailed property information, see “Properties” section on page 18.

(Optional) Provision the SipICANCELEncapREL Property on the SIP Profile

To make the encapsulated REL message required in the SIP-I CANCEL message, you need to provision the SipICANCELEncapREL property as follows:

prov-ed:profile:name="sipi-out",sipicancelencaprel="1"

(Optional) Attach the ISUP TMR Profile to the SIP Profile

prov-add:profile:name="isup02",type="ISUPTMRPROFILE",t6="120000",variant="isupv2-german",t2="180000",t9="60000",t33="12000",validation="OFF"prov-ed:profile:name="sipi-out",isuptmrprofile="isup02"

Attach the SIP Profile to the Trunk Group

prov-add:trnkgrpprof:name="3000",profile="sipi-out"

Outgoing SIP-I Message Processing

Figure 5 shows how Cisco PGW 2200 Softswitch transforms the incoming ISUP messages to the outgoing SIP-I messages if the route preference is enabled. The Cisco PGW 2200 Softswitch selects a route from the route analysis after a German ISUP initial address message (IAM) comes in. If the route preference is enabled, Cisco PGW 2200 Softswitch selects the trunk group 3000 based on the trunk group property SipIEgressMDO. The other trunk group properties, sipMimeBodySupport, SipIEgressHandling, and SipIEgressISUPVersion, determine the content of SIP-I header fields in the outgoing SIP-I messages.

Note If the route preference is not enabled, Cisco PGW 2200 Softswitch selects an outgoing trunk group in the route as the result of the route analysis. The trunk group property SipIEgressHandling provisioned on this trunk group determines the content of SIP-I header fields in the outgoing SIP-I messages.



Figure 5 Processing SIP-I Messages on the Outgoing SIP Trunk Group

Enabling the Route Preferencenuman-add:resulttable:custgrpid="1000",setname="set-7",name="rp",resulttype="SIPI_CONTROL",dw1="1"

Note SIPI_CONTROL is a new result type introduced in this feature. To enable the SIP-I route preference, the Cisco PGW 2200 Softswitch requires the dw1 to be set to 1.

It is possible to configure the Cisco PGW 2200 Softswitch so that, for calls between ISUP and SIP trunks with SIP-I supported, the Cisco PGW 2200 Softswitch tries to route the calls using the SIP trunk on which the corresponding SIP-I variant is available to match the ISUP trunk. Use the SIPI_CONTROL result type in dial plans to achieve this.

For detailed information on this result type, see the “Result Type Definitions” section on page 26. For detailed information on the dial plan, see the Cisco PGW 2200 Softswitch Release 9.8 Dial Plan Guide at

http://www.cisco.com/en/US/docs/voice_ip_comm/pgw/9/dial_plan/guide/dplan.html.

Additional Provisioning for Finnish SIP-IFinnish SIP-I has some specific message requirements which require additional provisioning:

• Add Meter Pulse Message Support, page 12

• Give ISUP Encapsulation Priority over SIP Headers, page 12

• Map the Cause Code, page 12

• Stop the Hop Counter and Satellite Indicator From Increasing, page 12

• Set Calling Party Number (CgPN) APRI to Presentation Restricted, page 13

1 2

2808

73

43

Content-Type:application/isup;version=isupv2-german;base=etsi356Content-Disposition:signal; handling=required

Encapsulated ISUPMessage IAM

INVITE

TG 3000

TG 4000

TG 5000

Trunk sipMimeBodySupport SipIEgressMDO SipIEgressISUPVersion SipIEgressHandlingGroup

3000 4 ISUPV2_GERMAN_SIPI isupv2-german 2

4000 3 or 4 ISUPV3_UK_SIPI X-UKISUP 1

5000 3 or 4 ISUPV3_UK_SIPI etsi356 2

PGW

SIP-IProce-ssor

UKISUP

GERMANISUP

ANSIISUP

Route List

IAM 5

SIP-I Message

http://www.cisco.com/en/US/docs/voice_ip_comm/pgw/9/dial_plan/guide/dplan.html



Add Meter Pulse Message Support

Currently the Cisco PGW 2200 Softswitch supports meter pulse message (MPM) which is required in Finnish ISUP. Finnish SIP-I encapsulates MPMs in INFO messages in order to interwork this Finnish ISUP service among service providers. For details on provisioning MPM support for Finnish ISUP on the Cisco PGW 2200 Softswitch, see the section, Provisioning Tasks, of the feature guide Meter Pulse Messages Support at

http://www.cisco.com/en/US/docs/voice_ip_comm/pgw/9/feature/module/9.5_1_/FMmpm.html.

Give ISUP Encapsulation Priority over SIP Headers

Finnish SIP-I requires that within an incoming SIP-I message, the parameters in the encapsulated ISUP message has higher priority over the ones in the SIP header when the device decodes the SIP-I message. To achieve this on the Cisco PGW 2200 Softswitch, you need to provision the SipICLICOLPreference property for the SIP profile used for Finnish SIP-I.

prov-ed:profile:name="sipi-in",sipiclicolpreference="1"

Note To make encapsulated ISUP content has higher priority over SIP headers in the decoding of incoming SIP-I messages, set the SipICLICOLPreference to 1.

For detailed property information, see “Properties” section on page 18.

Map the Cause Code

According to Ficora GFI 0301: Guidelines for Implementation ISUP-SIP Interworking Profile C (Finland ISUP), Finnish SIP-I map the cause code 24 to the SIP status code 503 Service Unavailable.

You need to manually map the cause code 24 (internal cause value IC_REJECTED_BY_FEATURE (169) by default) to 503 Service Unavailable (internal cause value IC_SERVICE_UNAVAIL(209) by default):

numan-add:resultset:custgrpid="1111",name="cause-set-1"numan-add:cause:custgrpid="1111",setname="cause-set-1",causevalue= 169numan-add:resulttable:custgrpid="1111",setname"cause-set-1",name="cause-tbl-1",resulttype="CAUSE",dw1=209

Note For details on the ISUP cause codes and the internal cause codes on the Cisco PGW 2200 Softswitch, see Appendix B, Cause and Location Codes in Cisco PGW 2200 Softswitch Release 9.8 Dial Plan Guide at the following URL.


Stop the Hop Counter and Satellite Indicator From Increasing

The hop counter has no value change for an ISUP to Finnish SIP-I call. There is no satellite circuit in the connection according to the Ficora GFI 0301. If you have provisioned the CircHopCount and the SatelliteInd properties to other values, you need to set them to default values in the common profile:

prov-add:profile:name="sipicommon",type="COMMONPROFILE",circhopcount="0"prov-ed:profile:name="sipicommon",satelliteind="0"

http://www.cisco.com/en/US/docs/voice_ip_comm/pgw/9/feature/module/9.5_1_/FMmpm.html


SIP-I Protocol Feature ModuleProvisioning Examples


prov-ed:profile:name="sipi-in",commonprofile="sipicommon" (using Finnish SIP-I on incoming trunks)orprov-ed:profile:name="sipi-out",commonprofile="sipicommon"(using Finnish SIP-I on outgoing trunks)

Set Calling Party Number (CgPN) APRI to Presentation Restricted

Finnish SIP-I requires the CgPN APRI be set to presentation restricted.

prov-ed:profile:name="sipi-in",restrictpresifnopaid="1"

Provisioning ExamplesThis section provides a provisioning example for this feature. Additional provisioning examples for the Cisco PGW 2200 Softswitch software can be found in the Cisco PGW 2200 Softswitch Release 9.8 Provisioning Guide.

________________________________________; Add SIP-I Mapping Table;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;prov-add:sipiversion:profilename="BT",version="X-UKISUP",mdo="ISUPV3_UK_SIPI"prov-add:sipiversion:profilename="BT",version="etsi356",mdo="ISUPV3_UK_SIPI"prov-add:sipiversion:profilename="BT",version="itu-t92+",mdo="Q761_99VER_BASE_SIPI"prov-add:sipiversion:profilename="US",version="itu-t92+",mdo="Q761_99VER_BASE_SIPI"prov-add:sipiversion:profilename="US",version="ansi00",mdo="ANSISS7_STANDARD_SIPI"prov-add:sipiversion:profilename="GERMAN",version="isupv2-german",mdo="ISUPV2_GERMAN_SIPI"prov-add:sipiversion:profilename="FINNISH",version="isupv2-finnish96",mdo="ISUPV2_FINNISH96_SIPI"prov-add:sipiversion:profilename="RUSSIAN",version="Q761_97VER_RUSS",mdo="Q761_97VER_RUSS_SIPI"

________________________________________; Add a SIP Profile for the Incoming SIP Trunk Group with SIP-I Support;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;prov-add:profile:name="sipi-in",type="SIPPROFILE",sipmimebodysupport="4"

________________________________________; Attach the SIP-I Mapping to the SIP Profile;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;prov-ed:profile:name="sipi-in",sipiingressversionmap="BT"

________________________________________; (Optional) Attach the ISUP TMR Profile to the SIP Profile;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;prov-add:profile:name="isup01",type="ISUPTMRPROFILE",t6="120000", variant="etsi356",t2="180000",t9="60000",t33="12000",validation="OFF"prov-ed:profile:name="sipi-in",isuptmrprofile="isup01"

________________________________________; Attach the SIP Profile to a Trunk Group;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;prov-add:trnkgrpprof:name=”2000”,profile=”sipi-in”

________________________________________; Add a SIP Profile for the Outgoing SIP Trunk Group with SIP-I Support;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;prov-add:profile:name="sipi-out",type="SIPPROFILE",sipmimebodaysupport="4"

SIP-I Protocol Feature ModuleProvisioning Examples


________________________________________; Provision the SIP-I Version on the SIP Profile;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;prov-ed:profile:name="sipi-out",sipiegressisupversion="isupv2-german"

________________________________________; Provision the SIP-I Variant on the SIP Profile;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;prov-ed:profile:name="sipi-out",sipiegressmdo="ISUPV2_GERMAN_SIPI"

________________________________________; Provision the Handling Property on the SIP Profile;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;prov-ed:profile:name="sipi-out",sipiegresshandling="2"

________________________________________; (Optional) Make ISUP REL message encapsulation required in the SIP-I CANCEL message;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;prov-ed:profile:name="sipi-out",sipicancelencaprel="1"

________________________________________; (Optional) Attach the ISUP TMR Profile to the SIP Profile;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;prov-add:profile:name="isup02",type="ISUPTMRPROFILE",t6="120000",variant="isupv2-german",t2="180000",t9="60000",t33="12000",validation="OFF"prov-ed:profile:name="sipi-out",isuptmrprofile="isup02"

________________________________________; Attach the SIP Profile to a Trunk Group;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;prov-add:trnkgrpprof:name="3000",profile="sipi-out"

________________________________________; Enable the Route Preference;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;numan-add:resulttable:custgrpid="1000",setname="set-7",name="rp",resulttype="SIPI_CONTROL",dw1="1"

________________________________________; (For Finnish SIP-I Only) Give ISUP Encapsulation Priority over SIP Headers;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;prov-ed:profile:name="sipi-in",sipiclicolpreference="1"

________________________________________; (For Finnish SIP-I Only) Map the Cause Code;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;numan-add:resultset:custgrpid="1111",name="cause-set-1"numan-add:cause:custgrpid="1111",setname="cause-set-1",causevalue= 169numan-add:resulttable:custgrpid="1111",setname"cause-set-1",name="cause-tbl-1",resulttype="CAUSE",dw1=209

________________________________________; (For Finnish SIP-I Only) Set Hop Counter and Satellite Indicator to Default Values;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;prov-add:profile:name="sipicommon",type="COMMONPROFILE",circhopcount="0"prov-ed:profile:name="sipicommon",satelliteind="0"prov-ed:profile:name="sipi-in",commonprofile="sipicommon" (using Finnish SIP-I on incoming trunks)orprov-ed:profile:name="sipi-out",commonprofile="sipicommon"(using Finnish SIP-I on outgoing trunks)

________________________________________; (For Finnish SIP-I Only) Set CgPN APRI to Presentation Restricted

SIP-I Protocol Feature ModuleMML Command Reference


;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;prov-ed:profile:name="sipi-in",restrictpresifnopaid="1"

MML Command ReferenceThis section documents new, modified, or deleted Man-Machine Language (MML) commands. All other MML commands are documented in the Cisco PGW 2200 Softswitch Release 9 MML Command Reference at

http://www.cisco.com/en/US/docs/voice_ip_comm/pgw/9/command/reference/mmlref_1.html.

New MML CommandsThis section contains the MML commands that are new for this feature.

PROV-ADD:SIPIVERSION:PROFILENAME—Add an Entry to the sipIVersion.dat File (Release 9.8(1))

Purpose: Adds an entry in the sipIVersion.dat file.

Syntax: prov-add:sipiversion:profilename="SIP-I mapping profile name",version="SIP-I version in Content-Type",mdo="SIP-I variant name"

Input Description:

• PROFILENAME—MML name of a SIP-I mapping profile. This name can be up to 20 alphanumeric characters in length.

– The name must start with an alphabetic character.

• VERSION— SIP-I version defined by the operator and used in the SIP-I message Content-Type header field. One SIP-I mapping profile can have more than one SIP-I version defined on the Cisco PGW 2200 Softswitch. This parameter value can be up to 128 characters in length.

• MDO—SIP-I variant name mapped to the SIP-I message ParamContent field. This name can be up to 40 alphanumeric characters.

Example: The MML command shown in the following example adds a mapping from SIP-I version X-UKISUP to SIP-I variant ISUPV3_UK_SIPI in the SIP-I mapping profile BT:

mml>prov-add:sipiversion:profilename="BT",version="X-UKISUP",mdo="ISUPV3_UK_SIPI"

Comments: Performance Impact Category: A

http://www.cisco.com/en/US/docs/voice_ip_comm/pgw/9/command/reference/mmlref_1.html

SIP-I Protocol Feature ModuleMML Command Reference


PROV-ED:SIPIVERSION:PROFILENAME—Edit an Entry in the sipIVersion.dat File (Release 9.8(1))

PROV-RTRV:SIPIVERSION:PROFILENAME—Retrieve an Entry in the sipIVersion.dat File (Release 9.8(1))

Purpose: Edits an entry within a SIP-I mapping profile in the sipIVersion.dat file.

Syntax: prov-ed:sipiversion:profilename="SIP-I mapping profile name",version="SIP-I version in Content-Type",mdo="SIP-I variant name"

Input Description:



• VERSION—SIP-I version defined by the operator and used in the SIP-I message Content-Type field. One SIP-I mapping profile can have more than one SIP-I version defined on the Cisco PGW 2200 Softswitch. This parameter value can be up to 128 characters in length.

• MDO—SIP-I variant name mapped to the SIP-I message ParamContent field. This name can be up to 40 alphanumeric characters.

Example: The MML command shown in the following example edits the mapping from SIP-I version “X-UKISUP” to SIP-I variant ISUPV3_UK_SIPI in the SIP-I mapping profile BT:

mml>prov-ed:sipiversion:profilename="BT",version="X-UKISUP",mdo="ISUPV3_UK_SIPI"


Purpose: Displays the information for one entry within a SIP-I mapping profile in the sipIVersion.dat file.

Syntax: prov-rtrv:sipiversion:profilename="SIP-I mapping profile name",version="SIP-I version in Content-Type"

Input Description:



• VERSION—SIP-I version defined by the operator and used in the SIP-I message Content-Type header field. One SIP-I mapping profile can have more than one SIP-I version defined on the Cisco PGW 2200 Softswitch. This parameter value can be up to 128 characters in length.

Example: The MML command shown in the following example displays the information of the entry for SIP-I version X-UKISUP in the SIP-I mapping profile BT:

mml>prov-rtrv:sipiversion:profilename="BT",version="X-UKISUP"


SIP-I Protocol Feature ModuleSoftware Changes for This Feature


PROV-DLT:SIPIVERSION:PROFILENAME—Delete an Entry in the sipIVersion.dat File (Release 9.8(1))

Modified MML CommandsNo MML commands are modified for this feature.

Related MML CommandsYou need to provision MPM for the Finnish ISUP variant before you use Finnish SIP-I. See the MML commands for provisioning MPM on the Cisco PGW 2200 Softswitch at

http://www.cisco.com/en/US/docs/voice_ip_comm/pgw/9/feature/module/9.5_1_/FMmpm.html.

Software Changes for This FeatureThe following sections contain software changes related to this feature:

• Alarms, page 17

• Properties, page 18

• Result Type Definitions, page 26

AlarmsThis section lists the alarms that are added for this feature. For information on the other alarms for the Cisco PGW 2200 Softswitch software, see the Cisco PGW 2200 Softswitch Release 9 Messages Reference at

Purpose: Deletes an entry within a SIP-I mapping profile in the sipIVersion.dat file.

Syntax: prov-dlt:sipiversion:profilename="SIP-I mapping profile name",version="SIP-I version in Content-Type"

Input Description:



• VERSION—SIP-I version defined by the operator and used in the SIP-I message Content-Type header field. One SIP-I mapping profile can have more than one SIP-I version defined on the Cisco PGW 2200 Softswitch. This parameter value can be up to 128 characters in length.

Example: The MML command shown in the following example deletes the mapping for the SIP-I version X-UKISUP in the SIP-I mapping profile BT:

mml> prov-dlt:sipiversion:profilename="BT",version="X-UKISUP"


http://www.cisco.com/en/US/docs/voice_ip_comm/pgw/9/feature/module/9.5_1_/FMmpm.html#wp1076169



http://www.cisco.com/en/US/docs/voice_ip_comm/pgw/9/system/message/errmsg.html.

Unsupported SIP-I Call

Description

This alarm is triggered when the Cisco PGW 2200 Softswitch rejects an unsupported SIP-I call.

Severity

Informational (non-service affecting)

Cause

The Cisco PGW 2200 Softswitch raises the alarm in any one of the three following cases:

• If the property sipMimeBodySupport is set to 3 (only SIP-I supported on the incoming trunk group) and the Content-Disposition header in the incoming SIP-I message contains “handling=required”, the Cisco PGW 2200 Softswitch cannot find any matched SIP-I mapping profile or version entry in the configuration.

• The property sipMimeBodySupport is set to 0 (only SIP supported on the incoming trunk group), and the Content-Disposition header in the incoming SIP-I message contains “handling=required”.

• If the property sipMimeBodySupport is set to 3 (only SIP-I supported on the incoming trunk group), the Cisco PGW 2200 Softswitch receives a SIP INVITE message.

Type

Processing error alarm

Action

Perform the following steps:

1. Check the sipMimeBodySupport property value to make sure that SIP/SIP-I call is allowed on the incoming trunk group.

2. Check the SipIIngressVersionMAP property value on the incoming SIP trunk group.

3. Use the following command to see whether the Cisco PGW 2200 Softswitch selects the correct SIP-I variant:

prov-rtrv:sipiversion:profilename="SIP-I mapping profile name",version="SIP-I version in Content-Type"

PropertiesThe properties identified in this section are used for the SIP-I Protocol feature. After confirming which SIP-I protocol standard you are following (see the “Supported Standards, MIBs, and RFCs” section on page 6), you can provision these properties according to that specific SIP-I protocol.

For information on other properties of the Cisco PGW 2200 Softswitch software, see the Cisco PGW 2200 Softswitch Release 9.8 Provisioning Guide at

http://www.cisco.com/en/US/docs/voice_ip_comm/pgw/9/provisioning/guide/prvgde.html

http://www.cisco.com/en/US/docs/voice_ip_comm/pgw/9/system/message/errmsg.html

http://www.cisco.com/en/US/docs/voice_ip_comm/pgw/9/provisioning/guide/prvgde.html



New Properties

Table 1 describes the new SIP profile and domain profile properties used for this feature.

Table 1 New Properties

Property Description

isuptmrProfile This property indicates the Level 2 ISUP TMR profile that is attached to a SIP profile.

Valid values: any string up to 128 characters in length.

Default value: NULL.

Dynamically reconfigurable: yes.

LRNDigitCCPrefix

This property indicates whether the function is enabled: the Cisco PGW 2200 Softswitch adds a prefix to the destination country code in CC_DIG for the call to the location routing number and changes the NOA code to international. This is an outgoing trunk group property. This property is for PSTN emulation services (SIP/SIP-I).

Valid values: boolean (0 = not enabled, 1 = enabled).

Default value: 0.


LRNDigitCCrm This property specifies a country code digit string to which the RNDigitCCrm is compared if the NOA code is International. If the digits match, the matched digits are removed from the location routing number and the NOA code is set to National. This is an incoming trunk group property. This property is for PSTN emulation services (SIP/SIP-I).

Valid values: NULL or any string up to 5 digits.



PropagateDelayCounter

This property indicates the propagation delay increase value (measured in milliseconds) which the Cisco PGW 2200 Softswitch adds to the propagation delay of the incoming message. The outgoing message carries the calculation result. This property is for PSTN emulation services (SIP-I).

Valid values: integer (0 to 255).

Default value: 0.


RestrictPresIfNoPAID

This property indicates whether the Cisco PGW 2200 Softswitch sets the CgPN APRI of the outgoing ISUP message to presentation restricted when the incoming SIP-I message does not contain the P-Asserted-Identity header. This property is for PSTN emulation services (SIP/SIP-I).

Valid values: boolean

where:

0 = If the incoming SIP-I message does not contain the P-Asserted-Identity header, the Cisco PGW 2200 Softswitch sets the CgPN APRI of the outgoing ISUP message according to the ITU-T Recommendation Q1912.5.

1 = If the incoming SIP-I message does not contain the P-Asserted-Identity header, the Cisco PGW 2200 Softswitch sets the CgPN APRI of the outgoing ISUP message to presentation restricted.

Default value: 0.




SIPCOLPReqEnabled

This property specifies whether the COLP request for SIP-originated calls is enabled or not. This property is for PSTN emulation services (SIP/SIP-I).

Values: boolean (0 = not enabled, 1 = enabled).

Default value: 0.


SipEgressEarlyDialogRelType

This property indicates whether the Cisco PGW 2200 Softswitch sends the CANCEL message or the BYE message for the Early Dialog release. This property is for Q.1912.5 compliance.

Valid values: boolean (0 = send the CANCEL message, 1 = send the BYE message).

Default value: 0.


SipEgressGN2FromScreenInd

This property controls how the Cisco PGW 2200 Softswitch maps the generic number to the SIP From header. This property is for PSTN emulation services (SIP/SIP-I).

Valid values: integer (from 0 to 3)

where:

0 = UPVP and UPNVIf the screen indicator subparameter in the incoming ISUP message is UPVP or UPNV and the property value is 0, the Cisco PGW 2200 Softswitch maps the generic number to the SIP From header.

1 = UPVPIf the screen indicator subparameter in the incoming ISUP message is UPVP and the property value is 1, the Cisco PGW 2200 Softswitch maps the generic number to the SIP From header.

2 = UPNVIf the screen indicator subparameter in the incoming ISUP message is UPNV and the property value is 2, the Cisco PGW 2200 Softswitch maps the generic number to the SIP From header.

3 = always mappingIf the property value is 3, the Cisco PGW 2200 Softswitch always maps the generic number to the SIP From header.

Default value: 0.


SipICANCELEncapREL

This property indicates whether the encapsulated REL message is required or not in the CANCEL message.

This property is a non-essential SIP-I-specific property.

Valid values: boolean (0 = not required, 1 = required).

Default value: 0.


Table 1 New Properties (continued)




SipICLICOLPreference

This property indicates which parameters the CLI/Connect number takes as preference, SIP header or ISUP parameters. This property is a non-essential SIP-I-specific property.

Valid values: boolean.

0 = CLI/Connect number takes SIP header parameters as preference.

1 = CLI/Connect number takes ISUP parameters as preference.

Default value: 0.


SipIConfusionHandling

This property indicates whether to terminate the ISUP confusion message or transport this message transparently. This property is a non-essential SIP-I-specific property.

Valid value: boolean.

0 = terminate the ISUP confusion message.

1 = transport the ISUP confusion message transparently.

Default value: 0.


SipIEgressHandling

This property indicates the value of handling the disposition parameter in the Content-Disposition header field of the ISUP MIME body in SIP-I messages. This property is set on outgoing trunk groups with SIP-I support. If it is set to 2, “handling=required” is always added to the INVITE Content-Disposition header. If it is set to 0, “handling=required” is added only if there is a to-be-encapsulated IAM message with user-to-user information; otherwise, “handling=optional” is added. This property is an essential SIP-I-specific property.

Valid value: integer (from 0 to 2)

where:

0 = Content-Disposition header is “Content-Disposition:signal; handling=required” only if there is a to-be-encapsulated IAM message with user-to-user information; otherwise, Content-Disposition header is “Content-Disposition:signal; handling=optional”.

1 = Content-Disposition header is “Content-Disposition:signal; handling=optional”.

2 = Content-Disposition header is “Content-Disposition:signal; handling=required”.

Default value: 1.


SipIEgressISUPVersion

This property indicates the version subparameter used in the Content-Type header field for SIP-I messages on the outgoing SIP trunk group. This property is an essential SIP-I-specific property.

Valid values: NULL or any string up to 128 characters in length.







SipIEgressMDO This property indicates the SIP-I variant name on the outgoing SIP trunk group. This property is an essential SIP-I-specific property.

Valid values: NULL or any string up to 40 alphanumeric characters.



SipIFacilityRejectHandling

This property indicates whether to terminate the ISUP facility reject message or transport this message transparently. This property is a non-essential SIP-I-specific property.

Valid values: boolean.

0 = terminate the ISUP facility reject message.

1 = transport the ISUP facility reject message transparently.

Default value: 0


SipIIngressVersionMAP

This property indicates the SIP-I mapping profile name which is defined in the SIP profile name field of the sipIVersion.dat file. This property is an essential SIP-I-specific property.

Valid values: NULL or the string defined in the SIP-I mapping profile name field of the sipIVersion.dat file, like BT.



SipIngressLNPHandling

This property controls whether the Cisco PGW 2200 Softswitch maps the SIP routing number and the telephone number to the called party number and the generic address ISUP parameters. This property is for PSTN emulation services (SIP/SIP-I).

Valid values: boolean (0 = no mapping, 1 = mapping)

Default value: 0.






Updated Properties

The following existing sigpath properties are added to the SIP sigpath in this feature.

• ADigitCCPrefix

• ADigitCCrm

• BDigitCCPrefix

• BDigitCCrm

• CCOrigin

For Finnish SIP-I, you can provision the following properties in the common profile.

• AOCEnabled

• CircHopCount

• CLIPEss

• PropagateDelayCounter

• SatelliteInd

Table 2 describes SIP profile properties which have modified values in this feature.

SipInsertReasonHeader

This property indicates whether a reason header containing the cause code is required or not. This property is for Q.1912.5 compliance.


where:

0 = do not insert the reason header.

1 = add the reason header in Q.850 format.

2 = add the reason header in ANSI format.

Default value: 0.


SipIToiw2 This property indicates the Toiw2 timer value measured in seconds. This property is for Q.1912.5 compliance.

Valid values: integer (from 4 to 14).

Cause for initiation: Sending of INVITE.

Termination criterion: On receipt of 18x, or 200 OK INVITE.

Action At expiry: Send early ACM

Default value: 4.






Table 2 Updated Properties


InhibitSipFromMapping

The value 5 is added in this feature. This property determines the mapping from the incoming SIP message to the ISUP CLI. This property is for PSTN emulation services (SIP/SIP-I).

Valid values:

• 0 = If the PAID/RPID E164 number is present, map the PAID/RPID to CgPN, and map the E164 number in username in From header to GN (additional CgPN). If the PAID/RPID E164 number is not present, map the E164 number in username in From header to CgPN.

• 1 = Ignore the From header, and map the PAID/RPID E164 number to CgPN.If the remote party ID or P-Asserted-ID header is present and the InhibitSipFromMapping property = 1, then disable mapping the SIP From header to the generic number. If the remote party ID or P-Asserted-ID header is not present and the InhibitSipFromMapping property = 1, then disable mapping the SIP From header to the calling party number.

• 2 = Ignore the PAID/RPID, and map the E164 number in the username in From header to CgPN.

• 3 = If the PAID/RPID E164 number is present, map the PAID/RPID to CgPN, and map the E164 number in Display name in From header to GN (additional CgPN). If the PAID/RPID E164 number is not present, map the E164 number in the username in From header to ISUP CgPN, and map the E164 number in the displayname in From header to GN (additional CgPN).

• 4 = If the PAID/RPID E164 number is present, map the PAID/RPID to CgPN, and map the E164 number in the username in From header to GN (additional CgPN). If the PAID/RPID E164 number is not present, ignore From header.

• 5 = If the PAID/RPID E164 number is present, map the PAID/RPID to CgPN, and map the E164 number in username in From header to GN (additional CgPN). If the PAID/RPID E164 number is not present, map the E164 number in the username in From header to ISUP CgPN, and map the E164 number in displayname in From header to GN (additional CgPN).

Note The value 4 is available only in Release 9.7(3). The value 5 is available only in Release 9.8(1).

Default value: 0.




Table 3 describes the original ISUP sigpath properties which you can provision in the common profile for this feature.

sipMimeBodySupport

The values 0, 3, and 4 are added in this feature. This property indicates how SIP, SIP-T, SIP-GTD, and SIP-I are supported on one trunk group. This property is an essential SIP-I-specific property.


where:

• 0 = only SIP supported

• 1 = SIP-T supported

• 2 = SIP-GTD supported

• 3 = Only SIP-I supported on the incoming trunk group, SIP and SIP-I supported on the outgoing trunk group

• 4 = SIP and SIP-I supported on both the incoming and outgoing trunk groups

Default value: 0.


Support183 The values 1, 2, and 5 are added in this feature. This property indicates how the Cisco PGW 2200 Softswitch supports the 183 response code. This property is for Q.1912.5 compliance.

Valid values: integer (from 0 to 5).

where:

0 = 183 not supported

1 = Q1912.5 supported without SDP in 180 message

2 = Q1912.5 supported with InbandInfo check

3 = 183 supported

4 = always send 183

5 = Q1912.5 supported

Default value: 3.


Table 2 Updated Properties (continued)




Result Type DefinitionsTable 4 describes the result type added for this feature. For information on other result type definitions for the Cisco PGW 2200 Softswitch software, see the Cisco PGW 2200 Softswitch Release 9.8 Dial Plan Guide at

http://www.cisco.com/en/US/docs/voice_ip_comm/pgw/9/dial_plan/guide/dplan.html.

Table 3 Properties Provisioned in the Common Profile


T2 This property indicates the ISUP T2 timer value measured in millisecond seconds. This property is for PSTN emulation services (SIP-I).

Valid value: 180000

Cause for initiation: Receives a user generated SUS (user Initiated TP service) in order to unplug the terminal from the socket and plug it in another one.

Termination criterion: At receipt of resume (user) message.

Action at Expiry: Initiate release procedure.

Default value: 180000


Valid value: 2000 - 120000

Cause for initiation: Receives SUS (network)

Termination criterion: At receipt of resume (network) message or release message.


Default value: 120000.


Valid value: 12000 - 15000

Cause for initiation: Sends an MCID request in an Information Request message

Termination criterion: At receipt of at the receipt of an Information Response


Default value: 15000.

CLIPEss This property indicates whether/how to request the Calling Line Identity (CLI) in MCID service. This property is for PSTN emulation services (SIP-I).

Valid value: 0, 1, 2

0 = CLI not requested

1 = CLI requested if not provided and call is dropped if CLI is not available

2 = CLI requested if not provided and call is continued regardless if CLI is available or not

Default value: 0


SIP-I Protocol Feature ModuleTroubleshooting the Feature


SIPI_CONTROL

A new result type SIPI_CONTROL is added to enable the SIP-I route preference and to overwrite the outgoing SIP-I related configuration parameters on outgoing trunk group. Currently this result type is used to enable the SIP-I route preference only.

Dataword 1: enable the route preference

1 = Enable the route preference

Troubleshooting the FeatureThis section describes troubleshooting procedures for this feature:

• Incoming SIP-I calls fail.

Table 4 New Result Type Definitions

Resu

lt N

umbe

r

Result Type Dataword1 Dataword2 Dataword3 Dataword4

Analysis Points

Result Type Valid For

Inte

rmed

iate

End

Poin

t

A-d

igit

anal

ysis

B-d

igit

anal

ysis

Caus

e

Pre-

anal

ysis

84 SIPI_CONTROL Enable the route preference

0 (not used) 0 (not used) 0 (not used) x



• Outgoing SIP-I calls fail.

Action Description

Step 1 Check the property sipMimeBodySupport on the incoming trunk group.

The Cisco PGW 2200 Softswitch requires this property to be set to 3 or 4 in order to support SIP-I on the incoming trunk group.

For property details, see Properties, page 18.

Step 2 Check the SIP-I interface license. Use the MML command, rtrv-lics:all, to check if the SIP-I license is available. The following example gives you an example of using this command to check the SIP-I license.

mml> rtrv-lics:all

The following system output is truncated. The bottom line indicates that the SIP-I interface license is available.

MGC-01 - Media Gateway Controller 2009-02-23 01:53:48.371 ESTM RTRV "LMAgent:------------------------------------------------------------------PGW Fully Featured License 9.8 permanent ------------------------------------------------------------------Interface Name Entitled Provisioned SS7Interface Y Y PRIInterface Y N PBXInterface Y N INAPInterface Y N LIInterface Y N/A SBEInterface Y N SIPIInterface Y Y

Step 3 Check the property SipIIngressVersionMap on the incoming trunk

The Cisco PGW 2200 Softswitch requires this property to be set to the desired SIP-I mapping profile on the incoming trunk group.

See Provisioning Tasks, page 6.

Step 4 Check the entry of that desired SIP-I mapping profile in sipIVersion.dat.

Check if entry of that desired SIP-I mapping profile is correctly provisioned in sipIVersion.dat.

1. Check if the SIP-I version field of that entry matches the version subparameter in the Content-Type in the incoming SIP-I INVITE message.

2. Check if the SIP-I variant field of that entry is correctly provisioned using the following command:

prov-rtrv:sipiversion:profilename="BT",version="etsi356"

For details on how to add, edit, and delete records in the sipIVersion.dat, see Provisioning Tasks, page 6.



• Ringback tones are missing.

Action Description

Step 1 Check the property sipMimeBodySupport on the outgoing trunk group.

The Cisco PGW 2200 Softswitch requires this property to be set to 3 or 4 in order to support SIP on the outgoing trunk group. For property details, see the “Properties” section on page 18.

Step 2 Check the SIP-I interface license. See Step 2 in the previous troubleshooting procedure for failed incoming SIP-I calls.

Step 3 Check the Content-Disposition parameter in the outgoing SIP-I INVITE message.

If it is "handling=optional", change the SipIEgressHandling property on the outgoing trunk group to 2. See the “Provisioning Tasks” section on page 6.

Step 4 Check the SIP-I version defined in SipIEgressISUPVersion property.

Check if the SIP-I version defined in SipIEgressISUPVersion property on the outgoing trunk group matches the SIP-I version of the peer devices.



• (Finnish SIP-I only) Finnish SIP-I doesn’t work.

For more information on operational tasks for the rest of the Cisco PGW 2200 Softswitch software, see the Cisco PGW 2200 Softswitch Release 9 Operations, Maintenance, and Troubleshooting Guide at

http://www.cisco.com/en/US/docs/voice_ip_comm/pgw/9/maintenance/guide/omtguide.html.

Action Description

Step 1 Provision the property support183 on the incoming trunk group.

• If the terminating side cannot play the remote ringback tone, you can provision the support183 property:

– 0 (183 not supported) = The Cisco PGW 2200 Softswitch sends a 180 Ringing without SDP.

– 1 (Q1912.5 supported without SDP in 180 message) = The Cisco PGW 2200 Softswitch sends a 180 Ringing without SDP.

– 2 (Q1912.5 supported with InbandInfo check) = The Cisco PGW 2200 Softswitch sends a 180 Ringing without SDP.

– 3 (183 supported) = The Cisco PGW 2200 Softswitch sends a 180 Ringing without SDP.

• If the terminating side can play the remote ringback tone and the alerting signaling includes the InbandInfo indicator, you can provision the support183 property:

– 2 (Q1912.5 supported with InbandInfo check) = The Cisco PGW 2200 Softswitch sends a 180 Ringing with SDP.

– 3 (183 supported) = The Cisco PGW 2200 Softswitch sends a 183 Session Progress with SDP.

– 4 (always send 183) = The Cisco PGW 2200 Softswitch sends a 183 Session Progress with SDP.

– 5 (Q1912.5 supported) = The Cisco PGW 2200 Softswitch sends a 180 Ringing with SDP.

• If the terminating side can play the remote ringback tone but the alerting signaling does not include the Inbandinfo indicator, you can provision the support183 property:

– 4 (always send 183) = The Cisco PGW 2200 Softswitch sends a 183 Session Progress with SDP.

– 5 (Q1912.5 supported) = The Cisco PGW 2200 Softswitch sends a 180 Ringing with SDP.

Action Description

Step 1 Check the MPM provisioning on the Cisco PGW 2200 Softswitch

For details on provisioning MPM support for Finnish ISUP on the Cisco PGW 2200 Softswitch, see the section, Provisioning Tasks, of the feature guide Meter Pulse Messages Support athttp://www.cisco.com/en/US/docs/voice_ip_comm/pgw/9/feature/module/9.5_1_/FMmpm.html.

Step 2 Check the property SipICLICOLPreference

For Finnish SIP-I, encapsulated ISUP takes precedence over SIP headers. Make sure the SipICLICOLPreference property is set to 1.

http://www.cisco.com/en/US/docs/voice_ip_comm/pgw/9/maintenance/guide/omtguide.html



SIP-I Protocol Feature ModuleObtaining Documentation, Obtaining Support, and Security Guidelines


If you still have problems with this feature, get the MDL trace and contact the Cisco TAC.

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.

Mapping DetailsThis section contains additional information which may be useful for you to understand specific mapping details of parameters. The heavy vertical line in the tables indicates where the mapping takes place. Different combinations of input message parameters and the Cisco PGW 2200 Softswitch properties on the left of the heavy vertical line have corresponding mapping results on the right. These tables are not limited to SIP and ISUP mapping.

Table 5 describes the mapping from SIP header fields to ISUP message parameters under control of the property InhibitSipFromMapping. Table 6 describes the mapping from the address complete message (ACM) to 180 Ringing /183 Session Progress under control of the property Support183. Table 7 describes the mapping from the call progress message (CPG) to 180 Ringing /183 Session Progress under control of the property Support183.

Table 5 Mapping of SIP Header Fields to ISUP CgPN/GN/PN/GAP Address Subparameter Under Control of the

InhibitSipFromMapping Property

SIP Header Fields Property ISUP Parameter Fields

P-Asserted-Identity Field From Field

InhibitSipFromMapping Address Signal in CgPN1 Fields

Address Signal in GN2 or GA3 Fields

Address Signal in PN4 Fields

Present in E164 format5

Present in E164 format

0

4

5

From the E164 number in username of SIP P-Asserted Identity.

Address signal: from the E164 number in username of SIP From header

PN should be the same as GN.

1 Absent

3 Address signal: from the E164 number in displayname of SIP From header

2 From the E164 number in username of SIP From header

Absent

http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html

SIP-I Protocol Feature ModuleMapping Details


Absent or the field not in E164 format

0

1

3

4

5

From the E164 number in username of SIP P-Asserted Identity.

Absent

2 Absent


Present in E164 format

0

2

• From the E164 number in username of SIP From header if username is present in SIP From header

• From the E164 number in displayname of SIP From header if displayname is present in SIP From header and InhibitSipFromMapping = 3

Absent

3

5

The E164 number in displayname of SIP From header is mapped to GA/GN if username present in the SIP From header is already mapped to CgPN.

1

4

Absent Absent


Any valid value (integer, 0 to 5)

Absent Absent

1. CgPN = calling party number.

2. GN = generic number (Q1912.5/EN 383 001, ND 1017 only).

3. GA = generic address (T1.679 only).

4. PN = presentation number (ND1017 only).

5. For SIP-URI in the P-Asserted-Identity or the From header field, if the field userinfo is E164 number with parameter “user=phone” or the field userinfo is E164 number with respectSipUriUserParm value set to 0, the Cisco PGW 2200 Softswitch treats the SIP-URI as E164 format.

Table 5 Mapping of SIP Header Fields to ISUP CgPN/GN/PN/GAP Address Subparameter Under Control of the

InhibitSipFromMapping Property (continued)

SIP Header Fields Property ISUP Parameter Fields

P-Asserted-Identity Field From Field

InhibitSipFromMapping Address Signal in CgPN1 Fields

Address Signal in GN2 or GA3 Fields

Address Signal in PN4 Fields



Table 6 Mapping ISUP Address Complete Message (ACM) to 180/183 Under Control of the Property Support183

Called Party Status Indicator in BCI1

1. BCI = Backward Call Indicator.

Local SDP2 Ready

2. SDP = Session Description Protocol.

Support183 Property InbandInfo in OBCI3

3. OBCI = Optional Backward Call Indicator.

Message Sent to SIP

Subscriber free No 4 (always send 183) Any 183 Session Progress

Any other Any 180 Ringing

Yes 0 (183 not supported)

1 (Q1912.5 supported without SDP in 180)

5 (Q1912.5 supported)

2 (Q1912.5 supported with InbandInfo)

Any 180 Ringing

4 (always send 183) Any 183 Session Progress

3 (183 is supported) Has inband indicator 183 Session Progress with SDP

No inband indicator 180 Ringing

No indication or connect when free

No Any valid value (integer, 0 to 5) Any • In Profile C4

183 (ACM) Session Progress

• In Profile BNot interworked

4. For details of the Profile B and Profile C definitions, see the ITU-T Recommendation Q.1912.5 (2004) Interworking between Session Initiation Protocol (SIP) and Bearer Independent Call Control Protocol or ISDN User Part.

Yes 0 (183 not supported) Any 180 Ringing

3 (183 is supported) or 4 (always send 183)

Any 183 Session Progress

1 (Q1912.5 supported without SDP in 180)


Any • In Profile C183 (ACM) Session Progress



Has inband indicator 183 Session Progress

No inband indicator • In Profile C183 (ACM) Session Progress




Note Table 6 is not applicable for SIP to SIP B2BUA. This table is for SIP-I involved calls and SIP-to-EISUP calls. For details on whether or not the Cisco PGW 2200 Softswitch includes SDP in 180/183 messages, see the troubleshooting procedure when ringback tones are missing in the “Troubleshooting the Feature” section on page 27.

Table 7 Mapping ISUP Call Progress Message (CPG) to 180/183 Under Control of the Property Support183

Event Indicator in Event Information of CPG1

1. CPG = call progress message

Local SDP2 Ready

2. SDP = Session Description Protocol

Support183 Property Message Sent to SIP

000 0001 (“alerting”) Either 1 (Q1912.5 supported without SDP in 180)



180 Ringing

1 (183 not supported)

3 (183 supported)

180 Ringing

4 (always send 183) 183 Session Progress

000 0010 (“progress”) No 1 (Q1912.5 supported without SDP in 180)



• In Profile C3

183 (CPG) Session Progress


3. For details of the Profile B and Profile C definitions, see the ITU-T Recommendation Q.1912.5 (2004) Interworking between Session Initiation Protocol (SIP) and Bearer Independent Call Control Protocol or ISDN User Part

Values other than 1, 2, or 5 Not interworked

Yes 1 (Q1912.5 supported without SDP in 180)



• In Profile C183 (CPG) Session Progress


Values other than 1, 2, or 5 183 Session Progress

000 0011 (in-band information or an appropriate pattern is now available)

No 1 (Q1912.5 supported without SDP in 180)





Values other than 1, 2, or 5 Not interworked

Yes 1 (Q1912.5 supported without SDP in 180)




2 (Q1912.5 supported with InbandInfo) 183 (CPG) Session Progress

Values other than 1, 2, or 5 183 Session Progress



Note Table 7 is not applicable for SIP to SIP B2BUA. This table is for SIP-I involved calls and SIP to EISUP calls.

Table 8 describes the mapping from the ISUP connected number parameter to the SIP P-Asserted-Identity header.

Note Cisco PGW 2200 Softswitch does not split the address signal into the format, CC + NDC + SN. You can manipulate the address signal (for example, adding CC, or removing CC) by means of dial plan.

Table 9 is a matrix of calling line identification (CLI) suppression values based upon the incoming PSTN signaling settings and the SIP property cgpnInclude. The property cgpnInclude determines whether the call setup message includes CLI or not.

Table 8 Mapping the ISUP Connected Number Parameter to the SIP P-Asserted-Identity Header

ISUP Connected Number Parameter Value

SIP P-Asserted-Identity Header Value

NOA national (significant) number tel URI or SIP URI1

1. A tel URI or a SIP URI with “user=phone” is used according to operator policy.

CC (country code) is added to connected address signals to construct an E.164 number in the URI. The number is prefixed with a plus sign.

international number Complete connected address signals are mapped to construct an E.164 number in the URI. The number is prefixed with a plus sign.

address signals • If NOA value is national (significant) number, the format of address signals is NDC2+ SN3.

• If NOA value is international number, the format of address signals is CC4 + NDC + SN.

2. NDC = national destination code

3. SN = subscriber number

4. CC = country code

tel URI or SIP URI5

5. A tel URI or a SIP URI with “user=phone” is used according to operator policy.

CC + NDC+ SN as an E.164 number in the URI. The number is prefixed with a plus sign.



Table 10 is a matrix of generic number (GN) suppression values based upon the incoming PSTN signaling settings and the SIP property cgpnInclude. The property cgpnInclude determines whether the call setup message includes GN or not.

Table 11 is a matrix of presentation number (PN) suppression values based upon the incoming PSTN signaling settings and the SIP property cgpnInclude. The property cgpnInclude determines whether the call setup message includes PN or not.

Table 9 CLI Suppression in a SIP Environment Under Control of cgpnInclude

cgpnInclude Value (of Terminating/Outgoing SIP Trunk Group)

Received CLI (in IAM1)

1. IAM = initial address message

Received CLIR2 (in IAM)

2. CLIR = Calling Line Identification Restriction

Displayname Field in the Outgoing Message From Header

Username Field in the Outgoing Message From Header

Not applicable Not available Not available Unknown Unknown

0 (do not include) Available 0 (no restriction)

CLI CLI

0 (do not include) Available 1 (restriction) Anonymous Anonymous

1 (include) Available 0 (no restriction)

CLI CLI

1 (include) Available 1 (restriction) Anonymous CLI

Table 10 GN Suppression in a SIP Environment Under Control of cgpnInclude

cgpnInclude Value (of Terminating/Outgoing SIP Trunk Group) GN (in IAM1)


Received GN APRI2 (in IAM)

2. APRI = Address Presentation Restricted Indicator

Displayname Field in the Outgoing Message From Header

Username Field in the Outgoing Message From Header



Address signal of GN Address signal of GN



Address signal of GN Address signal of GN

1 (include) Available 1 (restriction) Address signal of GN Address signal of GN

Table 11 PN Suppression in a SIP Environment Under Control of cgpnInclude


Received PN (in IAM1)

Received PN APRI2 (in IAM)

Displayname Field in Outgoing Message From Header

Username Field in Outgoing Message From Header



PN if present for the ISUP variant


SIP-I Protocol Feature ModuleGlossary


Glossary





1 (include) Available 1 (restriction) Anonymous PN if present for the ISUP variant


2. APRI = Address Presentation Restricted Indicator

Table 12 Acronyms and Expansions

Acronym Expansion

ACgPN additional calling party number (value of number qualifier indicator within the generic number)

ACM address complete message

APRI Address Presentation Restricted Indicator

BCI Backward Call Indicator

CC country code

CdPN called party number

CgPN calling party number

CIC carrier identification code (ANSI)

CLI calling line identification

CPG call progress message

GN generic number (ITU/ETSI)

ISDN Integrated Services Digital Network

ISUP ISDN User Part

LNP Local Number Portability

MGC media gateway controller

MIME Multipurpose Internet Mail Extensions

NDC National Destination Code

NOA nature of address indicator

OBCI Optional Backward Call Indicator

PGW PSTN Gateway

PN presentation number (UK)

PSTN public switched telephone network

REL release message

Table 11 PN Suppression in a SIP Environment Under Control of cgpnInclude (continued)


Received PN (in IAM1)

Received PN APRI2 (in IAM)

Displayname Field in Outgoing Message From Header

Username Field in Outgoing Message From Header

SIP-I Protocol Feature ModuleGlossary


CCDE, CCENT, CCSI, Cisco Eos, Cisco HealthPresence, Cisco IronPort, the Cisco logo, Cisco Nurse Connect, Cisco Pulse, Cisco SensorBase, Cisco StackPower, Cisco StadiumVision, Cisco TelePresence, Cisco Unified Computing System, Cisco WebEx, DCE, Flip Channels, Flip for Good, Flip Mino, Flipshare (Design), Flip Ultra, Flip Video, Flip Video (Design), Instant Broadband, and Welcome to the Human Network are trademarks; Changing the Way We Work, Live, Play, and Learn, Cisco Capital, Cisco Capital (Design), Cisco:Financed (Stylized), Cisco Store, Flip Gift Card, and One Million Acts of Green are service marks; and Access Registrar, Aironet, AllTouch, AsyncOS, Bringing the Meeting To You, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, CCSP, CCVP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco IOS, Cisco Lumin, Cisco Nexus, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity, Collaboration Without Limitation, Continuum, EtherFast, EtherSwitch, Event Center, Explorer, Follow Me Browsing, GainMaker, iLYNX, IOS, iPhone, IronPort, the IronPort logo, Laser Link, LightStream, Linksys, MeetingPlace, MeetingPlace Chime Sound, MGX, Networkers, Networking Academy, PCNow, PIX, PowerKEY, PowerPanels, PowerTV, PowerTV (Design), PowerVu, Prisma, ProConnect, ROSA, SenderBase, SMARTnet, Spectrum Expert, StackWise, WebEx, and the WebEx logo are registered trademarks of Cisco Systems, Inc. and/or its affiliates in the United States and certain other countries.

All other trademarks mentioned in this document or website are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (0910R)

Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display output, network topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in illustrative content is unintentional and coincidental.

© 2008–2009 Cisco Systems, Inc. All rights reserved.

SDP Session Description Protocol

SIP Session Initiation Protocol

SIP-I SIP with encapsulated ISUP

SIP-T Session Initiation Protocol for Telephones

Table 12 Acronyms and Expansions (continued)

Acronym Expansion