VOS3000 how-to

Register VOS3000 to a SIP carrier

Most wholesale carriers allow your server's IP. Some give you a user name and password instead. This is how VOS3000 handles those.

Updated · By the VOS3000 Web team

Quick answer: When a carrier gives you a SIP account instead of allowing your IP, add it in the desktop client under Operation management, Registration management with the user name, password and server IP, then point a routing gateway of the registration type at it. Domain management keeps the IP of a carrier's host name up to date.

Where
Operation management, Registration management
Needs
User name, password, server IP
Used by
A routing gateway of the registration type
Host names
Domain management, Dynamic or Static

When you need it

If the carrier gives you an IP and port and allows your server's IP, a normal routing gateway is enough. If the carrier gives you a SIP user name and password to register with, as many retail SIP trunks and some PBXs do, VOS3000 must register to it first.

Add the registration

In the VOS3000 desktop client, open Navigation → Operation management → Registration management and add a row:

  • Mark: a name for this registration. A routing gateway of the registration type uses the mark to find it.
  • User name and Authentication password: from the carrier.
  • Server ip: the carrier's registration server.
  • Line limit: concurrent calls allowed on this registration.

In Additional settings you can set the Signaling port, Encryption, Host name (the server address used in REGISTER, From and To; the server IP by default), a Sip proxy, the User-Agent (VOS3000 and its version by default), the Local ip and Local port to register from, and the Register period: Default (the system parameter) or Auto negotiation (the server decides). If the carrier asks for a different user name in the authentication than in the From header, fill in Authentication user.

Send calls through it

Create a routing gateway of the registration type and link it to the registration's mark. Give it prefixes, a priority and a vendor rate like any other routing gateway; see routing order. Caller and callee dial plans work as usual, and the registration has its own outbound caller dial plans; see dial plan patterns.

Check that it works

The registration row shows Registeration time, Update time, Actual register cycle (the period after negotiation) and Last error. If Last error shows 401 or 403, the user name or password is wrong or the carrier does not allow your IP. If it shows a timeout, check the server IP, the signalling port and your firewall.

Related softswitch parameters: SS_SIP_USER_AGENT_RETRY_DELAY (60 s) is how long VOS3000 waits before retrying a failed registration, SS_SIP_USER_AGENT_SEND_UNREGISTER (On) sends an unregister when a registration is removed, and SS_SIP_USER_AGENT_PRIVACY adds a Privacy header to registrations.

Carriers with a host name: Domain management

If the carrier gives a host name instead of an IP, add it in Operation management → Domain management. Each domain has an IP, a Type and an update time:

  • Dynamic: VOS3000 looks up the name again every SERVER_DNS_UPDATE_INTERVAL seconds (600 by default), so a change of the carrier's IP is picked up.
  • Static: the name is not looked up again.

Routing gateways and registrations can then use the domain.

Questions about this topic

How do I register VOS3000 to a SIP provider?

Add the account in Operation management, Registration management with the user name, password and server IP, then use it from a routing gateway of the registration type.

Why does my VOS3000 registration fail?

Open Registration management and read the Last error column. Check the user name, authentication user, password, server IP and signalling port, and that the provider allows your server's IP.

Can a VOS3000 routing gateway use a host name?

Yes. Add the host name in Domain management; Dynamic domains are looked up again every SERVER_DNS_UPDATE_INTERVAL seconds (600 by default).

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.