|
Ключ
Эта строка удалена.
Это слово было удалено. Это слово было добавлено.
Эта строка добавлена.
|
Изменения (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 схемы. |
| Расположение скрипта управления в системе зависит от выбранного типа 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} |