SIP OPTIONS checks on VOS3000 routing gateways
Find out a carrier is down before your customers do, instead of sending every call into a timeout.
Updated · By the VOS3000 Web team
Quick answer: With Options online check ticked on a routing gateway, VOS3000 sends SIP OPTIONS to the carrier every SS_SIP_OPTIONS_CHECK_PERIOD. If one IP and port stops answering it uses one that answers, and if none answer the gateway is not used until an OPTIONS check succeeds again. The carrier must answer OPTIONS from your IP.
- Setting
- Routing gateway: Options online check
- Interval
- SS_SIP_OPTIONS_CHECK_PERIOD
- One IP fails
- Switches to an IP and port that answers
- All fail
- Gateway unused until OPTIONS succeed
What OPTIONS does
OPTIONS is a SIP request that asks a server what it supports. It sets up no call, but an answer, normally 200 OK, proves that the far SIP port is reachable and something is listening. Used regularly, it is a health check.
Without it, VOS3000 learns that a carrier is down only by sending real calls there. Each call waits for the INVITE timeout (SS_SIP_TIMEOUT_INVITE) before it moves to the next gateway, which adds post dial delay to every call. See SIP timeouts.
Turn it on
- Open the routing gateway and go to Additional settings → Protocol → SIP.
- Tick Options online check and apply.
- The interval is the softswitch parameter SS_SIP_OPTIONS_CHECK_PERIOD, in Softswitch management → Additional settings. It applies to every gateway that has the check on.
What VOS3000 does with the result
| Result | What happens |
|---|---|
| OPTIONS answered | The gateway is used as normal. |
| One IP and port fails | VOS3000 switches to an IP and port where the OPTIONS check succeeds. |
| All IPs and ports fail | The routing gateway cannot be used until a later OPTIONS check succeeds. |
So the check works best with a second route: while one carrier is out, calls for that prefix go to your other routing gateways in normal routing order, without first waiting on the dead one.
Why carriers must allow OPTIONS
Many carriers protect their session border controllers by answering only INVITEs from known IPs, or by blocking or rate-limiting OPTIONS. If the carrier never answers, VOS3000 counts every check as failed and stops using the gateway, although calls would have worked. Before you tick the box:
- Ask the carrier to accept and answer OPTIONS from your VOS3000 signalling IP.
- Ask which IPs and ports they answer on, if they have more than one.
- Check that your own firewall lets their answers back in.
Test before you rely on it
On the server, capture SIP with sngrep or tcpdump -i any -n port 5060 and look for the OPTIONS request and the carrier's answer. If the answer is 200 OK, keep the check on. If it is missing or an error, leave the check off for that carrier until they fix it.
Worked example
Carrier X goes down for 20 minutes. Without the check, every call for its prefix first waits for the INVITE timeout, then moves to carrier Y. With Options online check on X, VOS3000 stops sending calls to X once its checks fail, so they go to Y at once. When X answers OPTIONS again, it is back in use.
Questions about this topic
What is a SIP OPTIONS check?
VOS3000 sends a SIP OPTIONS request to the carrier from time to time. An answer shows that the carrier's SIP port is reachable before any call is sent there.
How often does VOS3000 send OPTIONS?
As often as the softswitch parameter SS_SIP_OPTIONS_CHECK_PERIOD says. The manual does not give a default, so check the value on your server.
What happens when OPTIONS checks fail?
VOS3000 switches to an IP and port of the gateway that answers OPTIONS. If none answer, the routing gateway is not used until a later OPTIONS check succeeds.
Why must the carrier allow OPTIONS?
If the carrier ignores or blocks OPTIONS from your IP, VOS3000 sees every check fail and stops sending calls to that gateway, even though INVITEs would work.
Run VOS3000 without the server work
Pick a VOS3000 server hosted by us, or have us install VOS3000 on your own server. VOS3000 Web and the Android app come with it.
Keep reading
Add a routing gateway
Set up a vendor route: prefix, IP and port, priority and least-cost options.
Routing order and LCR
How VOS3000 sorts routing gateways: prefix, priority, ASR, lowest rate, and when it fails over.
SIP timeouts and call limits
INVITE and ringing timeouts, session timer, the 2-hour limit, no-media hang up and max call duration.
Desktop, SIP and CDR firewalls
Allow trusted IPs, change the SIP port and unban addresses.