VOS3000 contains hundreds of configurable parameters that control every aspect of its operation – from SIP timers and H.323 settings to billing rules and alarm thresholds. Understanding these VOS3000 system parameters is essential for tuning performance, troubleshooting issues, and customizing the platform to your specific needs.
This comprehensive reference covers the most important parameters grouped by category, with explanations of what they do and when you might need to change them.
VOS3000 parameters are spread across two main locations:
Changes to parameters take effect immediately – no service restart required in most cases.
These parameters control the VOS3000 server environment, database behavior, and reporting.Parameter Name Default Value Description When to Change SERVER_BILLING_FEE_PRECISION0.0000000 Number of decimal places for billing amounts. If you need more/less precision in call charges (e.g., 4 decimals for fractional cents). SERVER_BILLING_HOLD_TIME_PRECISION1000 Time rounding precision in milliseconds. E.g., 50 means round to nearest 50ms. Adjust to match your carrier’s billing increments (6 seconds = 6000). SERVER_QUERY_ONE_PAGE_SIZE10000 Number of records displayed per page in CDR queries. Increase if you want to see more records at once (may slow down browser). SERVER_QUERY_CDR_MAX_DAY_INTERVAL31 Maximum number of days allowed in a single CDR query. Increase for longer reports, but beware of performance impact. SERVER_ALARM_EMAIL(empty) Email address for alarm notifications. Set to receive email alerts when alarms trigger. SERVER_ALARM_ENABLE_EMAILOff Enable/disable email alarms. Turn On after configuring email settings. SERVER_PASSWORD_LENGTH8 Minimum password length for new users. Increase for better security (e.g., 12). SERVER_PAY_DELAY_CUSTOMER_EXPIRE_DAY365 Days added to account expiry after recharge. Adjust based on your recharge policies. SERVER_REPORT_*Various Enable/disable automatic generation of daily reports. Turn off reports you don’t need to save server resources.
These parameters control SIP signaling behavior and are critical for interoperability with carriers and devices.Parameter Name Default Value Description When to Change SS_SIP_TIMEOUT_INVITE10 Seconds to wait for a response to INVITE before trying next gateway. Increase if carriers are slow to respond; decrease to fail faster. SS_SIP_TIMEOUT_RINGING120 Seconds to wait for answer after receiving ringing (180). Adjust for markets where users take longer to answer. SS_SIP_TIMEOUT_TRYING20 Seconds to wait for 100 Trying after INVITE. Increase if carriers don’t send early progress. SS_SIP_TIMEOUT_SESSION_PROGRESS20 Seconds to wait for 183 Session Progress. Some carriers send 183 very late – increase if calls fail prematurely. SS_SIP_TIMEOUT_SESSION_PROGRESS_SDP120 Seconds to wait for 183 with SDP (early media). Increase if early media takes time to arrive. SS_SIP_STOP_SWITCH_AFTER_SDPOn Stop trying other gateways after receiving SDP (media negotiation started). Turn Off if you want to continue trying better gateways even after SDP received. SS_SIP_RESEND_INTERVAL0.5,1,2,4,4,4,4,4,4,4 Comma‑separated retransmission intervals (seconds) for SIP messages. Customize for networks with high packet loss (longer intervals). SS_SIP_SESSION_TTL600 Session timer interval (seconds) for keeping calls alive. Shorter for aggressive dead‑call detection; longer to reduce signaling. SS_SIP_NO_TIMER_REINVITE_INTERVAL7200 Maximum call duration (seconds) for non‑timer‑aware SIP devices. Force hangup of very long calls to prevent billing errors. SS_SIP_NAT_KEEP_ALIVE_PERIOD30 Seconds between NAT keep‑alive messages. Reduce if devices behind NAT drop pinholes quickly.
For networks using H.323 gateways or terminals.Parameter Name Default Value Description When to Change SS_H323_TIMEOUT_SETUP5 Seconds to wait for Call Proceeding after Setup. Increase if H.323 gateways are slow. SS_H323_TIMEOUT_CALLPROCEEDING20 Seconds to wait for Alerting after Call Proceeding. Adjust based on typical answer times. SS_H323_TIMEOUT_ALERTING120 Seconds to wait for Connect after Alerting. Same as SIP ringing timeout. SS_H323_TIMEOUT_CALLPROCEEDING_OLC20 Seconds to wait for OLC (Open Logical Channel) after Call Proceeding. Increase if media negotiation is slow. SS_H323_STOP_SWITCH_AFTER_OLCOff Stop trying other gateways after OLC (media opened). Turn On if you want to lock the gateway once media starts.
These affect overall call handling and routing logic.
| Parameter Name | Default Value | Description | When to Change |
|---|---|---|---|
SS_MAX_CALL_DURATION | None | Global maximum call length in seconds. | Set to prevent extremely long calls (e.g., 10800 for 3 hours). |
SS_MEDIA_PROXY_MODE | Auto | Media proxy decision: Auto, On, Off, Must On. | Force On if you need recording or NAT traversal for all calls. |
SS_MEDIA_PROXY_PORT_RANGE | 10000,39999 | RTP port range for media proxy. | Adjust if you need to limit firewall rules. |
SS_GATEWAY_ASR_CALCULATE | Off | Enable real‑time ASR (Answer Seizure Ratio) calculation for routing. | Turn On to use ASR as a routing metric. |
SS_GATEWAY_ACD_CALCULATE | Off | Enable real‑time ACD (Average Call Duration) calculation. | Turn On to use ACD in routing decisions. |
SS_GATEWAY_SWITCH_UNTIL_CONNECT | Off | Continue trying gateways until one answers (not just until ringing). | Useful when carriers rarely answer but you want to try all options. |
SS_REDIRECT_OFFLINE_PHONE_TO_GATEWAY | Off | If a called phone is offline, try routing through gateways. | Useful for hybrid networks where phones may not always register. |
SS_ACCOUNT_INDICATION_METHOD | Off | How to warn of low balance: Off, Prompt balance, Prompt duration. | Enable to play warnings to callers before cutoff. |
Controls for IVR, callback, and value‑added services.Parameter Name Default Value Description When to Change IVR_RINGING_TIMEOUT120 Seconds to wait for answer in IVR scenarios. Adjust for different user behavior. IVR_SETUP_TIMEOUT20 Seconds to wait for initial response. Increase if IVR connections are slow. IVR_MEDIA_CHECK_TIMEOUT2 Minutes of no media before hanging up. Reduce to free ports faster on dead calls. IVR_CODEC_PRIORITYg729a,g729,g723,g711a,g711u Preferred codec order for IVR. Reorder based on your termination costs/quality.
No. VOS3000 reads parameters from the database in real time. Changes take effect immediately for new calls. Ongoing calls continue with the parameters they started with.
Most parameters are safe to experiment with, but extreme values (e.g., setting timeouts to 0) can cause unexpected behavior. Always note the original value so you can revert if needed.
For SIP, start with SS_SIP_TIMEOUT_INVITE and SS_SIP_RESEND_INTERVAL. If carriers are slow to respond, increasing these can reduce “Response timeout” failures.
Set SS_SIP_NAT_KEEP_ALIVE_PERIOD to 20‑30 seconds and SS_SIP_NAT_KEEP_ALIVE_MESSAGE to “HELLO” or any string. The softswitch will send UDP packets to keep NAT bindings open.
Auto mode enables media proxy only when needed – e.g., when devices are behind different NATs, when encryption is required, or when a device explicitly requests it. This is the recommended setting for most deployments.
Mastering VOS3000 system parameters gives you fine‑grained control over your softswitch. Use this reference as a starting point, experiment carefully, and always monitor the impact of your changes. With the right tuning, you can maximize call completion rates, improve voice quality, and optimize resource usage.
Need expert help with VOS3000 configuration or performance tuning? Contact us on WhatsApp: +8801911119966
Master the VOS3000 clearing report for reliable financial settlement and reconciliation. Learn clearing report configuration, partner settlement, billing reconciliation, and… Read More
Master the VOS3000 analysis report for comprehensive gateway performance monitoring. Learn ASR ACD analysis, gateway quality metrics, route performance evaluation,… Read More
Master VOS3000 bill report for accurate revenue tracking across gateways, phone accounts, and destinations. Learn bill report configuration, revenue analysis,… Read More
This website uses cookies.