User`s manual

Table Of Contents
SIP User's Manual 6. Gateway's ini File Configuration
Version 5.0 155 October 2006
Table 6-7: SIP Configuration Parameters (continues on pages 150 to 169)
ini File Field Name
Web Parameter Name
Valid Range and Description
ProxyLoadBalancingMethod
[Proxy Load Balancing
Method]
Enables the usage of the Proxy Load Balancing mechanism.
Valid options include:
0 = Load Balancing is disabled (default).
1 = Round Robin.
2 = Random Weights.
When Round Robin (1) algorithm is used, a list of all possible Proxy IP
addresses is compiled. This list includes all entries in the ProxyIP table after
necessary DNS resolutions (including NAPTR and SRV, if configured). This list
can handle up to 15 entries.
After this list is compiled, the Proxy Keep-Alive mechanism (according to
EnableProxyKeepAlive and ProxyKeepAliveTime) is used to mark each entry
as Offline or Online. The balancing is only performed on Proxy servers that are
marked as Online.
All outgoing messages are equally distributed across the Proxy IP list.
REGISTER messages are also distributed unless a RegistrarIP is configured.
The Proxy IP list is refreshed according to ProxyIPListRefreshTime. If a
change in the order of the entries in the list occurs, all load statistics are
erased and balancing starts over again.
When Random Weights (2) algorithm is used, the outgoing requests are not
distributed equally among the Proxies. The weights are received from the DNS
server by using SRV records. The gateway sends the requests in such a
fashion that each Proxy receives a percentage of the requests according to its
assigned weight.
Load Balancing is not used in the following scenarios:
The ProxyIP table includes more than one entry.
The only Proxy defined is an IP address and not an FQDN.
SRV usage is not enabled (DNSQueryType).
The SRV response includes several records with a different Priority value.
ProxyIPListRefreshTime
[Proxy IP List Refresh Time]
Defines the time interval (in seconds) between refreshes of the Proxy IP list.
This parameter is used only when ProxyLoadBalancingMethod = 1.
The interval range is 5 to 2,000,000. The default interval is 60.
IsFallbackUsed
[Enable Fallback to Routing
Table]
0 = Gateway fallback is not used (default).
1 = Internal Tel to IP Routing table is used when Proxy servers are not
available.
When the gateway falls back to the internal Tel to IP Routing table, the
gateway continues scanning for a Proxy. When the gateway locates an active
Proxy, it switches from internal routing back to Proxy routing.
Note: To enable the redundant Proxies mechanism set
‘EnableProxyKeepAlive’ to 1 or 2.
UserName
[User Name]
Username used for Registration and for Basic/Digest authentication process
with Proxy / Registrar.
Parameter doesn’t have a default value (empty string).
Password
[Password]
Password used for Basic/Digest authentication process with Proxy / Registrar.
The default is ‘Default_Passwd’.
Cnonce
[Cnonce]
String used by the SIP Server and client to provide mutual authentication (free
format, i.e., ‘Cnonce = 0a4f113b’).
The default is ‘Default_Cnonce’.
IsRegisterNeeded
[Enable Registration]
0 = Gateway does not register to Proxy/Registrar (default).
1 = Gateway registers to Proxy/Registrar at power up.
Note: The gateway sends a REGISTER request for each channel or for the
entire gateway (according to the parameter AuthenticationMode).