Интеграция с Infomir Ministra (ex Stalker)

Ключ
Эта строка удалена.
Это слово было удалено. Это слово было добавлено.
Эта строка добавлена.

Изменения (42)

просмотр истории страницы
{toc}

{include:CarbonBilling:Настройка IPTV. Общее}

h1. Настройка Stalker
{include:CarbonBilling:Добавление NAS IPTV}

h2. Настройка доступа конфигурации Stalker в custom.ini
h1. Настройка Ministra

{tip}*Время выполнения инструкции*: 60-120 минут, зависит от количества услуг и тарифных планов{tip}

{info}Раньше платформа называлась Stalker Middleware и в интерфейсе Carbon Billing осталось прежнее название, тем не менее интеграция работает и с Ministra{info}

h2. Настройка доступа конфигурации Ministra в custom.ini

Для интеграции Stalker Ministra с Carbon Billing 5, в настройках конфигурационного файла IPTV custom.ini требуется настроить API и включить работу с тарифами.
Путь до API обязательно должен быть */stalker_portal/api/*
{code}[system]
stalker_api_url = http://localhost/stalker_portal/api/{code}
...
enable_tariff_plans = true{code}

Подробней про настройки Stalker Ministra Вы можете почитать в его документации: "[Конфигурационный файл|https://wiki.infomir.eu/rus/ministra-tv-platform/rukovodstvo-po-installyatsii-ministra/konfiguratsionnyj-fajl]"

h2. Stalker Ministra с IPTVPortal

Пример содержимого main.ini для Stalker: Ministra:

{code}tmplt=tmplt/main.cfg.tmplt
...
*iptvportal_username* \- имя пользователя на портале
*iptvportal_password* \- пароль пользователя на портале
*stalker_username* \- имя пользователя при использовании оборудования Stalker Ministra
*stalker_password* \- пароль пользователя при использовании оборудования Stalker Ministra
*delete_not_existing* \- флаг, отвечающий за удаление абонента на оборудовании, если абонента нет в биллинге (0-не удалять, 1-удалять).

...
{info}

h2. Stalker Ministra без IPTVPortal

Пример содержимого main.ini для Stalker: Ministra:
{code}tmplt=tmplt/main.cfg.tmplt
iptvportal_host=
...
*iptvportal_username* \- оставьте пустым
*iptvportal_password* \- оставьте пустым
*stalker_username* \- имя пользователя на API Stalker Ministra
*stalker_password* \- пароль пользователя API Stalker Ministra
*delete_not_existing* \- флаг, отвечающий за удаление абонента в портале, если абонента нет в биллинге (0-не удалять, 1-удалять)
*sync_stalker_users_by_mac* \- синхронизировать учетные записи iptv по mac приставки (0 - по ip, 1 - по mac)
...
После этого обязательно нужно нажать кнопку "Сохранить" сразу под полем, в которое вносились изменения.

{info}Синхронизация абонентов между *Carbon Billing 5* и *Stalker* *Ministra* производится по IP учетной записи интернет. При необходимости (например, если ip абонента динамический, либо учетная запись интернет отсутствует или их несколько) в main.ini можно установить опцию sync_stalker_users_by_mac=1, тогда синхронизация приставок будет проходить по mac из учетной записи iptv{info}
{info}
При добавлении нового пользователя не происходит автоматического добавления его на оборудование. Это происходит в момент синхронизации биллинга с оборудованием, которая проводится раз в час при наличии галочки "Синхронизировать пользователей на этом NAS" в настройках NAS
{info}

h2. Настройка тарифных планов, пакетов услуг и пользователей на Stalker
h2. Ограничение запросов к API поставщика услуг

!stalker_create_tv_channels.png|border=1,width=537,height=290!
В файле *main.ini* необходимо добавить параметр *sync_minutes* (по умолчанию значение параметра равно 60, единица измерения - 1 минута). Данный параметр задает период ожидания между синхронизациями IPTV OSS, другими словами, регулирует частоту отправки API-запросов на портал поставщика. У некоторых поставщиков услуг IPTV есть ограничение на кол-во API-запросов к их серверу. Чтобы не выходить за рамки данных ограничений, рекомендуется увеличить параметр sync_minutes таким образом, чтобы период ожидания увеличился с 60 минут до 24 часов или 7 суток. После этого необходимо перезапустить обработчик синхронизаций:
{code}
chroot /app/asr_billing
service oss restart
{code}

h2. Настройка тарифных планов, пакетов услуг и пользователей на Ministra
# Добавьте ТВ-каналы \\ \\
!stalker_create_tv_channels.png|border=1,width=537,height=290! \\ \\
# Зайдите в меню "Пакеты услуг" \\ \\
!stalker_create_subscriptions.png|border=1,width=539,height=158! \\ \\

# Создайте пакеты услуг, значение поля "Внешний ID" используйте в дальнейшем при создании услуг в биллинге - именно ими реализовано управление через биллинг. \\ \\
!stalker_create_subscriptions_form.png|border=1,width=755,height=408! \\ \\

# Зайдите в меню "Тарифные планы" \\ \\
!stalker_create_tariff.png|border=1,width=639,height=181! \\ \\

# Создайте один тариф, установите опцию "По умолчанию", добавьте пакеты услуг. Все не опциональные пакеты будут подключаться абоненту автоматический, управление ими из биллинга будет невозможно. \\ \\
!stalker_create_tariff_form.png|border=1,width=809,height=322! \\ \\

# Зайдите в меню "Пользователи" и нажмите "Добавить пользователя" \\ \\
!stalker_add_user.png|border=1,width=909,height=262! \\ \\

# В форме добавления пользователя достаточно указать MAC-адреса приставки - по нему будет происходить синхронизация. \\ \\
!stalker_add_user_form.png|border=1,width=630,height=399! \\ \\

# Далее добавьте абоненту в биллинге услугу создания учетной записи и услуги пакетов ТВ, это описано в разделе "[Настройка услуг IPTV|#configure_billing_services]"
После настройки пользователя в биллиге, в течение 10 минут в портале Сталкер ему добавятся пакеты ТВ, обновятся логин, пароль, а так же имя пользователя. \\ \\
!stalker_billing_user.png|border=1! \\ \\
!stalker_users_after_sync.png|border=1,width=917,height=184!

{anchor:configure_billing_services}
{include:CarbonBilling:Настройка услуг IPTV}