Введение

Автоматизированная система расчетов «Град-Р» (АСР или Биллинговая система, далее БС) предназначена для учета и тарификации использования клиентом интернет услуг, которые предоставляются компанией провайдером.

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

Для работы с интерфейсом БС пользователю достаточно обладать элементарными навыками работы в Internet.

1. Общие сведения

1.1. Структура системы

Общая структура системы показана на рис. 1.1.

Рис 1.1. Общая структурная схема АСР «Град-Р».

Интерфейс пользователя системы создан в html. Пользователь работает с системой через браузер (MS Internet Explorer 5.0 и выше, Netscape Communicator 4.78 и выше, Konqueror версии 3.0 и выше, Mozilla 1.0 и выше). В веб-сервер АСР встроен модуль взаимодействия с основным модулем АСР, оформленным в виде CORBA-сервиса. За хранение и обработку данных отвечает СУБД Oracle. Компоненты АСР взаимодействуют друг с другом с использованием стандарта CORBA. Общий вид - основной сервер, с которым взаимодействуют модули учета и мониторинга, различные зависимости от набора устройств провайдера.

1.2. Состав комплекса

В состав программного комплекса входят следующие компоненты:

CORBA-сервисы

UAKGQueryService: Сервис доступа к БД
nsd: CORBA Naming Service
eventd: CORBA Event Service
BillingServer: Сервер бизнес логики и Web интерфейсов

Web сервисы

apache 2.0.45: Web -сервер
mod_cbroker: модуль Web-сервера, предназначенный для связи с CORBA приложениями

Утилиты online и offline загрузки данных:

RadiusCollector: для данных, генерируемых Radius сервером
SNMPCollector: для данных, генерируемыми SNMP устройствами
NetFlowCollector: для данных, генерируемыми маршрутизаторами CISCO
PCAPCollector: для данных, генерируемыми маршрутизаторами на основе UNIX систем.
SquidCollector: для данных, генерируемыми прокси-сервером.

Утилиты регулирования доступа:

pam_billing.so - PAM модуль, предназначенный для ПО, поддерживающее стандарт PAM. (В частности - freeradius, ssh, ftpd)
SquidAccessChecker - утилита авторизации для прокси-сервера squid
BillingAccessChecker - утилита авторизации, предназначенная для вызова из скриптов пользователя

Утилиты резервного копирования БД:

ExportBillingDB.sh - утилита предназначенная для создания резервных копий БД БС
ImportBillingDB.sh - утилита предназначенная для импорта в БД из резервной копии

Утилиты обмена файлами с другим ПО:

ExportLedgerData.sh - утилита предназначенная для генерирования файлов обмена с финансовым ПО.

1.3. Программное и аппаратное окружение

Программные и аппаратные средства, работающие вместе с АСР «Град-Р», но не являющиеся его частью:

1) Программные средства:

a) Стандартное ПО управления доступом (одно или несколько из):

i) ПО контроля доступа Radius;

ii) Сервер доступа на основе FreeBSD или Linux;

iii) Маршрутизатор на основе FreeBSD или Linux;

iv) Прокси сервер Squid;

b) СУБД Oracle 9i;

c) Браузеры пользователей;

2) Аппаратные средства:

a) Стандартные учетные устройства (одно или несколько из):

i) Серверы доступа и модемы с поддержкой протокола SNMP RMON2 или RADIUS;

ii) Концентраторы и маршрутизаторы с поддержкой протокола SNMP RMON2;

iii) Маршрутизаторы с поддержкой протокола CISCO NetFlow;

iv) Маршрутизаторы на основе компьютеров общего назначения;

b) Компьютер общего назначения, на котором выполняется сервер приложений;

c) Один или несколько компьютеров общего назначения, на которых выполняются модули учета и мониторинга. Могут быть совмещены с (2.2);

d) Компьютеры пользователей.

2. Компиляция и установка

Процесс компиляции зависит от операционный системы и используемого ORB (Object Request Broker). В данном руководстве описывается случай использования Linux RedHat-8.0 и выше. Для других операционных систем, поддерживаемых АСР «Град-Р», методика компиляции и установки аналогичная, за исключением, возможно, синтаксиса системных вызовов и названий конфигурационных файлов.

2.1. Установка с помощью дистрибутива исходного кода

2.1.1. Необходимое ПО

Операционная система - RedHat-8.0 и выше;
Сервер БД - Oracle-9.02;
CORBA-ORB - mico-2.3.9 с поправками, указанными в приложении 1;
Компилятор C++ - gcc-3.2.

2.1.2. Необходимые предусловия компиляции

БД: В текущем окружении определенны переменные среды ORACLE - ORACLE_HOME и NLS_LANG. Переменная среды PATH должна содержать путь к утилитам Oracle, а переменная среды LD_LIBRARY_PATH - к библиотекам. Критерий проверки - утилита Oracle sqlplus должна запускаться из текущего окружения.
ORB: В текущем окружении переменная среды PATH должна содержать путь к утилитам ORB, а переменная среды LD_LIBRARY_PATH - к библиотеке ORB. Критерий проверки - компилятор idl и сервер имен CORBA (NameService, nsd в случае Mico) должны запускаться из текущего окружения.
HTTPD: Веб-сервер Apache (версия-2.0.45) должен быть установлен вместе с библиотеками поддержки разработки.

2.1.3. Процесс компиляции

Скомпилировать и установить GradSoft C++ ToolBox, в соответствии с Руководством Администратора GradSoft C++ ToolBox.
Скомпилировать и установить ModCbroker, в соответствии с Руководством Администратора ModCbroker
Скомпилировать и установить PIMR, в соответствии с Руководством Администратора ModCbroker
Скомпилировать и установить UAKGQueryService2, в соответствии с Руководством Администратора UAKGQueryService2
Скомпилировать и установить PartyManagement, в соответствии с Руководством Администратора PartyManagement
Зайти в корневую директорию дистрибутива исходных текстов Billing.
Запустить процесс конфигурации с помощью команды ./configure, указав в опциях конфигурации нахождения установленных пакетов
Запустить процесс компиляции с помощью команды gmake
Запустить процесс инсталляции с помощью команды gmake install
Скопировать директорию webresources в поддиректорию htdocs Apache
Зайти в подкаталог SDK
Запустить процесс конфигурации с помощью команды ./configure, указав в опциях конфигурации нахождения установленных пакетов
Запустить процесс компиляции с помощью команды gmake
Запустить процесс инсталляции с помощью команды gmake install
Зайти в подкаталог interfaces
Инсталлировать каждый из дополнительных компонент, следуя инструкциям, указанным в расположенных там файлах документации

2.2. Установка с помощью бинарного дистрибутива

2.2.1. Необходимое ПО

Операционная система - RedHat-8.0
Сервер БД - Oracle-9.*.*
Вспомогательное ПО - JRE-1.3.02 или выше

2.2.2. Необходимые предусловия инсталляции

Операционная система:
БД:

В текущем окружении определенны переменные среды ORACLE - ORA_HOME и NLS_LANG. Переменная среды PATH должна содержать путь к утилитам Oracle, а переменная среды LD_LIBRARY_PATH - к библиотекам. Критерий проверки - утилита Oracle sqlplus должна запускаться из текущего окружения.
База данных в Oracle создана с поддержкой национальных символов в кодировке по умолчанию. Причём при работе с базой данных должна правильно выполняться перекодировка кириллицы из кодировки CL8MSWIN1251 (кодировка данных внутри дистрибутива) в кодировку базы данных и наоборот. Критерий проверки - в базу данных можно внести кириллические символы в поля типа VARCHAR2 а потом их оттуда прочитать. Некоторые кодировки базы данных хотя и позволяют хранить русские символы на двоичном уровне, но перекодировка при этом выполняется неправильно, например, WE8ISO8859P1. Единственной кодировкой с поддержкой кириллицы в группе 8859 является WE8ISO8859P5.
В базе данных должен быть создан пользователь, которому предоставлены следующие права:

connect
resource
create any sequence
alter any sequence
drop any sequence
create any directory
drop any directory

JRE (Java Runtime Environment):

JRE должна быть доступна из текущего окружения. Используется только в процессе инсталляции и при деинсталляции.

2.2.3. Процесс инсталляции

Убедиться, что выполнены предусловия
Запустить инсталлятор, с помощью команды:

     java -jar Billing-2.*.jar

В процессе инсталляции заполнить следующие значения:

Bs-root	Папка для установки АСР
Bs-host	IP адрес сервера, на который устанавливается система.
Ora-home	Местонахождение инсталляции Oracle (`ORACLE_HOME`)
Web-port	Порт веб-сервера. (по умолчанию – 8081)
Web-https-port	Порт веб-сервера для протокола https. (по умолчанию – 8082)
Ns-port	Порт сервера имен (по умолчанию – 3901)
Query-port	Порт сервиса запросов (по умолчанию – 3902)
Db-login	Логин пользователя БД
Db-password	Пароль пользователя БД
Db-alias	Алиас баз данных

Включить вызов скриптa startBilling.sh в процесс загрузки системы.
Перейти к настройке утилит.

Для проверки успешности инсталляции, наберите в браузере адрес:

https://<bs-host>:<web-https-port>/

Логин и пароль администратора по умолчанию: admin/admin.

3. Настройка системы

3.1. Основные конфигурационные параметры

<bs-host> - хост, на котором расположен основной сервер биллинга.
<ns-port> - порт сервера имен.
<bs-root> - директория, в которую установлены компоненты АСР. Указывается при инсталляции. В целях упрощения изложения будем подразумевать, что компоненты АСР на всех компьютерах установлены в директории /usr/local/Billing

3.2. Некоторые предварительные сведения

Системный журнал: Все сервисы и системные утилиты используют для вывода сообщений об ошибках стандартный системный журнал syslog. Обычное местонахождение файла системных сообщений - /var/log/messages. Для параллельного вывода сообщений на экран терминала в целях отладки, все утилиты АСР используют опцию --dup-log-to-stderr
Файлы отсева: Файлы отсева АСР находятся в поддиректории /var/log/Billing в поддиректориях, соответствующей техническому типу услуги. Имя файла отсева соответствует шаблону <hname>.<method>.bk<nSeconds>.log где:

hname - технический вид сервиса.
method - метод сбора данных, обычно коррелирующий с именем соответствующей утилиты.
nSeconds - время создания файла (в количестве секунд по Гринвичу).

В том случае, если исходные данные по какой-то причине не принимаются биллинговой системой, то они направляются в файл отсева. Каждый запуск утилиты приводит к формированию нового файла отсева при наличии ошибок приема данных. Администратор должен регулярно следить за файлами отсева и устранять причины возникновения ошибок исходных данных. Все утилиты сбора информации также реализуют функциональность повторного чтения данных из файла отсева и передачу этих данных в биллинговую систему. Для этого используется опция командной строки --process-backlog. Заметим, что при обработке файла отсева может генерироваться новый файл отсева.

Режимы ввода. Мы различаем два основных режима ввода - offline и online. В режиме online данные периодически сбрасываются в биллинговую систему в режиме псевдо-реального времени. В режиме offline утилиты обрабатывают файлы журналирования устройств с определенной периодичностью, определяемой администратором системы, либо в ручном режиме.

3.3. Web-интерфейс АСР

После установки, web интерфейс пользователя биллинговой системы доступен по адресу http://<bs-host>:<web-port>, где <bs-host> - хост, где инсталлирован биллинг, <web-port> - порт доступа к Web-интерфейсу пользователя, который был указан при инсталляции. При вводе такого URL происходит автоматический редирект на http://<bs-host>:<web-https-port>/cbroker/BillingInfo/menu.

Веб-интерфейс администрирования доступен по адресу https://<bs-host>:<web-https-port>/cbroker/Billing/menu, где <web-https-port> - защищенный порт доступа.

3.4. Подключения АСР

Опишем несколько типовых конфигураций подключения Биллинговой системы к устройствам

3.4.1. Web-доступ через прокси

Схема сети изображена на рис. 3.1.

Рис 3.1. Схема подключения клиентов через прокси-сервер.

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

Для чтения данных в online режиме вставьте в скрипты запуска выражение

tail -f   /var/log/squid/access.log |   \

/usr/local/billing/bin/SquidCollector --online \

-ORBInitRef NameService=corbaloc::<bs-host>:<bs-port>/NameService &

где

Ø /var/log/squid/access.log - расположение лог-файла SQUID;

Ø /usr/local/billing - расположение инсталляции биллинговой системы;

Ø <bs-host> - IP адрес основного сервера АСР;

Ø <bs-port> - номер порта сервиса именования.

Для чтения данных в offline режиме вставьте в набор периодически запускающихся скриптов системы следующее выражение:

/usr/local/billing/bin/SquidCollector /var/log/squid/access.log \

-ORBInitRef NameService=corbaloc::<bs-host>:<bs-port>/NameService

Способ зависит от типа системы: можно воспользоваться либо crontab, либо /etc/periodic.

Для добавления авторизации определите в файле конфигурации squid.conf внешнюю авторизацию с помощью программы SquidAccessChecker. Вставить в файл конфигурации squid.conf следующие строки:

auth_param basic program /usr/local/Billing/bin/squid-auth.sh

auth_param basic children 5

auth_param basic realm Password checker [My ISP]

auth_param basic credentialsttl  1 hours

где

squid-auth.sh имеет следующий вид:

#!/bin/sh

LD_LIBRARY_PATH=/usr/local/Billing/lib:$LD_LIBRARY_PATH

export LD_LIBRARY_PATH

/usr/local/billing/bin/SquidAccessChecker -ORBInitRef NameService=corbaloc::<bs-host>:<bs-port>/NameService

3.4.2. Выделенные линии с подсчетом трафика с помощью SNMP

Схема сети приведена на рис 3.2.

Рис 3.2. Схема подключения выделенных линий через SNMP-устройство.

Как видно из рисунка, существуют три различные сущности:

устройство, предоставляющее SNMP статистику (определяется IP адресом);
интерфейс выделенной линии клиента, трафик по которой мы считаем (определяется IP адресом);
площадка, на которой расположен модуль АСР, считывающий эту статистику (определяется IP адресом).

Для того чтобы связать выделенную линию с клиентом, необходимо выделить клиенту идентификатор (login) и записать в справочнике выделенных линий (таблице идентификаторов IP адресов) АСР cледующую информацию:

Логин	Логин клиента
Community	SNMP community устройства, по умолчанию - public
Сеть абонента	IP сеть, доступ к которой проходит по этой выделенной линии в формате x.x.x.x/y. Если на стороне клиента один IP адрес, необходимо указать этот IP адрес
IP адрес площадки	IP адрес компьютера, на котором запущен SNMPCollector
Инвертирование направление	установить, если входящий трафик на этой линии надо считать исходящим (и наоборот)
Интерфейс	цифра, обозначающая номер интерфейса в SNMP таблице interfaces.ifTable.ifEntry
IP адрес устройства	Адрес SNMP устройства
Протокол мониторинга	Должно быть указано «snmp»

Чтение данных производится в online-режиме, в скриптах старта площадки, на которой должны работать тарификаторы, должна запускаться программа /usr/local/Billing/SNMPCollector.

Например, с помощью следующего скрипта:

#!/bin/sh

LD_LIBRARY_PATH=/usr/local/Billing/lib:$LD_LIBRARY_PATH

export LD_LIBRARY_PATН

/usr/local/billing/SNMPCollector -ORBInitRef NameService=corbaloc::<bs-host>:<bs-port>/NameService

Добавление авторизации при установлении соединения по выделенной линии зависит от способа построения сети:

Если устройство допускает радиус авторизацию, то используйте pam-модуль АСР /usr/local/billing/pam/lib_billing.so (подробнее - см. раздел),
Если допускает вызов внешней программы:

/usr/local/billing/bin/BillingAccessChecker --hname Inet \

 --login <login> \

 --password <password> \

 -ORBInitRef NameService=corbaloc::<bs-host>:<bs-port>/NameService

Если нет, то используйте BillingAccessChecker в скрипте изменения правил для firewall.

3.4.3. Выделенные линии с подсчетом трафика на UNIX-маршрутизаторе

Типичная схема сети изображена на рис 3.3.

Рис. 3.3. Схема подключения выделенной линии через Unix-маршрутизатор.

На маршрутизаторе работает модуль PCAPCollector, передающий тарифицирующую информацию в основной модуль АСР.

В этом случае в справочник выделенных линий (таблицу «Идентификаторы IP-адресов») необходимо занести следующую информацию:

Логин	Логин клиента
Сеть абонента	IP сеть, доступ к которой проходит по этой выделенной линии в формате x.x.x.x/y. Если на стороне клиента один IP адрес, необходимо указить этот IP адрес
IP адрес площадки	IP адрес компьютера, на котором запущен PCAPCollector
Интерфейс	Обозначение интерфейса, через который мы считаем трафик. Например - eth0
Протокол мониторинга	Должен быть указан «pcap»

Заметим, что должны быть внесены те сети клиентов, трафик которых считается с помощью pcap. Также имеет значение таблица 'области маршрутизации': для всех сетей клиента области маршрутизации должны быть локальными. Например, если клиенты размещены в сети 195.12.12.0/24, то в таблице областей маршрутизации должна находится запись

Загрузчик называется PCAPCollector. Для того чтобы им воспользоваться, вставьте в скрипты запуска команду:

#!/bin/sh

/usr/local/billing/bin/PCAPCollector  \

   -ORBInitRef NameService=corbaloc::<bs-host>:<bs-port>/NameService

Дополнительные опции, которые могут оказаться полезными:

-aggreagation-time <nsec>: Задает время в секундах, в течение которого мы накапливаем трафик, чтобы отдать его биллинговой системе.
-show-ip: Включает режим вывода на стандартный вывод заголовков пакетов.

Кроме клиентов, указанных в справочнике выделенных линий, PCAPCollector генерирует статистику для двух выделенных логинов:

LLTransit - неучтенный транзитный трафик на маршрутизаторе между двумя областями
LLocal - локальный неучтенный трафик на маршрутизаторе

Автоматическое отключение настраивается также как и в предыдущем примере.

3.4.4. Выделенные линии с подсчетом трафика с помощью CISCO NetFlow

Схема сети у нас показана на рис 3.4.

Рис 3.4. Схема подключения выделенной линии через Cisco NetFlow.

Для учета трафика с помощью Cisco NetFlow используется загрузчик NetFlowCollector.

В справочнике выделенных линий для каждой линии должны присутствовать следующие значения:

Логин	Логин клиента, с которым будет ассоциироваться выделенная линия
Услуга	Услуга (сервис), предоставляемая клиенту (LL)
Сеть абонента	ІP-сеть, доступ к которой происходит по этой выделенной линии, в формате x.x.x.x/y. Если с стороны клиента только один ІP-адрес, необходимо указать этот ІP-адрес
ІP-адрес площадки	ІP-адрес компьютера, на котором запущен NetFlowCollector
Порт	порт приема NetFlow трафика
ІP-адрес устройства	Адрес устройства NetFlow
Протокол мониторинга	Должен быть указан «netflow»

Маршрутизатор должен быть сконфигурирован так, чтобы посылать Netflow трафик на площадку, где работает модуль NetFlowCollector и на порт, который указан в справочнике.

Две особенности:

порт приема NetFlow трафика должен быть один и тот же на одной площадке.
при использовании 8-й версии NetFlow способ агрегирования должен быть prefix-matrix.

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

#!/bin/sh

/usr/local/billing/bin/NetFlowCollector  \

  -ORBInitRef NameService=corbaloc::<bs-host>:<bs-port>/NameService

Дополнительные опции, которые могут оказаться полезными:

-aggreagation-time <nsec>: Задает время в секундах, в течение которого мы накапливаем трафик, чтобы отдать его биллинговой системе.
-show-flow: Включает режим печати на стандартный вывод информации о трафике.

Автоматическое отключение пользователей настраивается с помощью pam-модуля.

3.4.5. Коммутируемые линии на основе серверов доступа, поддерживающих протокол Radius (MAX6000, CISCO, системы на основе UNIX)

В этом случае используется загрузчик RadiusCollector для чтения данных и модуль pam_billing.so для авторизации.

Для чтения данных в online режиме вставьте в скрипты запуска выражение

tail -f  /var/log/radact/HOST/detail.log |   \

         /usr/local/billing/bin/RadiusCollector --online \

    -ORBInitRef NameService=corbaloc::<bs-host>:<bs-port>/NameService &

где

/var/log/squid/access.log -расположение лог-файла SQUID.
/usr/local/billing - расположение инсталляции биллинговой системы.
<bs-host> - IP адрес основного сервера АСР.
<bs-port> - номер порта сервиса именования.

/usr/local/billing/bin/RadiusCollector /var/log/radact/HOST/detail.log \

    -ORBInitRef NameService = corbaloc::<bs-host>:<bs-port>/NameService

3.4.6. Некоммутируемые линии на основе протокола ppoe

В этом случае удобно использовать PCAPCollector для сбора трафика, а авторизацию производить посредством radius-сервера, используя PAM-модуль АСР.

3.4.7. Настройка авторизации сервиса с помощью Radius

Для использования радиус авторизации должно выполняться следующее:

· Операционная Система включает путь к библиотекам АСР в список путей динамической загрузки. Файл /etc/ld.so.conf должен содержать строку /usr/local/billing/lib

Для обновления списка путей динамической загрузки добавьте строку /usr/local/billing/lib в файл /etc/ld.so.conf и введите команду:

ldconfig -v

· Настроено обращение сервиса radius к модулю pam_billing.so (зависит от конфигурации pam на компьютере).

Случай 1. Существует каталог /etc/pam.d.

Необходимо вписать в файл /etc/pam.d/radiusd следующие строки:

auth required  /usr/local/billing/lib/pam_billing.so --hname Inet

-ORBInitRef NameService=corbaloc::<bs-host>:<bs-port>/NameService

aссount required /usr/local/billing/lib/pam_billing.so --hname Inet

-ORBInitRef NameService=corbaloc::<bs-host>:<bs-port>/NameService

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

Случай 2. Каталога /etc/pam.d не существует, но существует файл /etc/pam.conf

Необходимо вписать в этот файл следующие строки:

radiusd auth required  /usr/local-ob/lib/pam_billing.so --hname Inet

      -ORBInitRef NameService=corbaloc::<bs-host>:<bs-port>/NameService

radiusd aссount required  /usr/local-ob/lib/pam_billing.so --hname Inet

      -ORBInitRef NameService=corbaloc::<bs-host>:<bs-port>/NameService

4. Утилиты резервного копирования БД

4.1. Создание копии

Для создания резервной копии БД используется утилита экспорта БД ExportBillingDB.sh. Данная утилита для работы использует программу exp, входящую в поставку Oracle и командный интерпретатор sh.

Параметры для работы утилиты находятся в конфигурационных файлах BillingDB.cfg, environment.sh.

ExportBillingDB.sh запускается в интерпретаторе sh и не требует параметров.

После того как ExportBillingDB.sh отработает, копия состояния БД на текущий момент будет сохранена в подкаталоге ./var/backup/Billing в файле с именем:

export.{DB_name}.{user_name}.{yr}.{mnth}.{day}.{h}.{min}.{sec}.snap

где

{DB_name} - имя БД

{user_name} - имя пользователя

{yr}.{mnth}.{day} - дата создания копии БД

{h}.{min}.{sec} - время создания копии БД

В каталоге ./var/backup/Billing будет размещен лог файл с именем:

export.{DB_name}.{user_name}.{yr}.{mnth}.{day}.{h}.{min}.{sec}.log

4.2. Загрузка копии базы из файла в БД

Для импорта БД используют утилиту импорта БД ImportBillingDB.sh. Данная утилита позволяет загрузить в БД снимок базы, сделанный с помощью утилиты ExportBillingDB.sh. Для работы используется программа imp, входящая в поставку Oracle и интерпретатор sh.

Параметры для работы утилиты находятся в конфигурационных файлах BillingDB.cfg, environment.sh.

Для загрузки копии базы необходимо:

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

ImportBillingDB.sh ../var/backup/Billing/export.billingdb.dbuser.2003.07.23.04.39.47.snap

Данные утилиты предназначены для создания резервных копий БД, но не подходят для переноса данных из одной версии БС в другую. Утилита импорта ImportBillingBD.sh может внести данные из резервной копии только для того же пользователя, под которым эта копия была создана. Также необходимо не забыть перед импортом БД из резервной копии очистить БД. Это можно сделать, пересоздав пользователя БД.

5. Описание параметров запуска приложений командной строки

5.1. Опции, общие для всех программ АСР

-ORBInitRef NameService = <NameService-IOR> - эта опция определяет местонахождение CORBA-сервиса наименования. <NameService=IOR> должен иметь вид corbaloc::<bs-host>:<ns-port>;
--dup-log-to-stderr - дублировать всю информацию, направляющуюся в системный журнал, на терминал;
--help - вывести на экран список и значения опций;
--config <argument> - считать опции из файла конфигурации <argument>.

5.2. Сервисы

5.2.1. Основной модуль

--servlet-name <servlet-name> - имя сервлета, входящее в состав URL АСР ("Billing" по умолчанию);
--login <login> - логин для базы данных АСР (обязательный параметр);
--passwd <password> - пароль для базы данных АСР (обязательный параметр);
--db_link <db-link> - псевдоним (alias) базы данных АСР ("" по умолчанию);
--db_drv <db-driver> - драйвер для базы данных АСР ("Oracle8" по умолчанию), в данный момент поддерживается только "Oracle8";
--url-base <url-base> - URL, на который будут ссылаться изображения и java-скрипты;
--language <language-label> - язык интерфейса:

'ru' - русский.
'ua' - украинский.

--no-pimr - не использовать PIMR;
--logfile <log-file-name> - имя лог-файла;
<ORB-args> - параметры конфигурации ORB (обязательные параметры) - см. параметры конфигурации ORB, например:

·                   -ORBInitRef NameService = <NameService-IOR>

·                   -ORBInitRef UAKGQueryService2 = <UAKGQueryService2-IOR>

·                   -ORBInitRef PIMR = <PIMR-IOR>

·                   -ORBConnLimit=<n>

--no-pimr - не использовать репозиторий реализаций.

Параметры конфигурации ORB для основного сервиса:

-ORBInitRef NameService=X - аргумент должен быть объектной ссылкой на сервис имен CORBA и иметь вид: corbaloc::<bs-host>:<ns-port>/NameService
-ORBInitRef UAKGQueryService2=X - аргумент должен быть объектной ссылкой на сервис доступа к БД и иметь вид: corbaloc::<bs-host>:<ns-port>/NameService
-ORBInitRef PIMR = <PIMR-IOR> - аргумент должен быть объектной ссылкой на сервис репозитория и иметь вид: corbaloc::<bs-host>:<ns-port>/NameService

В случае, когда репозиторий реализаций не используется, должна быть включена опция --no-pimr

-ORBConnLimit=<n> - определить максимальное количество одновременных соединений.

5.2.2. Сервис доступа к БД

--log-sql - записывать в системный журнал все SQL запросы.
--log-to-file fname - дублировать всю информацию, направляющуюся в системный журнал, в файл fname.
--log-to-stderr - дублировать всю информацию, направляющуюся в системный журнал, на терминал.
--no-syslog - отключить вывод в системный журнал,
--with-naming - зарегистрировать объект получения доступа к БД в сервисе имен.
-ORBIIOPAddr=inet:<bs-host>:<qr-port> - определить IIOP адрес объекта получения доступа к БД (обязательно)
--help - вывести на экран список и значения опций
--config fname - считать опции из файла конфигурации fname

5.2.3. Сервиc связи с Web

Конфигурационные файлы сервиса связи с Web хранятся в конфигурационном файле <billing-root>/apache/conf/httpd.conf.

Кроме стандартных опций Apache там указаны команды связи с CORBA-инфраструктурой биллинговой системы.

Это директивы загрузки mod_cbroker, директива CbrokerORBArgs и конфигурация виртуальной директории /cbroker.

Директива CbrokerORBArgs. должна иметь вид:

CbrokerORBArgs -ORBInitRef NameService=corbaloc::<bs-host>:<ns-port>/NameService

а в конфигурации виртуальной директории /cbroker должен быть указан метод авторизации и имя сервлета АСР.

Более подробную информацию можно найти в руководстве по Apache и в руководстве по ModCbroker.

5.2.4. Сервис имен

-ORBIIOPAddr=inet:<bs-host>:<ns-port> - определяет хост и порт Name Service.

5.3. Утилиты

5.3.1. Общие опции для всех утилит

· -ORBInitRef NameService=X - аргумент должен быть объектной ссылкой на сервис имен CORBA и иметь вид: corbaloc::<bs-host>:<ns-port>/NameService. Эта опция является обязательной для всех утилит.

· --dup-log-to-stderr - дублировать вывод сообщений об ошибках, которые обычно пишутся в системный журнал, на терминал пользователя в стандартный поток сообщений об ошибках.

· --log-file <argument> - также выводить сообщения в файл <argument>

· --help - вывести на экран терминала перечень опций и краткие пояснения.

· --config <argument> - обработать опции из файла конфигурации <argument>

5.3.2. Общие опции для всех коллекторов

· --aggregation-time <argument> - определить промежуток времени агрегации, в секундах. Время агрегации - это время, за которое коллектор аккумулирует статистику, прежде чем передать ее в биллинг. Значение по умолчанию - 1 час, т. е. 3600 секунд

· --dup-put-to-stdout - выводить на терминал пользователя данные, передающиеся в биллинг.

· --process-backlog <argument> - обрабатывать файл отсева <argument>

· --service-log-dir <argument> - использовать <argument> как директорию для файлов отсева.

5.3.3. Опции, специфические для отдельных коллекторов:

· SNMPCollector

o --ppp-interface <argument> - использовать информацию о ppp соединениях, по интерфейсу <argumnent> (обычно это tun0 на FreeBSD или ppp0 на Linux)

o --update-time <argument> - периодичность запроса чтения данных SNMP

· NetflowCollector

o --local-as <argument> - задать аргумент как номер локальной автономной системы.

o --show-flow - выводить на терминал заголовки NetFlow пакетов.

o --use-as-areas - определять область маршрутизации на основании таблицы номеров AS, а не таблицы IP адресов, как обычно.

· PCAPCollector

Перед использованием PCAPCollector ознакомьтесь с разделом 3.4.3.

o --filter <argument> - передавать в биллинг информацию только о тех пакетах, которые удовлетворяют ip-фильтру <argument>

o --show-devices - вывести на терминал список интерфейсов, доступных для прослушивания.

o --show-ip - во время работы выводить на терминал информацию о прослушиваемых пакетах.

· RadiusCollector

o --date-format <argument>. Использовать формат даты <argument> (по умолчанию: '%a %b %d %T %Y')

o --online - читать лог Radius со стандартного ввода в режиме online. Обычно применение - использование вида:

tail -f /var/log/Billing/mylog.log | ./myProcessor --online

o --process-file <argument> - брать данные из файла <argument>

· SquidAccessChecker - это утилита, предназначенная для запуска из прокси-сервера squid версии 2.4.0 или выше.

o --suffix <argument> добавлять суффикс '@'<argument> к имени логина перед проверкой.

· BillingAccessChecker

o --hname <argument> - авторизовать для технического описания сервиса с именем hname. (Для Internet-а это Inet)

o --login <argument> - авторизовать логин <argument>

o --password <argument> - авторизовать по паролю <argument>.

6. Утилита экспорта данных

Утилита экспорта данных об оплатах и начислениях называется exportLedgerData и имеет следующие опции:

· --beg-time <argument> - определить начало периода, за который нам нужны данные.

· --end-date <argument> - определить конец периода, за которые нам нужны данные.

· --income-file <argument> - имя файла, куда выводить информацию об оплатах.

· --outgo-file <argument> - имя файла, куда выводить информацию о начислениях.

Формат данных начислений на лицевой счет имеет следующий вид: для каждой оплаты генерируется строка соответствующая шаблону

Лицевой счет пользователя: customer_id, Сервис: service_name', Сумма: payment ,Дата:date;

Формат данных списаний с лицевого счета имеет вид

Лицевой счет пользователя: customer_id, Сервис: service_name, Сумма: outgo, Тариф: tariff_component_name,Дата:date; '

Дата в формате 'DD:MM:YYYY'. Кодировка - Win1251.

7. Сообщения об ошибках

7.1. БД

Коды ошибок, используемые для связи сервлета и процедур базы данных АСР

Группа -20100 .. -20199. Не найдена запись, удовлетворяющая критериям поиска

-20101, 'update_basic_rates: item of treatment is absent'

Группа -20200 .. -20299 Действия, нарушающие ограничения целостности данных

Шкала ставок:

-20201, 'update_basic_rates: can not remove level: first level is persistent'
-20202, 'insert_basic_rates: can not remove level: another level fills this place'
-20203, 'update_basic_rates: forbidden value of level: level is negative'

Простой тариф (компонента тарифного плана):

    -20210,

    'TARIFF_ADMISSION_FEE: impossible period of validity'

    -20211,

    'TARIFF_AMOUNT_FEE: impossible period of validity'

    Тарифный план:

    -20220,

    'delete_tariff_card: must not delete default tariff card'

    Сервис-контракты: -20230 .. -20239

      -20230,

      'SERVICE_CONTRACTS: absurd period of validity'

      время начала действия сервис-контракта больше или равно времени конца

      -20231,

      'SERVICE_CONTRACTS: unwarranted set of parameters'

      нарушено условие уникальности для сервис-контрактов

      -20232,

      'SERVICE_CONTRACTS: forbidden change'

      запрещенные изменения:

      например,

        изменение тарифного плана,

        ставки кредитования,

        т.п.

    Области маршрутизации трафика: -20240 .. -20249

      -20240,

      'routing_areas: must not delete mandatory value '''||<name>||''''

      -20241,

      'routing_areas: must not rename mandatory value '''||<name>||''''

    Режимы доступа: -20250 .. -20259

      -20250,

      'TIME_BRACKETS_WEEK: impossible period of validity'

      -20251,

      'TIME_BRACKETS_MONTH: impossible period of validity'

      -20252,

      'TIME_BRACKETS_WEEK: unmeaning time span: '||

      'the time of the beginning is''nt less then time of the ending'

      -20253,

      'TIME_BRACKETS_MONTH: impossible time span: '||

      'the time of the beginning is''nt less then time of the ending'

      -20254,

      'TIME_BRACKETS_WEEK: unmeaning time span: '||

      'the day of the beginning is larger then day of the ending'

      (-20255: reserved)

      -20256,

      'TIME_BRACKETS_WEEK: unwarranted set of parameters'

      -20257,

      'TIME_BRACKETS_MONTH: unwarranted set of parameters'

Действия, нарушающие целостность данных, могут быть двух сортов:

а) запрещенные независимо от текущего состояния системы

    (напр.: установить отрицательное количество пользователей);

б) запрещенные в данном конкретном случае (напр.: такая ставка уже есть)

    Настройки: -20260 .. -20269

      -20260,

      'PROPERTIES: improper value of BILL_PROP_TMPL: personal account '''||<value>||' is absent'''

    Описание сервисов: -20270..-20279

      -20260,

      'SERVICES: the preffered service is already exists for '||hname

 Группа -20300 .. -20399

 Действия, связанные с некорректными входными данными, поступающими из устройств.

   -20301,'Unknown record type:'

       из устройства поступил заголовок с типом записи, который не зарегистрирован.

   -20302,'impossible qualifier position'

       некорректное описание формата входных данных в БД.

   -20303,'impossible integer amount position'

       некорректное описание формата входных данных в БД.

   -20304,'impossible double amount position'

       некорректное описание формата входных данных в БД.

   -20305,'impossible statistic position'

       некорректное описание формата входных данных в БД.

   -20306,'unknown item name:'

       из устройства поступило поле, описание которого нет в БД для формата записи устройства

   -20310,'erroneous data: span time is negative'

       продолжительность сеанса "уменьшилась" после того, как прошло еще немного времени

   -20311,'erroneous data: unknown login '''||TO_CHAR(login_)||''''

       из устройства поступили данные, привязанные к неизвестному логину,

       причем настройки системы не позволяют зарегистрировать его автоматически

 Группа -20500 .. -20599

 Ошибки конфигурирования системы

   -20500,'not enough data: value added tax has no set'

   -20501,'not enough data: sale tax has no set'

 Группа -20600 .. -2069

 Внутренние ошибки: ситуации, которых в принципе не должно быть,

 если данные вводились через интерфейс

   -20600,

   'internal error: a few service-contracts found for '''||TO_CHAR(login)||''''

7.2. Утилиты

7.2.1. Сообщения об ошибках, общие для всех утилит

"Can't resolve Naming Service initial reference" - невозможно разрешить ссылку на сервис имен. Администратор должен проверить наличие и правильность синтаксиса опции -ORBInitRef NameService=... при запуске соответствующей утилиты.
"Can't resolve Naming Service" - невозможно обратиться к Name Service. Уточняющее сообщение выводится в следующей строчке. В этом случае администратор должен проверить следующее:

правильность синтаксиса опции -ORBInitRef NameService=...
запущен ли сервис имен nsd на соответствующем хосте с соответствующей опцией -ORBIIOPAddr.
Если утилита и сервис имен запущены на разных хостах, проверить связь между ними.

Can't narrow NameService initial reference to correct type: (уточняющее сообщение) - невозможно привести объектную ссылку у нужному типу.
В этом случае администратор должен проверить следующее:

Скорее всего, по координатам, указанным в -ORBInitRef NameService=... запущен другой сервис
запущен ли сервис имен nsd на соответствующем хосте с соответствующей опцией -ORBIIOPAddr.
Если утилита и сервис имен запущены на разных хостах, проверить связь между ними.

"name 'BillingAPI' is not found in root context of NameService" - Проверьте, запущен ли основной сервер биллинга BillingServer.
"error during resolving BillingAPI: NamingContext::CannotPorceed" - как правило обозначает неправильную настройку механизма балансирования нагрузки в сервисе имен.
"gethostname failed" - ошибка в настройках сети UNIX системы, такие как отсутствие /etc/hosts либо нефункционирующий сервис DNS
"This machine have broken hostentry structure, check network configuration" -ошибка в настройках сети UNIX системы.
"Can't determinate local IP, inet\_ntoa failed. Check network configuration" - ошибка в настройках сети UNIX системы.
"Can't find not-localhost IP - are you connected?" - не найден сетевой интерфейс, отличающийся от локального. Обычно обозначает что у компьютера просто не настроены сетевые интерфейсы либо не работает ethernet карта.
"Can't open log file: (имя) reason: (уточняющее сообщение) - невозможно открыть файл журналирования сообщений. Проверьте разрешение на запись и существование каталога файлов журнала.
"exception during ORB shutdown: (уточняющее сообщение)" - никаких действий производить не нужно.
"billingAPI unavaliable: (уточняющее сообщение)" - проверьте одно из следующего

Запущен ли основной сервер биллинга
Если утилита и основной сервере запущены на разных хостах, проверить связь между ними.

"invalid aggregation time:(уточняющее сообщение)" - неправильно указан параметр --aggregation-time
"Can't open backlog file (имя) for writing. (уточняющее сообщение)" - невозможно открыть файл отсева (уточняющее сообщение). Проверьте разрешение на запись и существование каталогов для файла отсева.
"can't read record: (запись)" - невозможно прочитать запись из файла отсева.

o Проверьте, что файл отсева корректный.

o Проверьте, что этот файл отсева сгенерирован той утилитой, которую Вы запускаете.

"error during put\_one: (уточняющее сообщение)" - ошибка при передаче записи в биллинговую систему
"error during put: (уточняющее сообщение)":

o Убедитесь, что вы подаете на вход корректные данные.

o Если это сообщение из БД, действуйте в соответствии с указаниями в списке ошибок БД.

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

"InvalidData, item=(имя поля) why= (уточняющее предложение)"

Убедитесь, что вы подаете на вход корректные данные.
Если это сообщение из БД, действуйте в соответствии с указаниями в списке ошибок БД.

"InvalidKey" - Обратитесь к производителю ПО.
"Can't call BillingAPI: (уточняющее сообщение) " - проверьте одно из следующих:

Запущен ли основной сервер биллинга
Если утилита и основной сервере запущены на разных хостах, проверить связь между ними.
Проверить, запущен ли сервис имен nsd по адресу, указанному в опциях запуска утилиты
Проверить, что в параметрах запуска биллинга не указана опция api-name (ее не должно быть)

"impossible - unknown item type" - Обратитесь к производителю ПО.
"Can't get IpRoutingAreas: (уточняющее сообщение) ";
"Can't get AsRoutingAreas: (уточняющее сообщение) ";
"Can't load LL info, exiting (уточняющее сообщение) " - Эти сообщения означают, что утилита не может связаться с сервером биллинга для получения служебной информации. Необходимо проверить наличие процессов BillingServer и UAKGQuery.
"Invalid IP net (сеть) in routing areas, skipping" - Это сообщение показывает, что в БД занесена некорректная информация о области маршрутизации. Как правило - следствие внесение данных в БД без помощи штатных средств биллинговой системы. Необходимо в таблице IP областей маршрутизации привести все адреса IP сетей к виду x.x.x.x/y.
"Can't transform string (строка) to ip net address :(уточняющее сообщение)". -Это сообщение показывает, что в БД занесена некорректная информация о области маршрутизации. Как правило - следствие внесение данных в БД без помощи штатных средств биллинговой системы. Необходимо в таблице идентификаторов IP адресов привести все адреса IP сетей к виду x.x.x.x/y.
"error during read record: (запись) (уточняющее сообщение) - Это сообщение появляется в утилитах, которые читают лог-файлы прикладного ПО. Администратор системы должен проверить – соответствует ли читаемый файл тому формату, который читает утилита.
"--online and --process-file options are non compatible" - утилита запущена с опциями, которые противоречивы. Необходимо исправить опции утилиты в скрипте запуска.
"Can't open file (имя файла) for reading:" - невозможно открыть файл для чтения. Проверьте существования файла, права доступа к нему и существование каталога.
"none from processing options (список опций) is set" - для запуска утилиты необходимо указать одну из опций в списке.
"option (опция) require argument" - опция, требующая обязательного аргумента, указана в командной строке без него.

7.2.2. PCAPCollector

"No entries for pcap monitoring for my IP address" - Означает, что в БД биллинга в таблице информации о выделенных линиях не найдено информации о данном коллекторе. Администратор должен проверить информацию о выделенных линиях и откорректировать данные.
"Error in pcap\_findalldevs: (детализированное сообщение об ошибке)" - обычно обозначает ошибку в конфигурации UNIX-маршрутизатора.
"No pcap devices was found":

Запуск PCAP произведен от лица пользователя UNIX системы, не обладающего полномочиями суперпользователя.
Маршрутизатор отключен от сети.
В ядро системы не включен опция поддержки драйвера тунеллирования.

"No entries for interfaces in Billing Database" - В таблице информации о выделенных линиях не найдено информации о интерфейсах, с которого pcap может осуществлять мониторинг. Администратор должен проверить поле интерфейс в таблице информации о выделенных линиях и откорректировать данные.
"Can't open pcap device (имя устройства): <детализированное сообщение об ошибке>" - обычно обозначает ошибку настройки сети.
"Error setting the filter for interface " - Проверить синтаксис опции командной строки --filter.
"Can't load snap file: first-time call ?" - Это сообщение возникает тогда, когда PCAPCollector не может открыть файл, со сброшенной статистикой. Это сообщение нормально, если PCAPCollector стартует в штатном режиме, а не после сбоя.
"Can't open file <имя файла> for writing" - Невозможно открыть файл для записи. Администратор должен проверить права доступа и наличие директории для соответствующего файла.

7.2.3. SNMPCollector

"invalid update time:(уточняющее сообщение)"

- неправильно указан параметр --update-time.

"parameter --update-time is not set"

- параметр --update-time не установлен.

"--aggregation-time is less then --update-time"

- время агрегации не может быть меньше времени обновления данных.

"failed connection:(уточняющее сообщение)"

- не удалось соединиться с SNMP агентом. Проверить правильность задания параметров SNMP агента.

"failed read:(уточняющее сообщение)"

- не удалось получить информацию об объекте с SNMP агента. Проверить правильность задания интерфейсов для SNMP агента.

"timeout:(уточняющее сообщение)"

- время ожидания ответа от SNMP агента истекло. Проверить правильность задания параметров SNMP агента.

"not found:(уточняющее сообщение)"

- не удалось найти интерфейс на SNMP агенте. Проверить правильность задания интерфейсов для SNMP агента.

"no one snmp device found for"

- ни один SNMP агент не задан для данной площадки. Проверить правильность задания параметров SNMP агента.

"no one ppp interfaces found for"

- ни один ppp интерфейс не задан для данной площадки. Проверить правильность задания параметров SNMP агента для ppp интерфейса.

Примечание: предупреждение действительна только для SNMPCollector-а,

поддерживающего снятие данных по ppp через SNMP.

7.2.4. NetFlowCollector

"bad packet - unknown netflow version" - в трафике netflow получен пакет, с некорректным байтом версии. Необходимо проверить, что по адресу, указанному в идентификаторах IP адресов действительно генерируется netflow трафик.
"Invalid packet(len must be bigger from (адрес)" - в трафике netflpw получен пакет с некорректным байтом длинны. Необходимо проверить, что по адресу, указанному в идентификаторах IP адресов действительно генерируется netflow трафик.
"bad aggregation of netflow V8 packet: must be set to PREFIX\_MATRIX method" - тип агрегирования в конфигурации маршрутизатора установлен в значение, отличное от PREFIX\_MATRIX. Необходимо переконфигурировать маршрутизатор.
"bad V8 packet: unknown aggregation from (адрес)" - в трафике netflow получен пакет, с некорректным байтом типа агрегации. Необходимо проверить, что по адресу, указанному в идентификаторах IP адресов действительно генерируется netflow трафик.
"AS number 0: misconfiguration encoured"

Используется определение областей маршрутизации по автономной системе следующего хопа пакета, но netflow коллектор запущен без опции --local-as
Используется определение областей маршрутизации по автономной системе следующего хопа пакета, но используемая версия протокола netflow не поддерживает передачу этих данных.

"local-as option argument is invalid:" - неправильный аргумент опции --local-as
"socket call failed: (уточняющее сообщение)" - ошибка конфигурации сети.
"bind call failed: (уточняющее сообщение) " Проверьте одно из следующих

Порт занят какой-то другой программой.
Вы пытаетесь запустить вторую копию NetFlowCollector, в то время, как одна уже работает.

"select failed: (уточняющее сообщение)" - ошибка конфигурации сети.
"recvfrom failed: (уточняющее сообщение)" - ошибка конфигурации сети либо на вход подается неправильный протокол.
"Can't load snap file: first-time call ?" - Это сообщение возникает тогда, когда NetFlowCollector не может открыть файл, со сброшенной статистикой. Это сообщение нормально, если NetFlowCollector стартует в штатном режиме, а не после сбоя.
"Can't open file <имя файла> for writing"; - Невозможно открыть файл для записи. Администратор должен проверить права доступа и наличие директории для соответствующего файла.

7.2.5. RadiusCollector

"warning: [Stop|Start|Interium-Update] Packet without attribute (имя атрибута)" - в файле есть запись о пакете, без атрибута с именем, приведенным в сообщении, которое там должно быть. Проверьте, что файл не поврежден.
"warning: unknown packet type, skipping" - в файле есть запись о пакете, с неизвестным типом (полем Acct-Status-Type). Проверьте что файл не поврежден, и если такой тип действительно присутствует в генерируемом файле - свяжитесь с разработчиками.
" warning: empty value in key-value pair. "- Во время обработки лог-файла встретилась строка типа 'Name=' что нехарактерно для правильного Radius файла.
" warning: single " in key-value pair. " - Обработанная строка не в формате Radius-Detail. Проверьте правильность файла.
" warning: can't file '=' in key-value pair". - Обработанная строка не в формате Radius-Detail. Проверьте правильность файла.
" warning: tab instead of date string - non detail file ? " - Обработанная строка не в формате Radius-Detail. Проверьте правильность файла.
" warning: Bad name in snap-file" - снап-файл, записанный радиус-коллектором, содержит некорректную информацию. Скорее всего этот файл подтвержден либо не совпадают версии коллектора, который читает снап-файл и коллектора, который его записал.
" unhandled exception: <текст сообщения> " - произошло прерывание, обработка которого не предусмотрена. Свяжитесь с разработчиками ПО.

7.2.6. SquidCollector

"double initialization of SquidCollector singleton" - внутренняя ошибка программы. Обратитесь к разработчику.
"SquidCollector singleton is not initialized" - внутренняя ошибка программы. Обратитесь к разработчику.
"Invalid service name: check input file"- не задано имя сервиса. Проверьте правильность задания имени сервиса.
"Invalid hname: check input file" - не задан технический вид сервиса. Проверьте правильность задания hname.
"stop-time mark is incorrect" -формат времени неправильный. Формат времени должен соответствовать количеству секунд с 1 января 1970 года.

7.2.7. SquidAccessChecker

" Can't connect to Billing Main Server (уточняющее сообщение)” - невозможно соединиться с основным сервером биллинга. Проверьте что сервер биллинга запущен и что в опциях правильно указано имя хоста основного сервера.
" Billing::ServerError (серверное сообщение)” - во время авторизации произошла ошибка на сервере биллинга.

7.2.8. pam_billing

"Billing::ServerError (уточняющее сообщение)" - произошла ошибка при передаче данных о текущем соединении. Проверьте корректность входных данных по уточняющему сообщению.
"Can't connect to Billing Server: (уточняющее сообщение) " - модуль не может связаться с основным сервером биллинга. Проверьте

Запущен ли основной сервер биллинга.
Есть ли связь между компьютером, на котором запущен биллинг и компьютером, на котором исполняется данный модуль.

" pam_billing: unknown error after unsuccesfull initialization" – сбой в работе после неуспешной инициализации модуля. Необходимо исправить параметры инициализации, исходя из предыдущих сообщениях об ошибках и перезапустить программу, использующую данный модуль.

8. Назначение и условия применения

8.1. Основные функциональные возможности системы

Автоматизированная система учета и тарификации интернет-услуг «Град-Р» поддерживает реализацию следующих основных функций:

· Работа с пользователями

Ø Создание учетной карточки пользователя

Ø Создание пользователя коммутируемого соединения

Ø Создание пользователя выделенной линии

Ø Ведение учетной карточки пользователя для физических/юридических лиц

Ø Просмотр истории изменения реквизитов пользователей

Ø Автоматический учет потребления услуг клиентом

Ø Автоматическая тарификация услуг

Ø Автоматическое ведение лицевого счета пользователя

Ø Просмотр истории баланса счета

Ø Автоматическое формирование счетов, на оплаты различных типов – авансовая и кредитная схема

Ø Внесение платежей и их привязка к счетам

Ø Автоматическое предупреждение пользователей по электронной почте о необходимости внесения оплаты

Ø Ведение автоматического контроля процесса доступа в зависимости от баланса счета пользователя

Ø Автоматическая отправка счета на оплату услуг по электронной почте

Ø Формирование детальной статистики использования услуг пользователем за определенный период времени

Ø Ведение записей истории работы с клиентом

Ø Ведение справочника пользователей, с расширенными возможностями поиска

Ø Ведение работы с пользователями с учетом различных подразделений продаж

Ø Предоставление клиенту доступа к своему лицевому счету, детальной статистике и реквизитам, с возможностью принятия/не принятия счета

· Тарификация услуг, в том числе:

Ø Создание редактирование тарифицируемых услуг.

Ø Создание, редактирование сервисных тарифных планов, позволяющее формировать сумму оплаты, учитывая:

o объем использованного ресурса

o количество актов доступа к ресурсу

o время доступа: даты, часы, дни недели

o области маршрутизации

o площадку, через которую получен доступ к ресурсу

o тип трафика: входящий, исходящий, общий; выбрать максимум из входящего, исходящего

Ø БС позволяет назначать:

o сроки действия тарифных составляющих

o абонентскую плату

o период времени и количество ресурса, которые предоставляются за абонентскую плату

o квоту на потребление ресурса на определенный период времени

o плату за превышение квоты на ресурс

Ø Ограничение доступа на определенные часы, даты, дни недели – задается группой ограничений по времени

o создание, редактирование ограничений по времени

o ведение справочника ограничений по времени

Ø Ведение справочника областей маршрутизации

Ø Ведение справочника IP-адресов

Ø Ведение справочника автономных систем

Ø Ведение справочника тарифных зон

Ø Ведение справочника выделенных линий

· Автоматическое формирование отчетов

· Автоматическое создание графиков

· Администрирование системы:

Ø Ведение справочника курса валюты

Ø Ведение справочника бизнес центров

Ø Ведение справочника подразделений продаж

Ø Делегирование прав пользователей в системе

Ø Редактирование текста предупреждения пользователю о низком балансе счета

Ø Работа с первичными данными от тарифицирующих устройств

8.2. Условия работы с БС

Условия поддержки корректной работы БС смотрите подробнее в документе «АСР «Град-Р»: Руководство администратора».

Доступ к установленной и работающей БС пользователь может получить, если конфигурация его компьютера позволяет установку хотя бы один из следующих браузеров Интернет:

· Internet Explorer версии 5.0 и выше,

· Konqueror версии 3.0 и выше

· Mozilla 1.0 и выше

· Netscape Communicator 4.78 и выше

Работа пользователя с БС осуществляется через браузер Интернет.

8.3. Пользователи БС

Пользователями БС, в первую очередь, являются рабочие компании провайдера Internet услуг и дилеры. Их разделяют по правам доступа к данным БС на следующие группы

· Администратор ('Administrator')- пользователь БС, который фактически имеет доступ ко всем данным БС. Кроме того, лишь администратор имеет возможность назначать права доступа пользователю БС и определять его подразделение.

· Директор ('Chief') - имеет доступ к данным любого пользователя БС, может редактировать документы, открытые любым другим пользователем БС.

· Менеджер ('Manage/operator') - имеет доступ к данным пользователей своего подразделения и пользователей, которые не относятся ни к одному из подразделений. Имеет возможность редактировать документы, которые вносил сам или их вносили дилеры и пользователи его подразделения.

· Дилер ('Dealer') - имеет ограниченный доступ к данным пользователей, за которых он отвечает. Имеет возможность редактировать документы, которые вносил сам или их вносили "его" пользователи.

Все вышеперечисленные группы пользователей объединены понятием Оператор БС.

Другой основной группой пользователей являются конечные пользователи - потребители Internet услуг:

· Пользователь ('End user') - имеет ограниченный доступ только к своим данным.

8.4. Права пользователей БС

8.4.1. Права пользователей группы «Администратор»

Пользователь с правами «Администратора» имеет доступ к следующим данным БС:

· Полный список пользователей БС. Все данные о пользователях БС с возможностью добавления, редактирования и удаления.

· Курс валюты с возможностью редактирования.

· Список бизнес центров с возможностью добавления, редактирования и удаления.

· Тарифы и услуги с возможностью добавления, редактирования и удаления.

· Работать с набором отчетов администратора

· Работать со статистической информацией представленной в виде графиков

Только «Администратор» имеет право доступа к следующей информации:

· Список подразделений продаж с возможностью добавления, редактирования и удаления. А также возможность приписывать пользователя к подразделению.

· Список операторов БС с возможностью изменений прав операторов.

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

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

Только «Администратор» имеет возможность изменять права пользователя - уровень доступа к БС.

8.4.2. Права пользователей группы «Директор»

Пользователь с правами «Директор» имеет доступ к данным всех пользователей БС.

Используя БС, «директор» может сделать следующие действия:

· Найти пользователей:

Ø По логину

Ø По реквизитам пользователя

· Работать с данными клиентов

Ø Просмотреть состояние счета

Ø Просмотреть договоры с возможностью редактирования, добавления

Ø Просмотреть выписанные счета с возможностью

добавления
печати
отправления электронной почтой
определения, был ли счет оплачен
удаления счетов.

Ø Просмотреть и отредактировать информацию о сделанных пользователем платежах. Оплата ведется в условных единицах по курсу БС на этот день.

Ø Просмотреть реквизиты пользователя с возможностью редактирования.

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

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

Ø Просмотреть детальную статистику пользователя

Ø Назначить ответственного дилера.

· Работать с набором отчетов директора.

· Работать со статистической информацией представленной в виде графиков

· Работать с услугами

Ø Просмотреть и редактировать услуги

Ø Создавать новые услуги

Ø Удалять услуги

Ø Создавать и назначать тарифы

· Редактировать текст и тему предупреждения, которое отправляется пользователям.

· Просматривать и редактировать названия бизнес центров.

· Просматривать и редактировать курсы валюты

8.4.3. Права пользователей группы «Менеджер»

Пользователь с правами «Менеджер» имеет доступ к данным пользователей только из своего подразделения и к пользователям, не относящимся ни к одному из подразделений.

Используя БС, «менеджер» может сделать следующие действия:

· Найти пользователей (среди своих клиентов):

Ø По логину

Ø По реквизитам пользователя

· Работать с данными своих клиентов

Ø Просмотреть состояние счета

Ø Просмотреть договоры с возможностью редактирования и добавления

Ø Просмотреть выписанные счета с возможностью

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

Ø Просмотреть и отредактировать информацию про сделанные пользователем платежи. Оплата ведется в условных единицах по курсу БС на этот день.

Ø Просмотреть реквизиты пользователя с возможностью редактирования.

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

Ø Просмотреть, к какому бизнес центру принадлежит клиент и возможность редактирования своих записей

Ø Просмотреть детальную статистику пользователя

Ø Назначить ответственного дилера

· Работать с набором отчетов менеджера.

· Работать со статистической информацией представленной в виде графиков.

· Работать с услугами

Ø Просматривать и редактировать услуги

Ø Создавать новые услуги

Ø Удалять услуги

Ø Назначать тарифы

· Редактировать текст и тему предупреждения, которое посылается пользователям

· Просматривать и редактировать названия бизнес центров

· Просматривать и редактировать курсы валюты

8.4.4. Права пользователей группы «Дилер»

Пользователь с правами «Дилер» имеет доступ к данным только «своих» пользователей.

Используя БС, дилер может сделать следующие действия:

· Найти пользователей (среди своих клиентов):

Ø По логину (идентификатору)

Ø По реквизитами

· Просмотреть такие данные про своих клиентов:

Ø Состояние счета

Ø Детальную статистику

Ø Реквизиты пользователя

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

Ø Выписанные счета с возможностью добавления, печати и удаления счетов. Счета, которые были занесены другим лицом, удалить невозможно

Ø Набор отчетов дилера

Также дилер может выступать в роли потребителя Интернет услуг. Он имеет возможность просмотреть свои данные по использованию Интернет.

Дилер так же может получить необходимую информацию касающуюся тарификации услуг:

· Просмотреть тарифные планы, указанные в его договоре.

· Просмотреть все тарифные планы поддерживаемые провайдером.

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

8.4.5. Права пользователей группы «Пользователь»

Пользователь с правами «Пользователя» имеет доступ только к своим данным.

· Состояние счета (текущий баланс и баланс за минувшие 12 месяцев)

· Детальную статистику (за указанный пользователем период времени).

· Выписанные счета с возможностью принятия/отклонения, печати, отправки по электронной почте и предупреждения о том, что счет был получен. Также есть возможность выписать себе счет.

· Просмотр и редактирование своих реквизитов, входящих в «учетную карточку пользователя».

· Просмотреть тарифные планы, указанные в его договоре.

· Просмотреть все тарифные планы поддерживаемые провайдером.

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

9. Начало работы с программой

9.1. Работа с программой после установки

Предполагается, что установлены все модули БС и запущенны все необходимые утилиты и исполняемый файл BillingServer (смотрите первые главы данного руководства).

После первого запуска доступ к БС имеет пользователь с правами «Администратора».

Администратор БС регистрирует пользователей БС, заводит для них входные идентификаторы и пароли, назначает права доступа к БС. Далее создавать пользователей, назначать для них входные идентификаторы и пароли могут также и пользователи с правами «директора» или «менеджера».

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

9.2. Доступ к БС и авторизация пользователей

Доступ к БС предоставляется через Web-интерфейс, URL дает провайдер. Существует два URL: для входа конечных пользователей и для входа операторов БС – сотрудников фирмы провайдера (см. п 3.3).

Для того, чтобы получить доступ к интерфейсу БС, пользователь должен обратиться по определенному URL и пройти авторизацию. Форма авторизации представлена на рис 9.1.

Рис 9.1. Форма авторизации пользователя

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

Если входной идентификатор и пароль введены правильно, то пользователь получает доступ к интерфейсу БС.

После успешной идентификации пользователя системой, на экран будет выведено главное меню для работы с БС, состав которого зависит от прав доступа пользователя.

Если пароль или/и идентификатор были введены ошибочно, то доступ к системе не разрешается. В этом случае пользователю необходимо повторить попытку авторизации.

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

10. Интерфейс БС

Интерфейс пользователя БС представляет собой совокупность меню, форм и таблиц, позволяющих настраивать систему и управлять ею согласно уровню доступа.

10.1. Система меню и навигация

Система меню БС представлена главным и выпадающим меню. Вид главного меню зависит от прав пользователя. На рис 10.1 изображено главное меню «администратора». Если навести курсор мыши на пункт главного меню, то появится выпадающее меню.

Пункты главного меню

Пункты выпадающего меню

Рис 10.1. Главное и выпадающее меню (рабочее место «Администратора»)

Кроме того, для работы с определенным пользователем существует «Основное меню для работы с пользователем».

Основное меню для работы с пользователем предоставляет возможность быстрого перехода к формам для работы с договорами, счетами, сервис контрактами конкретного пользователя, с его реквизитами и т.п. Оно находится под главным меню (см. рис 10.3).

Подробное описание меню для каждой группы пользователей представлено в соответствующих разделах данного руководства:

· Рабочее место пользователя с правами доступа «администратора» (раздел 10.6.1.)

· Рабочее место пользователя с правами доступа «директор» или «менеджер» (раздел 10.6.2.)

· Рабочее место пользователя с правами доступа «дилер» (раздел 10.6.3.)

· Рабочее место пользователя с правами доступа «пользователь» (раздел 10.6.4.)

В БС широко используется навигация между формами и управление с помощью ссылок – подчеркнутый текст, что позволяет разгрузить систему меню и предоставляет дополнительный способ действия и переключения между формами.

10.2. Формы

Доступ к выполнению различных операций в БС пользователь получает с помощью форм интерфейса БС.

Пример формы и ее элементов, таких как кнопки, поля для ввода и поля для выбора данных, показан на рис 10.2. Также пример формы представлен на рис 10.3.

Поле для выбора данных

Кнопка

Поле для ввода

Рис 10.2 Форма «Курс валюты» (рабочее место «Администратора»)

Кнопка рядом с полем для выбора даты (как здесь, так и на других формах) позволяет подставить в поле текущую дату.

Кнопки «Изменить», «Внести», «Подтвердить» и «ОК» означают принятие к сохранению текущих значений, введенных в поля формы.

Кнопки «Вернуться», «Отменить» означают отказ от сохранения введенных значений и оставляют данные без изменений.

Кнопки «Далее» и «Назад» выполняют функции навигации в последовательности форм.

Переход к формам БС осуществляется посредством выбора нужного пункта главного или выпадающего меню, а также при работе с мастерами по созданию пользователей, где навигация между формами осуществляется с помощью кнопок.

10.3. Таблицы форм

Форма БС может быть представлена в виде таблицы. Пример таблицы смотрите на рис 10.3.

Рис 10.3. Форма «Платежи» (рабочее место «Администратора»)

Общие операции при работе с таблицами форм БС

· подчеркнутый голубой знак + - добавить строку в таблицу;

· подчеркнутый красный знак х - удалить строку из таблицы;

· подчеркнутый синий знак * или номер 1, 2 и т.п. - внести изменения в строку таблицы;.

· подчеркнутый голубой знак .. - отображения в таблице строк с истекшим сроком действия (например, сервис-контракты)

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

В окне отображается первые 20 строк таблицы. Для навигации по таблице используются подчеркнутые знаки под таблицей:

· подчеркнутый синий знак '<<' - предыдущие 20 строк;

· подчеркнутый синий знак '>>' - следующие 20 строк.

Подчеркнутое название колонки таблицы позволяет выполнить сортировку строк по алфавиту.

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

Подчеркнутые голубые знаки 1..50 (числовые диапазоны в строке под заголовком и внизу таблицы) – быстрая навигация между наборами строк в таблице.

Данные обозначения универсальны для всех форм-таблиц в БС и могут встречаться в различных комбинациях в разных формах БС.

10.4. Пункт меню «Помощь»

Для получения подсказки по пункту меню, в котором работает пользователь БС, необходимо щелкнуть по пункту Помощь главного меню. После этого появится пункт справки БС, в котором будут описаны возможные действия с формой.

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

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

10.5. Выходные документы

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

Рис 10.4. Шаблон извещения для оплаты через банк.

Обозначения на рис 10.4:

$1	Сокращенное название исполнителя
$2	ИНН исполнителя
$3	Расчетный счет исполнителя
$4	Название банка
$5	Корреспондентский счет
$6	БИК банка исполнителя
$7	ФИО
$8	Город
$9	Улица, дом, квартира
$10	Номер договора
$11	Дата заключения договора
$12	Номер счета
$13	Дата открытия счета
$14	Сумма платежа
$15	Дата платежа

Рис 10.5. Шаблон счета.

Обозначения на рис 10.5:

$1	Название фирмы провайдера
$2	Почтовый индекс провайдера
$3	Район
$4	Город
$5	Телефон
$6	Налоговый номер получателя
$7	Краткое название получателя
$8	Номер счета получателя платежа
$9	Название банка получателя
$10	БИК
$11	Номер счета получателя в банке
$12	Номер счета
$13	Дата выписки счета
$14	Общая стоимость предоставленных услуг без НДС
$15	Величина НДС
$16	Общая стоимость предоставленных услуг с НДС
$17	Полная сумма счета
$18	Фамилия и инициалы руководителя
$19	Фамилия и инициалы главного бухгалтера
$20	Номер договора
$21	Дата заключения договора
$22	Единица измерения товара (услуги)
$23	Количество предоставленных товаров (услуг)

Рис 10.6. Шаблон акта приема-сдачи работ.

Обозначения на рис 10.6:

$1	Конечный срок действия договора
$2	Сокращенное название исполнителя
$3	Сокращенное название клиента (Фамилия и инициалы для физического лица)
$4	Город исполнителя
$5	Улица, дом и квартира исполнителя
$6	Город заказчика
$7	Улица, дом и квартира заказчика
$8	Название банка исполнителя
$9	Название банка клиента
$10	БИК исполнителя
$11	БИК клиента
$12	Расчетный счет исполнителя
$13	Расчетный счет клиента
$14	Код ОКПО исполнителя
$15	Код ОКПО клиента
$16	Должность исполнителя
$17	Должность клиента
$18	Фамилия, имя и отчество исполнителя полностью
$19	Фамилия, имя и отчество клиента полностью
$20	Фамилия и инициалы исполнителя
$21	Фамилия и инициалы клиента
$22	Номер договора
$23	Дата заключения договора
$24	Общая стоимость предоставленных услуг без НДС
$25	Величина НДС
$26	Общая стоимость предоставленных услуг с НДС
$27	Сумма со скидкой без НДС
$28	Сумма со скидкой с налогом
$29	Расшифровка суммы прописью
$30	Текущая дата
$31	Дата начала действия сервис-контракта
$32	Дата окончания действия договора
$33	Номер счета клиента
$34	Дата открытия счета

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

10.6. Рабочие места пользователей

10.6.1. Рабочее место пользователя с правами доступа «Администратора»

Главное меню

Главное меню пользователя с правами «администратора» (наиболее полное меню) имеет вид, представленный на рис 10.7.

Рис 10.7. Главное меню рабочего места «Администратора»

Пункты главного меню содержат следующие подпункты:

· Пункт Пользователи содержит подпункты:

Ø Список пользователей – полный список пользователей БС;

Ø Вне подразделений – список пользователей вне подразделений продаж;

Ø Поиск – поиск пользователя по реквизитам;

Ø Поиск по идентификатору – поиск пользователя по идентификатору;

Ø Новый пользователь

…выделенной линии – создание пользователя выделенной линии;

…коммут. соединение – создание пользователя коммутируемого соединения;

…только карточка – создание пользователя без указания создания договора;

Ø Статистика – просмотр статистики всех пользователей (поиск пользователя по идентификатору и подразделениям).

· Пункт Отчеты содержит все существующие в БС отчеты, в том числе:

Ø Состояние счетов – отчет по состоянию счетов пользователей;

Ø По тарифу – отчет по сальдо пользователей, подключенных по определенному тарифному плану;

Ø Регистрация действий – журнал регистрации действий операторов БС;

Ø Книга продаж - отчет по продажам за определенный период времени;

Ø Трафик - отчет по объему трафика в БС за определенный период времени;

Ø Интенсивность трафика - отчет по интенсивность трафика в БС за определенный период времени;

Ø Список должников - отчет по клиентам с отрицательным сальдо лицевого счета. Так же указывается сумма задолженности;

Ø Реестр счетов - отчет по счетам, выписанные за определенный период времени;

Ø Реестр оплат - отчет по платежам, которые проводились через БС за определенный период времени;

Ø Приход по VoIP – отчет по ожидаемому приходу для услуги VoIP;

Ø Доходы по услугам – отчет о прибыли по всем услугами, предоставляемым провайдером;

· Пункт Графики содержит все пункты позволяющие формировать статистическую информацию по использованию ресурсов в графическом виде, в том числе;

Ø Доходы по сервисам – график прихода и начисления сумм за предоставление различных видов сервиса;

Ø Выделенные линии (дни) – график загрузки выделенных линий по дням;

Ø Выделенные линии (часы) – график загрузки выделенных линий по часам;

Ø Модемный пул – график загрузки модемного пула;

Ø Прокси сервер (дни) – график загрузки прокси сервера по дням.

· Пункт Услуги содержат подпункты:

Ø Тарифные планы – создание, редактирование тарифных планов;

Ø Услуги – создание, редактирование услуг;

Ø Режим доступа – создание, редактирование ограничений по времени (ограничений времени действия тарифных составляющих по датам, часам, дням недели).

· Пункт Разное содержит подпункты:

Ø Предупреждения – редактирование предупреждения отсылаемого пользователю в случае низкого баланса счета;

Ø Бизнес-центры (если включено в конфигурацию БС) – создание, редактирование бизнес центров;

Ø Курс валюты – установка курса валюты в БС;

Ø Параметры – назначение пользователя, реквизиты которого будут использоваться для оформления официальных документов, ставок налогов.

· Пункт Администратор содержит подпункты:

Ø Операторы – список операторов БС изменение их прав доступа;

Ø Подразделения – список подразделений продаж, их создание и редактирование;

Ø Привязка устройств – список площадок и ключей модулей тарификации БС установленных на этих площадках;

Ø Зоны маршрутизации - справочник областей маршрутизации;

Ø Зоны IP-сетей – справочник сетей и выбор для них областей маршрутизации;

Ø Зоны автономных систем - справочник автономных систем и выбор для них областей маршрутизации;

Ø Тарифные зоны VoIP – зоны тарификации VoIP;

Ø Выделенные линии - справочник выделенных линий;

Ø Внесенные файлы - справочник фалов первичных данных, загруженных в БС вручную;

Ø Настройки – набор параметров системы, таких как почтовый сервер, кодировки сообщений;

Ø Архив данных – архив первичных данных, приходящих с устройств. Данные хранятся в техническом формате.

· Пункт Помощь - позволяет получить помощь по операциям с БС.

Ø Помощь по текущей странице - помощь по текущей форме БС;

Ø О программе – информация о производителе БС.

Основное меню для работы с пользователем

Рис 10.8. Основное меню для работы с пользователем для «Администратора»

Пункты Основного меню для работы с пользователем

Состояние счета - Позволяет просматривать состояние счетов пользователя и историю баланса ежемесячно за последние 12 месяцев.

Договор - Позволяет просматривать, редактировать, вносить и удалять cервис-контракты и работать с договором пользователя.

Счета - Позволяет просматривать и вносить новые счета пользователя.

Платежи - Позволяет просматривать, редактировать и вносить новые платежи пользователя.

Реквизиты - Позволяет просматривать и редактировать реквизиты пользователя. Просматривать историю изменения реквизитов пользователя. Позволяет удалять пользователя.

Права - Позволяет изменять права доступа пользователя БС и приписывать его к определенному подразделению продаж.

Идентификаторы - Позволяет просматривать идентификаторы пользователя и изменять его пароли.

История - Позволяет просматривать, вносить и удалять заметки относительно работы с пользователем.

Бизнес-центр - Позволяет просматривать и назначать бизнес-центр, к которому относится пользователь.

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

Дилер - Позволяет просматривать и назначать дилера, ответственного за пользователя.

10.6.2. Рабочее место пользователя с правами доступа «Директора» и «Менеджера»

Главное меню

Главное меню пользователя с правами «менеджера» или «директора» показано на рис 10.8.

Рис 10.9. Главное меню рабочего места «Директора» или «Менеджера»

Пункты главного меню содержат следующие подпункты:

· Пункт Пользователи содержит подпункты:

Ø Список пользователей – полный список пользователей БС;

Ø Вне подразделений – список пользователей вне подразделений продаж;

Ø Поиск – поиск пользователя по реквизитам;

Ø Поиск по идентификатору – поиск пользователя по идентификатору;

Ø Новый пользователь

…выделенной линии – создание пользователя выделенной линии;

…коммут. соединение – создание пользователя коммутируемого соединения;

…только карточка – создание пользователя без указания создания договора;

Ø Статистика – просмотр статистики всех пользователей (поиск пользователя по идентификатору и подразделениям)

· Пункт Отчеты содержит все существующие в БС отчеты, в том числе;

Ø Состояние счетов – отчет по состоянию счетов пользователей;

Ø По тарифу – отчет по сальдо пользователей, подключенных по определенному тарифному плану;

Ø Регистрация действий – журнал регистрации действий операторов БС;

Ø Книга продаж - отчет по продажам за определенный период времени;

Ø Трафик - отчет по объему трафика в БС за определенный период времени;

Ø Интенсивность трафика - отчет по интенсивность трафика в БС за определенный период времени;

Ø Реестр счетов - отчет по счетам, выписанные за определенный период времени;

Ø Реестр оплат - отчет по платежам проводились через БС за определенный период времени;

Ø Доходы по сервисам – график прихода и начисления сумм за предоставление различных видов сервиса;

Ø Выделенные линии (дни) – график загрузки выделенных линий по дням;

Ø Выделенные линии (часы) – график загрузки выделенных линий по часам;

Ø Модемный пул – график загрузки модемного пула;

Ø Прокси сервер (дни) – график загрузки прокси сервера по дням;

· Пункт Услуги содержит подпункты:

Ø Тарифные планы – создание, редактирование тарифных планов;

Ø Услуги – создание, редактирование услуг;

· Пункт Разное содержит подпункты:

Ø Предупреждения – редактирование предупреждения, отсылаемого пользователю в случае низкого баланса счета;

Ø Бизнес-центры (если включено в конфигурацию БС) – создание, редактирование бизнес центров;

Ø Курс валюты – установка курса валюты в БС

· Пункт Помощь - позволяет получить помощь по операциям с БС.

Ø Помощь по текущей странице - помощь по текущей форме БС

Ø О программе – информация о производителе БС

Основное меню для работы с пользователем

Рис 10.10. Основное меню для работы с пользователем для «Директора» или «Менеджера»

Пункты Основного меню для работы с пользователем

Счета - Позволяет просматривать и вносить новые счета пользователя.

Платежи - Позволяет просматривать, редактировать и вносить новые платежи пользователя.

Идентификаторы - Позволяет просматривать идентификаторы пользователя и изменять его пароли.

История - Позволяет просматривать, вносить и удалять заметки относительно работы с пользователем.

Бизнес-центр - Позволяет просматривать и назначать бизнес-центр, к которому относится пользователь.

Дилер - Позволяет просматривать и назначать дилера, ответственного за пользователя.

10.6.3. Рабочее место пользователя с правами доступа «Дилера»

Главное меню

Главное меню пользователя с правами «Дилера» представлено на рис 10.11.

Рис 10.11. Главное меню рабочего места «Дилера»

Пункты главного меню содержат следующие подпункты:

· Пункт Приватное, позволяет «дилеру» просмотреть свои данные как данные клиента провайдера, содержит подпункты:

Ø Состояние счета - позволяет просматривать состояние своего счета и историю баланса ежемесячно за последние 12 месяцев;

Ø Выписанные счета - позволяет просматривать, принимать или не принимать, вносить новые счета на себя;

Ø Реквизиты - позволяет просматривать и редактировать свои реквизиты. Просматривать историю изменения реквизитов пользователя;

Ø Детальная статистика - позволяет просматривать свою детальную статистику использования услуг за выбранный период времени.

· Пункт Пользователи содержит подпункты:

Ø Поиск – поиск пользователя по реквизитам;

Ø Поиск по идентификатору – поиск пользователя по идентификатору

· Пункт Тарифы содержит подпункты:

Ø Мои тарифы – позволяет просмотреть тарифные планы, указанные в собственном договоре дилера;

Ø Просмотр тарифов – позволяет просмотреть все тарифные планы, поддерживаемые провайдером;

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

· Пункт Помощь - позволяет получить помощь по операциям с БС:

Ø Помощь по текущей странице - помощь по текущей форме БС;

Ø О программе – информация о производителе БС.

Основное меню для работы с пользователем

Рис 10.12. Основное меню для работы с пользователем для «Дилера»

Пункты Основного меню для работы с пользователем

Счета - Позволяет просматривать и вносить новые счета пользователя.

Реквизиты - Позволяет просматривать и редактировать реквизиты пользователя. Просматривать историю изменения реквизитов пользователя.

История - Позволяет просматривать, вносить и удалять заметки относительно работы с пользователем.

10.6.4. Рабочее место пользователя с правами доступа «Пользователя»

Главное меню

Главное меню пользователя с правами «пользователя» представлено на рис 10.13.

Рис 10.13. Главное меню рабочего места «Пользователь»

Пункты главного меню содержат следующие подпункты:

· Пункт Пользователь, позволяет пользователю просмотреть свои данные и содержит подпункты:

Ø Состояние счета - позволяет просматривать состояние своего счета и историю баланса ежемесячно за последние 12 месяцев.

Ø Выписанные счета - позволяет просматривать, принимать или не принимать, вносить новые счета на себя.

Ø Реквизиты - позволяет просматривать и редактировать свои реквизиты. Просматривать историю изменения реквизитов пользователя.

· Пункт Тарифы содержит подпункты:

Ø Мои тарифы – просмотреть тарифные планы, указанные в собственном договоре дилера

Ø Просмотр тарифов – просмотреть все тарифные планы поддерживаемые провайдером. поиск пользователя по идентификатору

Ø Режим доступа – Просмотреть группы временных ограничений, которые используются при работе тарифов

· Пункт Помощь - позволяет получить помощь по операциям с БС.

Основное меню для работы с пользователем

Рис 10.14. Основное меню для работы с пользователем для «Пользователя»

Пункты Основного меню для работы с пользователем

Состояние счета - Позволяет пользователю просматривать состояние своего лицевого счета и историю баланса ежемесячно за последние 12 месяцев.

Счета – Позволяет пользователю просматривать и выписывать новые счета. А так же принимать или не принимать счета.

Реквизиты – Позволяет пользователю просматривать и редактировать свои реквизиты. Просматривать историю изменения реквизитов пользователя.

11. Операции обработки данных для рабочих мест «Администратора», «Менеджера», «Директора»

11.1. Работа с пользователем

11.1.1. Создание и удаление пользователя, работа с учетной информацией

Создание нового пользователя

Создать нового пользователя БС можно тремя различными способами, воспользовавшись одним из пунктов выпадающего меню пункта Пользователи:

· пункт Новый пользователь ... выделенной линии

Для такого пользователя создается

Ø Учетная карточка пользователя

Ø Договор, сервис-контракт, входной идентификатор и пароль

Ø В справочник выделенных линий заносится информация о выделенной линии, которая создается для указанного идентификатора пользователя

· пункт Новый пользователь ... коммут. соединение

Для такого пользователя создается

Ø Учетная карточка пользователя

Ø Договор, сервис-контракт, входной идентификатор и пароль

· пункт Новый пользователь ... только карточка

Для такого пользователя создается

Ø Учетная карточка пользователя

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

Учетная информация пользователя (карточка) доступна через пункт меню Реквизиты основного меню для работы с пользователем. Смотрите рис 11.1.

Рис 11.1. Учетная информация пользователя

Редактирование учетной информации пользователя

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

Удаление пользователя

В БС удалить можно только такого пользователя, для которого нет никаких данных про использование им ресурсов.

Удаление пользователя осуществляется через форму «Учетная информация пользователя» (рис 11.1).

Просмотр истории изменения атрибутов пользователя

В БС предоставляется возможность хранить историю изменения атрибутов пользователя, т.е. можно легко последить всю последовательность работы операторов и пользователей с реквизитами.

Просмотр истории изменения атрибутов осуществляется через форму «Учетная информация пользователя» (рис 11.1).

11.1.2. Заключение договоров, сервис контрактов, тарификация, заведение входного идентификатора и пароля

Договор и сервис контракты пользователя

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

Сервис-контракт - определяет условия доступа пользователя к ресурсам Интернет на определенный период времени. В сервис контракте указывается:

· услуга, к которой предоставляется доступ;

· тарифный план, определяющий условия доступа к услуге, в соответствии с которым будет проводиться оплата;

· идентификатор пользователя, по которому будет предоставляться доступ к услуге в соответствии с выбранным тарифом;

· период действия контракта.

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

Заведение договора и сервис контрактов осуществляется через форму «Договор» (см рис 11.2).

Рис 11.2. Форма «Договор» с таблицей сервис контрактов

Договор регистрируется путем ввода его номера, названия и срока действия (ссылка № на рис 11.2)

Сервис-контракт для пользователя заводится добавлением строки в таблицу формы «Договор». Обязательно выбирается идентификатор (или вводится новый), устанавливается тарифный план и срок действия контракта. (см рис 11.3)

Рис 11.3. Новый сервис-контракт.

Заведение входного идентификатора и пароля

Входной идентификатор и пароль используются в БС для авторизации пользователя, и позволяют предотвратить несанкционированный доступ к данным БС.

Идентификаторы пользователя определяются в сервис контрактах договора пользователя. На один идентификатор можно открыть только сервис контракты на одну и ту же услугу, при этом не допускается создание сервис контрактов на предоставления доступа к одной услуге с пересекающимися периодами действия. Для двух сервис контрактов на предоставление той же самой услуги и одного идентификатора обязательно, чтобы выполнялось следующее условие: дата начала второго сервис контракта должна быть больше или равна дате окончания первого сервис контракта.

Пользователь может иметь сколько угодно входных идентификаторов. Каждому идентификатору соответствует только один пароль.

11.1.3. Работа со счетами, платежами, просмотр баланса

БС позволяет автоматически выписывать счета на оплату за предоставленные пользователю услуги. Счета могут быть двух типов:

· авансовая плата (оператор БС заносит в счет сумму к оплате, скидки и т.п.)

· оплата постфактум (сумма к оплате подставляется автоматически).

На основе введенных при создании счета данных БС автоматически формирует счет, который можно распечатать и отослать по электронной почте. Кроме того, БС предоставляет возможность привязывать к счетам платежи и определять, был ли счет оплачен.

Работа со счетами

Создавать, удалять, распечатывать и т.п. счета пользователя позволяет форма «Расчетные документы» (пункт меню Счета).

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

Форма «Расчетные документы» приведена на рис 11.4.

Рис 11.4. Форма «Расчетные документы»

Обозначения на рис 11.4

подчеркнутый красный знак x – удалить счет

подчеркнутый зеленый знак @ - привязать счет к оплате

подчеркнутый красный знак # - отвязать счет от оплаты

подчеркнутый синий знак P – распечатать счет

подчеркнутый синий знак M – выслать счет электронной почтой

подчеркнутый синий знак A – выписать акт приема-передачи

Работа с платежами

Данные о пополнении счета пользователем вносятся в БС через платежи.

Создавать, редактировать и удалять платежи пользователя позволяет форма «Платежи» (рис 11.5).

Рис 11.5. Форма «Платежи».

Сопоставить платеж и определенный счет можно посредством привязки этого платеж к счету. После того как сделана привязка, состояние счета будет изменено на «оплачен» или «частично оплачен» в случае частичной оплаты суммы. К счету можно привязать сразу несколько оплат.

При редактировании платежа имеется возможность направить его на оплату того или иного вида услуги, если у пользователя имеется несколько сервис контрактов. Кроме того, можно вносить комментарии, характеризующие платеж.

Просмотр баланса лицевого счета пользователя

Просмотреть баланс счета пользователя за последние 12 месяцев позволяет форма «Состояние счета», доступная через соответствующий пункт основного меню для работы с пользователем.

11.1.4. Просмотр статистики потребления услуг

Просмотреть детальную статистику пользователя позволяет форма Детальная статистика (рис 11.6).

Рис 11.6. Детальная статистика пользователя.

Здесь предоставляется возможность задать период времени, для которого следует отобразить статистические данные по использованию услуг пользователем. Кроме того, существует возможность быстрой навигации между детальной статистикой различных пользователей путем выбора из списков подразделений, пользователей и идентификаторов. Для поиска по подразделениям необхъодимо выбрать ссылку Пользователь (рис. 11.6). Появится форма, изображенная на рис. 11.7.

Рис 11.7. Детальная статистика пользователя: поиск по подразделениям.

· Пункт 'Поиск’ – по реквизитам, когда известен один или более реквизитов пользователя;

· Пункт