Stargazer
ОПИСАНИЕ БД СЕРВЕРА

Структура директорий

База данных имеет следующую структуру:

В директории admins находятся данные администраторов.

В директории deleted_users находятся директории с пользователями, которые были удалены из системы. Это своего рода "Корзина", как в MS Windows. Имя поддиректроий образуется из имени удаленного пользователя и временнОй метки, когда был удален пользователь.
В данном случае del_test - имя удаленного пользователя, а число, идущее за точкой - временнАя метка.

В директории tariffs находятся данные тарифов.

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

Описание параметров администраторов

настройка конфигурационных файлов /var/stargazer/admins/[конф. файлы администраторов и их прав]. Файлы имеют текстовый формат следующей структуры ПАРАМЕТР=ЗНАЧЕНИЕ. Комментарии в файле начинаются с символа #. Все файлы, которые находятся в данном каталоге должны быть с названиями вида NAME.adm, где NAME – логин администраторов, так как он будет вводиться при запросе в конфигураторе. Все параметры кроме Password могут принимать значения 0 или 1. Данный файл не рекомендуется редактировать вручную, т. к. это можно сделать либо из конфигуратора либо из WEB-интерфейса.

Описание параметров:

  • Password – параметр, содержащий пароль данного администратора в зашифрованном виде, по умолчанию Password=123456. Длина пароля не может превышать 32 символа.
  • ChgStat – параметр, дающий право администратору изменять состояние счетчиков статистики клиента, а также всех параметров, относящихся к файлу stat пользователя, по умолчанию ChgStat=1
  • ChgConf – параметр, дающий право администратору изменять пароль клиента, а также менять все параметры из файла conf клиента, т. е. пароль, имя, IP адрес и др., по умолчанию ChgConf=1
  • ChgCash – параметр, дающий право администратору изменять состояние счета клиента, по умолчанию ChgCash=1
  • UsrAddDel – параметр, дающий право администратору добавлять или удалять клиентов в (из) системы, по умолчанию UsrAddDel=1
  • ChgAdmin – параметр, дающий право администратору редактировать свойства других администраторов системы, по умолчанию ChgAdmin=1
  • ChgTariff - параметр, дающий право администратору редактировать свойства тарифных планов системы, по умолчанию ChgTariff=1
  • ChgPassword – параметр, дающий право администратору изменять пароль клиента, по умолчанию ChgPassword=1
Д) настройка конфигурационных файлов /var/stargazer/users/[конф. файлы клиентов и их статистика]. Файлы имеют текстовый формат следующей структуры ПАРАМЕТР=ЗНАЧЕНИЕ. Комментарии в файле начинаются с символа #. В каталоге /var/stargazer/users должны находиться каталоги с настройками клиентов и их статистикой. Каждый каталог который находиться внутри, считается системой как клиент, т. е. сколько каталогов в /var/stargazer/users столько и клиентов в системе. К примеру в системе заведен клиент с логином test, тогда путь к его настройкам будет такой: /var/stargazer/users/test/[настройки и статистика клиента test]. В каталоге клиента будут находиться каталог detail_stat и файлы conf, log и stat. В каталоге detail_stat находиться детальная статистика клиента; структура подкаталогов: YYYY/MM, где YYYY – год ведения детальной статистики, MM – месяц, в каталоге MM находятся файлы с именами типа 1, 2 и т. д. – т. е. файлы отвечающие дням месяца, в которые велась запись детальной статистики. Например, файл детальной статистики по клиенту test за 23 апреля 2004 года будет находиться в /var/stargazer/users/test/detail_stat/2004/04/23. Файл с простой статистикой клиента, где собраны данные по подключениям и отключением клиентского авторизатора будет находиться в /var/stargazer/users/test/log.

Описание параметров файла conf

  • Password – параметр содержащий пароль клиента так, как он будет указан в авторизаторе, в незашифрованном виде. Длина пароля не может превышать 32 символа
  • IP – параметр, указывающий сервер, с каких адресов клиент может авторизоваться, разделителем служит символ “,” (запятая). Разрешается вводить в данный параметр до 5 адресов через запятую или “*” (звездочка) - т.е. любой адрес
  • Tariff – параметр, указывающий серверу, по какому тарифу следует учитывать статистику клиента. Должен совпадать хотя бы с одним символьным представлением наименований тарифов
  • TariffChange – параметр, указывающий серверу на какой тариф следует изменить тарифный план со следующего месяца. Должен совпадать хотя бы с одним символьным представлением наименований тарифов
  • Credit – сумма кредита клиента, т. е. сумма на которую клиенту разрешено заходить в «минуса»
  • Down – данный параметр показывает, что пользователь отключен администратором, и не может быть авторизован
  • Passive
  • RealName – реальное ФИО клиента, как оно было задано в конфигураторе
  • Address – адрес клиента, как оно было задано в конфигураторе
  • Phone – телефон(ы) клиента, , как оно было задано в конфигураторе
  • Note – примечания, касающиеся данного клиента
  • Iface – наименование сетевого интерфейса, как оно задано в системе (например eth2). Это тот интерфейс, к которому подключен пользователь. Если в этом поле будет указан иной интерфейс, то для пользователя не будет осуществляться подсчет трафика. Если интерфейс имеет alias’ы, например eth0:1, то у пользователя должен стоять реальный интерфейс, вне зависимости от того к кому он подключен eth0 или eth0:1
  • Email – адрес электронной почты клиента. Используется для рассылки писем
  • Group – параметр, определяющий группу, к которой принадлежит клиент. Пока группа заведена в системе для более удобного просмотра пользователей по какому-либо признаку, например по наименованию адреса
  • AlwaysOnline – клиент всегда авторизован, и может не использовать авторизатор
  • CreationTime – параметр определяющий дату и время создания клиентского аккаунта
Описание параметров файла stat

  • DN, UN – где вместо N – число, указывающие номер направления. Параметры, хранящие статистику клиента по направлениям, в байтах
  • Cash – количество денежных средств на персональном счету клиента. В валюте системы
  • LastCashAdd – значение последней добавленной суммы на персональный счет клиента
  • LastCashAddTime – дата и время, в которое было произведено последнее пополнение персонального счета клиента
  • PassiveTime – величина времени, на которое была произведена «заморозка» клиента
  • FreeMb – величина оставшихся у клиента количества бесплатных Мб трафика
Е) настройка конфигурационных файлов /var/stargazer/tariff/[конф. файлы тарифных планов системы]. Файлы имеют текстовый формат следующей структуры ПАРАМЕТР=ЗНАЧЕНИЕ. Комментарии в файле начинаются с символа #. Все файлы, которые находятся в данном каталоге и имеют расширение «tf» считаются системой как настройка тарифного плана, т. е. сколько фалов с таким расширением будет в данном каталоге, столько тарифных планов и будет в системе.

Описание файла тарифа

Тарифный план имеет следующие атрибуты
Общие атрибуты, которые относятся целиком к тарифу:

  • Время задающее «день» и «ночь»
  • Абонплата
  • Тип подсчитываемого трафика
Атрибуты, задаваемые для каждого направления отдельно:
  • Цена за Мб для каждого направления до превышения порога
  • Цена за Мб для каждого направления после превышения порога
  • Цена за 1 Мб для «дня» и «ночи»
  • Величина порога в Мб
  • Способ снятия денег: за сумму входящего и исходящего трафика, входящий, исходящий, наибольший из входящего или исходящего
  • Количество Мб трафика, до превышения которого деньги с пользователя не снимаются (предоплаченный трафик)
Описание параметров фала тарифов

  • ThresholdN – где вместо N – число, указывающие номер направления. Данный параметр определяет порог по направлению, при превышении которого изменится цена за 1 Мб трафика. Если