Meet (meet)

Description

Starts the Meet video conferencing server.

Made redundant in Active-Passive mode.

Creates an integration_point in the master domain for use by the Meet server.

Creates classes in the domain center for use by the Meet server.

Creates collections/classes: meet/Rooms, meet/Users, meet/RoomSessions, meet/UserSessions, meet/Messages, meet/records, meet/Feedbacks. Allows their further modification to extend the set of properties and enumerated field value variants.

Starts the VCS server in a separate process and restarts it on termination; prepares startup parameters from the role parameters, the configuration in domain.settings.meet_config (in the master domain), and certificates domain.settings.meet_cert_pem, domain.settings.meet_turn_cert_pem, domain.settings.meet_use_system_cert.

On startup, determines the web server whose address will be passed to the VCS server using the following algorithm:
1. all web servers of the current site are selected;
2. roles whose tags contain "meet" are selected from them (if none, all roles);
3. only roles located on the same server as meet are selected from them (if none, all roles from the previous step);
4. the role list is sorted by the order parameter;
5. the first web server role from the list is selected.

Table 1. System characteristics

Code

meet

Operation mode

Service

Redundancy mode

Active-Passive

Site types

Any

Layer

Service

Placement

Internal

State preservation and recovery on restart

Yes

Application

era_meet

Parameters

Table 2. Parameters
Name Type Default Description

name

str

required

Name. May consist of Latin letters and digits and must start with a letter.

roletype

str

required

Role type. Possible values: "meet".

ext

json

empty

Additional role options. Contains a JSON object or list.

enabled

bool

empty

Role activity flag. When set to false, the role does not participate in validation and is not started.

limit_of_cores

int

empty

Limit on the number of CPU logical cores used. Default: 0 - unlimited.

logging_default_level

int

empty

Default logging level set specifically for the role instance (microservice type). More

allow_divergence

bool

false

Flag allowing parameter differences in roles of the same group. Default: false - not allowed.

roleid

int

required

Role identifier.
Unique across the entire system, regardless of site or server. Cannot be changed.
An integer from 1 to 9999.

separate

bool

required

Flag indicating whether the role is allocated to a separate node.

group

int

required

Group number.
Horizontal scaling within a site is not supported. All role instances on the site must have the same value.
An integer from 1 to 9999999.

order

int

required

Order of the role instance within the group.
Determines the order in which takeover occurs in Active-Passive mode.

include_domains

array<str>

empty

List of domain names served by this group.
Any domain of any level can be specified. Specifying a domain causes its subtree to be served on this group and not on other role groups, except for branches mentioned in other groups.
Together, all role groups on the site serve the full domain tree.

listeniface

str

node_iface

Alias of the network interface on which the Meet server listener will be started. Default: alias of the network interface of the node that starts the server.

announcediface

str

node_iface

Alias of the network interface that is accessible from outside. Default: alias of the network interface of the node that starts the server.

port

int

required

Local port on which the Meet server listener will be started.

monitoring_enabled

bool

true

Per-second preparation of the current report on workers and rooms, written to the log and provided via the link /monitoring/<report_password>

cert_domain

str

empty

Domain for which the certificate was issued. Default: value from the master domain setting settings.meet_config.era.defaultDomain.

datadir

str

:SITESHARE/meet

Alias of the server directory for storing Meet server data (conference recordings, attachments, playback files, etc.).

certdir

str

empty

Alias of the server directory for storing certificates (fullchain.pem and privkey.pem files). If a certificate chain to a certification authority (CA) must be specified, it must be placed at the end of the certificate file.

turn_iface

str

node_iface

Alias of the network interface that is accessible from outside. Default: alias of the network interface of the node that starts the server.

turn_port

int

empty

Local port on which the coturn listener will be started. Default: 0 - listener is not started.

turn_port_tls

int

empty

Local TLS port for coturn. Default: 0 - listener is not started.

turn_certdir

str

empty

Alias of the server directory for storing certificates (fullchain.pem and privkey.pem files) for the turn service. If a certificate chain to a certification authority (CA) must be specified, it must be placed at the end of the certificate file.

listeniface_http

str

empty

Alias of the network interface on which the Meet server listener (http) will be started.

port_http

int

empty

Local port (http) on which the Meet server listener will be started.

datadir

str

empty

Alias of the server directory for storing VCS server data (attachments, video conference recordings, playback files, whiteboard files, user background images). Default: working directory of the meet role.

takeover

bool

global

Takeover mode switch.

Failover - activation of a lower-priority service instance when the higher-priority service instance (leader of the active-passive group) is detected as unavailable.
Takeover - activation of the higher-priority service instance (leader of the active-passive group) during its recovery, accompanied by stopping the service on the lower-priority service instance.

  • If the mode is enabled, takeover is performed automatically.

  • If the mode is disabled, takeover is not performed; the recovered group leader temporarily becomes a follower and waits for the service to be unloaded on the lower-priority instance.

  • If the option is not set, its value from the current site parameters is used. If it is not set on the site, the value from the general section is used. If it is not set anywhere, takeover is enabled for more accurate load distribution according to the configured priorities.

domain_group

int

group

Domain distribution group number. Instances with the same value share the domain subtree (include_domains) as one group. Defaults to the group number.
An integer from 0.

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.

Node example
{
  "name": "meet1",
  "roletype": "meet",
  "group": 11420,
  "order": 1,
  "roleid": 11420,
  "separate": true,
  "listeniface": "eth0",
  "port": 4123
}

See also