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
| Parameter | Default | What it does |
|---|---|---|
| SERVER_BILLING_FREE_TIME | 0 | Seconds taken off the charged duration of every call. Talk time is not changed. |
| SERVER_BILLING_HOLD_TIME_PRECISION | 1000 | Rounding of duration, in milliseconds. At 50, 21.049 s counts as 21 s and 21.050 s as 22 s. |
| SERVER_BILLING_FREE_E164S | Numbers that are free to call, with no time limit. | |
| SERVER_BILLING_NO_CDR_E164S | Free numbers that also create no CDR. | |
| SERVER_BILLING_GATEWAY_ROUTE_PREFIX | Technical prefixes left out of billing: with 99,88, a call to 99123 is billed as 123. | |
| SERVER_BILLING_PREVENT_OVERDRAFT_ADVANCE_TIME | 1 | Minutes of credit reserved ahead during a call, so a balance cannot go far below zero (1 to 15). |
| SERVER_DISPLAY_MONEY_PRECISION | 3 | Decimal places shown for money: at 3, 1 is shown as 1.000. |
CDR and queries
| Parameter | Default | What it does |
|---|---|---|
| SERVER_BILLING_RECORD_ZERO_HOLD_TIME | On | Saves 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_CALL | On | Saves 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_INTERVAL | 31 | Longest date range for one CDR search, in days. |
| SERVER_QUERY_CDR_DENY_TIME | Hours of the day when CDR searches are blocked, for example 18,19,20 for your busy hours. | |
| SS_CDR_RECORD_TO_FILE | Off | Also 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.
Keep reading
SIP timeouts and call limits
INVITE and ringing timeouts, session timer, the 2-hour limit, no-media hang up and max call duration.
Fraud protection settings
Authentication lockouts, dynamic blacklists, geofencing and call limits that cap fraud losses.
CDR text files
Write every call to an hourly text file: how to turn it on, where the files are and the field format.
Restart VOS3000 services
The VOS3000 services, which one to restart after a change, and how to stop and start them.