Документация по модулю Интернет+ и принадлежащим к нему страницам перенесена в Confluence
http://abills.net.ua:8090/pages/viewpage.action?pageId=7504005
Internet+
Модуль для предоставления услуг интернет связи. Создан для замены модулей Dv, Dhcphost, IPN, Vlan
Возможности
- Подключение PPPoE/PPTP
- Активация IPoE
- DHCP Option82
- Авторизация по любым параметрам абонента (MAC,CPE_MAC,NAS_PORT,VLAN,SVLAN) или по их комбинации
- Отображение состояния оборудования абонента
- Тестирование оборудования подключения
- Трафик на порту комутатора
- Длина кабеля к абоненту
- Состояние порта
- Тарификация
- Месячная
- Дневная
- Комбинировання
Управление модулем
Отчеты
Абон. плата (periodic)
В системе существует несколько типов снятия периодических снятий денег (абон. плата) они разделяются на месячные и дневные. Для дневной абон. платы используется скрипт
# /usr/abills/libexec/periodic daily
Для месячной
# /usr/abills/libexec/periodic monthly
дополнительные параметры передаваемые при запуске снятий. Данные программы стоит выполнять через cron с интервалом 1 час. Например дневная программа периодических действий в 00:00:00 месячная в 01:00:00. Месячную и дневную программу нужно запускать каждый день
TP_ID | Номер тарифного плана. Снятия производятся только для указанного тарифного плана. Также можно указать несколько тарифных планов через точку с запятой. Пример TP_ID=«1;2;3;4;5» |
---|---|
LOGIN=«» | Логин абонента. Снятия производятся только для определённого абонента. |
DATE=xxxx-xx-xx | Дата выполнения периодических процесов. Операции будут производиться с датой указанной в этом параметре |
SKIP_ROTATE=1 | Не проводить ротацию логов при месячном периодике. Стандартно система ротейтит errors_log s_detail internet_log_intervals |
DEBUG=1..7 | Режим отладки. В режиме отладки выше 7 система показывает выполнение команд но не выполняет их |
Снятие абон. платы за определённое число
дневная
# /usr/abills/libexec/periodic daily DATE="2014-06-05"
месячнная
# /usr/abills/libexec/periodic monthly DATE="2014-06-05"
Дополнительные параметры
Диагностика соединения
По умолчания в биллинге используется команда ping для диагностики соединения. Но можно расширить инструменты диагностики за счет внешних программ при помощи опции INTERNET_EXTERNAL_DIAGNOSTIC.
$conf{INTERNET_EXTERNAL_DIAGNOSTIC}='-' | Внешняя диагностика соединения |
---|
Объявление:
NAME:CMD ARGS
NAME | имя команды |
---|---|
CMD | сама команда |
ARGS | аргументы |
Список возможных аргументов:
USER_NAME
SESSION_START
ACCT_SESSION_TIME
ACCT_INPUT_OCTETS
ACCT_OUTPUT_OCTETS
EX_INPUT_OCTETS
EX_OUTPUT_OCTETS
CONNECT_TERM_REASON
FRAMED_IP_ADDRESS
LAST_UPDATE
NAS_PORT
NAS_IP_ADDRESS
CALLING_STATION_ID
CONNECT_INFO
ACCT_SESSION_ID
NAS_ID
ACCT_SESSION_STARTED
ACCT_INPUT_GIGAWORDS
ACCT_OUTPUT_GIGAWORDS
FILTER_ID
Пример Использование ARP Ping
$conf{INTERNET_EXTERNAL_DIAGNOSTIC}='ARPPING:arping %CALLING_STATION_ID%';
Если нужно обявить несколько внешних программ это можно сделать через точку с запятой (;)
ARP Ping для mikrotik
$conf{INTERNET_EXTERNAL_DIAGNOSTIC}='/usr/abills/Abills/modules/Dv/arping.pl ACCT_SESSION_ID=%ACCT_SESSION_ID%';
Дополнительный пароль сервиса.
$conf{INTERNET_PASSWORD}=1;
При включении данной опции система будет использовать для подключения пароль сервиса интернет. Если пароль не заполнен будет использоваться основной пароль абонента. Данный пароль можно изменить только с админ формы.
Дополнительный логин сервиса.
$conf{INTERNET_LOGIN}=1;
При включении данной опции система будет использовать для подключения логин сервиса интернет. Если логин не заполнен будет использоваться основной логин абонента. Данный логин можно изменить только с админ формы.
Изменение даты активации при платеже
$conf{INTERNET_PAY_ACTIVATE}=1;
Изменение даты активации (если дата активации клиента выставлена). Дата активации клиента меняется если соблюдаются следующие условия.
- На момент пополнения счета баланс клиента должен быть отрицательным (баланс=депозит+кредит)
- После пополнения счета баланс абонента должен быть положительным.
При соблюдении выше указанных условий дата активации изменяется на дату платежа.
Установка даты активации при первом подключении абонента
$conf{INTERNET_USER_ACTIVATE_DATE}
Установка даты активации при первом подключении абонента со статусом «не активировано». Абонент подключается, статус меняется на активно и устанавливается текущая дата активации
Активировать только при депозите не ниже полного месяца
$conf{INTERNET_FULL_MONTH}=1;
Для тарифных планов с месячной распределённой абон. платой производить активацию только при наличии полной сумы абон. платы на месяц
Внешний информатор услуги
в случае если штатные сообщения системы не устраивают можно их заменить собственными через опцию $conf{INTERNET_WARNING_EXPR} . Если указать в ней текст он будет отображаться в информационной панели. Также можно запустить внешнюю программу, а вывод показать абоненту и администратору.
$conf{INTERNET_WARNING_EXPR}='CMD:/usr/abills/misc/dv_warning.pl LOGIN=%LOGIN% LANGUAGE=%language%';
Кастомные команды для шейпера
$conf{linkupdown_external}='cmd';
Опция предназначена для создания собственных правил шейпера.
Запускается в программе linkupdown следующим образом
$conf{linkupdown_external} "$ACTION" "$INTERFACE" "$USER" "$CLIENT_IP