VOS3000 how-to

VOS3000 system parameters

Hundreds of switches change how VOS3000 bills, records and routes calls. Here are the ones operators actually change.

Updated · By the VOS3000 Web team

Quick answer: VOS3000 has two sets of system parameters in the desktop client: SERVER_ parameters under System management, System parameter, and softswitch SS_ parameters under Operation management, Softswitch management, Additional settings, System parameter. They set billing precision, CDR rules, timeouts, media proxy, blacklist limits and more.

Server parameters
System management, System parameter
Softswitch parameters
Softswitch management, Additional settings
Per-gateway values
Default means use the system parameter
Tip
Note the old value before you change one

Two places

  • System management → System parameter: the SERVER_ parameters, for billing, reports, queries, payments and mail.
  • Operation management → Softswitch management → Additional settings → System parameter: the softswitch parameters, named SS_, for SIP, H.323, media, routing and blacklists.

Both are in the VOS3000 desktop client. Many gateway and phone settings have a Default choice, which means "use the system parameter". Before you change a parameter, write down the old value, change one thing at a time and test with a call. Some changes only apply after a service restart; see restart VOS3000 services.

Billing

ParameterDefaultWhat it does
SERVER_BILLING_FREE_TIME0Seconds taken off the charged duration of every call. Talk time is not changed.
SERVER_BILLING_HOLD_TIME_PRECISION1000Rounding of duration, in milliseconds. At 50, 21.049 s counts as 21 s and 21.050 s as 22 s.
SERVER_BILLING_FREE_E164SNumbers that are free to call, with no time limit.
SERVER_BILLING_NO_CDR_E164SFree numbers that also create no CDR.
SERVER_BILLING_GATEWAY_ROUTE_PREFIXTechnical prefixes left out of billing: with 99,88, a call to 99123 is billed as 123.
SERVER_BILLING_PREVENT_OVERDRAFT_ADVANCE_TIME1Minutes of credit reserved ahead during a call, so a balance cannot go far below zero (1 to 15).
SERVER_DISPLAY_MONEY_PRECISION3Decimal places shown for money: at 3, 1 is shown as 1.000.

CDR and queries

ParameterDefaultWhat it does
SERVER_BILLING_RECORD_ZERO_HOLD_TIMEOnSaves CDRs of calls with no talk time. The manual suggests turning it off while the switch is under attack, to reduce load.
SERVER_BILLING_RECORD_ILLEGAL_CALLOnSaves CDRs of illegal calls: the caller's IP is not in any mapping gateway and the number is not a phone.
SERVER_QUERY_CDR_MAX_DAY_INTERVAL31Longest date range for one CDR search, in days.
SERVER_QUERY_CDR_DENY_TIMEHours of the day when CDR searches are blocked, for example 18,19,20 for your busy hours.
SS_CDR_RECORD_TO_FILEOffAlso writes CDRs to hourly text files; see CDR text files.

Calls and media

  • SS_MEDIA_PROXY_MODE (Auto) and SS_MEDIA_PROXY_PORT_RANGE (10000,39999): see media proxy.
  • SS_MAX_CALL_DURATION, SS_MEDIA_CHECK_TIMEOUT and the SIP timeouts: see SIP timeouts.
  • SS_GATEWAY_SWITCH_LIMIT and the ASR and rate sorting parameters: see routing order.

Accounts, logins and mail

  • SERVER_PAY_DELAY_CUSTOMER_EXPIRE_DAY (365): days an account's validity is extended after a recharge.
  • SERVER_DISPLAY_CUSTOMER_ALARM_MONEY (20): accounts below this balance are coloured in Account management.
  • SERVER_LOGIN_FAILED_DISABLE_TIME (120 s): how long a desktop client user is locked out after repeated wrong passwords.
  • SERVER_MAIL_SMTP_SERVER, SERVER_MAIL_SMTP_FROM and SERVER_MAIL_SMTP_FROM_USER: the mail server VOS3000 uses for bills and alarm e-mails.
  • SERVER_NTP_SERVER (time-a.nist.gov): the time server. Correct time matters for CDRs and bills.

Security-related parameters, such as password retry limits and dynamic blacklists, are on fraud protection settings.

Questions about this topic

Where are the VOS3000 system parameters?

In the desktop client: System management, System parameter for SERVER_ parameters, and Operation management, Softswitch management, Additional settings, System parameter for softswitch SS_ parameters.

How do I give customers free seconds on every call?

Set SERVER_BILLING_FREE_TIME. That many seconds are taken off the charged duration of each call; the talk time stays the same.

How does VOS3000 round call duration?

With SERVER_BILLING_HOLD_TIME_PRECISION in milliseconds. At 50, a 21.049-second call counts as 21 seconds and a 21.050-second call as 22.

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.