3.11 Настройка конфигурационного файла MSR

Конфигурационный XML-файл после установки медиасервера находится по пути /etc/ecss/ecss-media-server/config.xml.

<?xml version="1.0" encoding="utf-8"?>
<config date="14:43:38 17.04.2019">
    <general log-level="3" log-rotate="yes" max-calls="8192" max-in-group="512" load-sensor="media" load-delta="10"
     log-name="msr.log"
     log-path="/var/log/ecss/media-server" />
    <transport bind-addr="10.22.131.92" port="5040" transport="udp+tcp" />
    <media mixer-clock-rate="8000" use-vad="no" cng-level="0" jb-size="60"
     rtcp-timeout="0" rtp-timeout="350" cn-multiplier="3" port-start="12000" port-range="1024"
     tias-in-sdp="no" thread-cnt="2" silence-threshold="-30" dtmf-flash-disable="no"
     video-dscp="0" other-dscp="0"
     dummy-video-src="/usr/share/ecss-media-server/video/dummy_video.yuv" video-enc-width="1280" video-enc-height="720" />
    <codec pcma="1" pcmu="2" ilbc="0" gsm="0" g722="3" g729="0" speex="0" l16="0" h264="1" h263-1998="2" t38="1" tel-event-pt="0" />
    <accounts>
        <dynamic msr_name="msr_1" realm="sip:10.22.131.92:5000" dtmf_mode="rfc+inband+info" auth_name="user" auth_password="password" />
    </accounts>
    <pbyte>
        <mcc bind-addr="10.22.131.92" port="5700" />
    </pbyte>
</config>

где

• general - общие настройки медиасервера:
  • log-level - уровень логов. Чем больше значение, тем больше информации в логах (по умолчанию: "3");
  • log-rotate - ротация логов (по умолчанию: "no")
  • log-path - путь до директории с логами
  • max-calls - максимальное количество одновременно обслуживаемых медиасервером вызовов (по умолчанию: "256");

  • max-in-group - максимальное количество абонентов в группе в рамках конференции (по умолчанию: "128");

    Если услуга "Конференц-связь" используется с большим количеством участников, то необходимо увеличить значение данного параметра. Максимальное значение 4000.
  • load-sensor - включение механизма информирования ядра о загрузке msr(по умолчанию - media;
  • load-delta - определяет относительное изменение(сравнение текущей загрузки с предыдущей) загрузки msr(от 1 до 100), при которой формируется нотификации о текущей загрузки msr(не чаще 1 раза в секунду). Коэффициент загрузки отправляется в каждое ядро посредством SIP PUBLISH с Event eltex-load-sensor, в Body находится текущая загрузка msr (по умолчанию -10)

• transport - настройки транспорта:
  • bind-addr - IP-адрес, который будет использовать медиасервер для SIP-сигнализации (по умолчанию: "127.0.0.1"). Данный параметр необходимо настроить в соответствии с сетевыми настройками хоста;
  • port - номер порта для SIP (по умолчанию: "5040"). Если на хосте, где установлен медиасервер, порт 5040 уже занят, то значение данного параметра необходимо изменить;
  • transport - тип транспорта (по умолчанию: "udp+tcp"), принимает значения: "udp", "tcp", "udp+tcp". Данный параметр не требует изменений.

• media - параметры медиа:
  • mixer-clock-rate - частота используемая внутренним микшером медиасервера (по умолчанию: "8000"). Данный параметр настраивается в соответствии с аппаратными возможностями сети. (К примеру, для поддержки работы G.722 в режиме HD, параметр устанавливается в соответствии с частотой дискретизации данного кодека "16000").
  • use-vad - включить Voice Activity Detection (по умолчанию: "no"). Данный параметр не требует изменений;
  • cng-level - 0 - выкл, любое другое значение будет подставляться в поле level пакета. По умолчанию указывается "0" в целях сохранения обратной совместимости.
  • jb-size - максимальная задержка в мс, которая будет вноситься для поддержания непрерывного потока media;
  • rtcp-timeout - если в течение этого периода времени не приходит RTCP медиасерверу, то можно считать, что клиент неактивен (по умолчанию: "0" - не используется). При использовании функции контроля, контроль включается только после приема от встречной стороны одного RTCP пакета;
  • rtp-timeout - тайм-аут RTP-трафика, аналогично предыдущему параметру (по умолчанию: "0" - не используется);
  • cn-multiplier - множитель к rtp-timeout, если последний полученный RTP-пакет был с comfort noise (по умолчанию: "2");
  • port-start - начало диапазона портов, которые будут использоваться для RTP-потоков (по умолчанию: "12000");
  • port-range - размер диапазона (по умолчанию: "1024");
  • tias-in-sdp - включение/отключение передачи атрибута b=TIAS/AS в offer SDP (по умолчанию: "no");
  • thread-cnt - количество рабочих потоков для обработки медиаданных (по умолчанию: "2");
  • silence-threshold - пороговый уровень тишины для Voicemail в дБ (по умолчанию: "-30" дБ);
  • dummy-video-src - путь к файлу видеозаставки (формат YUV420), которая отображается при отсутствии видеопотока (по умолчанию: "/usr/share/ecss-media-server/video/dummy_video.yuv");
  • video-enc-width и video-enc-height - все кадры поступающие на енкодер с шириной или высотой больше данных будут конвертированы в данный размер. По умолчанию устанавливаются в 1280х720.
  • video-dscp - значение DCSP для видео(по умолчанию - 0);
  • other-dscp - значение DCSP для остальных типов медии(по умолчанию - 0);
• codec - приоритеты кодеков (1 - максимальный, 255 - минимальный, 0 - кодек отключен). Поддерживаемые кодеки:
  1. pcma
  2. pcmu
  3. ilbc
  4. gsm 
  5. g722
  6. g729
  7. speex
  8. l16
  9. h264
  10. h263-1998
  11. t38

• accounts - все аккаунты для регистрации медиасервера. Может содержать до 32-х элементов acc;
• dynamic - отдельный аккаунт с параметрами:
  • msr_name - имя MSR, отображаемое на ECSS;
  • realm - сервер регистрации в формате sip:domain. Указывается адрес SIP-сервера для регистрации медиасервера;
  • dtmf_mode - режим детектирования DTMF ("rfc", "inband", "info"). Данный параметр необходимо настроить в соответствии с настройками отправки DTMF на абонентском устройстве.
  • auth_name - имя пользователя, используемое для авторизации;
  • auth_password - пароль для авторизации.

• pbyte - настройка соединений pbyte;
  • mcc - настройка управляющего соединения media control channel;
  • bind-addr - IP-адрес, на котором будет ожидаться подключение;
  • port - порт для входящих подключений, (по умолчанию: 5700).