SIP Proxies Panel

To use SIP proxies, they must be defined and then assigned to a SIP Proxy Group (a collection of SIP Proxies). For further information on SIP Proxy Groups, please refer to SIP Proxy Groups.

Table 1. BAM Command Line Utility SIP Proxies options
Name Description
View SIP Proxies View already defined SIP Proxies
Add SIP Proxies Add a new SIP Proxy
Update SIP Proxies Update an already defined SIP Proxy
Remove SIP Proxies Remove an already defined SIP Proxy
Assign SIP Custom Headers to SIP Proxies Assign a SIP Custom Header to a SIP Proxy
Unassign SIP Custom Headers from SIP Proxies Remove a SIP Custom Header from a SIP Proxy

Table 2. Mandatory Parameters
Name Description
Name A user defined name for the proxy
Description A user defined description for the proxy
Mode Specifies the proxy mode. This can be LOOSE_ROUTING or REWRITE_DESTINATION.
  • LOOSE_ROUTING is how SIP proxies normally work, where any outbound requests with this proxy attached will set the Route: header
  • REWRITE_DESTINATION simply rewrites the destination's address to the address specified in the "SIP Address" parameter. The user part of the destination address will be original user part of the destination, or the phone number from a tel: URI if a tel: URI is specified.
SIP Address The full SIP address for the proxy (e.g. sip:proxy@192.168.0.5). Can include further information if necessary, e.g. port and transport (sip:proxy@192.168.0.5:5060;transport=udp)

Table 3. Optional Parameters
Name Description Default
Priority Sets the priority of this proxy for any group it is assigned to (please see "Weight and Priority" section in this document) 1
Weight Sets the weight of this proxy for any group it is assigned to (please see "Weight and Priority" section in this document) 1
Try Anonymous? Determines whether this proxy should try using anonymous credentials if an authentication challenge is received False
OPTIONS ping enabled? Enables OPTIONS ping, which is used by BVR to monitor the status of the proxy. If the OPTIONS ping receives a SIP 2xx response (e.g. 200 OK), the proxy will be set to UP. Otherwise, if it receives a non-2xx final response OR the request times out, it will be set to DOWN) False
OPTIONS ping frequency if proxy is up How frequently (in seconds) to send a SIP OPTIONS message when the proxy is UP 60
OPTIONS ping frequency if proxy is down How frequently (in seconds) to send a SIP OPTIONS message when the proxy is DOWN 60
Note: If OPTIONS ping is not enabled, a proxy will be set to DOWN if requests to it time out. The proxy will not be used again until every other proxy in the group is also DOWN.
Note: If a proxy is edited in BAM and the SIP address has changed, the status will be reset to UP.

Weight and Priority

For more information on how BVR uses Weight and Priority to provide load balancing and redundancy, please refer to Weight and Priority usage in the Blueworx Platform