SIP Profile Field Descriptions¶
Option |
Description |
---|---|
Name (Mandatory) |
Enter a name to identify the SIP profile; for example, SIP_7905. The value can include 1 to 50 characters, including alphanumeric characters, dot, dash, and underscores. |
Description (Optional) |
This field identifies the purpose of the SIP profile; for example, SIP for 7970. The description can include up to 50 characters in any language, but it cannot include double-quotes (“), percentage sign (%), ampersand (&), back-slash (\), or angle brackets (<>). |
Default MTP Telephony Event Payload Type (Optional) |
This field specifies the default payload type for RFC2833 telephony event. See RFC 2833 for more information. Usually, the default value specifies the appropriate payload type. Be sure that you have a good understanding of this parameter before changing it, as changes could result in DTMF tones not being received or generated. Default-101 Range-96 to 127 This parameter’s value affects calls with the following conditions:
|
Early Offer for G.Clear Calls (Optional) |
This feature supports both standards-based G.Clear (CLEARMODE) and proprietary Cisco Session Description Protocols (SDP). To enable or disable Early Offer for G.Clear Calls, choose one of the following options:
|
Option |
Description |
---|---|
User-Agent and Server header information (Mandatory) |
This feature indicates how Unified CM handles the User-Agent and Server header information in a SIP message. Choose one of the following options:
Default: Send Unified CM Version Information as User-Agent Header |
Version in User Agent and Server Header (Mandatory) |
This field specifies the portion of the installed build version that is used as the value of the User Agent and Server Header in SIP requests. Possible values are:
Default: Major and Minor |
Dial String Interpretation (Mandatory) |
Possible values are:
|
Option |
Description |
---|---|
Redirect by Application (Optional) |
If you select this check box and configure this SIP Profile on the SIP trunk, the Unified CM administrator can:
Getting redirected to a restricted phone number (such as an international number) means that handling redirection at stack level causes the call to be routed, not blocked. This behavior occurs if you leave the Redirect by Application check box clear. |
Disable Early Media on 180 (Optional) |
By default, Unified CM signals the calling phone to play local ringback if SDP is not received in the 180 or 183 response. If SDP is included in these responses, instead of playing ringback locally, Unified CM connects media. The calling phone then plays whatever the called device is sending (such as ringback or busy signal). If you receive no ringback, the device you are connecting to may include SDP in the 180 response, but not send media before 200OK response. In this case, select this check box to play local ringback on the calling phone and connect the media upon receipt of the 200OK response. Note: Even though the phone that is receiving ringback is the calling phone, you need the configuration on the called device profile because it determines the behavior. |
Outgoing T.38 INVITE include audio mline (Optional) |
The parameter allows the system to accept a signal from Microsoft Exchange that causes it to switch the call from audio to T.38 fax. To use this feature, configure a SIP trunk with this SIP profile. Note: The parameter applies to SIP trunks only, not phones that are running SIP or other endpoints. |
Option |
Description |
---|---|
Use Fully Qualified Domain Name in SIP Requests (Optional) |
This feature enables Unified CM to relay a caller’s alphanumeric hostname by passing it to the called device or outbound trunk as SIP header information. Enter one of the following: f - To disable this option. The IP address for Unified CM is passed to the line device or outbound trunk instead of the user’s hostname. t - To enable this option. Unified CM relays an alphanumeric hostname of a caller by passing it through to the called endpoint as a part of the SIP header information. This enables the called endpoint to return the call using the received or missed call list. If the call originates from a line device on the Unified CM cluster, and is routed on a SIP trunk, then the configured Organizational Top-Level Domain (for example, Cisco.com) is used in the Identity headers, such as From, Remote-Party-ID, and P-Asserted-ID. If the call originates from a trunk on Unified CM and is being routed on a SIP trunk, then:
Default: f - Disabled |
Assured Services SIP conformance (Optional) |
Select this check box for third-party AS-SIP endpoints and AS-SIP trunks to ensure proper Assured Service behavior. This setting provides specific Assured Service behavior that affects services such as Conference factory and SRTP. |
Table: SDP Information Tab
Option |
Description |
---|---|
SDP Transparency Profile (Optional) |
Displays the SDP Transparency Profile Setting (read-only) |
Accept Audio Codec Preferences in Received Offer (Optional) |
Choose one of the following options:
Default: Default |
Require SDP Inactive Exchange for Mid-Call Media Change (Optional) |
This feature determines how Unified CM handles midcall updates to codecs or connection information such as IP address or port numbers. If you select this check box, during midcall codec or connection updates Unified CM sends an INVITE a-inactive SDP message to the endpoint to break the media exchange. This is required if an endpoint is not capable of reacting to changes in the codec or connection information without disconnecting the media. This applies only to audio and video streams within SIP-SIP calls. Note For early offer enabled SIP trunks, the Send send-receive SDP in midcall INVITE parameter overrides this parameter. If this check box is clear, Unified CM passes the midcall SDP to the peer leg without sending a prior Inactive SDP to break the media exchange. Default: Clear |
Allow RR/RS bandwidth modifier (RFC 3556) (Mandatory) |
Specifies the RR (RTDP bandwidth allocated to other participants in an RTP session) and RS (RTCP bandwidth allocated to active data senders) in RFC 3556. Options are:
Default: TIAS and AS |
Table: Parameters used in Phone Tab
Option |
Description |
---|---|
Timer Invite Expires (seconds) (Optional) |
This field specifies the time, in seconds, after which a SIP INVITE expires. The Expires header uses this value. Valid values: Any positive number Default: 180 seconds |
Timer Register Delta (seconds) (Optional) |
This field is intended to be used by SIP endpoints only.
The endpoint receives this value through a TFTP config
file. The endpoint reregisters Timer Register Delta
seconds before the registration period ends. The
registration period gets determined by the value of the
Valid values: 0 to 32767 Default: 5 seconds |
Timer Register Expires (seconds) (Optional) |
This field is intended to be used by SIP endpoints only. The SIP endpoint receives the value through a TFTP config file. This field specifies the value that the phone that is running SIP sends in the Expires header of the REGISTER message. Valid values include any positive number; however, 3600 (1 hour) specifies the default value. Valid values: Any positive number Default: 3600 seconds (1 hour) If the endpoint sends a shorter Expires value than the
If the endpoint sends a greater Expires value than the
Note: For mobile phones running SIP, Unified CM uses this value
instead of the Note: For TCP connections, the value for the
|
Timer T1 (msec) (Optional) |
This field specifies the lowest value, in milliseconds, of the retransmission timer for SIP messages. Valid values: Any positive number Default: 500 msec |
Timer T2 (msec) (Optional) |
This field specifies the highest value, in milliseconds, of the retransmission timer for SIP messages. Valid values: Any positive number Default: 4000 msec |
Retry INVITE (Optional) |
This field specifies the maximum number of times that an INVITE request gets retransmitted. Valid values: Any positive number Default: 6 |
Retry Non-INVITE (Optional) |
This field specifies the maximum number of times that a SIP message other than an INVITE request gets retransmitted. Valid values: Any positive number Default: 10 |
Start Media Port (Optional) |
This field designates the start real-time protocol (RTP) port for media. Range: 2048 to 65535 Default: 16384 |
Option |
Description |
---|---|
Stop Media Port (Optional) |
This field designates the stop real-time protocol (RTP) port for media. Range: 2048 to 65535 Default: 32766 |
Call Pickup URI (Optional) |
This URI provides a unique address that the phone that is running SIP sends to Unified CM to invoke the call pickup feature. |
Call Pickup Group URI (Optional) |
This URI provides a unique address that the phone that is running SIP sends to Unified CM to invoke the call pickup group feature. |
Meet Me Service URI (Optional) |
This URI provides a unique address that the phone that is running SIP sends to Unified CM to invoke the meet me conference feature. |
User Info (Optional) |
This field configures the user- parameter in the REGISTER message. Valid values are:
Default: None |
DTMF DB Level (Optional) |
This field specifies the in-band DTMF digit tone level. Valid values are:
Default: Nominal |
Call Hold Ring Back (Optional) |
This parameter causes the phone to ring in cases where you have another party on hold when you hang up a call. Valid values are:
|
Anonymous Call Block (Optional) |
The field configures anonymous call block. Valid values are:
|
Caller ID Blocking (Optional) |
This field configures caller ID blocking. When blocking is enabled, the phone blocks its own number or email address from phones that have caller identification enabled. Valid values are:
|
Do Not Disturb Control (Optional) |
This field sets the Do Not Disturb (DND) feature. Valid values are:
|
Option |
Description |
---|---|
Telnet Level for 7940 and 7960 (Optional) |
Cisco Unified IP Phones 7940 and 7960 do not support SSH for sign-in access or HTTP that is used to collect logs. However, these phones support Telnet, which lets the user control the phone, collect debugs, and look at configuration settings. This field controls the telnet_level configuration parameter with the following possible values:
|
Resource Priority Namespace (Optional) |
This field enables the administrator to select one of the cluster’s defined Resource Priority Namespace network domains for assignment to a line using its SIP Profile. |
Timer Keep Alive Expires (seconds) (Optional) |
Unified CM requires a keepalive mechanism to support redundancy. This field specifies the interval between keepalive messages sent to the backup Unified CM to ensure its availability for failover. Default: 120 seconds |
Timer Subscribe Expires (seconds) (Optional) |
This field specifies the time, in seconds, after which a subscription expires. This value gets inserted into the`` Expires`` header field. Valid values: Any positive number Default: 120 seconds |
Timer Subscribe Delta (seconds) (Optional) |
Use this parameter with the Range: 3 to 15 seconds Default: 5 seconds |
Maximum Redirections (Optional) |
Use this configuration variable to determine the maximum number of times that the phone allows a call to be redirected before dropping the call. Default: 70 redirections |
Off hook To First Digit Timer (msec) (Optional) |
This field specifies the time in microseconds that passes when the phone goes off hook and the first digit timer gets set. Range: 0 to 15,000 microseconds Default: 15,000 microseconds |
Option |
Description |
---|---|
Call Forward URI (Optional) |
This URI provides a unique address that the phone that is running SIP sends to Unified CM to invoke the call forward feature. |
Speed Dial (Abbreviated Dial) URI (Optional) |
This URI provides a unique address that the phone that is running SIP sends to Unified CM to invoke the abbreviated dial feature. Speed dials that are not associated with a line key (abbreviated dial indices) do not download to the phone. The phone uses the feature indication mechanism (INVITE with Call-Info header) to indicate when an abbreviated dial number has been entered. The request URI contains the abbreviated dial digits (for example, 14), and the Call-Info header indicates the abbreviated dial feature. Unified CM translates the abbreviated dial digits into the configured digit string and extends the call with that string. If no digit string has been configured for the abbreviated dial digits, a 404 Not Found response gets returned to the phone. |
Conference Join Enabled (Optional) |
Select this check box to join the remaining conference participants when a conference initiator using a Cisco Unified IP Phone 7940 or 7960 hangs up. Leave it clear if you do not want to join the remaining conference participants. Note: This check box applies to the Cisco Unified IP Phones 7941/61/70/71/11 when they are in SRST mode only. |
Option |
Description |
---|---|
RFC 2543 Hold (Optional) |
Select this check box to enable setting connection address to 0.0.0.0 per RFC2543 when call hold is signaled to Unified CM. This allows backward compatibility with endpoints that do not support RFC3264. |
Semi Attended Transfer (Optional) |
This check box determines whether the Cisco Unified IP Phones 7940 and 7960 caller can transfer an attended transfer’s second leg while the call is ringing. Select the check box if you want semi attended transfer enabled; leave it clear if you want semi attended transfer disabled. Note: This check box applies to the Cisco Unified IP Phones 7941/61/70/71/11 when they are in SRST mode only. |
Enable VAD (Optional) |
Select this check box if you want voice activation detection (VAD) enabled; leave it clear if you want VAD disabled. When VAD is enabled, no media is sent when voice is detected. |
Stutter Message Waiting (Optional) |
Select this check box if you want stutter dial tone when the phone goes off hook and a message is waiting. Leave clear if you do not want a stutter dial tone when a message is waiting. This setting supports Cisco Unified IP Phones 7960 and 7940 that run SIP. |
MLPP User Authorization (Optional) |
Select this check box to enable MLPP User Authorization. MLPP User Authorization requires the phone to send in an MLPP username and password. |
Table: Normalization Script Tab
Option |
Description |
---|---|
Normalization Script |
From the drop-down list, choose the script that you want to apply to this SIP profile. To import another script from Unified CM, go to the SIP Normalization Configuration window (Device Device Settings SIP Normalization Script), and import a new script. |
Enable Trace |
Select this check box to enable tracing within the script or clear this check box to disable tracing. When selected, the trace.output API provided to the Lua scripter produces SDI trace. Note: We recommend that you only enable tracing while debugging a script. Tracing impacts performance and is not recommended under normal operating conditions. |
Script Parameters |
Enter parameter names and parameter values in the Script Parameters box as comma-delineated key-value pairs. Valid values include all characters except equals signs (-), semicolons (;), and nonprintable characters, such as tabs. You can enter a parameter name with no value. Alternatively, to add another parameter line from Unified CM, click the + (plus) button. To delete a parameter line, click the - (minus) button. |
Table: Incoming Requests FROM URI Settings Tab
Option |
Description |
---|---|
Caller ID DN |
Enter the pattern that you want to use for calling line ID, from 0 to 24 digits. For example, in North America:
You can also enter the international escape character +. |
Caller Name |
Enter a caller name to override the caller name that is received from the originating SIP Device. |
Table: Trunk Specific Configuration Tab
Option |
Description |
---|---|
Reroute Incoming Request to new Trunk based on |
Unified CM only accepts calls from a SIP device whose IP address matches the destination address of the configured SIP trunk. In addition, the port on which the SIP message arrives must match the one that is configured on the SIP trunk. After Unified CM accepts the call, Unified CM uses the configuration for this setting to determine whether to reroute the call to another trunk. From the drop-down list, choose the method that Unified CM uses to identify the SIP trunk where the call gets rerouted:
Default: Never Note: This setting does not work for SIP trunks connected to:
|
Option |
Description |
---|---|
RSVP Over SIP |
This field configures RSVP over SIP trunks. From the drop-down list, choose the method that Unified CM uses to configure RSVP over SIP trunks:
|
Resource Priority Namespace List |
Select a configured Resource Priority Namespace list from the drop-down menu. The Namespace List is configured in Unified CM in the Resource Priority Namespace List menu. You can access the menu in Unified CM from System MLPP > Namespace. |
Fall back to local RSVP |
Select this check box if you want to allow failed end-to-end RSVP calls to fall back to local RSVP to establish the call. If this check box is clear, end-to-end RSVP calls that cannot establish an end-to-end connection fail. |
SIP Rel1XX Options |
This field configures SIP Rel1XX, which determines whether all SIP provisional responses (other than 100 Trying messages) are sent reliably to the remote SIP endpoint. Valid values are:
If you set the RSVP Over SIP field to E2E, you cannot choose Disabled. |
Video Call Traffic Class |
Video Call Traffic Class determines the type of video endpoint or trunk that the SIP Profile is associated with. From the drop-down list, select one of:
Unified CM Locations Call Admission Control (CAC) reserves bandwidth from two Locations video bandwidth pools, Video Bandwidth and Immersive Bandwidth. The pool used depends on the type of call determined by the Video Call Traffic Class. Refer to the “Call Admission Control” chapter of the Cisco Unified Communications Manager System Guide for more information. |
Option |
Description |
---|---|
Calling Line Identification Presentation (Mandatory) |
Select one of:
Default: Default |
Session Refresh Method (Mandatory) |
Session Timer with Update: The session refresh timer allows for periodic refresh of SIP sessions. This allows the Unified CM and remote agents to determine whether the SIP session is still active. Prior to Release 10.01, when the Unified CM received a refresh command, it supported receiving either Invite or Update SIP requests to refresh the session. When the Unified CM initiated a refresh, it supported sending only Invite SIP requests to refresh the session. With Release 10.01, this feature extends the refresh capability so that Unified CM can send both Update and Invite requests. Specify whether to use Invite or Update as the Session Refresh Method. Default: Invite Note: Sending a midcall Invite request requires specifying an offer SDP in the request. This means that the far end must send an answer SDP in the Invite response. Update: Unified CM requests a SIP Update if the SIP session’s far end supports the Update method in the Supported or Require headers. When sending the Update request, the Unified CM includes an SDP. This simplifies the session refresh since no SDP offer or answer exchange is required. Note: If the far end of the SIP session does not support the Update method, the Unified CM continues using the Invite method for session refresh. |
Option |
Description |
---|---|
Enable ANAT |
This option allows a dual-stack SIP trunk to offer both IPv4 and IPv6 media. Selecting the Enable ANAT and MTP Required check boxes sets Unified CM to insert a dual-stack MTP and send an offer with two m-lines, for IPv4 and IPv6. If a dual- stack MTP cannot be allocated, Unified CM sends an INVITE without SDP. When you select the Enable ANAT check box and the Media Termination Point Required check box is clear, Unified CM sends an INVITE without SDP. When the Enable ANAT and MTP Required check boxes are cleared (or when an MTP cannot be allocated), Unified CM sends an INVITE without SDP. When you clear the Enable ANAT check box but you select the MPT Required check box, consider the information, which assumes that an MTP can be allocated:
|
Deliver Conference Bridge Identifier |
When checked, the SIP trunk passes the b-number identifying the conference bridge across the trunk instead of changing the b-number to the null value. The terminating side does not require this field. Selecting this check box is not required for Open Recording Architecture (ORA) SIP header enhancements to the Recording feature to work. Selecting this check box allows the recorder to coordinate recording sessions where the parties are participating in a conference. |
Allow Passthrough of Configured Line Device Caller Information |
Select this check box to allow passthrough of configured line device caller information from the SIP trunk. |
Option |
Description |
---|---|
Reject Anonymous Incoming Calls |
Select this check box to reject anonymous incoming calls. |
Reject Anonymous Outgoing Calls |
Select this check box to reject anonymous outgoing calls. |
Send ILS Learned Destination Route String |
When this check box is selected, for calls routed to a learned directory URI, learned number, or learned pattern, Unified CM:
When this check box is clear, Unified CM does not add the x-cisco-dest-route-string header to any SIP messages. The x-cisco-dest-route-string header allows Unified CM to route calls across a Session Border Controller. |
Table: Trunk SIP OPTIONS Ping Tab
Option |
Description |
---|---|
Enable OPTIONS Ping to monitor destination status for Trunks with Service Type “None (Default)” |
Select this check box if you want to enable the SIP OPTIONS feature. SIP OPTIONS are requests to the configured destination address on the SIP trunk. If the remote SIP device is unresponsive or returns a SIP error response such as 503 Service Unavailable or 408 Timeout, Unified CM reroutes the calls by using other trunks or a different address. If this check box is clear, the SIP trunk does not track the status of SIP trunk destinations. When this check box is selected, you can configure two request timers. |
Ping Interval for In-service and Partially In-service Trunks (seconds) |
This field configures the time duration between SIP OPTIONS requests when the remote peer is responding and the trunk is marked as In Service. If at least one IP address is available, the trunk is In Service; if all IP addresses are unavailable, the trunk is Out of Service. Default: 60 seconds Range: 5 to 600 seconds |
Ping Interval for Out-of-service Trunks (seconds) |
This field configures the time duration between SIP OPTIONS requests when the remote peer is not responding and the trunk is marked as Out of Service. The remote peer may be marked as Out of Service if:
If at least one IP address is available, the trunk is In Service; if all IP addresses are unavailable, the trunk is Out of Service. Default: 120 seconds Range: 5 to 600 seconds |
Ping Retry Timer (msec) |
This field specifies the maximum waiting time before retransmitting the OPTIONS request. Range: 100 to 1000 milliseconds Default: 500 milliseconds |
Ping Retry Count |
This field specifies the number of times that Unified CM resends the OPTIONS request to the remote peer. After the configured retry attempts are used, the destination is considered to have failed. To obtain faster failure detection, keep the retry count low. Range: 1 to 10 Default: 6 |
Table: Trunk SDP Information Tab
Option |
Description |
---|---|
Send send-receive SDP in midcall INVITE |
Select this check box to prevent Unified CM from sending an INVITE a-inactive SDP message during call hold or media break during supplementary services. Note: This check box applies only to early offer enabled SIP trunks and has no impact on SIP line calls. When you enable Send send-receive SDP in midcall INVITE for an early offer SIP trunk in tandem mode, Unified CM inserts MTP to provide sendrecv SDP when a SIP device sends offer SDP with a-inactive or sendonly or recvonly in audio media line. In tandem mode, Unified CM depends on the SIP devices to reestablish media path by sending either a delayed INVITE or midcall INVITE with send-recv SDP. When you enable Send send-receive SDP in midcall INVITE and Require SDP Inactive Exchange for Mid-Call Media Change on the same SIP Profile, the Send send-receive SDP in midcall INVITE overrides the Require SDP Inactive Exchange for Mid-Call Media Change, so Unified CM does not send an INVITE with a-inactive SDP in midcall codec updates. For SIP line side calls, the Require SDP Inactive Exchange for Mid-Call Media Change check box applies when enabled. Note: To prevent the SDP mode from being set to inactive in a multiple-hold scenario, set the Duplex Streaming Enabled clusterwide service parameter in Unified CM (System Service Parameters) to True. |
Option |
Description |
---|---|
Allow Presentation Sharing using BFCP |
If the check box is selected, Unified CM allows supported SIP endpoints to use the Binary Floor Control Protocol (BFCP) to enable presentation sharing. The use of BFCP creates an added media stream in addition to the existing audio and video streams. This additional stream is used to stream a presentation, such as a PowerPoint presentation from someone’s laptop, into a SIP videophone. If the check box is clear, Unified CM rejects BFCP offers from devices associated with the SIP profile. The BFCP application line and associated media line ports are set to 0 in the answering SDP message. Default: Clear Note: BFCP is only supported on SIP networks. BFCP must be enabled on all SIP trunks, lines, and endpoints for presentation sharing to work. BFCP is not supported if the SIP line or SIP trunk uses MTP, RSVP, TRP, or Transcoder. For more information on BFCP, refer to the Cisco Unified Communications Manager System Guide. |
Allow iX Application Media |
Select this check box to enable support for iX media channel. |
Allow multiple codecs in answer SDP |
This option applies when incoming SIP signals do not indicate support for multiple codec negotiation and Unified CM can finalize the negotiated codec. When this check box is selected, the endpoint behind the trunk can handle multiple codecs in the answer SDP. For example, an endpoint that supports multiple codec negotiation calls the SIP trunk, and Unified CM sends a Delay Offer request to a trunk. The endpoint behind the trunk returns all support codecs without the Contact header to indicate the support of multiple codec negotiation. In this case, Unified CM identifies that the trunk can handle multiple codec negotiation, and sends SIP response messages to both endpoints with multiple common codecs. When clear, Unified CM identifies that the endpoint behind the trunk cannot handle multiple codec negotiation, unless SIP contact header URI states it can. Unified CM continues the call with single codec negotiation. |