Заведение оборудования

Время выполнения инструкции: до 5 минут

Для настройки IPTV нужно:

Шаг 1. Создать сервер IPTV  в разделе оборудования, вкладка IPTV

IP-адрес - любой, например 1.1.1.1 IP важен только для [Ministra]

Примечание: Стандартная схема OSS зависит от IPTV портала. В данном случае схема выбрана для TITV!

Шаг 2. На вкладке Дополнительно ставим опцию "Передавать пароль в скрипт событий"

Шаг 3. Переходим в управление  и нажимаем Сохранить где указан каталог управления. Затем В "шаг 1 Инициализация" выполняем все кнопки последовательно

Шаг 4. Переходим на вкладку Настройка и обновляем список файлов

Шаг 5. В main.ini прописываем данные для вашего IPTV

TVIP TMS и TVIPmedia

При создании нового NAS в «Стандартной схеме OSS» нужно выбрать «TVIPmedia». Заполните параметры сервиса в файле main.ini следующим образом:

• Обязательные опции
  • url - адрес доступа в личный кабинет администратора. Например, для TVIP Media это скорей всего будет https://my.tvip.media/, для прочих сервисов на платформе TVIP TMS ссылка будет другой.
  • username - логин от администраторского личного кабинета
  • password - пароль от администраторского личного кабинета
  • provider - id провайдера (необходимо уточнить у TVIPmedia)

• Необязательные опции
  • delete_not_existing - включение/отключение проверки пользователей на портале TVIPmedia. Если поставить 1, то пользователи, которые есть на портале, но которых нет в биллинге, будут удаляться. По умолчанию — 0.

После этого обязательно нужно нажать кнопку "Сохранить" сразу под полем, в которое вносились изменения.

Ограничение запросов к API поставщика услуг

В файле main.ini необходимо добавить параметр sync_minutes (по умолчанию значение параметра равно 60, единица измерения - 1 минута). Данный параметр задает период ожидания между синхронизациями IPTV OSS, другими словами, регулирует частоту отправки API-запросов на портал поставщика. У некоторых поставщиков услуг IPTV есть ограничение на кол-во API-запросов к их серверу. Чтобы не выходить за рамки данных ограничений, рекомендуется увеличить параметр sync_minutes таким образом, чтобы период ожидания увеличился с 60 минут до 24 часов или 7 суток. После этого необходимо перезапустить обработчик синхронизаций:

chroot /app/asr_billing
service oss restart

Создание услуг IPTV

Время выполнения инструкции: от 5 минут, 1-2 минуты на каждую услугу, 1-2 минуты на создание шаблона сообщения

Для подключения сервиса IPTV абоненту, рекомендуется подключить как минимум две услуги:

• Первая: создание учетной записи

  В настройках услуги создания учётной записи для сервиса LifeStream нужно указать буквенный префикс логина для исключения возможного совпадения логинов в системе LifeStream.

• Вторая: подключение пакетов телевидения

Услуг, подключающих пакеты ТВ может быть несколько.

Услуга создания учётной записи должна быть в единственном экземпляре для каждого сервиса IPTV: одна для 24часаТВ, одна для Смотрёшки и тд Если не делать отдельную услугу, создающую учетную запись IPTV, она все равно будет создана синхронизатором в течение 10 минут после подключения услуги с пакетом ТВ

Добавление услуги, подключающей пакеты телевидения

Создайте услугу с типом "IP телевидение" по статье документации "Услуги". Настройте в ней следующие опции:

1. Вкладка "Основные". Опции:
   • Вид сервиса: IPTV;
   • Название: любое, соответствующее пакету TV выбранного оператора
     
     
     
     
2. Вкладка "Дополнительно". Опции:
   • Строка с дополнительными параметрами по активации/деактивации: ID пакета телевидения, список пакетов уточните у оператора IPTV
     
     
     
     
3. Вкладка "Личный кабинет". Опции:
   • Разрешить заказ через веб-интерфейс и Разрешить отключать через ЛК: параметры, позволяющие абоненту самостоятельно управлять подключением пакетов телевидения
     
     
     
     

Добавление услуги, создающей учетную запись на портале телевидения

Создайте услугу с типом "IP телевидение" по статье документации "Услуги". Настройте в ней следующие опции:

1. Вкладка "Основные". Опции:
   • Вид сервиса: IPTV;
   • Название: любое,  например "Учетная запись IPTV"
   • Бесплатный пакет IPTV: необходимая опция для работы услуги создания учетной записи:
     • в схеме LifeStream услуги с этой опцией не синхронизируются как пакеты IPTV
     • в схеме MEGOGO услуги с опцией не отображаются как возможные для заказа на промо-странице
       
       
       
       
2. Вкладка "Дополнительно".
   • Строка с дополнительными параметрами по активации/деактивации: оставьте пустыми;
   • NAS: выберите NAS соответствующего IPTV сервиса
   • Создавать учетную запись при подключении: включите;
   • Количество учетных записей: в зависимости от специфики работы Вашего IPTV, минимум одна;
   • Использовать цифровой пароль при создании учетной записи: включении этой опции не обязательно, но может быть полезно для сервисов настраиваемых на ТВ-приставках
     
     
     
3. Вкладка "Личный кабинет". Опции:
   • Разрешить заказ через веб-интерфейс: включите, чтобы абонент сам мог создать себе учетную запись;
   • Разрешить отключать через ЛК: отключите, чтобы  абонент случайно не создал себе множество учетных записей
     
     
     
     

Отправка сообщения абоненту о создании учетной записи

Создайте шаблон с типом сообщения "Создание учетной записи из услуги" по статье "Система отправки сообщений" как показано на изображении ниже:

Для передачи логина и пароля новой учетной записи, используйте переменные user_login и user_psw. Например: Реквизиты учетной записи: логин %(user_login)s, пароль %(user_psw)s. Используйте их для идентификации в портале IPTV

В настройках шаблона сообщений должна быть отключена опция "Использовать шаблонизатор django"

Если несколько сервисов телевидения, как правильно настроить?

Если в биллинг интегрировано более 1 сервиса IPTV одновременно (например, Lifestream + IPTVPortal) - смс будет отправляться по любому событию создания учетной записи.
В этом случае абонент может получить логин и пароль от второго сервиса.

Как решить

1. Добавьте в личном кабинете страницу с данными доступа к IPTV
2. В СМС отправляйте текст общего характера, например: "Реквизиты учетной записи IPTV находятся в личном кабинете".

Отладка

Лог интеграции с сервисом:

tail /app/asr_billing/var/log/nas_event_daemon/tvip_tms.log

Найти возникшие ошибки можно командой grep, например:

grep -i err /app/asr_billing/var/log/nas_event_daemon/tvip_tms.log

Сервер TVIP TMS вернул 401 статус (Unauthorized Error). Необходимо проверить логин и пароль в main.ini

Это ошибка basic авторизации на API. Она может возникнуть в двух случаях:

• Логин или пароль в main.ini указаны неверно
• Доступ отключен поставщиком

Неверный логин или пароль

1. Исправьте данные авторизации в main.ini
2. Перезапустите синхронизатор OSS:

   chroot /app/asr_billing service oss restart

Доступ к платформе отключен

Если Вы уверены, что логин и пароль правильные, то возможно отключена платформа TMS. Обратитесь в поддержку TVIP.