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_PRECISION | 0.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_PRECISION | 1000 | 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_SIZE | 10000 | 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_INTERVAL | 31 | 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_EMAIL | Off | Enable/disable email alarms. | Turn On after configuring email settings. |
SERVER_PASSWORD_LENGTH | 8 | Minimum password length for new users. | Increase for better security (e.g., 12). |
SERVER_PAY_DELAY_CUSTOMER_EXPIRE_DAY | 365 | 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_INVITE | 10 | 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_RINGING | 120 | Seconds to wait for answer after receiving ringing (180). | Adjust for markets where users take longer to answer. |
SS_SIP_TIMEOUT_TRYING | 20 | Seconds to wait for 100 Trying after INVITE. | Increase if carriers don’t send early progress. |
SS_SIP_TIMEOUT_SESSION_PROGRESS | 20 | Seconds to wait for 183 Session Progress. | Some carriers send 183 very late – increase if calls fail prematurely. |
SS_SIP_TIMEOUT_SESSION_PROGRESS_SDP | 120 | Seconds to wait for 183 with SDP (early media). | Increase if early media takes time to arrive. |
SS_SIP_STOP_SWITCH_AFTER_SDP | On | 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_INTERVAL | 0.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_TTL | 600 | Session timer interval (seconds) for keeping calls alive. | Shorter for aggressive dead‑call detection; longer to reduce signaling. |
SS_SIP_NO_TIMER_REINVITE_INTERVAL | 7200 | 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_PERIOD | 30 | 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_SETUP | 5 | Seconds to wait for Call Proceeding after Setup. | Increase if H.323 gateways are slow. |
SS_H323_TIMEOUT_CALLPROCEEDING | 20 | Seconds to wait for Alerting after Call Proceeding. | Adjust based on typical answer times. |
SS_H323_TIMEOUT_ALERTING | 120 | Seconds to wait for Connect after Alerting. | Same as SIP ringing timeout. |
SS_H323_TIMEOUT_CALLPROCEEDING_OLC | 20 | Seconds to wait for OLC (Open Logical Channel) after Call Proceeding. | Increase if media negotiation is slow. |
SS_H323_STOP_SWITCH_AFTER_OLC | Off | 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_TIMEOUT | 120 | Seconds to wait for answer in IVR scenarios. | Adjust for different user behavior. |
IVR_SETUP_TIMEOUT | 20 | Seconds to wait for initial response. | Increase if IVR connections are slow. |
IVR_MEDIA_CHECK_TIMEOUT | 2 | Minutes of no media before hanging up. | Reduce to free ports faster on dead calls. |
IVR_CODEC_PRIORITY | g729a,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
VOS3000 Caller Number Pool: Powerful CLI Rotation for Outbound Traffic The VOS3000 caller number pool feature solves a critical problem… Read More
VOS3000 Protect Route: Smart Backup Gateway Activation with Timer The VOS3000 protect route feature is one of the most misunderstood… Read More
VOS3000 outbound registration setup guide for carrier SIP trunk connections. Configure VOS3000 to register outbound to carriers, IMS, and ITSP… Read More
This website uses cookies.