You are viewing an old version of this page. View the current version.
Compare with Current
View Page History
Version 1
Next »
This section lists CLI commands to configure SIP egress IP attributes for sending a call in the forward direction to the peer.
Command Syntax
% set profiles signaling ipSignalingProfile <SIP profile name> egressIpAttributes
bci
bciInterworkEncountered <disable | enable>
bciIsdnAddess <disable | enable>
domainName
useIpSignalingPeerDomainInRequestUri <disable | enable>
useSipDomainNameInFromField <disable | enable>
preserveIngressFromDomainName <disable | enable>
useLowerCaseDomainNames <disable | enable>
useSipDomainNameInRequestUri <disable | enable>
preserveIngressRUriDomainName <disable | enable>
useLowerCaseDomainNames <disable | enable>
useZoneLevelDomainNameInContact <disable | enable>
flags
bgcfTargetSchemeTransparency <disable | enable>
convertInactiveToSendrecv <disable | enable>
disable2806Compliance <disable | enable>
disableOptionalRegisterParameters <disable | enable>
ignoreSdpAfterOfferAnswerCompleted <disable | enable>
includeEnumParameters <disable | enable>
map181Or182MessageTo183 <disable | enable>
mapContractorNumberInPSigInfoHeader <disable | enable>
qosBasedRouting <disable | enable>
sameCallIdForRequiredAuthorization <disable | enable>
suppressUnregister <disable | enable>
ttcIsupMapping <disable | enable>
useCalledPartyInRequestUri <disable | enable>
useColonInSdpMediaTypeParameter <disable | enable>
validateIsubAddress <disable | enable>
isub
allowNsapIsub <disable | enable>
allowUserSpecifiedIsub <disable | enable>
includeCalledPartyIsub <disable | enable>
includeCallingPartyIsub <disable | enable>
mediaQosKpiProfile <profile_name>
numberGlobalizationProfile <profile_name>
numberPortabilityAttributes
disableRn <disable | enable>
npdiOptions <doNotIncludeNpdi | includeNpdi | includeNpdiYes>
pChargeInfo
includeNOA <disable | enable>
includeNPI <disable | enable>
pChargeInfoTransparency <disable | enable>
pChargeInfoType <headerParameter | uriParameter | userParameter>
phoneContextParameterLength (0-31)
privacy
flags
includeEmbeddedPAIheaderInRedirectedInvite <disable | enable>
includePrivacy <disable | enable>
msLyncPrivacySupport <disable | enable>
privacyRequiredByProxy <disable | enable>
privacyInformation
<pAssertedId | pPreferredId | remotePartyId>
transparency <disable | enable>
redirect
contactHandling <mergeReceivedContacts | purgeExistingContacts>
flags
forceRequeryForRedirection <disable | enable>
honorEmbeddedHeadersin3xx <disable | enable>
relayUnusedContactParams <disable | enable>
skipCrankbackProfileAndAlwaysCrankback <disable | enable>
mode <acceptRedirection | allowSingleRedirectAttempt | rejectRedirection>
signalingQosKpiProfile <profile_name>
sipHeadersAndParameters
callForwarding
dataMapping <diversion | none | pkHeader>
diversionHeaderTransparency <disable | enable>
diversionHistoryInfoInterworking <disable | enable>
historyInformation
includeHistoryInformation <disable | enable>
causeParameterInRFC4458 <disable | enable>
reasonWithCauseValueAsPerRFC4244 <disable | enable>
destinationTrunkGroupOptions <includeDtg | includeNone | includeTgrpWithDomainName | includeTgrpWithIpAddress>
flags
endToEndAck <disable | enable>
includeCic <disable | enable>
includeCpcInformation <disable | enable>
includeNpi <disable | enable>
includeOlip <disable | enable>
includePKAdn <disable | enable>
includePstnParameters <disable | enable>
includeQvalue <disable | enable>
skipCSeqCheckInEarlyDialog <disable | enable>
transparencyForDestinationTrunkGroupParameter <disable | enable>
generateCallIdUsing <doNotUseIngressCallId | useIngressCallIdByAddingStaticString | useIngressCallIdByPrepending>
includeChargeInformation <includeNone | includePChargeInfo>
originatingTrunkGroupOptions <includeNone | includeOtg | includeTgrpWithDomainName | includeTgrpWithIpAddress>
sipToHeaderMapping <calledNumber | gapDialedNumber | none | originalCalledNumberOcn>
transport
type1...type4 <none | sctp | tcp | tlsOverTcp | udp>
Command Parameters
The IP Signaling Profile SIP Egress IP Attributes are as shown below:
IP Signaling Profile SIP Egress IP
Parameter | Length/Range | Description |
---|
bci
| N/A | Use this object to configure Backward Call Indicator (BCI) for Egress IP attributes. bciInterworkEncountered – Enable flag to indicate that ISUP is interworking with a network which is not capable of providing as many services as ISUP does. ISUP networks will therefore not employ certain features they otherwise normally would, including potentially the use of ISDN cause codes in failure conditions .bciIsdnAddess – Enable flag to enable ISDN Address in the BCI parameter of backward SS7 messages (e.g. ACM or ANM).
|
domainName
| N/A | Use this object to specify use of domain names. For parameter details see domainName Parameters table below. |
flags
| N/A | Use this object to set egress IP attribute flags.
If ‘onhold’ is received on ingress leg and ‘sendrecv’ is sent to egress leg, then the peer egress must respond with 18x/2xx with ‘sendrecv’. Only the ingress leg can trigger ‘offhold’. Other behavior is not supported.
When includeEnumParameters flag is enabled, do not enable other flags for standard parameters such as includeCic , and includeNpdi .
To view and configure this flag, you must first enable both 'authCodeHeaders ' transparency flag and 'statusCode4xx6xx ' relay flag.
suppressUnregister – Enable flag to prevent
Unable to show "metadata-from": No such page "_space_variables" from sending an unregister message (Register=0) to the registrar upon expiration of a SIP UA registration. When disabled, the Unable to show "metadata-from": No such page "_space_variables" generates unregister messages on the egress leg if the UA does not refresh the registration on time.ttcIsupMapping – When enabled, and when the IP protocol type of the IP signaling profile entry is SIP or SIP-I, the application that receives the Unable to show "metadata-from": No such page "_space_variables" policy response (which can be either the SIP signaling gateway application on the Unable to show "metadata-from": No such page "_space_variables" or the SIP core proxy on the Unable to show "metadata-from": No such page "_space_variables" ) applies the mapping necessary for TTC-ISUP signaling.useCalledPartyInRequestUri – When enabled, the Unable to show "metadata-from": No such page "_space_variables" copies the username selected for the "To" header to the Request URI instead of the registered username. When disabled, the Unable to show "metadata-from": No such page "_space_variables" includes the registered username in the Request URI. This flag is used when interoperating with IP-PBXs that require the real end station number in the Request URI in order to do proper routing of calls terminating on them.useColonInSdpMediaTypeParameter – When enabled, a colon (:) is used as the separator between the SDP Media Type parameter key and value. When disabled, an equal sign (=) is used as the separator between the SDP Media Type parameter key and value.validateIsubAddress – When enabled, the Unable to show "metadata-from": No such page "_space_variables" validates ISUB digits for called and calling parties. When disabled, the Unable to show "metadata-from": No such page "_space_variables" will not validate ISUB digits.
|
isub
| N/A | Use this object to configure ISDN Calling Party Subaddress (ISUB) parameters: allowNsapIsub – Enable to allow NSAP ISUB parameter.allowUserSpecifiedIsub – Allow user-specified ISUB.includeCalledPartyIsub – Include called party ISUB.includeCallingPartyIsub – Include calling party ISUB.
|
mediaQosKpiProfile
| N/A | The Media QoS KPI (Key Performance Indicator) Profile name. |
numberGlobalizationProfile
| N/A | The Number Globalize Profile name. This profile converts numbers to SIP global number format. |
numberPortabilityAttributes
| N/A | Number portability attributes configuration. disableRn – Enable flag to prevent the Unable to show "metadata-from": No such page "_space_variables" and ERE SIP proxy/redirector from sending the SIP rn parameter in the egress INVITE message when an LNP translated number is present. When the flag is disabled, the Unable to show "metadata-from": No such page "_space_variables" and ERE SIP proxy/redirector send "rn=NNNN" in the userinfo portion of the Request URI, where "NNNN" is the LNP translated number.npdiOptions – Use the following options to specify whether the Unable to show "metadata-from": No such page "_space_variables" and ERE SIP proxy/redirector send the SIP NPDI parameter in the egress INVITE message when LNP translation is performed by ERE call processing or the preceding switch.doNotIncludeNpdi – Do not send the NPDI parameter.includeNpdi – Send "npdi" in the userinfo portion of the Request URI.includeNpdiYes – (default) Send "npdi=yes" in the userinfo portion of the Request URI.
|
pChargeInfo | | Use this parameter to configure egress P-Charge-Info header in INVITE message behavior. includeNOA – Enable flag to include Nature of Address Indicator in egress P-Charge-Info header in INVITE message.
includeNPI – Enable flag to include Number Plan Indicator in egress P-Charge-Info header in INVITE message.
pChargeInfoTransparency – Enable flag to transparently pass egress P-Charge-Info header in INVITE message.
When pChargeInfoTransparency is enabled, the flags includeNOA , includeNPI and pChargeInfoType are not visible.
pChargeInfoType – The format types for which NPI/NOA are encoded in P-Charge-Info header. Options include:
headerParameter – NPI and NOA are sent in header parameter format. For example, P-Charge-Info: <sip:123456@10.54.69.140>;npi=ISDN;noa=3uriParameter (default) – NPI and NOA are sent in uri parameter format. For example, P-Charge-Info: sip:123456@10.54.69.144;npi=ISDN;noa=3userParameter – NPI and NOA are sent in user info parameter format. For example, P-Charge-Info: <sip:12345;npi=ISDN;noa=3@10.54.69.144>
The pChargeInfo parameter is only available when includeChargeInformation flag is set to "includePChargeInfo ".
|
phoneContextParameterLength
| 0-31 | Use this attribute to specify the length of phone-context parameter sent in RURI and To headers of the egress message (default = 0). When a value greater than "0" is configured, and the called number is globalized using the existing globalization profile, the PSX sends the configured value in a policy response to the Unable to show "metadata-from": No such page "_space_variables" . The Unable to show "metadata-from": No such page "_space_variables" uses this configured value to insert phone-context parameter of received length in RURI and To headers. |
privacy
| N/A | Specifies the privacy parameters. |
redirect
| N/A | Specifies the redirect parameters. contactHandling – Select one of the following to control processing of contacts received in SIP Redirects:mergeReceivedContacts – Contacts received in Redirects are ordered by q-value and inserted at the head of the list of untried contacts.purgeExistingContacts – Contacts received in Redirects are ordered by q-value and replace untried contacts.
flags forceRequeryForRedirection – (applies to Invite requests only) Use flag to re-query ERE with contact information received in a 3xx response for redirection-type scenarios.honorEmbeddedHeadersin3xx – Enable flag to allow the processing of embedded headers in 3xx Contact headers for the trunk group that received the 3xx.
relayUnusedContactParams – When enabled, Contact parameters received in 3xx responses that are not consumed/processed locally by the SBC (see NOTE below) can now be passed through to the R-URI of subsequent INVITE request.skipCrankbackProfileAndAlwaysCrankback – Enable this flag to force any 4xx–6xx SIP response code to cause crankback so the next potential contact or 3xx response is tried. If disabled, only the response codes specified in default SBC crankback profile cause the call to crank back.mode – Use this object to control SIP redirection:acceptRedirection – (default) Multiple redirections are allowed.allowSingleRedirectAttempt – Only a single Redirect is allowed per route. Additional Redirects cause crankback to be performed.rejectRedirection – If a Redirect is received, crank back is performed.
NOTE
Parameters consumed/processed locally by the SBC and excluded from relayUnusedContactParams command include: - dtg
- tgrp
- trunk-context
- cic
- npdi
- npi
- rn
- bgid
- bgt
- user
- phone-context
|
signalingQosKpiProfile
| N/A | The Signaling QoS KPI (Key Performance Indicator) Profile name. |
sipHeadersAndParameters
| N/A | Specifies the SIP header parameters. See sipHeadersAndParameters Parameters table below for parameter details. |
transport
| N/A | Use this object to set up to four transport parameter types: Each transport type above can be set to any one of the following transport protocols:
none (default)sctp tcp tlsOverTcp udp
|
Parameter | Description |
---|
useIpSignalingPeerDomainInRequestUri | Enable flag to use IP Signaling Peer Domain in Request URI. |
useSipDomainNameInFromField | By default, Unable to show "metadata-from": No such page "_space_variables" uses its IP address as the host-port of the FROM URI in the outgoing INVITE message. Enable flag to use the originating gateway information returned in the policy response as the host-port of the FROM URI in the outgoing INVITE message. When useSipDomainNameInFromField is enabled, the following parameters are available: preserveIngressFromDomainName – If a SIP domain is configured for the ingress trunk group and this flag is enabled, the default gateway associated with that SIP domain will be the originating gateway. Otherwise, the originating gateway will be the default gateway associated with the SIP domain associated with the Softswitch entity.
useLowerCaseDomainNames – Set flag to allow lower case domain name.
The above two flags only apply when a domainName is configured for this zone (see Zone - CLI page).
|
useSipDomainNameInRequestUri | Use this flag to specify how to treat SIP Domain name in outgoing SIP INVITE. When useSipDomainNameInRequestUri is enabled, the following parameters are available: |
useZoneLevelDomainNameInContact
| Enable flag to use Zone level domain name in Contact header. |
sipHeadersAndParameters Parameters
Parameter | Description |
---|
callForwarding | This parameter is used to control the call forwarding data mapping method in egress SIP signaling.
diversionHistoryInfoInterworking is only visible when either Diversion or History-Info header is selected as the egress call forwarding header. Diversion and History-Info Transparency configuration controls are ignored when it is enabled. This parameter has precedence over the others.
historyInformation includeHistoryInformation – Use this parameter to specify how to treat call forwarding history information. Enable this flag to include History-Info in INVITE egress message.
disable (default)enable
causeParameterInRFC4458 – Enable this flag to include the History-Info cause value in egress message as per RFC 4458 recommendation. When the flag is enabled, the output is similar to the following example:
History-Info: < sip:1234567890@P1.interwork.com?Privacy=none>;index=1, <sip: last_diverting_target;cause=408>;index=1.1
reasonWithCauseValueAsPerRFC4244 – Enable this flag to include History-Info cause value with Reason Header as per RFC 4244 recommendation. When the flag is enabled, the output is similar to the following example:
History-Info: <sip:1234567890@P1.interwork.com?Privacy=none>;index=1, <sip: last_diverting_target?Reason=SIP%3Bcause%3D408>;index=1.1
|
destinationTrunkGroupOptions | Use this parameter to specify destination trunk group options. includeDtg – Include the destination trunk group parameter in SIP headers sent over associated trunk group.includeNone (default) – Do not include any trunk group information.includeTgrpWithDomainName – Include trunk group with domain name.includeTgrpWithIpAddress – Include the destination trunk group, and include the trunk context as domain name.
|
flags | Use this object to configure the SIP Headers and Parameters flags. includeNpi – If enabled, the Unable to show "metadata-from": No such page "_space_variables" includes the Numbering Plan Indicator in a npi= parameter in outgoing INVITE messages.includeOlip – If enabled, the Unable to show "metadata-from": No such page "_space_variables" includes the Originating Line Information Parameter in a oli= parameter in outgoing INVITE messages.includePKAdn – When enabled, the Unable to show "metadata-from": No such page "_space_variables" includes the P-K-Adn header in egress SIP messages. When disabled, the Unable to show "metadata-from": No such page "_space_variables" does not include the P-K-Adn header. The P-K-Adn header is a customer-specific SIP header used for ISUP-to-SIP interworking and contains the Translation Source Number (TSN) used in Number to SIP URL translation via the Number Username Translation screen (Generic variant only).includePstnParameters – If enabled, the Unable to show "metadata-from": No such page "_space_variables" includes a set of specific PSTN parameters in a pstn-params= entry in outgoing INVITE messages. The PSTN parameters currently included in pstn-params are Screening Indicator, ISDN Indicator, and Transmission Medium Requirement (TMR).includeQvalue – If enabled, the ERE SIP proxy/redirector includes the qvalue parameter (for example, q=0.9) in the Contact header of outgoing 3xx messages.skipCSeqCheckInEarlyDialog – When enabled, the Unable to show "metadata-from": No such page "_space_variables" accepts multiple SIP requests in which the CSeq number in a later request is of a lesser value than the CSeq number received in earlier requests.transparencyForDestinationTrunkGroupParameter – When enabled, if ERE receives both tgrp parameter and trunk-context in an ingress INVITE Request-URI, ERE as proxy transparently passes the tgrp parameter and trunk-context in the egress INVITE Request-URI. Values selected for the "Destination Trunk Group Option" are ignored.
|
generateCallIdUsing | Use this parameter to control ingress and egress Call-ID behavior. doNotUseIngressCallId – Generates egress Call-ID independent of ingress Call-ID.useIngressCallIdByAddingStaticString – Generates egress Call-ID using ingress Call-ID and a static string (egressCallIdStaticString ) configured in the SIP trunk group. Egress Call-ID is the aggregate of ingress Call-ID and static string.useIngressCallIdByPrepending – Generates egress Call-ID using ingress Call-ID and locally generated string. Egress Call-ID is the aggregate of ingress Call-ID and locally generated string.
|
includeChargeInformation | Select the includePChargeInfo option to map charge information in a call setup message (i.e., the charge number parameter of an IAM) to egress P-Charge-Info header in INVITE message. If the ERE returns billing information in a policy response, the Unable to show "metadata-from": No such page "_space_variables" ensures that the egress P-Charge-Info header in INVITE message is populated with the indicated data. If the Unable to show "metadata-from": No such page "_space_variables" receives a SIP INVITE message for a call destined to the PSTN, the Unable to show "metadata-from": No such page "_space_variables" populates the charge number parameter of the outgoing IAM based on the egress P-Charge-Info header in INVITE message.includeNone (default)includePChargeInfo
|
originatingTrunkGroupOptions | Use this parameter to specify originating trunk group options. includeNone (default) – Do not include any trunk group information.includeOtg – Include the originating trunk group parameter in SIP headers sent over the associated trunk group.includeTgrpWithDomainName – Include the originating trunk group, and include the trunk context as domain name.includeTgrpWithIpAddress – Include the originating trunk group, and include the trunk context as IP address
|
sipToHeaderMapping
| This parameter indicates which number is mapped and returned in the outgoing SIP To header. Options include: calledNumber – The TO header is mapped using the called number.gapDialedNumber – The TO header is mapped using the Generic Address Parameter from mime, if applicable.none (default) – The TO header user part is mapped from the Original Called Number, if present. Otherwise, it is mapped from the Called Number. The Original Called Number may be taken from the Diversion or the History-Info header, if present, in a SIP Invite.originalCalledNumberOcn – The TO header is mapped using the redirecting original Called number OCN parameter. This is filled from the SIP Invite using the Diversion or the History-Info header, if present.
|