Guest

Cisco PGW 2200 Softswitch

SIP-I Protocol

  • Viewing Options

  • PDF (523.5 KB)
  • Feedback
SIP-I Protocol Feature Module

Table Of Contents

SIP-I Protocol Feature Module

Feature Overview

Benefits

Prerequisites

Restrictions or Limitations

Related Documents

Supported Standards, MIBs, and RFCs

Provisioning Tasks

Provisioning an Incoming SIP Trunk Group

SIP-I Version Name and ISUP Variant Mapping

Add a SIP Profile

Attach the SIP-I Mapping Profile to the SIP Profile

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

Attach the SIP Profile to the Trunk Group

Incoming SIP-I Message Processing

Provisioning an Outgoing SIP Trunk Group

Add a SIP Profile

Provision the SIP-I Version on the SIP Profile

Provision the SIP-I Variant on the SIP Profile

Provision the Handling Property on the SIP Profile

(Optional) Provision the SipICANCELEncapREL Property on the SIP Profile

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

Attach the SIP Profile to the Trunk Group

Outgoing SIP-I Message Processing

Enabling the Route Preference

Additional Provisioning for Finnish SIP-I

Add Meter Pulse Message Support

Give ISUP Encapsulation Priority over SIP Headers

Map the Cause Code

Stop the Hop Counter and Satellite Indicator From Increasing

Set Calling Party Number (CgPN) APRI to Presentation Restricted

Provisioning Examples

MML Command Reference

New MML Commands

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

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

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

Modified MML Commands

Related MML Commands

Software Changes for This Feature

Alarms

Unsupported SIP-I Call

Properties

New Properties

Updated Properties

Result Type Definitions

Troubleshooting the Feature

Obtaining Documentation, Obtaining Support, and Security Guidelines

Mapping Details

Glossary


SIP-I Protocol Feature Module


Document Release History

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.


Feature History

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.


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

Feature Overview

Supported Standards, MIBs, and RFCs

Provisioning Tasks

Provisioning Examples

MML Command Reference

Software Changes for This Feature

Troubleshooting the Feature

Obtaining Documentation, Obtaining Support, and Security Guidelines

Mapping Details

Glossary

Feature Overview

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

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.

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.

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

Benefits

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

Prerequisites

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

Restrictions or Limitations

The 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 Documents

This 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 Tasks

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

Provisioning an Incoming SIP Trunk Group

Provisioning an Outgoing SIP Trunk Group

Enabling the Route Preference

Additional Provisioning for Finnish SIP-I

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_FINNISH9
6_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.

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


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"

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.

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.

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"

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.

(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",t
2="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 Preference

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

Finnish SIP-I has some specific message requirements which require additional provisioning:

Add Meter Pulse Message Support

Give ISUP Encapsulation Priority over SIP Headers

Map the Cause Code

Stop the Hop Counter and Satellite Indicator From Increasing

Set Calling Party Number (CgPN) APRI to Presentation Restricted

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.

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= 169
numan-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.

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


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"
prov-ed:profile:name="sipi-in",commonprofile="sipicommon" (using Finnish SIP-I on incoming 
trunks)
or
prov-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 Examples

This 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_FINNISH9
6_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"

________________________________________
; 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",t
2="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= 169
numan-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)
or
prov-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
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
prov-ed:profile:name="sipi-in",restrictpresifnopaid="1"

MML Command Reference

This 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 Commands

This 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


PROV-ED:SIPIVERSION:PROFILENAME—Edit 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:

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 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_U
K_SIPI"

Comments:

Performance Impact Category: A


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

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:

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.

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"

Comments:

Performance Impact Category: A


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

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:

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.

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"

Comments:

Performance Impact Category: A


Modified MML Commands

No MML commands are modified for this feature.

Related MML Commands

You 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 Feature

The following sections contain software changes related to this feature:

Alarms

Properties

Result Type Definitions

Alarms

This 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

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"

Properties

The 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), 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

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.

Dynamically reconfigurable: yes.

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.

Default value: NULL.

Dynamically reconfigurable: yes.

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.

Dynamically reconfigurable: yes.

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.

Dynamically reconfigurable: yes.

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.

Dynamically reconfigurable: yes.

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.

Dynamically reconfigurable: yes.

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 UPNV
If 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 = UPVP
If 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 = UPNV
If 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 mapping
If the property value is 3, the Cisco PGW 2200 Softswitch always maps the generic number to the SIP From header.

Default value: 0.

Dynamically reconfigurable: yes.

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.

Dynamically reconfigurable: yes.

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.

Dynamically reconfigurable: yes.

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.

Dynamically reconfigurable: yes.

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.

Dynamically reconfigurable: yes.

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.

Default value: NULL.

Dynamically reconfigurable: yes.

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.

Default value: NULL.

Dynamically reconfigurable: yes.

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

Dynamically reconfigurable: yes.

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.

Default value: NULL.

Dynamically reconfigurable: yes.

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.

Dynamically reconfigurable: yes.

SipInsertReasonHeader

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

Valid values: integer (from 0 to 2)

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.

Dynamically reconfigurable: yes.

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.

Dynamically reconfigurable: yes.


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.

Table 2 Updated Properties 

Property
Description

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.

Dynamically reconfigurable: yes.

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.

Valid values: integer (from 0 to 4)

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.

Dynamically reconfigurable: yes.

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.

Dynamically reconfigurable: yes.


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

Table 3 Properties Provisioned in the Common Profile

Property
Description

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

T6

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

Valid value: 2000 - 120000

Cause for initiation: Receives SUS (network)

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

Action at Expiry: Initiate release procedure.

Default value: 120000.

T33

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

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

Action at Expiry: Initiate release procedure.

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


Result Type Definitions

Table 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 4 New Result Type Definitions 

Result Number
Result Type
Dataword1
Dataword2
Dataword3
Dataword4
Analysis Points
Result Type Valid For
Intermediate
End Point
A-digit analysis
B-digit analysis
Cause
Pre-analysis

84

SIPI_CONTROL

Enable the route preference

0 (not used)

0 (not used)

0 (not used)

     

 x

   

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 Feature

This section describes troubleshooting procedures for this feature:

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

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 EST

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

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="etsi
356"

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

Outgoing SIP-I calls fail.

 
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.

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.

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.

Ringback tones are missing.

 
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.

(Finnish SIP-I only) Finnish SIP-I doesn't work.

 
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 at
http://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.

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.

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 Details

This 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 CgPN 1 Fields
Address Signal in GN 2 or GA 3 Fields
Address Signal in PN 4 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

 

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

Absent or the field not in E164 format

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

Absent or the field not in E164 format

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 6 Mapping ISUP Address Complete Message (ACM) to 180/183 Under Control of the Property Support183 

Called Party Status Indicator in BCI 1
Local SDP 2 Ready
Support183 Property
InbandInfo in OBCI 3
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 B
Not interworked

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)

5 (Q1912.5 supported)

Any

In Profile C
183 (ACM) Session Progress

In Profile B
Not interworked

2 (Q1912.5 supported with InbandInfo)

Has inband indicator

183 Session Progress

No inband indicator

In Profile C
183 (ACM) Session Progress

In Profile B
Not interworked

1 BCI = Backward Call Indicator.

2 SDP = Session Description Protocol.

3 OBCI = Optional Backward Call Indicator.

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.



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.


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

Event Indicator in Event Information of CPG 1
Local SDP 2 Ready
Support183 Property
Message Sent to SIP

000 0001 ("alerting")

Either

1 (Q1912.5 supported without SDP in 180)

5 (Q1912.5 supported)

2 (Q1912.5 supported with InbandInfo)

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)

5 (Q1912.5 supported)

2 (Q1912.5 supported with InbandInfo)

In Profile C3
183 (CPG) Session Progress

In Profile B
Not interworked

Values other than 1, 2, or 5

Not interworked

Yes

1 (Q1912.5 supported without SDP in 180)

5 (Q1912.5 supported)

2 (Q1912.5 supported with InbandInfo)

In Profile C
183 (CPG) Session Progress

In Profile B
Not interworked

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)

5 (Q1912.5 supported)

2 (Q1912.5 supported with InbandInfo)

In Profile C
183 (CPG) Session Progress

In Profile B
Not interworked

Values other than 1, 2, or 5

Not interworked

Yes

1 (Q1912.5 supported without SDP in 180)

5 (Q1912.5 supported)

In Profile C
183 (CPG) Session Progress

In Profile B
Not interworked

2 (Q1912.5 supported with InbandInfo)

183 (CPG) Session Progress

Values other than 1, 2, or 5

183 Session Progress

1 CPG = call progress message

2 SDP = Session Description Protocol

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



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.

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

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.

tel URI or SIP URI5

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

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

2 NDC = national destination code

3 SN = subscriber number

4 CC = country code

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



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 9 CLI Suppression in a SIP Environment Under Control of cgpnInclude

cgpnInclude Value (of Terminating/Outgoing SIP Trunk Group)
Received CLI (in IAM 1 )
Received CLIR 2 (in IAM)
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

1 IAM = initial address message

2 CLIR = Calling Line Identification Restriction


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 10 GN Suppression in a SIP Environment Under Control of cgpnInclude

cgpnInclude Value (of Terminating/Outgoing SIP Trunk Group)
GN (in IAM 1 )
Received GN APRI 2 (in IAM)
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)

Address signal of GN

Address signal of GN

0 (do not include)

Available

1 (restriction)

Anonymous

Anonymous

1 (include)

Available

0 (no restriction)

Address signal of GN

Address signal of GN

1 (include)

Available

1 (restriction)

Address signal of GN

Address signal of GN

1 IAM = initial address message

2 APRI = Address Presentation Restricted Indicator


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 11 PN Suppression in a SIP Environment Under Control of cgpnInclude 

cgpnInclude Value (of Terminating/Outgoing SIP Trunk Group)
Received PN (in IAM 1 )
Received PN APRI 2 (in IAM)
Displayname Field in Outgoing Message From Header
Username Field in Outgoing Message From Header

Not applicable

Not available

Not available

Unknown

Unknown

0 (do not include)

Available

0 (no restriction)

PN if present for the ISUP variant

PN if present for the ISUP variant

0 (do not include)

Available

1 (restriction)

Anonymous

Anonymous

1 (include)

Available

0 (no restriction)

PN if present for the ISUP variant

PN if present for the ISUP variant

1 (include)

Available

1 (restriction)

Anonymous

PN if present for the ISUP variant

1 IAM = initial address message

2 APRI = Address Presentation Restricted Indicator


Glossary

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

SDP

Session Description Protocol

SIP

Session Initiation Protocol

SIP-I

SIP with encapsulated ISUP

SIP-T

Session Initiation Protocol for Telephones