Table Of Contents
Configuring Cisco UBE Out-of-dialog OPTIONS Ping for Specified SIP Servers or Endpoints
Configuring Cisco UBE Out-of-dialog OPTIONS Ping for Specified SIP Servers or Endpoints
The Out-of-dialog (OOD) Options Ping feature provides a keepalive mechanism at the SIP level between any number of destinations. A generic heartbeat mechanism allows Cisco Unified Border Element to monitor the status of SIP servers or endpoints and provide the option of busying-out a dial-peer upon total heartbeat failure. When a monitored endpoint heartbeat fails, the dial-peer is busied out. If an alternate dial-peer is configured for the same destination pattern, the call is failed over to the next preferred dial peer, or else the on call is rejected with an error cause code.
Table 1 describes error codes option ping responses considered unsuccessful and the dial-peer is busied out for following scenarios:
Table 1 Error Codes that busyout the endpoint
Error Code Description503
service unavailable
505
sip version not supported
no response
i.e. request timeout
All other error codes, including 400 are considered a valid response and the dial peer is not busied out.
Note The purpose of this feature is to determine if the SIP session protocol on the endpoint is UP and available to handle calls. It may not handle OPTIONS message but as long as the SIP protocol is available, it should be able to handle calls.
When a dial-peer is busied out, Cisco Unified Border Element continues the heartbeat mechanism and the dial-peer is set to active upon receipt of a response.
Prerequisites
•The following are required for OOD Options ping to function. If any are missing, the Out-of-dialog (OOD) Options ping will not be sent and the dial peer is reset to the default active state.
–Dial-peer should be in active state
–Session protocol must be configured for SIP
–Configure Session target or outbound proxy must be configured. If both are configured, outbound proxy has preference over session target.
Cisco Unified Border Element
•Cisco IOS Release 15.0(1)M or a later release must be installed and running on your Cisco Unified Border Element.
Cisco Unified Border Element (Enterprise)
•Cisco IOS XE Release 3.1S or a later release must be installed and running on your Cisco ASR 1000 Series Router
Restrictions
•The Cisco Unified Border Element OOD Options ping feature can only be configured at the VoIP Dial-peer level.
•All dial peers start in an active (not busied out) state on a router boot or reboot.
•If a dial-peer has both an outbound proxy and a session target configured, the OOD options ping is sent to the outbound proxy address first.
•Though multiple dial-peers may point to the same SIP server IP address, an independent OOD options ping is sent for each dial-peer.
•If a SIP server is configured as a DNS hostname, OOD Options pings are sent to all the returned addresses until a response is received.
•Configuration for Cisco Unified Border Element OOD and TDM Gateway OOD are different, but can co-exist.
SUMMARY STEPS
1. enable
2. configure terminal
3. dial-peer voice tag voip
4. voice-class sip options-keepalive
5. exit
DETAILED STEPSTroubleshooting Tips
The following commands can help troubleshoot the OOD Options Ping feature:
•debug ccsip all—shows all Session Initiation Protocol (SIP)-related debugging.
•show dial-peer voice x—shows configuration of keepalive information.
Router# show dial-peer voice | in optionsvoice class sip options-keepalive up-interval 60 down-interval 30 retry 5voice class sip options-keepalive dial-peer action = active•show dial-peer voice summary—shows Active or Busyout dial-peer status.
Router# show dial-peer voice summaryAD PRE PASSTAG TYPE MIN OPER PREFIX DEST-PATTERN KEEPALIVE111 voip up up 0 syst active9 voip up down 0 syst busy-out