1 <chapter xml:id="ch13">
2 <title>Приложение Г</title>
4 <title>Описание процесса установки БД для СУБД MySQL</title>
5 <para>Для работы модуля необходимо завести учетную запись пользователя СУБД MySQL. Для этого можно использовать командный интерпретатор mysql:</para>
6 <programlisting linenumbering="unnumbered">
9 Welcome to the MySQL monitor. Commands end with ; or \g.
10 Your MySQL connection id is 9 to server version: 5.0.26-log
12 Type 'help;' or '\h' for help. Type '\c' to clear the buffer.
14 mysql> create user stg_user identified by '123456';
15 Query OK, 0 rows affected (0.04 sec)
17 <para>Модуль для работы с MySQL автоматически создает БД и необходимые для его работы таблицы. Для этого у пользователя, указанного в настройках должны быть установлены соответствующие права (см. документацию по настройке MySQL: MySQL User Account Management). Модуль может корректно работать и с пользователем с ограниченными правами (полный доступ только к своей БД). Для этого необходимо сперва вручную создать БД, а затем дать пользователю права на доступ к ней. Например так:</para>
18 <programlisting linenumbering="unnumbered">
21 Welcome to the MySQL monitor. Commands end with ; or \g.
22 Your MySQL connection id is 9 to server version: 5.0.26-log
24 Type 'help;' or '\h' for help. Type '\c' to clear the buffer.
26 mysql> create user stg_user identified by '123456';
27 Query OK, 0 rows affected (0.04 sec)
29 mysql> create database stg_database;
30 Query OK, 1 row affected (0.02 sec)
32 mysql> grant all on stg_database.* to stg_user;
33 Query OK, 0 rows affected (0.06 sec)
35 <para>После этого модуль при первом запуске сам создаст необходимые таблицы.</para>
38 <title>Описание структуры БД для СУБД MySQL</title>
39 <para>Таблица admins (учетные записи администраторов системы):</para>
40 <itemizedlist mark="opencircle">
41 <listitem><para>login – название учетной записи администратора системы;</para></listitem>
42 <listitem><para>password – пароль для учетной записи администратора системы;</para></listitem>
43 <listitem><para>ChgConf – флаг, разрешающий менять конфигурационные параметры пользователы;</para></listitem>
44 <listitem><para>ChgPassword – флаг, позволяющий менять пароль пользователя;</para></listitem>
45 <listitem><para>ChgStat – флаг, позволяющий менять статистические данные пользователя;</para></listitem>
46 <listitem><para>ChgCash – флаг, позволяющий менять количество денег на счету у пользователя;</para></listitem>
47 <listitem><para>UsrAddDel – флаг, позволяющий управлять учетными записями пользователей;</para></listitem>
48 <listitem><para>ChgTariff – флаг, позволяющий управлять тарифами;</para></listitem>
49 <listitem><para>ChgAdmin – флаг, позволяющий управлять учетными записями администраторов системы.</para></listitem>
51 <para>Таблица tariffs (описание тарифов системы):</para>
52 <itemizedlist mark="opencircle">
53 <listitem><para>name – название тарифа;</para></listitem>
54 <listitem><para>PriceDayA<n> - стоимость 1 Мб трафика по направлению <n> днем до превышения порога;</para></listitem>
55 <listitem><para>PriceDayB<n> - стоимость 1 Мб трафика по направлению <n> днем после превышения порога;</para></listitem>
56 <listitem><para>PriceNightA<n> - стоимость 1 Мб трафика по направлению <n> ночью до превышения порога;</para></listitem>
57 <listitem><para>PriceNightB<n> - стоимость 1 Мб трафика по направлению <n> ночью после превышения порога;</para></listitem>
58 <listitem><para>Threshold<n> - порог по трафику;</para></listitem>
59 <listitem><para>Time<n> - время дня;</para></listitem>
60 <listitem><para>NoDiscount<n> - флаг, указывающий, что трафик по направлению <n> считается без учета порогового значения;</para></listitem>
61 <listitem><para>SinglePrice<n> - флаг, указывающий, что трафик по направлению <n> считается без учета времени суток;</para></listitem>
62 <listitem><para>PassiveCost – стоимость «заморозки» учетной записи пользователя;</para></listitem>
63 <listitem><para>Fee – абонплата;</para></listitem>
64 <listitem><para>Free – количество бесплатных Мб трафика, входящих в абонплату;</para></listitem>
65 <listitem><para>TraffType – тип подсчета трафика (up, down, up+down, max).</para></listitem>
67 <para>Таблица users (учетные записи пользователей системы и их статистика):</para>
68 <itemizedlist mark="opencircle">
69 <listitem><para>login – название учетной записи пользователя;</para></listitem>
70 <listitem><para>Password – пароль для учетной записи пользователя;</para></listitem>
71 <listitem><para>Passive – флаг режима «Заморожен»;</para></listitem>
72 <listitem><para>Down – флаг режима «Отключен»;</para></listitem>
73 <listitem><para>AlwaysOnline – флаг режима «Всегда on-line»;</para></listitem>
74 <listitem><para>Tariff – название тарифа;</para></listitem>
75 <listitem><para>Address – адрес пользователя;</para></listitem>
76 <listitem><para>Phone – номер телефона пользователя;</para></listitem>
77 <listitem><para>Email – адрес электронной почты пользователя;</para></listitem>
78 <listitem><para>Note – примечания;</para></listitem>
79 <listitem><para>RealName – реальное имя пользователя;</para></listitem>
80 <listitem><para>StgGroup – название группы пользователя;</para></listitem>
81 <listitem><para>Credit – величина кредита в деньгах;</para></listitem>
82 <listitem><para>TariffChange – название тарифа, на который будет переведен пользователь в начале месяца;</para></listitem>
83 <listitem><para>Userdata<n> - поля дополнительных данных пользователя;</para></listitem>
84 <listitem><para>CreditExpire – дата окончания действия кредита пользователя;</para></listitem>
85 <listitem><para>DisabledDetailStat — отключение детальной статистики пользователя;</para></listitem>
86 <listitem><para>IP – список IP-адресов пользователя;</para></listitem>
87 <listitem><para>D<n> - объем входящего трафика по направлению <n>;</para></listitem>
88 <listitem><para>U<n> - объем исходящего трафика по направлению <n>;</para></listitem>
89 <listitem><para>Cash – количество денег на счету;</para></listitem>
90 <listitem><para>FreeMb – количество бесплатных мегабайт;</para></listitem>
91 <listitem><para>LastCashAdd – последнее пополнение счета;</para></listitem>
92 <listitem><para>LastCashAddTime – время последнего пополнения счета;</para></listitem>
93 <listitem><para>PassiveTime - время, проведенное пользователем в «замороженном» состоянии за месяц (используется для вычисления объема снимаемой абонплаты);</para></listitem>
94 <listitem><para>LastActivityTime – время последней активности пользователя;</para></listitem>
95 <listitem><para>NAS – используется совместно с модулем захвата трафика для NetFlow.</para></listitem>
97 <para>Таблица messages (сообщения пользователю):</para>
98 <itemizedlist mark="opencircle">
99 <listitem><para>login – название учетной записи пользователя, для которой предназначено сообщение;</para></listitem>
100 <listitem><para>id – уникальный иденетификатор сообщения;</para></listitem>
101 <listitem><para>type – тип сообщения;</para></listitem>
102 <listitem><para>lastSendTime – время последней отсылки сообщения;</para></listitem>
103 <listitem><para>creationTime – время создания сообщения;</para></listitem>
104 <listitem><para>showTime – время показа сообщения;</para></listitem>
105 <listitem><para>stgRepeat – количество повторений сообщения;</para></listitem>
106 <listitem><para>repeatPeriod – период повторения сообщения;</para></listitem>
107 <listitem><para>text – текст сообщения.</para></listitem>
109 <para>Таблица stat (месячная статистика пользователей):</para>
110 <itemizedlist mark="opencircle">
111 <listitem><para>login – название учетной записи пользователя, которой принадлежит запись в статистике;</para></listitem>
112 <listitem><para>month – месяц записи статистики;</para></listitem>
113 <listitem><para>year – год записи статистики;</para></listitem>
114 <listitem><para>U<n> - объем исходящего трафика за месяц по направлениям;</para></listitem>
115 <listitem><para>D<n> - объем входящего трафика за месяц по направлениям;</para></listitem>
116 <listitem><para>cash – количество денег на счету.</para></listitem>
118 <para>Таблица logs_<m>_<y> (помесячный журнал сессий пользователя и изменений его параметров):</para>
119 <itemizedlist mark="opencircle">
120 <listitem><para>unid – уникальный идентификатор записи;</para></listitem>
121 <listitem><para>login – название учетной записи пользователя;</para></listitem>
122 <listitem><para>text – текст записи в журнале.</para></listitem>
124 <para>Таблица detailstat_<m>_<y> (помесячная детальная статистика пользователей):</para>
125 <itemizedlist mark="opencircle">
126 <listitem><para>login – название учетной записи пользователя;</para></listitem>
127 <listitem><para>day – порядковый номер дня в месяце;</para></listitem>
128 <listitem><para>startTime – время начала сессии;</para></listitem>
129 <listitem><para>endTime – время завершения сессии;</para></listitem>
130 <listitem><para>IP – удаленный IP-адрес;</para></listitem>
131 <listitem><para>dir – направление;</para></listitem>
132 <listitem><para>up – объем исходящего трафика;</para></listitem>
133 <listitem><para>down – объем входящего трафика;</para></listitem>
134 <listitem><para>cash – стоимость трафика.</para></listitem>