Redirect SIP Service (redirect)
Description
Redirects SIP requests to one of the SIP gates of the current site. Provides the ability to use one IP address for devices connected to the site, increasing its throughput.
Made redundant and scaled in Active-Active mode.
Code |
|
Operation mode |
|
Redundancy mode |
|
Site types |
|
Layer |
|
Placement |
|
State preservation and recovery on restart |
|
Application |
|
Limitations
-
The role is available only in working domains
-
Is a border role and uses a TLS certificate for HTTPS and WSS connections.
Parameters
| Name | Type | Default | Description | ||
|---|---|---|---|---|---|
|
|
required |
Name. May consist of Latin letters and digits and must start with a letter. |
||
|
|
required |
Role type. Possible values: |
||
|
|
empty |
Additional role options. Contains a JSON object or list. |
||
|
|
empty |
Role activity flag. When set to false, the role does not participate in validation and is not started. |
||
|
|
empty |
Limit on the number of CPU logical cores used. Default: 0 - unlimited. |
||
|
|
empty |
Default logging level set specifically for the role instance (microservice type). More |
||
|
|
|
Flag allowing parameter differences in roles of the same group. Default: false - not allowed. |
||
|
|
required |
Role identifier. |
||
|
|
required |
Flag indicating whether the role is allocated to a separate node. |
||
|
|
required |
Local UDP port for SIP. The same port also handles TCP. |
||
|
|
required |
Local TCP port for SIP. If a value different from UDP is specified, it is opened additionally. |
||
|
|
empty |
Local TLS port for SIP ( |
||
|
|
empty |
Local WebSocketSecure port for SIP ( |
||
|
empty |
Local port for SIP interaction with other system microservices (UDP/TCP). |
|||
|
|
List of server interfaces on which port listeners are raised. For sg, esg, and redirect roles running on the same server, the same values can be specified as external ports (udp, tcp, tls, wss) if their listen interface lists do not overlap. The original interface of the current node is always added to the listen interface list (except when a virtual address exists in the same subnet). The listener is raised on the 'sip_internal_port', which must not be used by other microservices on the same server. |
|||
|
|
List of monitored virtual interfaces (Virtual IP). If some virtual interfaces are specified in the list, the microservice instance monitors their appearance before starting the target service.
The target use of a virtual interface assumes the following combination of settings:
|
|||
|
|
|
Response code sent to the UA for redirection. Possible values: |
||
|
|
|
Switch for the mode of providing the UA with a list of addresses. |
||
|
|
empty |
List of |
||
|
|
|
Lifetime substituted into the "Contact" field during redirection, in seconds. |
||
|
|
Switch for logging SIP traffic to the |
|||
|
|
Switch for logging SIP transactions to the |
|||
|
|
Switch for logging events to the |
|||
|
|
Switch for logging Call-ID closures of legs/dialogs to the |
|||
|
|
Switch for logging media functions to the |
|||
|
|
Switch for logging to the |
Configuration example
Configuration management is performed in an application available to master domain administrators. The application hides the full configuration content, but it is still available through the API.
The configuration contains a section describing all instances of all roles. Parameters are defined for each specific role instance.
{
"name": "redirect1",
"roletype": "redirect",
"roleid": 11430,
"separate": true,
"tcp": 5060,
"udp": 5060,
"tls": 5061,
"wss": 5063,
"certdir": "/var/lib/era/certificates",
"keypass": "eb9c4458016d3f1e378d02004c4f4f50",
"expires": 180,
"multicontact": false,
"sipcode": 302
}