Brekeke Documents

Find user guides, developer guides, API references, tutorials, and more!

Brekeke SIP Server Wiki

  1. Brekeke SIP Server Basic Info
  2. Security
  3. Update & Upgrade
  4. Configuration
    1. Installation
    2. Basic Setup
    3. BSS Administration Tool
    4. Network Configuration
    5. Dial Plan
      1. Dial Plan Basics
      2. Dial Plan Reference
      3. Dial Plan Tutorial
      4. Dial Plan Examples
        1. Allow Parentheses in Contact-URI
        2. Apply two plugin to one call
        3. Authenticate callers by IP address
        4. Brekeke SIP Server works as Redirect Server
        5. Change Contact header
        6. Change payload type
        7. Change RTP Connection Info
        8. Connect to Gateways with BSS
        9. Count registration records per user
        10. Decline calls from non-numbered callers (SIP ID)
        11. Define outgoing From and To headers with / method
        12. Disable RTP-Relay if SDP indicates a Public IP address
        13. DNS-SRV failover
        14. Execute SQL query from Dialplan
        15. Failover with the Dial Plan
        16. Limit Concurrent Sessions through a specific route
        17. Limit session per sec in Dial Plan
        18. Remove all current registrations
        19. Reject non-registered caller's call
        20. Restrict INVITE Requests
        21. Restrict REGISTER requests
        22. Restrict registration only from single UA
        23. Restrict Upper or Thru Registration
        24. Set time range in Dial Plan
        25. Use Response Header Definition
        26. $webget method examples
      5. Dial Plan FAQ
    6. Block List
    7. Provisioning
    8. Push Notification
    9. SDN
    10. STIR/SHAKEN
    11. Advanced Edition
    12. Other Functions
    13. Third-Party Database
    14. Environment Variables
  5. Troubleshooting
  6. Developer's Guide
  7. Version History

How to make Failover in the Dial Plan

With the Failover plug-in for the Advanced Edition, you can make a failover based on SIP response or timeout.

Syntax in Deploy Patterns
-------------------------------------------------------------------------
[Deploy Patterns]
$session = failover SIP-URI/transport [SIP-URI/transport...] 
&failover.timer.inviting = Timer default:10sec 
&failover.timer.provisional = Timer default:20sec 
&failover.pattern.response = Default value: .+ 
&failover.redirection = Support 3xx redirection (default:true)
-------------------------------------------------------------------------
Examples

Example-1: Basic usage 
If sip:100@192.168.0.100 doesn’t respond or it returns a SIP error response, the SIP Server sends the INVITE to sip:101@192.168.0.101 over UDP.

------------------------------------------------------------------------- 
[Deploy Patterns] 
To = sip:100@192.168.0.100 
$session = failover sip:101@192.168.0.101 sip:102@192.168.0.102 
-------------------------------------------------------------------------

 

Example-2: Specify the transport 
If sip:100@192.168.0.100 doesn’t respond or it returns a SIP error response, the SIP Server sends the INVITE to sip:101@192.168.0.101 over TCP.

-------------------------------------------------------------------------
[Deploy Patterns] 
To = sip:100@192.168.0.100 
$transport = TCP 
$session = failover sip:101@192.168.0.101/TCP sip:102@192.168.0.102/TCP 
-------------------------------------------------------------------------

Note: The “UDP Failover” should be “on” at the [Configuration] > [SIP] page even if you don’t use UDP.

 

Example-3: Specify the inviting timeout.
If sip:100@192.168.0.100 doesn’t respond for 30 seconds, the SIP Server sends the INVITE to sip:101@192.168.0.101.

------------------------------------------------------------------------- 
[Deploy Patterns] 
To = sip:100@192.168.0.100 
$session = failover sip:101@192.168.0.101 sip:102@192.168.0.102 
&failover.timer.inviting = 30 
-------------------------------------------------------------------------

 

Example-4: Specify the response code 
If sip:100@192.168.0.100 responds with error code 4xx, the SIP Server sends the INVITE to sip:101@192.168.0.101.

------------------------------------------------------------------------- 
[Deploy Patterns] 
To = sip:100@192.168.0.100 
$session = failover sip:101@192.168.0.101 
&failover.pattern.response = 4.. 
-------------------------------------------------------------------------

 

Example-5: Handle 30x redirect response
If sip:100@192.168.0.100 responds with error code 30x, the SIP Server sends a new INVITE to the contact address indicated in the 30x response

---------------------------------------------------------------------- 
[Deploy Patterns] 
To = sip:100@192.168.0.100 
$session = failover
&failover.pattern.response = 30. 
----------------------------------------------------------------------
Yes No
« Execute SQL query from DialplanLimit Concurrent Sessions through a specific route »
Suggest Edit