Record Mover (recmover)

Description

The role of moving call recordings across domain repositories. Intercepts record mix completion events and moves records according to the record rules to the file stores of the respective domains.

Reserved in Active-Passive mode. Scaled by domain tree partitioning.

Initiates the shorthand process upon completion of its own operation.

The configuration requires Message Broker.

Table 1. System Characteristics

Code

recmover

Mode of operation

Service

Backup mode

Active-Passive

Types of sites

Any

Layer

Business logic

Placement

Internal

Saving and restoring state on reboot

Yes

appendix

era_recmover

Own storage

ODB Mnesia

Limitations

  • The domain file storage can be S3 storage, which is set in the general domain settings. By default, the domain record repository is a subdirectory within the shared directory, where the data is stored after mixing (role mix).

Parameters

Table 2. Parameters
Name Type Default Description

name

str

required

Name. May consist of Latin letters and numbers, must begin with a letter.

roletype

str

required

Role Type. Possible values: "recmover".

iface

str

required

The alias of the server network interface on which the roles will interact internally with each other.

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.

group

int

required

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

order

int

required

The order of a role instance within a group.
Defines in what order the flow in the mode will take place Active-Passive.

intervalerrsec

int

60

Interval until the next iteration in case of an error, in seconds.
Counts down from the end of the current iteration with an error.
Possible values from 1 to 86400.

intervalsec

int

300

Interval between copy operations (from the end of the previous one to the beginning of the next one), in seconds.
Possible values from 1 to 86400.

mode

str

"move"

"Mode of working with records as a data provider. Possible values:

  • "copy" – files are copied to domain storage, and remain in the site’s shared storage.

  • "move" – files are copied to domain storage and then deleted from the site’s shared storage.

Configuration example

The configuration is managed in an application available to master domain administrators. The application hides the full content of the configuration, but it is nevertheless accessible via the API.

The configuration contains a section to describe all instances of all roles. Parameters are defined for each specific role instance.

Example node
{
  "name": "recmoverl1",
  "roletype": "recmover",
  "iface": "eth0",

  "group": 11210,
  "order": 1,

  "intervalerrsec": 30,
  "intervalsec": 30,
  "mode": "copy"
}

See also