Раздел 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"
    }
  ],
  ...
}