. pay - информация о начислениях (история начислений) на лицевой счет пользователя условных единиц или $. Файл имеет формат вида: #

    #
    # Платежи клиента ivan
    #
    #
    1999/02/27 13: 00: 01 Add pay | 10. 5
    1999/03/15 15: 12: 00 Add pay | 23
    1999/05/05 12: 30: 40 Add pay | 6. 5

Как видно, данный файл имеет два поля произвольной длины разделенные символом "|". Первое (левое) поле содержит комментарий или, другими словами, обоснование для второго (правого) поля, в котором содержится число с плавающей точкой, определяющее стоимость транзакции, т. е. стоимость биллинговой информации. Основная и единственная единица измерения биллинговой информации - условная единица или $. Если приведенный выше файл содержится в домашнем каталоге пользователя ivan, то, просуммировав второе (правое) поле, можно выяснить, что общий размер начислений на лицевой счет (или платежей) клиента ivan равняется 40 условным единицам. Открыв этот файл, системный администратор или пользователь ivan может не только узнать сколько вообще было начислено на данный лицевой счет, но и то, когда (кем) это было сделано (забегая вперед, хочется отметить, что подобный способ хранения биллинговой информации в обычных текстовых файлах, т. е. "дата, обоснование операции | размер", является основным для предлагаемой системы). Добавлять или изменять информацию в файлах . pay должен только системный администратор. Делать это можно как из командной строки, так и через веб-интерфейс; . weekly - информация об отчислениях (история отчислений) с лицевого счета пользователя в условных единицах за фактическую работу за текущую неделю по каждому соединению (по каждой предоставленной услуге). Формат файла аналогичен формату файла . pay

    #
    #
    # Работа клиента ivan за текущую неделю
    #
    #
    1999/05/18 13: 00: 01 Time elapsed=40 sec. , cost | 0. 052

1999/05/19 15: 12: 00 Time elapsed=1200 sec. , cost | 0. 156

    1999/05/19 16: 30: 40 Time elapsed=75 sec. , cost | 0. 101

Запись в файл . weekly делает демон после окончания соединения. В приведенном выше фрагменте файла . weekly в первом поле содержится следующая информация: дата окончания соединения (YYYY/MM/DD), вреня окончания соединения (HH: MM: SS), продолжительность соединения в секундах (Time elapsed). Во втором поле файла . weekly, отделенного символом "|" содержится стоимость транзакции (стоимость соединения, стоимость фактически предоставленной услуги в условных единицах); . work - информация об отчислениях (история отчислений) с лицевого счета пользователя по за целые недели в сумме. В конце каждой недели второе поле файла . weekly суммируется и итоговая сумма заносится в файл . work.

    1999/05/18 1999/05/25 cost | 5. 011
    1999/05/26 1999/06/01 cost | 2. 133

Файлы . weekly в домашних каталогах пользователей "разбухают" вследствие того, что там протоколируется каждое соединение. С другой стороны, как показывает практика, большинству пользователей интересен лишь подробный отчет использования машинного времени за текущую и прошедшую неделю, поэтому информация, накопленная в файлах . weekly должна "компрессироваться". Если же пользователю нужно предоставить подробный отчет за работу двух- (трех-, четырех- и т. д. ) недельной давности (что случается не так часто), то эту информацию системный администратор может "вытащить" из SQL-базы. Обновлением файлов . work, . weekly и . weekly. last должна заниматься специальная программа w_update. pl, запускаемая по крону еженедельно; . weekly. last - копия файла . weekly за прошлую неделю;

. current - текущий размер лицевого счета пользователя в условных единицах, файл обновляется после завершения каждой сессии данного пользователя, служит для "быстрого" вычисления размера лицевого счета пользователя, например, при старте нового соединения;

. time - наличие такого файла (под наличием файла подразумевается файл с данным именем любой длины, в том числе и нулевой, доступный для чтения в данный момент) сигнализирует о том, что баланс лицевого счета пользователя всегда положителен. В русском языке обычно под этим подразумевают сладкое слово "халява". Разумеется, этот файл прежде всего должны иметь, например, сотрудники ISP и их ближайшие родственники ; -)

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

. type - тип пользователя (например, "свой", "халява", "бартер", "деньги"). Служит для деления пользователей на группы, по которым в дальнейшем генерируется статистическая информация;

. account - тип (или индекс) прайс-листа для данного пользователя. Этот файл очень удобно использовать для задания прайс-листа отдельным группам пользователей. Вы создаете желаемый прайс-лист и помещаете его в каталог /var/statserv/etc, а пользователям в домашних каталогах указываете лишь ссылку на него. Если Вы хотите поменять прайс-лист для некоторой группы пользователей, то, Вы редактируете прайс-лист всего в одном месте (см. ниже "Алгоритм выбора тарифной схемы для пользователя при старте демона");

. account. conf - собственный прайс-лист для данного пользователя. См. структуру файла . account. conf. Этот файл следует применять в том случае, когда Вы хотите задать для пользователя индивидуальный прайс-лист;

. pay. next - авансовый платеж, или следующее начисление на лицевой счет пользователя после обнуления текущего лицевого счета. Может быть использовано в том случае, когда пользователь не исчерпал текущий лицевой счет, однако оплатил следующую услугу по прежнему или новому прайс-листу;

. account. next - то же, что и . account (см. выше), но только для авансового платежа.

    Описание выходных документов.

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

    Оставшаяся сумма на счету у пользователя
    Время, проведенное в сети
    Статистика работы в сети по дням, неделям и месяцам

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

При генерации выше указанной информации используются дополнительные модули программы “Billing ISP” и системные программы Unix такие как, CGI- модули (для обращения к базам данных и генерации HTML кода и форм или писем), Apache web server (для вывода на экран HTML кода сгенерированного CGI программой), MTA Sendmail (для отправки электронного письма пользователю об окончании счета).

Описание технологии и алгоритмов решения задачи и их машинная реализация.

    Описание ввода в базу данных входной информации.

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

Алгоритм начисления условных единиц на лицевой счет пользователя Если файл . pay в домашнем каталоге пользователя отсутствует, то занести размер платежа в файл . pay, а индекс прайс-листа в файл . account. Переход к пункту 3; Вычислить текущий размер лицевого счета пользователя. Если он отрицателен или равен нулю, то очередной платеж заносится в файл . pay, а выбранный индекс прайс-лист в файл . account. Если текущий размер лицевого счета пользователя положителен, то очередной платеж заносится в файл . pay. next, а выбранный индекс прайс-листа в файл . account. next; Обновить файл . current с текущим размером лицевого счета;

Занести платеж в таблицу "ПЛАТЕЖИ" базы данных (опционально).

    Алгоритм фиксации в базе статистической информации
    Введение.

Рассматриваемый программный продукт напрямую зависит от системных вызовов операционной среды, в которой он работает, а также и от некоторых приложений, например PPPD (название этого демона происходит от названия протокола соединения пользователя и провайдера Point to Point Protocol), syslog (системная программа, которая фиксирует пребывание пользователя в системе, а также фиксирует в лог-файлы сообщения ядра ОС). В связи с тем, что описания данных продуктов это тема отдельной курсовой работы, данный алгоритм будет описан поверхностно. При соединении пользователя к провайдеру запускается программа Mgetty, которая управляет и инициализирует работу модема. Запуск данной програмы фиксируется в системных лог-файлах системы. После ее запуска она активизирует, в нашем случаи демон PPPD, который в свою очередь принемает и регистрирует пользовательские запросы и после проверки всего необходимого впускает или нет в систему. Все действия данных сервисов после соединения отслеживает программа syslog, которая и генерирует основную базу действий пользователя в системе. Billing ISP, как уже говорилось выше напрямую взаимодействует с PPPD проверяя актуальность данного подключения и в случаи удачного входа изменяет (уменьшает) за определенный квант времени счет пользователя. Также демон биллинга с момента соединения пользователя начинает вести подсчет времени пребывания пользователя с соответствующим изменением в SQL базе полей.

    Обобщенный алгоритм решения задачи.

Ядром предлагаемой системы является специально написанный демон "биллинга" (в дальнейшем просто демон), осуществляющий контроль за израсходованнным временем и/или условными единицами пользователя, находящегося в данный момент в режиме "он-лайн". Демон запускается в момент входа пользователя в систему, по истечении одного кванта времени (например, 5 секунд) снимает с лицевого счета пользователя стоимость одного кванта в соответствии с действующей в данный момент ценой, которая, кстати, может меняться в зависимости от времени суток, а после завершения сеанса связи демон прекращает свою работу, протоколируя информацию о продолжительности сеанса связи и отработанной стоимости в специальный лог-файл в домашнем каталоге пользователя и, при необходимости, в общую SQL-базу данных. Другими словами, отдельная копия демона постоянно присутствует в памяти сервера биллинга и "следит" за пользователем на протяжении всего сеанса связи. Информация о начислениях на лицевой счет пользователя и снятия с лицевого счета за фактически отработанное "он-лайновое" время (так называемая "биллинговая информация") хранится в домашних каталогах пользователей в обычных текстовых файлах. Т. е. для каждого пользователя создается свой набор файлов с биллинговой информацией. Соответственно, вычисление размера лицевого счета пользователя происходит на основании содержимого этих файлов. Такое распределенное хранение биллинговой информации по каждому пользователю обеспечивает простоту построения системы, а значит надежность, и предоставляет возможность организации несложной системы доступа к лицевым счетам через www-интерфейс. В тоже время, такая же информация, но немного в другом виде хранится в SQL-базе, однако она используется исключительно для генерации статистической информации предоставляемой системному администратору.

    Алгоритм выполнения отдельных модулей.

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

Данный алгоритм должна реализовывать программа, выполняющая аутентификацию пользователя (TACACS+ или pppd) на этапе подключения его к Интернету. В этот случае основную роль должен играть файл . current, который содержит уже вычисленное значение размера лицевого счета, т. к. в данный момент размер лицевого счета должен быть получен практически мгновенно. Если файл . refused присутствует в домашнем каталоге пользователя, то текущий размер лицевого счета принимается отрицательным. Переход к пункту 5; Если файл . time присутствует в домашнем каталоге пользователя, то текущий размер лицевого счета принимается положительным. Переход к пункту 5; Если файл . current присутствует в домашнем каталоге пользователя, то из него берется текущий размер лицевого счета (файл . current обновляется каждый раз после завершения работы демона). Переход к пункту 5; Текущий размер лицевого счета вычисляется по формуле : "общая сумма начислений из файла . pay минус общая сумма отчислений из файла . work минус общая сумма отчислений из файла . weekly"; Если текущий размер лицевого счета положителен, доступ в систему пользователю разрешатеся, в противном случае - запрещается. Алгоритм выбора прайс-листа (тарифной схемы) для пользователя при старте демона Если в домашнем каталоге пользователя находится файл . account. conf, то прайс-лист для данного пользователя читается из этого файла; Если в домашнем каталоге пользователя присутсвует файл . account, то из него читается первая строчка, которая добавляется в слову account, к полученной строке добавляется расширение . conf, и, таким образом файл c прайс-листом с полученным именем читается из каталога /var/statserv/etc; Если файлы . account. conf и . account отсутствуют в домашнем каталоге пользователя, то прайс-лист для данного пользователя читается из файла /var/statserv/etc/account. conf (прайс-лист по умолчанию)

    Действия, выполняемые демоном при старте

Анализирует командную строку. В качестве первого параметра ему передается имя пользователя, в качестве второго - NAS-порт (или устройство, например, /dev/cuaa2), в качестве третьего - адрес NAS-сервера (третий параметр нужен только в том случае когда у провайдера более одного NAS'a); Выбирает прайс-лист (тарифную схему) для пользователя (см. "Алгоритм выбора прайс-листа для пользователя при старте демона"); Проверяет присутствие в домашнем каталоге файла . time, если он там есть - взводит соответствующий флажок в переменную us. unoff=1; Проверяет присутствие в домашнем каталоге файла . refused, если он там есть - взводит соответствующий флажок в переменную us. refused=1; Вычисляет значение лицевого счета пользователя (см. пункт 4 "Алгоритма вычисления лицевого счета при входе пользователя в систему"). Даже если размер лицевого счета отрицателен, демон все равно продолжит свою работу, поскольку по истечении первого же кванта времени он, при необходимости, подаст сигнал на отключение этого пользователя; Демонизируется ; -);

Записывает свой PID в файл с именем NAS-порта в каталог /var/run (если у провайдера больше одного NAS'a - то необходимо модифицировать демон, чтобы избежать конфликтов в каталоге /var/run между NAS'ами); Программирует собственный таймер на заданный квант времени и входит в бесконечный цикл, вывести из которого может только SIGHUP. Действия, выполняемые демоном при истечении одного кванта времени Обновить счетчик (в секундах) продолжительности текущего соединения, в соответствии с действующим тарифом вычислить стоимость одного кванта времени, обновить переменную в которой накапливается стоимость текущей сессии; Проверить, присутствует ли пользователь все еще в системе - просмотреть файл /var/run/utmp. Если пользователя в системе нет, то вызвать процедуру, выполняемую при завершении сессии; Если пользователь не исчерпал свой лицевой счет, то ждать истечение следующего кванта времени. В противном случае описанные ниже действия возникают при исчерпывании средств на лицевом счете: Проверить, является ли этот пользовать "привелегированным". Для этого посмотреть на флажок us. unoff. Если us. unoff==1, то ждать истечение следующего кванта времени; Проверить, была ли вызвана программа /var/statserv/bin/killuser, если да - то ждать истечение следующего кванта времени. Дело в том, что из-за особенностей построения некоторых систем аутентификации, при исчерпывании средств на лицевом счете, фактически пользователь отключается не сразу после вызова программы /var/statserv/bin/killuser, а через некоторый интервал времени; Если файл . pay. next отсутствует в домашнем каталоге пользователя, значит, пользователя необходимо принудительно отключить. Переход к пункту 9; Прочитать сумму из файла . pay. next. Переписать ее в файл . pay. Удалить файл . pay. next. Вычислить текущий размер лицевого счета пользователя. Если он отрицателен, то переход к пункту 9; Перечитать новый прайс-лист из файла . account. next. Удалить файл . account. conf, если он присутствует. Переименовать файл . account. next в файл . account и ждать истечение следующего кванта времени. Вызвать программу /var/statserv/bin/killuser с параметрами имя_пользователя и NAS-порт, которая пошлет сигнал на отключение пользователя; Действия, выполняемые демоном при завершении сессии

При завершении сессии сервер аутентификации TACACS (или pppd) читает PID демона из каталога /var/run/ и посылает ему SIGHUP (возможен, также другой вариант, когда демон постоянно сканирует файл utmp и выполняет ниже описанные действия, если пользователь "изчез" из файла utmp). Демон удаляет файл со своим PID-ом из /var/run/, записывает сведения о только что завершенной сессии в файл . weekly, обновляет файл . current с текущим размером лицевого счета пользователя и вызывает скрипт /var/statserv/bin/close_session. с параметрами имя_пользователя, NAS-port, продолжительность_сессии, стоимость_сессии.

    Контрольный пример.
    Описание использования демона биллинга
    Описание использования демона биллинга

Демон billing является ядром предлагаемой системы учета пользователей для ISP. Он может работать в двух режимах - в "основном" режиме (т. е. режиме демона) для контроля лицевого счета пользователя в реальном масштабе времени и в "вспомогательном" режиме выдачи сведений о размере лицевого счета пользователя или контроля правильности задания тарифной схемы. Ниже приведены все возможные ключи запуска и параметры командной строки: /var/statserv/bin/billing

Usage error: billing [-vdeashtpPrRwW] [username] [port] [nas] -v show version and exit

    -d daemonize billing
    -e increase debug level in daemonize mode
    -a show current price
    -c show current account for sysadmin
    -s show current account
    -h show current account in HTML format
    -t total user account
    -p show pay -P show pay history
    -n show pay. next -N show pay. next history
    -r show work -R show work history
    -w show weekly -W show weekly history

Режим демона - запуск с ключом -d. Далее следуют обязательные параметры - имя пользователя, NAS-порт (порт модема) и имя NAS-сервера (если NAS-сервер у ISP один, то этот параметр выбирается произвольно, однако совсем опускать его нельзя). Пример: /var/statserv/bin/billing -d jackson Async2 access. provider. net Режим выдачи сведений о размере лицевого счета пользователя - запуск с ключом -s и единственным параметром - именем пользователя. Пример: /var/statserv/bin/billing -s jackson

В данном варианте на стандартный вывод ничего не выводится, а "знак" лицевого счета отражается в коде возврата. Если размер лицевого счета больше либо равен нулю, т. е. доступ пользователю в систему разрешен, то billing возвращает число 0, если меньше нуля, т. е. доступ пользователю в систему ограничен, то billing возвращает число 1. /var/statserv/bin/billing -st jackson

На стандартный вывод выводится общий размер лицевого счета пользователя в plain text. См. п. 4 алгоритма вычисления размера лицевого счета пользователя /var/statserv/bin/billing -spt jackson

На стандартный вывод выводится общий размер начислений на лицевой счет пользователя и его общий размер в plain text. Алгоритм вычисления лицевого счета тот же самый. Ключ -P задает вывод истории начислений. /var/statserv/bin/billing -c jackson

    Соответствует вызову
    /var/statserv/bin/billing -stpnrw jackson

т. е. наиболее "употребительному" использованию billing с точки зрения системного администратора. Вызов billing с ключом -h, например /var/statserv/bin/billing -shtpnrw jackson

выводит информацию о лицевом счете пользователя в HTML-формате для того, чтобы ее можно было предоставлять пользователю через www-интерфейс; Режим проверки алгоритма выбора прайс-листа для пользователя. Вызов:

    /var/statserv/bin/billing -a jackson

Предназначен исключительно для системного администратора чтобы контролировать правильность задания тарифной схемы для данного пользователя.

Страницы: 1, 2