How to add a mapping gateway in VOS3000
A mapping gateway is how a customer's traffic enters your switch. Here is how to add one and set it up correctly.
Updated · By the VOS3000 Web team
Quick answer: A mapping gateway is where a customer's calls enter VOS3000. Create the customer account first, with its billing rate group, then add a mapping gateway for that customer: choose Static, Dynamic or Registration, enter the customer's IP addresses and set the line limit.
- Used for
- Customer (incoming) traffic
- Billed by
- The customer account's rate group
- Gateway types
- Static, Dynamic, Registration
- Line limit
- Maximum concurrent calls
- Prefixes
- Additional Settings, Mapping prefix tab
Before you start: the customer account
Every mapping gateway belongs to a customer account, and the account decides the price. In VOS3000 Web open Accounts → Customer and add the customer with a name, a balance or overdraft, and a Billing Rate: the rate group the customer pays from. If you have no rate group yet, see VOS3000 rates.
Add the mapping gateway
Open Gateways → Mapping and click Add Mapping. The same fields appear in the VOS3000 desktop client.
- Customer: the account this traffic is billed to.
- Gateway Name: a unique name, for example the customer's company name.
- Call Permission: International (the default), Domestic, Local or Net.
- Limit: the line limit, meaning the most calls this customer can run at the same time.
- Priority: a number from 0 to 9999.
- Lock Type: No Lock to allow calls, or Bar All Calls to block them.
- Gateway Type: Static, Dynamic or Registration (see below).
- IP Address: the customer's signalling IP addresses, for a Static gateway.
Static, Dynamic or Registration?
- Static: the customer sends from fixed IP addresses. Enter one or more, separated by commas. Each IP address can be used by only one mapping gateway.
- Dynamic: no fixed IP address is entered. Use it for customers whose address changes.
- Registration: instead of an IP address you enter a registration identification.
Prefixes, rewrite rules and routing strategy
Click the sliders icon in the gateway row to open Additional Settings. Its tabs are Normal, Mapping prefix, Routing settings, Protocol, Codec and Others.
- Mapping prefix: caller and callee prefixes, each as an Allow or Forbidden list, plus caller and callee rewrite rules and dial plans.
- Routing settings: the first and second routing strategy: None, Connected ratio or Lowest rate per second.
- Protocol and Codec: SIP or H.323 options, DTMF and the codecs this customer may use.
Allow the customer on the SIP firewall
If the SIP firewall is on, the customer's IP addresses must be allowed on it. When you save a gateway whose IP is not allowed, VOS3000 Web warns you and offers to allow it.
Check that it works
The status light in the gateway list shows when the gateway is online. Send a test call, then look at it in Reports → Recent CDR. If it failed, the termination reason usually says why:
- InsufficientBalance (-2): the customer has no balance left.
- RateNotExist (-5): the customer's rate group has no rate for that number.
- OverCapacity (-25): the line limit was reached.
- NoAvailableRouter (-69): no routing gateway can carry that number. See how to add a routing gateway.
In the VOS3000 desktop client
Open Operation management → Gateway operation → Mapping gateway and click Add on the toolbar. The table has the same settings, with the client's names: Gateway name, Lock type, Call permission, Line limit, Ip, Account id, Priority and Additional settings. Click Apply to save. You can also use Operation Wizard → Mapping gateway-->routing gateway, which asks for the IP, gateway name and line limit (30 by default) step by step.
Questions about this topic
What is the difference between a mapping gateway and a routing gateway?
A mapping gateway receives calls from a customer and links them to the customer account for billing. A routing gateway sends calls out to a vendor or carrier.
Can one mapping gateway have several IP addresses?
Yes. For a Static gateway, enter several IP addresses separated by commas. Each IP address can belong to only one mapping gateway.
Where do I set the price for a mapping gateway?
Not on the gateway. The price comes from the rate group chosen as the customer's Billing Rate on the customer account.
Why do calls fail with OverCapacity?
The gateway reached its line limit. Raise the Limit on the mapping gateway if the customer needs more concurrent calls.
Try every step in the live demo
Each screen in this guide is in the VOS3000 Web demo, with made-up data. Sign in with demo / demo.
Keep reading
Gateway call authentication
IP, IP Address and Port or password: how a mapping gateway recognises a customer, and fixing -6.
Connect VICIdial to VOS3000
Account, mapping gateway and limits on VOS3000, then the carrier entry and dialplan on VICIdial.
Add a routing gateway
Set up a vendor route: prefix, IP and port, priority and least-cost options.
Rate groups and rates
Create rate groups, add rates and bill customers per second or per minute.