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

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

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

просмотр истории страницы
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.
По всем Dirty записям производится отправка команд на оборудование, после успешной отправки флаг Dirty сбрасывается, при неудачной отправка повторится в будущем.
h1. Какие схемы интеграции есть в биллинге

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

h2. Пользовательские

В поставку входят полностью готовые *Схемы управления* и файлы для управления Redback, Cisco, Mikrotik и ряда других производителей.
Если подходящей Вам схемы нет, можете создать [пользовательскую схему|CarbonBilling:Пользовательская схема].
Мы подготовили несколько примеров:
{pagetree:root=Пользовательская схема}

*Схема управления* \- это один из вариантов автоматической типовой интеграции, включает в себя все настройки биллинга, radius, dhcp, скрипты, а также {color:#ff0000}new2015\*{color} возможность автоматического создания и заливки конфигурации на оборудование.
h1. Как устроены OSS схемы

h2. Актуальный тип: OSS схема

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

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

h2. Устаревший тип: базовый скрипт управления

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

1. Оборудование->DHCP->БД Provisioning
2. Оборудование->Radius->БД Provisioning
3. Биллинг->БД Provisioning->OSS Скрипты конкретного оборудования->CoA/Telnet/SSH/SNMP \->Оборудование
h1. Управление сессиями абонентов на оборудовании

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



*Примечание:* модуль Provisioning сейчас не полностью отвязан от биллинга и пока не может работать на отдельном сервере, работы по автономному Provisioning планируется закончить к 01.11.2015. Выделение БД Provisioning позволит полностью останавливать биллинг для любых профилактических и плановых работ, при этом абоненты не пострадают, а также это позволит упростить и улучшить схему работы с филиалами.

----
h3. Состояния пользователей(Subscriber) и услуг

В рамках Provisioning и OSS под пользователем понимается пользователь на оборудовании, синонимы subscriber или session, его параметры заданы в  учетной записи у абонента.


Схема управления оборудованием основывается на Услугах, а не на балансе абонента, как в простейших биллингах.


Текущее Состояние абонента никак не влияет на оказание Услуги, влияет только текущее Состояние Услуги.

Это значит если у абонента, нет денег, но услуга была ранее оплачена, то она будет оказана до исчерпания Услуги.(у каждой услуги абонента есть свой баланс свои блокировки и тд)

Для удобства управления и по историческим причинам, таблица услуг трафика выделена отдельно от остальных услуг(возможно в будущем это изменится).

Таблица состояний и команд [http://docs.carbonsoft.ru/pages/viewpage.action?pageId=51708843]





----
h3. Этапы интеграции

Этап 1. Настройка мастером *Стандартной схемы* для этого типа оборудования(Cisco, Redback и т.д.).


Этап 2. Заливка полученного Стандартного конфига на оборудование.

Этап 3. Тестирование по инструкции, акт тестовых испытаний Стандартной схемы.


Этап 4. Тюнинг Стандартной схемы под требования провайдера или разработка custom схемы.

Этап 5. Акт тестовых испытаний интеграции.

Этап 6. Ввод в тестовую эксплуатацию на 32 дня, проверка закрытия месяца.


Этап 7. Акт тестовых испытаний интеграции.

Этап 8. Ввод в промышленную эксплуатацию.
Расположение скрипта управления в системе зависит от выбранного типа 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}