VOS3000 how-to

VOS3000 LRN and number portability

A ported US number keeps its digits but changes carrier. An LRN lookup tells VOS3000 where the number really lives, so you route and bill on that.

Updated · By the VOS3000 Web team

Quick answer: VOS3000 can ask an external LRN server where a US number has been ported. Set SS_LRN_SERVER_IP and SS_LRN_SERVER_PORT in the system parameters, then use the LRN options on the mapping gateway to route on the number the server returns and to add interstate or undetermined billing prefixes.

LRN server
SS_LRN_SERVER_IP
Port
SS_LRN_SERVER_PORT, 5060 by default
If the query fails
Failure action: Reject or Continue
Interstate check
Number management, Lerg Data

What LRN is

In the United States a subscriber can keep their number when they move to another carrier, so the dialled prefix no longer tells you which network serves the line. Each ported number is linked to a location routing number (LRN): a ten-digit number that identifies the switch now serving it. The links come from the national number portability database administered by the NPAC. A carrier that looks up (dips) the number before routing can send and rate the call by the real terminating network instead of the original prefix.

The VOS3000 manual describes it the same way: in America the LRN is kept in the signal control point (SCP) and is used for number portability.

Point VOS3000 at an LRN server

VOS3000 does not hold the portability data itself; it queries an LRN server. Get the server address and port from your LRN provider and enter them in Softswitch management → Additional settings → System parameter:

ParameterDefaultWhat it sets
SS_LRN_SERVER_IPEmptyThe IP address of the LRN server.
SS_LRN_SERVER_PORT5060The port of the LRN server, 1 to 65535.

LRN options on the mapping gateway

The lookup is then controlled per customer, in the mapping gateway's Additional settings → Others:

  • Eat prefix length: cuts that many leading digits from the number and bills on what is left.
  • Failure action: what to do when the query fails, Reject or Continue.
  • Routing using number: when set to query, the route lookup uses the number the LRN server returned, not the dialled one.
  • Interstate billing prefix: a prefix added for interstate calls.
  • Undetermined billing prefix: a prefix added for calls that cannot be recognised as interstate or not.

Whether a call is interstate comes from Number Management → Lerg Data: if the caller's and the callee's states are different, the call is interstate.

Worked example

Your US carrier charges more for interstate calls. Set Interstate billing prefix to 88 and Undetermined billing prefix to 99 on the customer's mapping gateway. In the customer's rate group, keep the normal rates under the usual prefixes and add a second set under 88 and a third under 99. VOS3000 matches the longest rate prefix, so an interstate call picks the 88 rate. See VOS3000 rates.

Pitfalls

  • Reject with a dead server stops all traffic. With Failure action set to Reject, every call on that gateway fails while the LRN server is unreachable, with LrnFail (-79) in the CDR. Use Continue if you prefer to carry calls unrated by LRN.
  • Ported numbers can be refused. RejectLrnPortedNumber (-78) means the call was rejected because the number is ported.
  • No Lerg Data, no interstate rates. Without state data VOS3000 cannot tell interstate calls apart, so expect the undetermined prefix.
  • Firewalls. Allow traffic between your server and the LRN server, or the queries will fail.

Check a few test calls in the CDR before you move real traffic.

Questions about this topic

What is LRN in VoIP?

A location routing number: the number of the switch that now serves a ported US phone number. A carrier looks it up before routing so the call goes to, and is rated for, the network that really owns the line.

Does VOS3000 have its own LRN database?

No. VOS3000 queries an LRN server that you point it to with SS_LRN_SERVER_IP and SS_LRN_SERVER_PORT. The data comes from your LRN provider.

What happens if the LRN server is down?

That depends on the Failure action on the mapping gateway. Reject refuses the call; Continue lets it go on without the LRN result.

How does VOS3000 know a call is interstate?

From Number management, Lerg Data: if the caller and the callee are in different states, the call is interstate and gets the Interstate billing prefix.

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.