ExpertBilling - Вклад участника [ru]

Вспомогательные скрипты и утилиты

2011-09-22T17:41:34Z

93.125.112.3: /* Страница-заглушка */

== Скрипт рассылки сообщений о состоянии баланса ==
Для рассылки информации о балансе используется скрипт /opt/ebs/data/sendmail.py.
Скрипт использует шаблон "Информационное письмо" сообщения о балансе, вид которого можно изменить в интерфейсе администратора.
По-умочланию шаблон выглядит так:
<pre>
---------------------------------------------------
Это сообщение сгенерировано биллинговой системой!
---------------------------------------------------

Здравствуйте, ${account.username}.
Уведомляем, что актуальный баланс Вашего лицевого счета составляет ${"%.2f" % account.ballance} руб. Размер кредита ${account.credit}.
Пожалуйста, пополните баланс во избежание блокировки.
---
${operator.organization}
</pre>

Параметры работы скрипта настраиваются в конфиг-файле ebs_config.ini
<pre>
[sendmail]
log_type = logging
log_file = log/sendmail_log
log_level= 0
log_ident= ebs_sendmail
subject = Provider information - тема письма
use_tls = False - использовать TLS
send_if_less = 5000 - пороговое значение баланса, ниже которого пользователь получит письмо
host = smtp.gmail.com - адрес SMTP сервера
host_user = SMTP имя пользователя
host_password = пароль SMTP пользователя
port = 25 SMTP порт сервера
email_from = info@provider.com - с этого адреса будут слаться письма
fail_silently = False - в случае ошибки продолжать отправку
</pre>

Для того, чтобы рассылать уведомления в 00:00:00 каждого дня, нужно добавить в crontab следующую строку:
<pre>
0 0 * * * /usr/bin/env python /opt/ebs/data/sendmail.py >>/opt/sendmail.log
</pre>

== Страница-заглушка ==
Вы можете настроить ExpertBilling так, что если у пользователя закончился баланс, то сервер доступа начнёт его перенаправлять на специальную страницу, где будет сказано об этом.
Возможны 2 варианта настройки:
* через IPN действия;
* через гостевой VPN пул;

У каждого из этих методов есть свои достоинства и недостатки. Использование IPN действий невозможно при динамической выдаче VPN IP адресов абонентам, а гостевой VPN пул не охватывает IPN абонентов.

=== Настройка заглушки через IPN Действия ===
Для настройки заглушки необходимо:

1 Включить и настроить IPN действия для тарифного плана. Если вы используете не IPN тарифные планы, то необходимо также разрешить PPTP/PPPOE/DHCP подключение при отрицательном балансе и блокировках.

2 Настроить apache так, чтобы при запросе любой страницы он отдавал сообщение о том, что у пользователя закончились деньги.

3 Настроить файервол на сервере доступа.

Приступим.
1.
[[Файл:ipn_actions_blank.png|center|IPN действия включены в тарифном плане]]

[[Файл:ipn_actions_subaccount.png|center|Аккаунту разрешено подключаться с нулевым балансом]]
Команды сервера доступа, к которому привязан аккаунт должны быть такими:

'''Для VPN тарифных планов:'''

Включить субаккаунт:
<pre>
/ip firewall address-list remove [find comment==blocked-$subacc_id]
</pre>
Отключить субаккаунт:
<pre>
/ip firewall address-list add list=blocked_users address=$subacc_vpn_ip_address comment=blocked-$subacc_id disabled=no
</pre>

'''Для IPN тарифных планов:'''

Включить субаккаунт:
<pre>
/ip firewall address-list remove [find comment==blocked-$subacc_id]
</pre>
Отключить субаккаунт:
<pre>
/ip firewall address-list add list=blocked_users address=$subacc_ipn_ip_address comment=blocked-$subacc_id disabled=no
</pre>

Для использования данной возможности субаккаунту _ДОЛЖЕН_ быть назначен серер доступа в его профиле.

2.
Добавьте в /etc/apache2/sites-enabled/ файл vhost_blank.conf со следующим содержимым
<pre>
Listen 81
<VirtualHost *:81>
ServerName 10.1.1.1
ServerAdmin webmaseter@isp.net

ErrorLog /var/log/apache2/nomoney_err.log
CustomLog /var/log/apache2/nomoney_access_log combined
DocumentRoot /opt/ebs/web/nomoney

<Directory "/opt/ebs/web/nomoney">
AllowOverride All
Options FollowSymlinks Includes
ErrorDocument 404 /index.html
DirectoryIndex index.html
AddDefaultCharset utf-8
allow from all
</Directory>
</Virtualhost>
</pre>
По пути /opt/ebs/web/nomoney нужно создать файл index.html со следующим содержимым:
<pre>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Сообщение от провайдера::ExpertBilling</title>
</head>
<body>
<center><img src="provider_logo.png" alt="" /></center>
<h1 align="center">Уважаемый абонент.</h1>
<h1 align="center">На вашем счету закончились деньги. <a href="https://isp.net." target="_blank">"Веб-кабинет"</a></h1>
</body>
</html>
</pre>

Перезапустите Apache для того, чтобы изменения вступили в силу.
<pre>
/etc/init.d/apache2 restart
</pre>
3. Настроим Firewall. Предположим, что 10.1.1.1 - IP адрес сервера с Apache, который мы настраивали пунктом выше.
Правила должны стоять в самом начале!!!
<pre>
/ip firewall filter add src-address-list=internet_users dst-address=10.1.1.1 action=accept
/ip firewall filter add src-address=10.1.1.1 dst-address-list=internet_users action=accept
/ip firewall filter add src-address-list=blocked_users action=drop
</pre>

Настроим редирект всех HTTP запросов
<pre>
/ip firewall nat add chain=srcnat src-address-list=blocked_users action=masquerade
/ip firewall nat add chain=dstnat protocol=tcp dst-port=80 src-address-list=blocked_users action=dst-nat to-addresses=10.1.1.1 to-ports=81
</pre>

Теперь при наступлении отрицательного баланса биллинг будет посылать на сервер доступа команду на добавление VPN IP адреса субаккаунта в адрес-лист blocked_users, все запросы на 80 порт которого будут редиректиться на сервер с apache, который по указанному адресу будет показывать нашу заглушку.

=== Настройка заглушки через гостевой VPN пул ===
Гостевой VPN служит для динамической выдачи VPN IP адресов, в случае если абонент заблокирован по причине отрицательного баланса или наличия других блокировок
Для настройки заглушки необходимо:

1 Создать VPN пул через интерфейс администратора. В пуле нужно указать сеть, которая не будет пересекаться ни с одной из ваших существующих сетей.

2 Указать созданный VPN пул в тарифном плане пользователя

2 Настроить apache так, чтобы при запросе любой страницы он отдавал сообщение о том, что у пользователя закончились деньги.

3 Настроить файервол на сервере доступа.

Приступим.
1. Создайте VPN пул через меню Справочники->IP пулы
[[Файл:vpn_pool.png|center]]

2. Укажите выбранный пул в тарифном плане
[[Файл:vpn_guestpool.png|center|Указание гостевого VPN пула]]

3.
Добавьте в /etc/apache2/sites-enabled/ файл vhost_blank.conf со следующим содержимым
<pre>
Listen 81
<VirtualHost *:81>
ServerName 10.250.1.1
ServerAdmin webmaseter@isp.net

ErrorLog /var/log/apache2/nomoney_err.log
CustomLog /var/log/apache2/nomoney_access_log combined
DocumentRoot /opt/ebs/web/nomoney

<Directory "/opt/ebs/web/nomoney">
AllowOverride All
Options FollowSymlinks Includes
ErrorDocument 404 /index.html
DirectoryIndex index.html
AddDefaultCharset utf-8
allow from all
</Directory>
</Virtualhost>
</pre>
По пути /opt/ebs/web/nomoney нужно создать файл index.html со следующим содержимым:
<pre>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Сообщение от провайдера::ExpertBilling</title>
</head>
<body>
<center><img src="provider_logo.png" alt="" /></center>
<h1 align="center">Уважаемый абонент.</h1>
<h1 align="center">На вашем счету закончились деньги. <a href="https://isp.net." target="_blank">"Веб-кабинет"</a></h1>
</body>
</html>
</pre>

Перезапустите Apache для того, чтобы изменения вступили в силу.
<pre>
/etc/init.d/apache2 restart
</pre>
3. Настроим Firewall. Предположим, что 10.250.1.1 - IP адрес сервера с Apache, который мы настраивали пунктом выше.
Правила должны стоять в самом начале!!!
<pre>
/ip firewall filter add src-address=10.250.1.0/24 dst-address=10.250.1.1 action=accept
/ip firewall filter add src-address=10.250.1.1 dst-address=10.250.1.0/24 action=accept
/ip firewall filter add src-address-list=10.250.1.0/24 action=drop
</pre>

Настроим редирект всех HTTP запросов
<pre>
/ip firewall nat add chain=srcnat src-address=10.250.1.0/24 action=masquerade
/ip firewall nat add chain=dstnat src_address=10.250.1.0/24 protocol=tcp dst-port=80 action=dst-nat to-addresses=10.250.1.1 to-ports=81
</pre>

Теперь при наступлении отрицательного баланса биллинг будет сбрасывать сессию абонента, а после переподключения выдавать IP адрес из созданного нами пула, все запросы с которого будут посылатся на сервер с apache.

Ограничением данного подхода является возможность его использования только в PPTP/L2TP/PPPOE тарифных планах.

== Скрипт импорта платежей ==

Скрипт предназначен для импорта платежей из текстовых файлов формата CSV.
Скрипт находится по пути /opt/ebs/data/scripts/payments/process.py
Файл настроек находится по адресу /opt/ebs/data/scripts/payments/pattern.ini

Формат файла настроек
<pre>
[Belarusbank]
folder_in=Belarusbank/IN/
folder_out=Belarusbank/OUT/
folder_err=Belarusbank/ERR/
file_mask=*.asb
exclude_mask=lan.*
separator=;
payment_type=BELARUSBANK_PAYMENT_IMPORT
encoding=cp855
fieldnames=ACC;FIO;DATETIME;TIME;SUM;EMPTY;EMPTY;EMPTY;PID
datetime_fmt=%d/%m/%Y
time_fmt=%H:%M

[Webmoney]
folder_in=WebMoney/IN/
folder_out=WebMoney/OUT/
folder_err=WebMoney/ERR/
file_mask=*.*
exclude_mask=r*.*
separator=;
payment_type=WEBMONEY_PAYMENT_IMPORT
fieldnames=DATETIME;ACC;SUM;EMPTY;EMPTY;PID;EMPTY;EMPTY;EMPTY;EMPTY
datetime_fmt=%d/%m/%Y %H:%M:%S
time_fmt=
encoding=utf-8
</pre>

Описание настроек:
* '''folder_in''' путь к папке с текстовыми файлами CSV
* '''folder_out''' путь к папке с успешно обработанными файлами платежей
* '''folder_err''' путь к папке с обработанными файлами платежей, содержащими записи в неверном формате или ошибочную информацию
* '''file_mask''' - маска файлов платежей
* '''exclude_mask''' - маска файлов, подлежащих к исключению обработки
* '''separator''' - разделитель в файле csv
* '''payment_type''' - тип платежа. Для нового типа платежей нужно создать запись в таблице базы данных billservice_transactiontype, поместив в поле '''name''' текстовое описание платежа, а в поле '''internal_name''' - текстовую константу '''payment_type'''.
* '''fieldnames''' - формат файла csv. Поле DATETIME предназначено для даты совершения платежа, поле ACC для номера договора аккаунта, SUM - сума платежа, EMPTY - пустое или не имеющее значения поле, PID аналогично EMPTY, TIME - поле времени платежа, если дата и время разнесены по разным столбцам
* '''datetime_fmt''' - формат поля DATETIME. Возможные значения символов подстановки вы можете найти на этой странице http://docs.python.org/library/datetime.html#strftime-and-strptime-behavior
* '''time_fmt''' формат поля TIME
* '''encoding''' кодировка файла CSV

'''Важно!!!''' Обращайте внимание на регистр символов в путях к папкам.
'''Обратите внимание''' В ранних версиях EBS 1.4 данный скрипт отсутствовал. Обратитесь к разработчикам за получением скрипта.

Документация по версии 1.4

2011-09-19T18:45:33Z

93.125.112.3: /* Принцип работы с IPN абонентами(Не актуально для 1.4. В работе.) */

{{H:h|Template:{{NAMESPACE}}:Editor toc}}

== Введение ==
Руководство будет полезно как профессионалам, имеющим опыт работы с биллинг-системами, так и пользователям, впервые сталкивающимся с подобными программными комплексами.

Для опытных пользователей порекомендуем ознакомиться с особенностями развертывания системы (раздел «Установка и предварительная настройка»), а затем обратиться к разделу «Решение задач», при необходимости уточняя детали в соответствующих подразделах раздела «Использование системы».

Если вы ранее не занимались настройкой и эксплуатацией подобных систем, советуем вам продолжить чтение по порядку. В случае необходимости, уточняйте значение терминов в глоссарии («Приложение 1»).

Для каждого из разделов системы («Тарифные планы», «Периоды тарификации» и т.п.) описываются особенности их реализации и назначение, интерфейс, а также при необходимости приводятся примеры использования возможностей Expert Billing Admin. Раздел «Решение задач» целиком состоит из пошаговых руководств по решению типовых задач.

=== Общая информация о биллинг-системах ===
В современном мире ресурсы каналов интернет-доступа остаются ограниченными, поэтому поставщики услуг (провайдеры) стремятся добиться максимальной эффективности использования доступных интернет-мощностей.

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

Системы биллинга, к которым принадлежит и Expert Billing System, производят учет и тарификацию предоставляемых услуг (в данном случае - интернет-трафика), а также автоматизируют процесс выставления клиентам счетов для оплаты.

Биллинг-системы бывают очень разными и могут классифицироваться по различным признакам: методам авторизации, принципам построения (модульности), особенности сбора статистики и управления серверами доступа.

Один из вариантов классификации современных биллинг-систем представлен на
схеме:

[[Файл:Ebs_020.gif]]

В случае с использованием авторизации пользователей, отличной от RADIUS, практически всегда в биллинг встраиваются собственные средства снятия, обработки и записи наработанной статистики. Если же NAS (Network Access Server) и сам биллинг находятся на разных системах, то для снятия статистики используются проверенные средства: alive-пакеты от NAS-сервера, протокол SNMP
(Simple Network Monitoring Protocol) либо NetFlow. Использование протокола NetFlow (протокол, разработанный компанией Cisco специально для мониторинга сети) позволяет получать подробнейшую информацию о сетевой активности пользователей. Данный способ сбора статистики является основным для построения мощных и отказоустойчивых систем.

ExpertBilling относится к виду биллинг-систем с логически разделённой системой управления доступом и системой тарификации, хотя они и могут находиться на одном физическом сервере.

== Системные требования ==

Минимальные системные требования позволят запустить биллинг-систему со всеми компонентами и обеспечат работу систем тарификации и управления доступом при объёме абонентской базы в среднем до 100-150 человек. Запись сырой статистики при этом рекомендуется отключить опцией write_flow = False в файле конфигурации [[ebs_config.ini]]

Рекомендуемая конфигурация(см.ниже) подойдёт для абонентской базы до 5000 человек при активном использоваии тарификации трафика и лимитов.

Оптимальная конфигурация компьютера для системы Expert Billing System зависит от ширины обслуживаемого биллингом канала и количества активных пользователей.

При решении типовых задач рекомендуется использовать компьютер с процессором, работающем на тактовой частоте не ниже 1 ГГц, снабженный не менее чем 512 МБ оперативной памяти.

Требования к объёму свободного места на диске напрямую зависят от того, насколько активно эксплуатируется система и требуется ли вам хранить NetFlow статистику. В случае хранения этой статистики мы рекомендуем использовать винчестеры объемом от 80 ГБ.

Обратите внимание: требования к объему свободного дискового пространства вызваны тем, что база данных при активном использовании биллинг-системы может значительно увеличиваться в объеме. Для корректной работы ExpertBilling необходимо обеспечить достаточное количество свободного дискового пространства на разделе с базой данных.

== Поддерживаемые ОС ==
* Debian 5.1-6 32-bit
* Ubuntu 9.04-10.10 32-bit. Рекомендуется 10.04
* Ubuntu Server 9.04-10.10 32-bit - Рекомендуется 10.04
* Другие операционные системы на кодовой базе Debian/Ubuntu 32-bit

Использование 64-битных операционных систем '''не рекомендуется''' по причине наличия в составе биллинга встроеного оптимизатора, который не будет работать на 64-битной операционной системе. Тем самым будет наблюдаться падение производительности до 300% на некоторых задачах.

=== Минимальные системные требования ===

* CPU: 1GHz
* RAM: 512MB
* HDD: 20GB

=== Рекомендуемая конфигурация ===

* CPU: 2-4 ядерный процессор от 2 GHz на ядро
* RAM: 4GB
* HDD: >250GB

== Обзор возможностей ==
[[Обзор возможностей]]

== Структурно-логическая схема работы системы ==
[[Expert Billing System]] построена на базе устоявшейся схемы с разделёнными компонентами авторизации, сбора статистики и ядром, отвечающим за логику работы системы. Структура биллинг-системы позволяет легко расширять её за счёт установки дополнительных RADIUS-серверов и коллекторов статистики.

[[Файл:ebs_029.png]]

[[Expert Billing System]] состоит из серверной и клиентской частей. Серверная часть включает следующие компоненты:

* Модуль core
* Модуль rad
* Модуль nf
* Модуль nfroutine
* Модуль rpc
* Веб-кабинет для пользователей

Модуль '''core''' – ядро биллинга, отвечающее за бизнес-логику (тарификация, списание средств, управление состоянием пользователей и др.)

Модуль '''rad''' предназначен для взаимодействия с сервером доступа по протоколу RADIUS.

Модуль '''nf''' используется в качестве коллектора NetFlow v5 статистики.

Модуль '''nfroutine''' производит агрегацию и обработку собранной модулем nf статистики о сетевой активности пользователей.

Модуль '''rpc''' предоставляет интерфейс для доступа к ядру биллинга извне (интерфейс администратора, интерфейс кассира, некоторые функции веб-кабинета).

'''Веб-кабинет''' пользователя представляет собой веб-приложение, написанное наязыке Python с использованием веб-фреймворка Django.

Клиентская часть [[Expert Billing System]] включает следующие компоненты:
* Интерфейс администриратора [[Expert Billing Admin]]
* Интерфейс кассира

Интерфейс администратора [[Expert Billing Admin]] является основным интерфейсом администратора для управления [[Expert Billing System]], она выполнена в качестве отдельного приложения.

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

== Структура директорий ==
/opt/ebs/
data/
dicts/ - RADIUS словари
ebscab/ - копия веб-кабинета
fonts/ - шрифты, используемые ядром для генерации графиков
init.d/ - init-скрипты
log/ - каталог с лог-файлами
core_log - лог-файл процесса core(ядра)
rad_log - лог-файл сервера RADIUS
nf_log - лог-файл NetFlow коллектора
nfroutine_log - лог-файл агрегатора и тарификатора NetFlow
rpc_log - лог-файл rpc-сервера
modules/ - каталог системных библиотек
nf_dump/ - каталог буферного хранения NetFlow статистики.
scripts/ - каталог с дополнительными скриптами
sql/ - каталог с первоначальным дампом базы данных
temp/ - каталог хранения NetFlow статистики
ebs_config.ini - основной файл настроек биллинг-системы
ebs_config_runtime.ini - дополнительный внутрисистемный файл настроек биллинг-системы
core - ядро биллинг-системы
rad - радиус сервер
nf - NetFlow коллектор
nfroutine - NetFlow агрегатор и тарификатор
rpc - RPC-сервер
license.lic - файл лицензии
web/
ebscab/
settings.py - файл настроек веб-кабинета

== Настройка действий на сервере доступа ==
[[Настройка действий на сервере доступа.]]

== Работа с документами и отчётами ==
[[Создание отчётов]]

== Принцип работы с IPN абонентами ==
ExpertBilling позволяет обслуживать как коммутируемые(PPTP/PPPOE/HoSpot), так и некоммутируемые соединения. В случае работы с IPN(IP Network, IPoE) тарифными планами, или PPPOE/PPTP тарифными планами с дублированием IPN действий схема работы системы выглядит следующим образом.

[[Файл:ipn_alg.png]]

=== Схема работы с IPN тарифными планами ===
Биллинг-система ExpertBilling 1.4 спроектирована таким образом, чтобы иметь возможность выполнять IPN действия для аккаунта и для субаккаунтов. Начиная с версии 1.4 возможность назначать аккаунтам IP/MAC была перенесена в субаккаунты. Таким образом выполнение IPN действий для аккаунта актуально только в случае выполнения групповых действий над всеми субаккаунтами или самим аккаунтом. К примеру блокирование всех правил на сервере доступа с комментарием, равным ID аккаунта. Данный подход может так же применяться в случае продажи услуг, доступ к которым может осуществляться по логину/логину паролю без назначения IP/mac адресов и других сетевых атрибутов аккаунта (хостинг, веб-почта, шаринг и д.р.).

Выполнение IPN действий происходит методом парсинга комманд сервера доступа(вторая закладка настроек сервера доступа) и их отправки на сервер доступа по протоколу SSH. В случае использования опции ssh_backend в конфиг-файле, транспортом между биллингом и сервером доступа может быть любой сетевой протокол, который будет реализовать бэкенд. Это может быть ssh/telnet/routeros api или любой другой. В команды сервера доступа могут быть подставлены переменные из аккаунта, субаккаунта, сервера доступа и настройки скорости. Подробнее читайте об этом в разделе о серверах доступа.

Команды управления по-умолчанию позволяют полноценно выполнять необходимые действия на сервере доступа, однако вы их можете изменять по своему усмотрению.

=== Управление аккаунтом ===
При создании абонента система посылает на сервер доступа команду "Добавить абонента" из настроек сервера доступа в интерфейсе администратора. Команда "Добавить абонента" является шаблоном, в котором служебные слова
заменяются соответствующими значениями. Резальтатом работы команды должны стать добавленные, но неактивированные записи.

Для использования в шаблоне команды могут быть использованы следующие переменные аккаунта:
<pre>
$account_id
$ballance
$credit
$datetime
$tarif_id
$access_parameters_id
$time_access_service_id
$traffic_transmit_service_id
$cost
$reset_tarif_cost
$settlement_period_id
$tarif_active
$acctf_id
$account_created
$disabled_by_limit
$balance_blocked
$nas_id
$ipn_status
$ipn_speed
$vpn_speed
$ipn_added
$allow_express_pay
$account_status
$username
$password
$current_acctf
$allow_ipn_with_null
$allow_ipn_with_minus
$allow_ipn_with_block
$userblock_max_days
</pre>
Так же могут быть использованы переменные сервера доступа:
<pre>
$id
$type
$name
$ipaddress
$secret
$login
$password
$allow_pptp
$allow_pppoe
$allow_ipn
$user_add_action
$user_enable_action
$user_disable_action
$user_delete_action
$vpn_speed_action
$ipn_speed_action
$reset_action
$speed_vendor_1
$speed_vendor_2
$speed_attr_id1
$speed_attr_id2
$speed_value1
$speed_value2
$identify
$subacc_add_action
$subacc_enable_action
$subacc_disable_action
$subacc_del_action
$subacc_ipn_speed_action
$acct_interim_interval
</pre>
Активация абонента должна приводить к активации добавленных на сервер доступа записей. Активация происходит в том случае, если абонент не активен и у него нет блокировок или ограничений по размеру баланса. Для активации используется соответствующий NAS Actions из параметров сервера доступа. В данной команде можно использовать те же подстановочные символы, что и для добавления абонента.

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

Удаление абонента происходит при его удалении из системы. Используемые подстановочные символы аналогичны команде добавления. Обратите внимание, что команда удаления с сервера доступа так же выставляет в системе статус "Не активен на сервере доступа" для аккаунта.

=== Управление субаккаунтами ===
Управление субаккаунтами осуществляется аналогично управлению аккаунтами, за тем исключением что становится доступно 3 дополнительные команды: установить IPN скорость, установить VPN скорость, сбросить VPN сессию.

Добавление/удаление субаккаунта происходит при соответствующих действиях в системе. При этом доступны следующие переменные:
<pre>
$id
$account_id
$username
$password
$vpn_ip_address
$ipn_ip_address
$ipn_mac_address
$nas_id
$ipn_added
$ipn_enabled
$need_resync
$speed
$switch_id
$switch_port
$allow_dhcp
$allow_dhcp_with_null
$allow_dhcp_with_minus
$allow_dhcp_with_block
$allow_vpn_with_null
$allow_vpn_with_minus
$allow_vpn_with_block
$associate_pptp_ipn_ip
$associate_pppoe_ipn_mac
$ipn_speed
$vpn_speed
$allow_addonservice
$allow_ipn_with_null
$allow_ipn_with_minus
$allow_ipn_with_block
$vlan
$vpn_ipv6_ip_address
$ipv4_ipn_pool_id
$ipv4_vpn_pool_id
</pre>
Так же могут быть использованы переменные сервера доступа:
<pre>
$id
$type
$name
$ipaddress
$secret
$login
$password
$allow_pptp
$allow_pppoe
$allow_ipn
$user_add_action
$user_enable_action
$user_disable_action
$user_delete_action
$vpn_speed_action
$ipn_speed_action
$reset_action
$speed_vendor_1
$speed_vendor_2
$speed_attr_id1
$speed_attr_id2
$speed_value1
$speed_value2
$identify
$subacc_add_action
$subacc_enable_action
$subacc_disable_action
$subacc_del_action
$subacc_ipn_speed_action
$acct_interim_interval
</pre>
и переменные аккаунта
<pre>
$account_id
$ballance
$credit
$datetime
$tarif_id
$access_parameters_id
$time_access_service_id
$traffic_transmit_service_id
$cost
$reset_tarif_cost
$settlement_period_id
$tarif_active
$acctf_id
$account_created
$disabled_by_limit
$balance_blocked
$nas_id
$ipn_status
$ipn_speed
$vpn_speed
$ipn_added
$allow_express_pay
$account_status
$username
$password
$current_acctf
$allow_ipn_with_null
$allow_ipn_with_minus
$allow_ipn_with_block
$userblock_max_days
</pre>

Активация/деактивация аккаунта выполняется аналогичным способом с использованием тех же переменных.

Установка скорости производится аналогичным способом через NAS Actions. В дополнение к подстановочным символам из команды на добавление абонента здесь используются $access_type, $session, $max_limit_tx, $max_limit_rx, $burst_limit_tx, $burst_limit_rx, $burst_treshold_tx, $burst_treshold_rx, $burst_time_tx, $burst_time_rx, $priority, $min_limit_tx, $min_limit_rx. Следуюет обратить внимание, но то, что перед добавлением записи, система должна перестраховаться и удалить уже возможно существующую с таким же идентификатором. Биллинг посылает команду на установку/изменение скорости в случае если скорость ещё не установлена или изменилась.

Состояние каждого аккаунта и его субаккаунтов вы можете контроллировать через EBS Admin в списке абонентов.

[[Файл:account_ipn_status.png]]

=== Статус аккаунта ===
Пять иконок напротив каждого абонента означают (слева-направо) "У клиента достаточно средств на лицевом счету для работы в текущем расчётном периоде", "У клиента нет блокировок по лимитам", "Пользователь неактивен на NAS", "Пользователь не добавлен на NAS", "У пользователя есть активные RADIUS сессии".

ExpertBilling позволяет использовать IPN действия и для PPTP/PPPOE тарифных планов.

[[Файл:pptp_pppoe_ipn.png]]

Схема использования IPN действий для PPTP/PPPOE тарифных планов.

IPN действия для PPTP/PPPOE тарифных планов отличаются от работы с IPN тарифными планами лиш тем, что настройки скорости для абонентов устанавливаются после каждой RADIUS авторизации.

Использование IPN действий целесообразно тогда, когда вы не хотите запрещать PPTP/PPPOE абонентам авторизацию при их блокировке, однако хотите закрыть доступ к определённым ресурсам или перенаправлять всех таких абонентов на какие-то ресурсы.

== Установка и начальная настройка ==
=== Установка биллинга ===
[[Инструкция по установке серверной части биллинг-системы ExpertBilling 1.4]]
=== Установка веб-кабинета ===
[[Инструкция по установке веб-кабинета]].

=== Установка и настройка дополнительных скриптов ===
[[Вспомогательные скрипты и утилиты]]

[[Система мониторинга загрузки серверов доступа]]

== Установка клиентской части ==

== Защита от нелегального копирования ===

'''Внимание!!! Expert Billing System является продуктом интеллектуального труда. Его нелегальное распространение и использование преследуется по закону.'''

Каждый серверный компонент Expert Billing System при установке привязывается к аппаратной конфигурации сервера. Это означает, что при изменении конфигурации системы (в частности, переразбивке/замене/добавлении/удалении жестких дисков, изменении номера активного интерфейса, добавлении/удалении любых IDE/SATA/SСSI-устройств, добавлении/извлечении USB дисков) и смене ОС система не будет работать из-за ограничений, налагаемых защитой от нелегального копирования. При изменении конфигурации оборудования вам необходимо обратиться к разработчику для получения новой копии Expert Billing System.

В комплекте поставки системы имеется файл license.lic, уникальный для каждого легального пользователя системы. Он является частью системы защиты Expert Billing System от нелегального распространения и не подлежит модификации и удалению. В случае его отсутствия или изменения, биллинг-система не будет работать.

В соответствии с лицензионным соглашением, покупатель получает права на модификацию и распространение кода веб-кабинета. При этом компания-разработчик Expert Billing System не несет никакой ответственности за возможный ущерб, нанесенный по причине использования модифицированного веб-кабинета.

== Решение проблем ==
[[Решение проблем с интерфейсом администратора]]

[[Решение проблем с ядром]]

[[Решение проблем с веб-кабинетом]]

== Варианты настройки ==
[[Настройка команд сервера доступа для привязки IP к MAC на IPN тарифе]]

Главная

2011-09-18T20:59:43Z

93.125.112.3:

'''Страница документации по ExpertBillingSystem.'''

ExpertBilling - это биллинговая система для интернет-провайдеров, предназначенная для тех организаций и частных лиц, которые начинают активно вести бизнес и ищут достойную замену существующим решениям в области биллинга. ExpertBilling предоставляет весь необходимый функционал для создания гибких схем тарификации, управления аккаунтами и мониторинга системы. Биллинговая система обладает открытой архитектурой, высокой надёжностью и предоставляет удобные инструменты администрирования, что позволяет максимально быстро и просто решать сложные задачи простыми способами. Мы ценим наших клиентов и предлагаем им только самое лучшее.

'''Внимание, wiki находится в стадии наполнения контентом. Будем рады принять помощь'''

[[Документация по версии 1.4]]

[[Файл:EBS.png|center]]