Table Of Contents
SIP Call Hold
Contents
Information About SIP Call Hold in SBC
How to Configure SIP Call Hold
Configuring SIP Call Hold
Example of Configuring SIP Call Hold
Additional References
Related Documents
Standards
MIBs
RFCs
Technical Assistance
SIP Call Hold
The SIP call hold feature in SBC provides a standard telephony service of putting a caller on hold. If a party in a call wants to put the other party "on hold", a party re-invites the other by sending an INVITE request with a modified session description protocol (SDP). When a SIP endpoint wishes to place a call on hold or respond to a call hold re-INVITE, it chooses an appropriate method. SBC modifies call hold SDPs to use any available methods in order to maximize inter-operating with SIP devices.
Feature History for SIP Call Hold
Release
|
Modification
|
Release 3.4.1
|
This feature was introduced on the Cisco XR 12000 Series Router.
|
Release 3.5.0
|
No modification.
|
Release 3.6.0
|
No modification.
|
Contents
This module contains the following sections:
•
Information About SIP Call Hold in SBC
•
How to Configure SIP Call Hold
•
Additional References
Information About SIP Call Hold in SBC
SBC accepts a SIP re-INVITE with an SDP, signaling that the sender wishes to put the call on hold. SBC modifies the SDP offer as needed and replaces remote endpoint addresses with known DBE media addresses. SBC then forwards the SIP message, containing the modified SDP to the remote endpoint.
If the re-INVITE is rejected by the endpoint going on hold, then the error response is returned to the holding endpoint (the endpoint that initiated the call hold). The media gate on the DBE continues to be connected and media continues to flow as before.
How to Configure SIP Call Hold
This section contains the steps for configuring the "no media" timeout duration for on-hold calls.
Configuring SIP Call Hold
SUMMARY STEPS
1.
configure
2.
sbc service-name
3.
sbe
4.
hold-media-timeout timeout
5.
commit
6.
exit
7.
show services sbc service-name sbe hold-media-timeout
8.
show services sbc service-name sbe calls
DETAILED STEPS
| |
Command or Action
|
Purpose
|
Step 1
|
configure
Example:
RP/0/0/CPU0:router# configure
|
Enables global configuration mode.
|
Step 2
|
sbc service-name
Example:
RP/0/0/CPU0:router(config)# sbc mysbc
|
Enters the mode of an SBC service.
Use the service-name argument to define the name of the service.
|
Step 3
|
sbe
Example:
RP/0/0/CPU0:router(config-sbc)# sbe
|
Enters the mode of the signaling border element (SBE) function of the SBC.
|
Step 4
|
hold-media-timeout timeout
Example:
RP/0/0/CPU0:router(config-sbc-sbe)#
hold-media-timeout 7200
|
The time an SBE will wait after receiving a media timeout notification from the DBE for an on hold call before tearing that call down.
• When the DBE detects that media has stopped on a call, it will start a timer for the specified duration, using the DBE media timeout CLI command.
• If no media flows before this timer expires, then the DBE will send a pin hole timeout event notification to the SBE.
• If the call is on hold, the SBE will set a timer with a duration matching the configured value using this command.
• If the call is not taken off hold before the SBE timer expires, then the call will be torn down.
The default value for this command is off. Unless a specific duration is set, on hold calls never time out.
|
Step 5
|
commit
Example:
RP/0/0/CPU0:router(config-sbc-sbe)# commit
|
Saves configuration changes. Use the commit command to save the configuration changes to the running configuration file and remain within the configuration session.
|
Step 6
|
exit
Example:
RP/0/0/CPU0:router(config-sbc-sbe)# exit
|
Exits the configuration session and returns to the SBC mode.
|
Step 7
|
show services sbc sbc-name sbe hold-media-timeout
Example:
RP/0/0/CPU0:router(config-sbc)# show services sbc
mysbc sbe hold-media-timeout
|
Shows the currently configured duration of the media timeout timer for on-hold calls.
|
Step 8
|
show services sbc sbc-name sbe calls
Example:
RP/0/0/CPU0:router(config-sbc)# show services sbc
mysbc sbe calls
|
Lists all the calls on the SBE.
|
Example of Configuring SIP Call Hold
The following command configures the SBE to wait for two hours after receiving the last media packet on an on-hold call before cleaning up the call resources.
RP/0/0/CPU0:router(config)# sbc mysbc sbe hold-media-timeout 7200
Additional References
The following sections provide references related to SIP call hold support in SBC.
Related Documents
Related Topic
|
Document Title
|
Cisco IOS XR master command reference
|
Cisco IOS XR Master Commands List
|
Cisco IOS XR SBC interface configuration commands
|
Cisco IOS XR Session Border Controller Command Reference
|
Initial system bootup and configuration information for a router using the Cisco IOS XR Software
|
Cisco IOS XR Getting Started Guide
|
Cisco IOS XR command modes
|
Cisco IOS XR Command Mode Reference
|
Standards
Standards
|
Title
|
No new or modified standards are supported by this feature, and support from existing standards has not been modified by this feature.
|
—
|
MIBs
RFCs
RFCs
|
Title
|
RFC 3261
|
SIP: Session Initiation Protocol
|
RFC 2543
|
Session Initiation Protocol
|
RFC 3515
|
Session Initiation Protocol (SIP) Refer Method
|
Technical Assistance
Description
|
Link
|
The Cisco Technical Support website contains thousands of pages of searchable technical content, including links to products, technologies, solutions, technical tips, and tools. Registered Cisco.com users can log in from this page to access even more content.
|
http://www.cisco.com/techsupport
|