Back to back UserAgent (b2b)
Description
Role that organizes switching between SIP devices by creating two-way dialogs.
Performs routing and calling of the corresponding devices, organizing a media stream between them through the mgc and mg roles.
Made redundant and scaled in Active-Active mode.
Services:
- Organization and servicing of SIP dialogs
- Management of media context business logic.
- Routing in the internal number plan.
- Calculation of subscriber representation.
- Forking (calling several registered devices or in several directions).
- Subscriber features: forwarding, group number, pickup, intercom, barge-in, transfer, leg replacement, multiple calls…
- Boss-secretary groups.
- CDR event generation.
- SIP call authorization.
- Registration servicing.
- Subscription servicing (BLF, voicemail) and notification sending.
- SIP service balancer.
- …
Code |
|
Operation mode |
|
Redundancy mode |
|
Site types |
|
Layer |
|
Placement |
|
State preservation and recovery on restart |
|
Application |
|
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. |
|
|
|
Switch for logging events to the |
|
|
|
Switch for logging Call-ID closures of different legs/dialogs to build sequence diagrams. When this log is enabled, the retention time of links in node memory (sip_stat_timeout_closure) can be reduced to save memory: volume estimate. |
|
|
|
Switch for logging media functions to the |
|
|
|
Switch for logging the MGC controller interaction protocol to the |
|
|
|
Switch for logging the dialog state machine trace to the |
|
|
|
Switch for logging SIP traffic to the |
|
|
|
By default, when initiating calls to addresses connected over TLS, an SDP offer for unencrypted media (RTP) is sent. This parameter can enable initiation of an SDP offer with an encrypted media stream for TLS addresses. |
|
|
|
Switch for monitoring TLS connection establishment. Changing the default settings may be required, for example, if a softphone does not initialize the media connection upon receiving a preliminary 183 response with SDP. |
|
|
|
Switch for sending a set of codecs in responses to INVITE.
|
|
|
|
Place RTP packet statistics in the conversation completion event. For the data to be placed in dialog history archives (the callcenter/connections/ArchiveConnections collection), enable the 'callcenter.ccs.rtpStat.store' option in the product layer of the corresponding domain. |
|
|
|
Switch for sending re-INVITE to the call initiator immediately after the dialog is established (the confirming SIP ACK request is received). |
|
|
|
Switch for checking devices by sending a SIP OPTIONS request when a REGISTER request exceeds the license limit.
|
|
|
|
List of audio codec names used to initiate a call (leg call). The value is a list of audio codec names in
Codecs are offered in list order. The base |
|
|
empty |
List of video codec names used to initiate a call (leg call). The value is a list of video codec names in
|
|
|
|
Use video transcoding.
|
|
|
|
Switch for recording dialogs with IVR. |
|
|
|
Switch for recording dialogs with conferences. |
|
|
|
Switch for recording listening and whispering dialogs. |
|
|
empty |
Header forwarding. Format:
Empty by default. |
|
|
true |
Switch for lowering the priority of local MG media gateways located on the same server as the currently active signaling server. |
|
|
empty |
Additional local SIP port (UDP/TCP) for interaction with other system microservices. The listener is raised if the value differs from 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": "b2b1",
"roletype": "b2b",
"roleid": 11240,
"separate": true,
"udp": 5090,
"tcp": 5090,
"send_reinvite_on_ack": false,
"allow_ac_set": false,
"check_by_options_on_limit": true,
"record_conf": false,
"record_ivr": false,
"log_cdr": true,
"log_trn": true,
"log_sip": true,
"log_media": true,
"log_mgct": true,
"fwd_headers": [
"X-Header-1",
"X-Header-2"
],
"payloads_audio_offer": [
"PCMU/8000", "CN/8000", "G722/8000"
]
}