{toc}
{include:CarbonBilling:Добавление NAS IPTV}
h1. Настройка Ministra
{tip}*Время выполнения инструкции*: 60-120 минут, зависит от количества услуг и тарифных планов{tip}
{info}Раньше платформа называлась Stalker Middleware и в интерфейсе Carbon Billing осталось прежнее название, тем не менее интеграция работает и с Ministra{info}
h2. Настройка доступа конфигурации Ministra в custom.ini
Для интеграции Ministra с Carbon Billing 5, в настройках конфигурационного файла IPTV custom.ini требуется настроить API и включить работу с тарифами.
Путь до API обязательно должен быть */stalker_portal/api/*
{code}[system]
stalker_api_url = http://localhost/stalker_portal/api/{code}
Должны быть указаны логи и пароль:
{code}[server_api]
enable_api = true
api_auth_login = stalkerapiuser
api_auth_password = stalkerapipassword
{code}
Интеграция со Сталкером возможна только при включении тарифов на стороне Сталкера:
{code}[billing]
enable_subscription = false
enable_tariff_plans = true{code}
Подробней про настройки Ministra Вы можете почитать в его документации: "[Конфигурационный файл|https://wiki.infomir.eu/rus/ministra-tv-platform/rukovodstvo-po-installyatsii-ministra/konfiguratsionnyj-fajl]"
h2. Ministra с IPTVPortal
Пример содержимого main.ini для Ministra:
{code}tmplt=tmplt/main.cfg.tmplt
iptvportal_host=provider.iptvportal.ru
iptvportal_username=iptvportaladmin
iptvportal_password=adminpassword111
stalker_username=stalkeradmin
stalker_password=adminpassword2000
delete_not_existing=1
enabled="1"{code}
*iptvportal_host* \- Доменное имя сервиса, который предоставляет услуги. Например admin.provider.iptvportal.ru
*iptvportal_username* \- имя пользователя на портале
*iptvportal_password* \- пароль пользователя на портале
*stalker_username* \- имя пользователя при использовании оборудования Ministra
*stalker_password* \- пароль пользователя при использовании оборудования Ministra
*delete_not_existing* \- флаг, отвечающий за удаление абонента на оборудовании, если абонента нет в биллинге (0-не удалять, 1-удалять).
После этого обязательно нужно нажать кнопку "*Сохранить*" сразу под полем, в которое вносились изменения.
{info}
При добавлении нового пользователя не происходит автоматического добавления его на оборудование. Это происходит в момент синхронизации биллинга с оборудованием, которая проводится раз в час при наличии галочки "Синхронизировать пользователей на этом NAS" в настройках NAS
{info}
h2. Ministra без IPTVPortal
Пример содержимого main.ini для Ministra:
{code}tmplt=tmplt/main.cfg.tmplt
iptvportal_host=
iptvportal_username=
iptvportal_password=
stalker_username=stalkeradmin
stalker_password=adminpassword2000
delete_not_existing=1
sync_stalker_users_by_mac=0
enabled="1"{code}
*iptvportal_host* \- оставьте пустым
*iptvportal_username* \- оставьте пустым
*iptvportal_password* \- оставьте пустым
*stalker_username* \- имя пользователя на API Ministra
*stalker_password* \- пароль пользователя API Ministra
*delete_not_existing* \- флаг, отвечающий за удаление абонента в портале, если абонента нет в биллинге (0-не удалять, 1-удалять)
*sync_stalker_users_by_mac* \- синхронизировать учетные записи iptv по mac приставки (0 - по ip, 1 - по mac)
В учетных записях IPTV необходимо заполнить поле *MAC*. В зависимости от выбранного метода синхронизации, она будет проходить либо по связке ip+mac, либо только по mac:
* Синхронизация по IP
\\
\\ !stalker_ip.png|border=0!
* Синхронизация по MAC
\\
\\ !stalker_mac.png|border=0!
После этого обязательно нужно нажать кнопку "Сохранить" сразу под полем, в которое вносились изменения.
{info}Синхронизация абонентов между *Carbon Billing 5* и *Ministra* производится по IP учетной записи интернет. При необходимости (например, если ip абонента динамический, либо учетная запись интернет отсутствует или их несколько) в main.ini можно установить опцию sync_stalker_users_by_mac=1, тогда синхронизация приставок будет проходить по mac из учетной записи iptv{info}
{info}
При добавлении нового пользователя не происходит автоматического добавления его на оборудование. Это происходит в момент синхронизации биллинга с оборудованием, которая проводится раз в час при наличии галочки "Синхронизировать пользователей на этом NAS" в настройках NAS
{info}
h2. Ограничение запросов к API поставщика услуг
В файле *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}
{include:CarbonBilling:Добавление NAS IPTV}
h1. Настройка Ministra
{tip}*Время выполнения инструкции*: 60-120 минут, зависит от количества услуг и тарифных планов{tip}
{info}Раньше платформа называлась Stalker Middleware и в интерфейсе Carbon Billing осталось прежнее название, тем не менее интеграция работает и с Ministra{info}
h2. Настройка доступа конфигурации Ministra в custom.ini
Для интеграции Ministra с Carbon Billing 5, в настройках конфигурационного файла IPTV custom.ini требуется настроить API и включить работу с тарифами.
Путь до API обязательно должен быть */stalker_portal/api/*
{code}[system]
stalker_api_url = http://localhost/stalker_portal/api/{code}
Должны быть указаны логи и пароль:
{code}[server_api]
enable_api = true
api_auth_login = stalkerapiuser
api_auth_password = stalkerapipassword
{code}
Интеграция со Сталкером возможна только при включении тарифов на стороне Сталкера:
{code}[billing]
enable_subscription = false
enable_tariff_plans = true{code}
Подробней про настройки Ministra Вы можете почитать в его документации: "[Конфигурационный файл|https://wiki.infomir.eu/rus/ministra-tv-platform/rukovodstvo-po-installyatsii-ministra/konfiguratsionnyj-fajl]"
h2. Ministra с IPTVPortal
Пример содержимого main.ini для Ministra:
{code}tmplt=tmplt/main.cfg.tmplt
iptvportal_host=provider.iptvportal.ru
iptvportal_username=iptvportaladmin
iptvportal_password=adminpassword111
stalker_username=stalkeradmin
stalker_password=adminpassword2000
delete_not_existing=1
enabled="1"{code}
*iptvportal_host* \- Доменное имя сервиса, который предоставляет услуги. Например admin.provider.iptvportal.ru
*iptvportal_username* \- имя пользователя на портале
*iptvportal_password* \- пароль пользователя на портале
*stalker_username* \- имя пользователя при использовании оборудования Ministra
*stalker_password* \- пароль пользователя при использовании оборудования Ministra
*delete_not_existing* \- флаг, отвечающий за удаление абонента на оборудовании, если абонента нет в биллинге (0-не удалять, 1-удалять).
После этого обязательно нужно нажать кнопку "*Сохранить*" сразу под полем, в которое вносились изменения.
{info}
При добавлении нового пользователя не происходит автоматического добавления его на оборудование. Это происходит в момент синхронизации биллинга с оборудованием, которая проводится раз в час при наличии галочки "Синхронизировать пользователей на этом NAS" в настройках NAS
{info}
h2. Ministra без IPTVPortal
Пример содержимого main.ini для Ministra:
{code}tmplt=tmplt/main.cfg.tmplt
iptvportal_host=
iptvportal_username=
iptvportal_password=
stalker_username=stalkeradmin
stalker_password=adminpassword2000
delete_not_existing=1
sync_stalker_users_by_mac=0
enabled="1"{code}
*iptvportal_host* \- оставьте пустым
*iptvportal_username* \- оставьте пустым
*iptvportal_password* \- оставьте пустым
*stalker_username* \- имя пользователя на API Ministra
*stalker_password* \- пароль пользователя API Ministra
*delete_not_existing* \- флаг, отвечающий за удаление абонента в портале, если абонента нет в биллинге (0-не удалять, 1-удалять)
*sync_stalker_users_by_mac* \- синхронизировать учетные записи iptv по mac приставки (0 - по ip, 1 - по mac)
В учетных записях IPTV необходимо заполнить поле *MAC*. В зависимости от выбранного метода синхронизации, она будет проходить либо по связке ip+mac, либо только по mac:
* Синхронизация по IP
\\
\\ !stalker_ip.png|border=0!
* Синхронизация по MAC
\\
\\ !stalker_mac.png|border=0!
После этого обязательно нужно нажать кнопку "Сохранить" сразу под полем, в которое вносились изменения.
{info}Синхронизация абонентов между *Carbon Billing 5* и *Ministra* производится по IP учетной записи интернет. При необходимости (например, если ip абонента динамический, либо учетная запись интернет отсутствует или их несколько) в main.ini можно установить опцию sync_stalker_users_by_mac=1, тогда синхронизация приставок будет проходить по mac из учетной записи iptv{info}
{info}
При добавлении нового пользователя не происходит автоматического добавления его на оборудование. Это происходит в момент синхронизации биллинга с оборудованием, которая проводится раз в час при наличии галочки "Синхронизировать пользователей на этом NAS" в настройках NAS
{info}
h2. Ограничение запросов к API поставщика услуг
В файле *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}