Интеграция оборудования интернет

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

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

просмотр истории страницы
h3. Введение
{toc}

*Биллинг* рассчитывает состояние абонентов и его услуг в реальном времени.
h1. Как интегрировать NAS/BRAS сервер

Состояния абонентов и услуг синхронизируются из биллинга в БД модуля  Provisioning, который управляет оборудованием.
Подсистема OSS позволяет авторизовать абонента и управлять состоянием сессии: изменять скорость доступа, добавлять или снимать блокировки и тд.

*БД Provisioning* \- это эталонное состояние в которое нужно привести оборудование.
# Определись с [типом авторизации|CarbonBilling:Типы авторизации] абонента и выберите оборудование.
# Выберите подходящую схему интеграции среди [стандартных|CarbonBilling:Стандартные схемы] - это существенно ускорит процесс, биллинг сам настроить NAS по шаблону.
{info}Стандартные схемы можно кастомизировать ([пример|CarbonBilling:Пример. Burst для Mikrotik-Simple и Mikrotik-Simple-Hotspot]), это всё равно будет быстрее чем делать полностью новую схему{info}
# Интегрируйте [по документации|CarbonBilling:Этап 1. Мастер Стандартной схемы NAS]

Если Вы не нашли подходящую стандартную схему, сделайте [пользовательскую|CarbonBilling:Пользовательская схема].

Если состояние абонента или услуги изменилось, то такая запись в БД Provisioning помечается как грязная Dirty и подлежит синхронизации с оборудованием.
h1. Какие схемы интеграции есть в биллинге

*Демоны* модуля Provisioning производят синхронизацию с оборудованием, через скрипты расположенные в  /var/lib/oss/core/имя_оборудования/
h2. Стандартные
В биллинге уже есть ряд схем интеграции с оборудованием известных вендоров:
{pagetree:root=Стандартные схемы}

В поставку входят полностью готовые *Схемы управления* и файлы для управления Redback, Cisco, Mikrotik и ряда других производителей.
h2. Пользовательские

*Схема управления* \- это один из вариантов типовой интеграции, включает в себя все настройки биллинга, radius, dhcp, а также new2015\* автоматическое создание и заливка конфигурации на оборудование.
Если подходящей Вам схемы нет, можете создать [пользовательскую схему|CarbonBilling:Пользовательская схема].
Мы подготовили несколько примеров:
{pagetree:root=Пользовательская схема}

h1. Как устроены OSS схемы

Провайдер может неограниченно подстраивать скритпы управления под свои нужды, либо создать пользовательскую схему под свои требования.
h2. Актуальный тип: OSS схема

Содержит шаблон настройки NAS и скрипты управления. После заполнения карточки NAS, из шаблонов формируются готовые конфигурационные файлы по которым настраивается оборудование для взаимодействия с биллингом.
# Вкладка "Описание"
#- *Cтандартная OSS схема*: одна из стандартных, либо "Пользовательская"
#- *OSS Каталог управления*: при создании NAS мастером, будет создан автоматический, при создании NAS через кнопку "Добавить" - укажите нужную папку, предварительно создав её на сервере.
# Вкладка "Дополнительно"
#- *Имя скрипта с событиями:* оставьте пустым
#- *Тип*: "OSS схема"

Модуль Provisioning
Оборудование
Интеграция с использованием OSS схемы поэтапно описана в данном разделе:
* [CarbonBilling:Этап 1. Мастер Стандартной схемы NAS]
* [CarbonBilling:Этап 2. Генерация конфигурации и upload на оборудование]
* [CarbonBilling:Этап 3. Тестирование стандартной схемы]
* [CarbonBilling:Этап 4, 5. Тюнинг Стандартной схемы под требования провайдера или разработка custom схемы]
* [CarbonBilling:Этап 6,7,8,9]

1. Описание системы состояний абонентов и услуг
2. Описания скриптов
3. Описание OSS системы
4. Описание мастера создания типовых конфигураций
5. Как тюнить команды, и как добавлять новые.
6. Описание интеграции с не типовым оборудованием.
h2. Устаревший тип: базовый скрипт управления

Представляет из себя просто скрипт управления - набор команд отправляемый на оборудования для изменения состояний сессий абонентов. Настройка оборудования биллингом не выполняется, только управление сессиями.
При выборе такой схемы интеграции, в настройках NAS укажите следующее:
# Вкладка "Описание"
#- *Cтандартная OSS схема*: "----"
# Вкладка "Дополнительно"
#- *Имя скрипта с событиями:* имя нужного файла из папки */app/asr_billing/var/lib/event/*
#- *Тип*: "Другой"

h1. Управление сессиями абонентов на оборудовании

Управление доступом абонентов к сервису осуществляется через отправку [команд|CarbonBilling:Состояния пользователей, услуг и команды управления интернет] по одному или нескольким из перечисленных протоколов: *CoA*, *ssh*, *http*, *telnet*, *snmp*.
Сами команды описываются в функциях shell-скрипта, вызываемых при наступлении тех или иных событий с абонентом в биллинге, например: переход в отрицательный или положительный баланс, изменение скорости по тарифу, добровольная блокировка и тд.
Так, при авторизации по протоколу RADIUS могут вызываться некоторые дополнительные команды, соответствующие событиям протокола: *Accounting Stop*, *Accounting Start*.

Расположение скрипта управления в системе зависит от выбранного типа NAS:
* OSS схема: */var/oss/core/*{color:#ff0000}{*}NAS{*}{color}*/*{color:#0000ff}{*}bin{*}{color}*/*{color:#ff0000}{*}session{*}{color} или */var/oss/core/*{color:#ff0000}{*}NAS{*}{color}*/*{color:#ff6600}{*}u{*}{color}{color:#0000ff}{*}bin{*}{color}*/*{color:#ff0000}{*}session{*}{color}, если в конкретном NAS Вы модифицировали схему
* Базовый скрипт событий: */var/lib/event/*{color:#ff0000}{*}script.sh{*}{color}