Документация по модулю Интернет+ и принадлежащим к нему страницам перенесена в Confluence http://abills.net.ua:8090/pages/viewpage.action?pageId=7504005

Internet+

Модуль для предоставления услуг интернет связи. Создан для замены модулей Dv, Dhcphost, IPN, Vlan

Возможности

Управление модулем

Отчеты

Абон. плата (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;

Изменение даты активации (если дата активации клиента выставлена). Дата активации клиента меняется если соблюдаются следующие условия.

  1. На момент пополнения счета баланс клиента должен быть отрицательным (баланс=депозит+кредит)
  2. После пополнения счета баланс абонента должен быть положительным.

При соблюдении выше указанных условий дата активации изменяется на дату платежа.

Установка даты активации при первом подключении абонента

$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