<?xml version="1.0" encoding="utf-8"?>
<config date="09:20:39 13.10.2019">
  <general log-level="3" log-rotate="yes" max-calls="8192" max-in-group="512" load-sensor="media" load-delta="10" spool-dir-size="100M" log-name="msr.log" log-path="/var/log/ecss/media-server" use-srtp="disabled" suspicious-mode="no"/>
  <transport bind-addr="127.0.0.1" port="5040" transport="udp+tcp"/>
  <media mixer-clock-rate="48000" use-vad="no" cng-level="0" jb-size="60" echo-cancel-algo="webrtc" echo-cancel-aggr="high" echo-cancel-tail="200" rtcp-timeout="0" rtp-timeout="350" udp-src-check="no" 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" g7221="0" opus="0" h264="1" h263-1998="2" t38="1" tel-event-pt="0"/>
  <accounts>
    <dynamic msr_name="MSR.name" realm="sip:127.0.0.1:5000" dtmf_mode="rfc+inband+info" auth_name="user" auth_password="password"/>
  </accounts>
  <pbyte>
    <mcc bind-addr="127.0.0.1" port="5700"/>
  </pbyte>
  <conf_dir path="/etc/ecss/ecss-media-server/conf.d"/>
</config

где

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

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

    

    Если услуга "Конференц-связь" используется с большим количеством участников, то необходимо увеличить значение данного параметра. Максимальное значение 4000.
  • load-delta - определяет относительное изменение(сравнение текущей загрузки с предыдущей) загрузки msr(от 1 до 100), при которой формируется нотификации о текущей загрузки msr(не чаще 1 раза в секунду). Коэффициент загрузки отправляется в каждое ядро посредством SIP PUBLISH с Event eltex-load-sensor, в Body находится текущая загрузка msr (по умолчанию -10);
  • load-sensor - включение механизма информирования ядра о загрузке msr(по умолчанию - media;
  • use-srtp - использование srtp (значения"disabled" rtp не используется,  "optional" - будет возможность звонить как с rtp, так и с srtp,  "mandatory" будет использоваться только srtp. (rtp звонки приниматься не будут)
• transport - настройки транспорта:
• bind-addr - IP-адрес, который будет использовать медиасервер для SIP-сигнализации (по умолчанию: "127.0.0.1"). Данный параметр необходимо настроить в соответствии с сетевыми настройками хоста;
• port - номер порта для SIP (по умолчанию: "5040"). Если на хосте, где установлен медиасервер, порт 5040 уже занят, то значение данного параметра необходимо изменить;
• transport - тип транспорта (по умолчанию: "udp+tcp"), принимает значения: "udp", "tcp", "udp+tcp". Данный параметр не требует изменений.
• media - параметры медиа:

  • mixer-clock-rate - частота используемая внутренним микшером медиасервера (по умолчанию: "48000"). Данный параметр настраивается в соответствии с аппаратными возможностями сети. (К примеру, для поддержки работы G.722 в режиме HD, параметр устанавливается в соответствии с частотой дискретизации данного кодека "16000"). Диапазон значений-8000-48000. Если будет задано значение > 48000, то будет устновлено в 48000. (в syslog будет предупреждение об этом).

    

    • При установке ECSS-10 версии 3.14, данный параметр имеет дефолтное значение 48000. Это сделано для поддержки HD кодеков, а также уверенного распознавания речи в таких сервисах как ivr, транскрибирование, ASR.
    • Выставление mixer-clock-rate = 48000 приводит к увеличению нагрузки на CPU, увеличение сетевого трафика и объема записанных файлов разговоров.
    • При штатном обновлении этот параметр сам собой не изменится.
  • use-vad - включить Voice Activity Detection (по умолчанию: "no"). Данный параметр не требует изменений;
  • cng-level - 0 - выкл, любое другое значение будет подставляться в поле level пакета. По умолчанию указывается "0" в целях сохранения обратной совместимости.
  • jb-size - максимальная задержка в мс, которая будет вноситься для поддержания непрерывного потока media;
  • echo-cancel-algo - Алгоритм используемый для эхокомпенсации. Реализовано три алгоритма: simple - простой алгоритм эхозаграждения, наименее предпочтительный;  speex - алгоритм, реализованный в кодеке speex, немного искажает звук; webrtc - алгоритм, реализованный в webrtc, используется по-умолчанию.
  • echo-cancel-aggr - Параметр определяет агрессивность эхокомпенсации. (low - низкая; mid - средняя; high - максимальная (по-умолчанию));
  • echo-cancel-tail - Длина буфера эхокомпенсатора в миллисекундах;
  • rtcp-timeout - если в течение этого периода времени не приходит RTCP медиасерверу, то можно считать, что клиент неактивен (по умолчанию: "0" - не используется). При использовании функции контроля, контроль включается только после приема от встречной стороны одного RTCP пакета;
  • rtcp-stat-dump - вывод rtcp статистики в логи (по умолчанию: "yes" - используется). Работает только при уровне логов выше 2;
  • 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 - количество рабочих потоков для обработки медиаданных (поdtmf-to-total-energy
    умолчанию: "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);
  • dtmf-hits-to-begin - (один hit равен 12.75 сек.) - количество детекций подряд одного и того же сигнала, который распознается в DTMF (по умолчанию - 2; возможные значения: 1..10);
  • dtmf-misses-to-end - (один miss равен 12.75 сек.) - количество детекций подряд НЕ DTMF сигнала следом за указанным количеством hit-ов которые распознали DTMF сигнал (по умолчанию - 2; возможные значения: 1..10)
• codec - приоритеты кодеков (1 - максимальный, 255 - минимальный, 0 - кодек отключен). Поддерживаемые кодеки:
  
  • pcma
  • pcmu
  • ilbc
  • gsm 
  • g722
  • g722.1
  • g729
  • speex
  • l16
  • h264
  • h263-1998
  • t38
  • tel-event-pt
• accounts - все аккаунты для регистрации медиасервера. Может содержать до 32-х элементов acc;
• dynamic - отдельный аккаунт с параметрами:
  • msr_name - имя MSR, отображаемое на ECSS;
  • realm - сервер регистрации в формате sip:domain. Указывается адрес SIP-сервера для регистрации медиасервера;
  • dtmf_mode - режим детектирования DTMF ("rfc", "inband", "info"). Данный параметр необходимо настроить в соответствии с настройками отправки DTMF на абонентском устройстве.
  • auth_name - имя пользователя, используемое для авторизации;
  • auth_password - пароль для авторизации.
• rtp -  режим подмены ip в sdp.

  • auto  - автоматический режим . Определяет общий ip для всех sdp, например : <auto addr-v4="192.168.1.2" addr-v6="::1"/>

  • manual - ручной режим. Задаются пары интерфейс-ip, например: <manual name="bond1.2" addr-v4="192.168.1.2" addr-v6="::1">
• pbyte - настройка соединений pbyte;
  • mcc - настройка управляющего соединения media control channel;
  • bind-addr - IP-адрес, на котором будет ожидаться подключение;
  • port - порт для входящих подключений, (по умолчанию: 5700).
• conf_dir path - путь до папки в которой будут содеражться конфигурации MSR. Данные конфигурации будут переопределять дефолтную конфигурацию config.xml