Middleware (mware)

Описание

Обеспечивает функции переноса данных между внутренними сервисами внутри сайта, а также контроля корректности работы.

Разделена на микросервисы по доменам. Обеспечивает автоматическую синхронизацию работы между сайтами, обслуживающими домен.
Резервируется в режиме Active-Passive. Масштабируется разделением доменного дерева.

Сервисы:
* Мониторинг работоспособности сервиса синхронизации файлов fsync.
* Мониторинг глобальных имен.
* Мониторинг состояния MEGACO-подключений между MGC и MG.
* Обеспечение функционирования учетных записей sipuser, настроенных на работу без регистрации.
* Управление звонками через API (callmanager).
* Сервис публикации ролевых приложений.
* Сервис голосовых оповещений.
* Сервис критических секций (компонент сценариев "Мьютекс" и др.).
* Контроллер потоковой репликации PostgreSQL.
* Сервис сопоставления записи с шаблоном (audoimatcher).

Table 1. Системные характеристики

Код

mware

Режим работы

Сервис

Режим резервирования

Active-Passive

Типы сайтов

Любые

Слой

Служебный

Размещение

Внутренний

Сохранение и восстановление состояния при перезагрузке

Да

Приложение

rostell_mware

Параметры

Описание столбцов в таблице

Table 2. Параметры
Имя Тип Умолчание Описание

name

str

required

Имя. Может состоять из латинских букв и цифр, должно начинаться с буквы.

roletype

str

required

Тип функциональной роли. Возможные значения: "mware".

iface

str

required

Алиас сетевого интерфейса сервера, на котором будет происходить внутреннее взаимодействие функциональных ролей между собой.

group

int

required

Номер группы.
В рамках горизонтального масштабирования функциональная роль может быть разделена на несколько групп на сайте, в каждой из которых активен только один экземпляр, а остальные зарезервированы.
Ответственность между группами разделяется по доменным множествам. Вместе все группы обслуживают полное доменное множество. Все функциональные роли одной группы должны иметь одинаковую ответственность.
Целое число от 1 до 9999999.

order

int

required

Порядок экземпляра функциональной роли в рамках группы.
Определяет в каком порядке будет происходить перетекание в режиме Active-Passive.

include_domains

array<str>

empty

Список имен доменов, которые обслуживает данная группа.
Может быть указан любой домен любого уровня. Указание домена приводит к тому, что дерево его поддоменов будет обслуживаться на этой группе и не будет обслуживаться на других группах функциональной роли, исключая только те ветви, которые упомянуты в других группах.
В совокупности все группы функциональной роли на сайте обслуживают полное дерево доменов.

pg_controller

array<object>

empty

Настройки для контроллера серверов PostgreSQL, находящихся в режиме потоковой репликации (версия pgsql 12+).
Список содержит объекты-группы. Каждая группа содержит список из двух серверов, находящихся в режиме потоковой репликации.
Сервис mware обеспечивает в каждой группе наличие 1 мастера, автоматически приводя к состоянию 1+1.
Если обнаруживаются два мастера - один из них переводится в режим recovery. Изначально мастером выбирается первый из серверов в списке. В дальнейшем тот, кто выполнял функцию мастера последним.
Если экземпляр-мастер становится недоступен, то в течение минуты-двух recovery-сервер превращается в мастер.
Если предыдущий мастер появляется снова, то он переводится в режим recovery путем остановки и полного бэкапа данных с текущего мастера.
В лог middleware трассируется вся активность сервиса.
Работа с состояниями экземпляров серверов БД производится через SSH, для чего в свойствах сервера должны быть указаны соответствующие опции.
Операция перевода в режим recovery сопровождается перемещением каталога с данными в указанную папку для бэкапов. По умолчанию /tmp/pg_backups.
Перевод в режим master только после истечения 30 секунд после потери текущего мастера.
Перевод в режим recovery возможен только при наличии активного мастера.

Настройки значений для групп:

  • key - уникальный строковый ключ группы. При отсутствии генерируется автоматически.

  • servers - список серверов, входящих в группу.

Настройки значений для серверов:

  • ssh_host - ssh host of postgresql (default as pg_host).

  • ssh_port - ssh port of postgresql server (default 22).

  • ssh_user - ssh user of postgresql host.

  • ssh_pwd - ssh password of postgresql host.

  • pg_host - actual current postgresql host address, available for replicas (default as ssh_host).

  • pg_port - actual current postgresql port, available for replicas (default 5432). Recommended to set the same value to all replicas.

  • pg_replica_user - actual current postgresql replica user login, available for replicas. Should be the same on all replicas.

  • pg_replica_pwd - actual current postgresql replica user password, available for replicas. Should be the same on all replicas.

  • pg_ctl_command - available for ssh user command (name, path or alias) to pg_ctl of current postgresql version.

  • pg_basebackup_command - available for ssh user command (name, path or alias) to pg_basebackup of current postgresql version.

  • pg_database - actual current postgresql initial database to connect to as replica user and save state (default postgres).

  • pg_data_folder - postgresql instance data folder. Recommended to set the same value to all replicas.

  • pg_backup_folder - postgresql instance backups folder.

  • pg_log_filepath - postgresql instance log file.

  • pg_signal_filepath - recovery signal file to make master. Recommended to set the same value to all replicas.

Указанное значение этого параметра не проверяется валидатором конфигурации в функциональной роли mic, однако проходит через фильтр в рантайме. В случае выявления некорретных настроек группа исключается. При отсутствии корректно настроенных групп контроллер бездействует и ожидает изменений в конфигурации.

Все функциональные роли системы автоматически переключаются в работу с новым мастером, указанным в конфигурации, вне зависимости от данной настройки.

=Настройка PostgreSQL=

Для того, чтобы сервис контроллера работал корректно, требуется предварительная настройка экземпляров PostgreSQL.
Серверы могут быть установлены с помощью скрипта платформы, в этом случае они получают эту настройку автоматически.

Версия PostgreSQL не ниже 12.
Для репликации создана учетная запись (например, replicator), ей разрешено 10 или более подключений.
В конфигурационных файлах произведены следующие настройки (значения отдельных параметров могут варьироваться по усмотрению администратора):

postgresql.conf
listen_addresses = '*'
hot_standby = on
wal_level = replica
max_wal_senders = 10
wal_keep_segments = 32
promote_trigger_file = '/var/lib/postgresql/12/era_instance_01/master.signal'
pg_hba.conf
host	all	            replicator     	0.0.0.0/0		md5

Если второй сервер настроен в режиме мастера, то после первого запуска контроллер автоматически переведет одного из них в режим репликации.

enable_audiomatcher

bool

false

Признак запуска процесса audio-matcher, используется для работы компонента ivr сценария - Антиробот.

Пример конфигурации

Управление конфигурацией производится в приложении, доступном для администраторов мастер-домена. Приложение скрывает полное содержание конфигурации, однако тем не менее оно доступно через API.

Конфигурация содержит раздел для описания всех экземпляров всех функциональных ролей. Параметры определяются для каждого конкретного экземпляра функциональной роли.

Пример узла
{
  "name": "mware2",
  "roletype": "mware",
  "iface": "eth0",

  "pg_controller": [
    {"key": "general",
     "servers": [
       {
        "ssh_host": "192.168.0.123",
        "ssh_port": 22,
        "ssh_user": "postgres",
        "ssh_pwd": "123456",
        "pg_host": "192.168.0.123",
        "pg_port": 5433,
        "pg_replica_user": "replica",
        "pg_replica_pwd": "654321",
        "pg_database": "postgres",
        "pg_ctl_command": "/usr/lib/postgresql/12/bin/pg_ctl",
        "pg_basebackup_command": "pg_basebackup",
        "pg_data_folder": "/var/lib/postgresql/12/instance01",
        "pg_backup_folder": "/var/lib/postgresql/12/backups/instance01",
        "pg_log_filepath": "/var/log/postgresql/postgresql-12-instance01.log",
        "pg_signal_filepath": "/var/lib/postgresql/12/instance01/master.signal"
       },
       {
        "ssh_host": "192.168.0.124",
        "ssh_port": 22,
        "ssh_user": "postgres",
        "ssh_pwd": "123456",
        "pg_host": "192.168.0.124",
        "pg_port": 5433,
        "pg_replica_user": "replica",
        "pg_replica_pwd": "654321",
        "pg_database": "postgres",
        "pg_ctl_command": "/usr/lib/postgresql/12/bin/pg_ctl",
        "pg_basebackup_command": "pg_basebackup",
        "pg_data_folder": "/var/lib/postgresql/12/instance01",
        "pg_backup_folder": "/var/lib/postgresql/12/backups/instance01",
        "pg_log_filepath": "/var/log/postgresql/postgresql-12-instance01.log",
        "pg_signal_filepath": "/var/lib/postgresql/12/instance01/master.signal"
       }
     ]
    }
  ],

  "group": 981001,
  "order": 10
}

См. также

  • Персонализация
  • Увеличить шрифт
  • Уменьшить шрифт