Table Of Contents
Configuring an Error Response Code upon an Out-of-Dialog OPTIONS Ping Failure at the Global Level
Configuring an Error Response Code upon an Out-of-Dialog OPTIONS Ping Failure at the Dial Peer Level
Cisco Unified Border Element Support for Configuring an Error Response Code upon an Out-of-Dialog OPTIONS Ping Failure
Cisco Unified Border Element (Cisco UBE) provides an option to configure the error response code when a dial peer is busied out because of an Out-of-Dialog OPTIONS ping failure.
The OPTIONS ping mechanism monitors the status of a remote Session Initiation Protocol (SIP) server, proxy or endpoints. Cisco UBE monitors these endpoints periodically. When there is no response from these monitored endpoints, the configured dial peer is busied out. If the dial-peer endpoint is busied out due to an OPTIONS ping failure, the call is passed on to the next dial-peer endpoint if an alternate dial peer is configured for the same destination. Otherwise the error response 404 is sent. This feature provides the option of configuring the error response code to reroute the call. Therefore when a dial peer is busied out due to the OPTIONS ping failure, the SIP error code configured in the inbound dial-peer is sent as a response.
To configure the SIP error code response, perform the following tasks:
•Configuring an Error Response Code upon an Out-of-Dialog OPTIONS Ping Failure at the Global Level (required)
•Configuring an Error Response Code upon an Out-of-Dialog OPTIONS Ping Failure at the Dial Peer Level (required)
Prerequisites
•The Cisco UBE Out-of-Dialog (OOD) OPTIONS Ping for Specified SIP Servers or Endpoints feature should be configured before configuring this error response code for a ping OPTIONS failure.
Cisco Unified Border Element
•Cisco IOS Release 15.1(1)T 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 error code configuration will not have any effect if it is configured on the outbound dial peer.
Configuring an Error Response Code upon an Out-of-Dialog OPTIONS Ping Failure at the Global Level
Table 1 describes the SIP error codes.
To configure the error response code for the OPTIONS ping failure to support the Cisco Unified Border Element at the global level, perform the steps in this section.
SUMMARY STEPS
1. enable
2. configure terminal
3. voice service voip
4. sip
5. error-code-override options-keepalive failure sip-status-code-number
6. end
DETAILED STEPS
Command or Action PurposeStep 1
enable
Example:Router> enable
Enables privileged EXEC mode.
•Enter your password if prompted.
Step 2
configure terminal
Example:Router# configure terminal
Enters global configuration mode.
Step 3
voice service voip
Example:Router(config)# voice service voip
Enters voice service configuration mode.
Step 4
sip
Example:Router(conf-voi-serv)# sip
Enters voice service SIP configuration mode.
Step 5
error-code-override options-keepalive failure sip-status-code-number
Example:Router(conf-serv-sip)# error-code-override options-keepalive failure 402
Configures the specified SIP error code number.
•sip-status-code-number —SIP status code to be sent for an options keepalive failure. Range: 400 to 699. Default: 503.
•Table 1 provides more details about these error codes.
Step 6
end
Example:Router(conf-serv-sip)# end
Exits voice service SIP configuration mode and returns to privileged EXEC mode.
Configuring an Error Response Code upon an Out-of-Dialog OPTIONS Ping Failure at the Dial Peer Level
To configure the error response code for the OPTIONS ping failure to support the Cisco Unified Border Element at the dial-peer level, perform the steps in this section.
SUMMARY STEPS
1. enable
2. configure terminal
3. dial-peer voice voice-dial-peer-tag voip
4. voice-class sip error-code-override options-keepalive failure {sip-status-code-number | system}
5. end
DETAILED STEPS
Command or Action PurposeStep 1
enable
Example:Router> enable
Enables privileged EXEC mode.
•Enter your password if prompted.
Step 2
configure terminal
Example:Router# configure terminal
Enters global configuration mode.
Step 3
dial-peer voice voice-dial-peer-tag voip
Example:Router(config)# dial-peer voice 234 voip
Enters dial peer voice configuration mode.
Step 4
voice-class sip error-code-error-override options-keepalive failure {sip-status-code-number | system}
Example:Router(config-dial-peer)# voice-class sip error-code-override options-keepalive failure 500
Configures the specified SIP error code number.
•sip-status-code-number —SIP status code to be sent for an options keepalive failure. Range: 400 to 699. Default: 503.
•Table 1 provides more details about these error codes.
Note If the system keyword is configured, the global level configuration will override the dial-peer configuration.
Step 5
end
Example:Router(config-dial-peer)# end
Exits dial peer voice configuration mode and returns to privileged EXEC mode.
Troubleshooting Tips
The following debug commands display any error that occurs with the error code response:
•debug ccsip messages—shows SIP messages.
Router# debug ccsip messagesSIP Call messages tracing is enabled•debug ccsip all—shows all SIP-related debugging.
Router# debug ccsip allThis may severely impact system performance. Continue? [confirm]All SIP Call tracing is enabled