Раздел general

Описание

Общие параметры конфигурации, не относящиеся к другим разделам.

Параметры раздела

Table 1. Параметры раздела
Спецификация Описание

Ключ: generaldomain
Обязательный: да
По умолчанию: — 

Алиас главного домена из раздела "tds"

Ключ: version
Обязательный: да
По умолчанию: — 

Версия конфигурации. Представляет собой строгое значение, известное системе. На текущий момент "3.0"

Ключ: master_admin_login
Обязательный: нет
По умолчанию: — 

Логин мастер-администратора.
Учетные данные пропускают запросы в систему под ролью администратора.
При этом самой учетной записи в домене не существует.

Ключ: master_admin_pwd
Обязательный: нет
По умолчанию: — 

Пароль мастер-администратора.
Может быть указан в виде зашифрованного значения.
Зашифровать и расшифровать пароль можно через API.
Ключ шифра зависит от экземпляра текущей системы.

Ключ: logging_min_disk_space
Обязательный: нет
По умолчанию: 3

Минимальный объем свободного места на диске, при достижении которого, логирование будет отключено, в ГБ.

Ключ: logging_role_store_days
Обязательный: нет
По умолчанию: 2

Количество дней, в течении которого лог-файлы хранятся в рабочей директории ролевой ноды.

Ключ: logging_role_max_size
Обязательный: нет
По умолчанию: 100

Максимальный объем лог-файлов, который может быть занят одной ролевой нодой (каталог log в рабочей директории ролевой ноды), в ГБ.

Ключ: logging_default_level
Обязательный: нет
По умолчанию: "INFO"

Уровень логирования по умолчанию, применяемый ко всем нодам.

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

Уровень по умолчанию применяется перед запуском приложений ролей/микросервисов.
Важно помнить, что отдельные микросервисы имеют собственные настройки уровней логирования для специфических журналов. Например, trn-логи SIP-сигнализации, отладочные логи медиа-шлюза, трассировка websocket веб-сервера.

Возможные значения:

  • CRASH

  • ERROR

  • WARNING

  • INFO

  • TRACE

  • DEBUG

Ключ: pang_to_disconnect_sec
Обязательный: нет
По умолчанию: 10

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

Ключ: sip_stat_timeout_callinfo
Обязательный: нет
По умолчанию: 1200

Время хранения в секундах статистической информации о вызовах. Применяется для мониторинговых запросов /api/monitor/v1/trace/calls.
По умолчанию данные сохраняются на 20 минут.
Чем больше время - тем дольше по времени от момента совершения звонка могут быть предоставлены данные запросом мониторинга. Одновременно с этим требуется больше оперативной памяти в нодах сип-сигнализации.

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

Возможные значения от 0 до 86400. 0 - сохранение не производится.

Ключ: sip_stat_timeout_closure
Обязательный: нет
По умолчанию: 12600

Время хранения в секундах статистической информации о связках между Call-Id телефонных вызовов одного сеанса для вычисления замыкания. Используется при построении диаграмм вызова.
Также сохраняет информацию о связях Call-Id вызовов с доменами системы для обеспечения возможности построения диаграмм в рабочих доменах по их собственным вызовам.
По умолчанию данные сохраняются на 3.5 часа.
Чем больше время - тем дольше по времени от момента совершения звонка могут быть построены замыкания и диаграммы по SIP-сигнализации сеанса. Одновременно с этим требуется больше оперативной памяти в нодах сип-сигнализации.

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

Возможные значения от 0 до 86400. 0 - сохранение не производится.

Ключ: cdr
Обязательный: нет
По умолчанию: true

Выключатель cdr-событий. Используется для тестовых контуров и генераторов звонков в нагрузочных стендах. Без cdr событий значительно снижается нагрузка, но отсутствует функционал cti-событий, ccs-событий взаимодействия с колл-центром, записи разговоров.

Ключ: check_quorum
Обязательный: нет
По умолчанию: false

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

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

Ключ: odd_referee
Обязательный: нет
По умолчанию: — 

Адрес или доменное имя стороннего сервера, выступающего в качестве нечетного арбитра при определении кворума среди четного количества серверов.
Проверка арбитражного сервера осуществляется с помощью отправки ping-запроса.
Применяется в качестве значения по умолчанию, если иное не указано в свойствах сайта.
Если параметр не задан глобально и не определен в настройках конкретного сайта, то при определении кворума на этом сайте считается, что арбитражный сервер доступен и кворум имеется.
Арбитражный сервер используется только если количество сконфигурированных серверов на сайте четно, и доступна ровно половина из них.

Ключ: pwd_hash_alg
Обязательный: нет
По умолчанию: — 

Хеш-функция хранения паролей пользователей. По умолчанию параметр отсутствтует, и хеш функция не используется, пароли пользователей хранятся в БД в открытом виде. Аналогично значению "none".
В случае указания sha, sha256, sha384, sha512, md5 - при изменении пароля пользователя он размещается в БД в хешированном виде, а при проверке производится хеширование проверяемого значения.
Любое другое значение - отключает хеширование.
При изменении параметра данные в БД не изменяются и требуют задания новых паролей для всех пользователей.
В случае использования сценариев внешней авторизации (проверки пароля во внешней системе), пароли учетных записей пользователей, сохраненные в БД не используются в нормальном режиме, и могут быть использованы только при ошибках в назначении или работе сценария.

Пример значения поля

{
  ...
  "general": {
    "generaldomain": "td_main",
    "master_admin_login": "superduke",
    "master_admin_pwd": "megaPassword42",
    "version": "3.0"
  },
  ...
}