VOS3000 how-to

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

  1. Open the routing gateway and go to Additional settings → Protocol → SIP.
  2. Tick Options online check and apply.
  3. 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

ResultWhat happens
OPTIONS answeredThe gateway is used as normal.
One IP and port failsVOS3000 switches to an IP and port where the OPTIONS check succeeds.
All IPs and ports failThe 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.