In this section:

 

Overview

The supports the SIP OPTIONS ping feature whereby a SIP OPTIONS request is periodically sent to a pre-configured or FQDN IP peer (IPv4 and IPv6 are supported) to check its status and discover any new capabilities. The OPTIONS request is sent via the Signaling Port of the zone configured for the peer. The From header of the OPTIONS request is populated with the IP address of the Signaling Port used.

This feature verifies peer-to-peer connectivity, and can be enabled in an existing ipPeer object. The frequency of OPTIONS requests is configurable.

If the peer does not respond after a configurable number of consecutive OPTIONS timeouts (1-10), it is declared down and no new calls are sent to this peer. While the peer is down, OPTIONS-based pinging continues. The peer is considered recovered after a configurable number of consecutive successful OPTIONS transactions (1-10). Up to 2,000 peers may be defined in the OPTIONS ping list using IP address, port and zone details. If a peer's port is omitted, 5060 is the default port.

The failureResponseCodes parameter is used in the Path Check Profile and SIP ARS Profile to specify which responses are considered failures. In this way, if the peer responds with values configured as 'failures', then the peer is blacklisted after a configurable amount of retries.

The Path Check Profile is a proactive system where, if the peer is associated with a profile, then OPTIONS request is sent to that peer continuously to monitor its state. If the peer responds, then it is considered as available. If the peer does not respond even after the configured number of retries, then that peer is blacklisted. Alternatively, if the blacklisted peer responds within the configured number of times, then it is considered as available and is removed from the blacklist. Refer to Path Check Profile - CLI or Service Profiles - Path Check Profile (EMA) for configuration details.

The SIP ARS Profile, on the other hand, is a more reactive system. It is triggered when a Trunk Group includes a configured SIP ARS Profile when an INVITE request is sent to the associated peer and the INVITE times out. This also applies for cases where recoveryAlgorithm configuration is set to "probe" (not "timer"). The peer is immediately blacklisted and the job of the OPTIONS is to indicate its availability again. Refer to SIP ARS Profile - CLI or Service Profiles - Sip Ars Profile (EMA) for configuration details.

An administrative state allows the ability to manually blacklist a peer whereby new calls to the peer are only sent if peer is "Up" (from ping state perspective) and "Active" (from administrative state perspective). A broad illustration of this feature is depicted in Figure 1  with the following principal elements:

  • Pathcheck task
  • a client interface or CLI commands
  • a configurable profile controlling the behavior of the pings
  • SIP options

The Path Check Profile specifies the conditions that constitute a connectivity failure, and in the event of such a failure, the conditions that constitute a connectivity recovery.

Path Check Architecture

The following example call flow reflects failureResponseCodes behavior when Path Check Profile is configured as follows:

  • replyTimeoutCount = 3
  • sendInterval = 60 seconds
  • recoveryCount = 2
  • protocol = sipOptions (default)
  • failureResponseCodes = all5xx