Раздел servers

Содержание

Описание
Параметры раздела
Пример значения поля

Описание

Список серверов.

Раздел содержит список всех серверов текущей конфигурации и их параметров. Роли к параметрам не относятся. Привязка серверов к сайтам и ролей к серверам происходит в разделе structure.

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

Table 1. Параметры раздела
Спецификация	Описание
Ключ: `name` Обязательный: `да` По умолчанию: —	Название сайта, указываемое при настройках других элементов конфигурации. Cтрока, может состоять из латинских букв и цифр, начинаться должно с буквы. Рекомендуются короткие говорящие значения.
Ключ: `logiface` Обязательный: `да` По умолчанию: `"eth0"`	Алиас интерфейса на сервере, на котором поднимается нода servershell – центральная нода сервера.
Ключ: `ifaces` Обязательный: `да` По умолчанию: —	Сетевые интерфейсы IPv4, доступные на сервере. [ { "Key":"IPv4_Address", … }, .. ] --- , где `Key` – алиас интерфейса, используемый для указания интерфейсов при настройке ролей; `IPv4_Address` - IPv4 адрес интерфейса. Адреса должны присутствовать на сервере.
Ключ: `descr` Обязательный: `нет` По умолчанию: —	Описание сервера. По умолчанию значение не задано.
Ключ: `erlangtcp` Обязательный: `нет` По умолчанию: `4369`	Порт для взаимодействия нод виртуальной машины erlang между собой. Должен быть одинаковым у всех серверов конфигурации.
Ключ: `nodesportrange` Обязательный: `нет` По умолчанию: `9310:90`	Диапазон портов, которые будут использоваться для ролевых нод. Формат: `PortFrom:PortCnt`, где `PortFrom` – начальное значение порта, `PortCnt` – количество портов.
Ключ: `globalsharepath` Обязательный: `нет` По умолчанию: `"/var/lib/era/files/globalshare"`	Путь до каталога globalshare на сервере. В случае, если параметр не указан, то фактически будет использоваться указанный путь по умолчанию на диске.
Ключ: `sitesharepath` Обязательный: `нет` По умолчанию: `"/var/lib/era/files/siteshare"`	Путь до каталога siteshare на сервере. В случае, если параметр не указан, то фактически будет использоваться указанный путь по умолчанию на диске.
Ключ: `localpath` Обязательный: `нет` По умолчанию: `"/var/lib/era/files/local"`	Путь до каталога local на сервере. В случае, если параметр не указан, то фактически будет использоваться указанный путь по умолчанию на диске.
Ключ: `syncrootpath` Обязательный: `нет` По умолчанию: `"/var/lib/era/files/syncroot"`	Путь до каталога :SYNC на сервере (синхронизируется ролью fsync и приложением syncthing). В случае, если параметр не указан, то фактически будет использоваться указанный путь по умолчанию на диске.
Ключ: `recstorepaths` Обязательный: `нет` По умолчанию: `[]`	Перечисление каталогов для хранения записей разговоров на текущем сервере. [ { "Key":"AbsPath", … }, … ] --- , где `Key` – ключ, используемый для указания путей на сервере при настройке ролей; `AbsPath` – абсолютный путь на сервере к каталогу или его алиас (например, `alias://paths/c`).
Ключ: `logging_default_level` Обязательный: `нет` По умолчанию: empty	Уровень логирования по умолчанию, применяемый в нодах, обслуживаемых на данном сервере. Текущий уровень логирования конкретной ноды можно изменить с помощью API и из приложения администратора мастер-домена. Такие изменения сбрасываются при перезапуске соответствующей ноды. Если уровень не задан, то применяется значение этого параметра из конфигурационных настроек текущего сайта. Возможные значения: `CRASH` `ERROR` `WARNING` `INFO` `TRACE` `DEBUG`
Ключ: `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 - сохранение не производится.

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

{
  ...
  "servers": [
    {
      "descr": "Central server1. Srv2",
      "erlangtcp": 4369,
      "ifaces": [
        {
          "key": "eth0",
          "value": "192.168.0.124"
        }
      ],
      "logiface": "eth0",
      "name": "worksrv1",
      "recstorepaths": [
        {
          "key": "main5",
          "value": "alias://paths/h"
        },
        {
          "key": "main4",
          "value": "alias://paths/g"
        }
      ]
    },
    {
      "descr": "admin srv 101 ipshnik. Srv2",
      "erlangtcp": 4369,
      "ifaces": [
        {
          "key": "eth0",
          "value": "192.168.0.123"
        }
      ],
      "logiface": "eth0",
      "name": "lwm123",
      "recstorepaths": [
        {
          "key": "main4",
          "value": "alias://paths/f"
        }
      ],
      "sitesharepath": "alias://paths/e"
    },
    {
      "descr": "admin srv 101 ipshnik. Srv22222",
      "erlangtcp": 4369,
      "ifaces": [
        {
          "key": "eth0",
          "value": "192.168.0.127"
        }
      ],
      "logiface": "eth0",
      "name": "lwm101",
      "recstorepaths": [
        {
          "key": "main4",
          "value": "alias://paths/f"
        }
      ],
      "sitesharepath": "alias://paths/e"
    }
  ],
  ...
}