Improved doc generation.
authorMaxim Mamontov <faust.madf@gmail.com>
Sun, 4 Sep 2016 16:36:22 +0000 (19:36 +0300)
committerMaxim Mamontov <faust.madf@gmail.com>
Sun, 4 Sep 2016 16:36:22 +0000 (19:36 +0300)
99 files changed:
doc/help/Makefile
doc/help/book/images/administrators.png [deleted file]
doc/help/book/images/autoupdate.png [deleted file]
doc/help/book/images/change-in-tariff-user.png [deleted file]
doc/help/book/images/coloring.png [deleted file]
doc/help/book/images/confirm-delete-user.png [deleted file]
doc/help/book/images/create-new-user.png [deleted file]
doc/help/book/images/data-editor.png [deleted file]
doc/help/book/images/delete-user.png [deleted file]
doc/help/book/images/display-statistics-floating.png [deleted file]
doc/help/book/images/dowload.png [deleted file]
doc/help/book/images/editor-rate-plans.png [deleted file]
doc/help/book/images/error.png [deleted file]
doc/help/book/images/filter.png [deleted file]
doc/help/book/images/firebird-erd.png [deleted file]
doc/help/book/images/inetaccess-main.png [deleted file]
doc/help/book/images/inform-admin.png [deleted file]
doc/help/book/images/information.png [deleted file]
doc/help/book/images/informserver.png [deleted file]
doc/help/book/images/interface.png [deleted file]
doc/help/book/images/internet-access.png [deleted file]
doc/help/book/images/ip-search.png [deleted file]
doc/help/book/images/key-admin.png [deleted file]
doc/help/book/images/key-settingsconfig.png [deleted file]
doc/help/book/images/key.png [deleted file]
doc/help/book/images/login.png [deleted file]
doc/help/book/images/messages.png [deleted file]
doc/help/book/images/network-settings.png [deleted file]
doc/help/book/images/new-customer.png [deleted file]
doc/help/book/images/notification-letters.png [deleted file]
doc/help/book/images/of-authorities.png [deleted file]
doc/help/book/images/other-settings.png [deleted file]
doc/help/book/images/send-message.png [deleted file]
doc/help/book/images/set-of-authorities.png [deleted file]
doc/help/book/images/settings-key.png [deleted file]
doc/help/book/images/sgconfig-main.png [deleted file]
doc/help/book/images/statistics.png [deleted file]
doc/help/book/images/tariff-plans.png [deleted file]
doc/help/book/images/tariff.png [deleted file]
doc/help/book/images/up-down-option.png [deleted file]
doc/help/book/images/up-down.png [deleted file]
doc/help/book/images/update.png [deleted file]
doc/help/book/images/upload-dowload.png [deleted file]
doc/help/book/images/user-button.png [deleted file]
doc/help/book/images/username.png [deleted file]
doc/help/book/images/view-letter.png [deleted file]
doc/help/book/images/window-of-authorities.png [deleted file]
doc/help/ch4.xml
doc/help/ch5.xml
doc/help/ch6.xml
doc/help/ch9.xml
doc/help/help.xml
doc/help/images/administrators.png [new file with mode: 0644]
doc/help/images/autoupdate.png [new file with mode: 0644]
doc/help/images/change-in-tariff-user.png [new file with mode: 0644]
doc/help/images/coloring.png [new file with mode: 0644]
doc/help/images/confirm-delete-user.png [new file with mode: 0644]
doc/help/images/create-new-user.png [new file with mode: 0644]
doc/help/images/data-editor.png [new file with mode: 0644]
doc/help/images/delete-user.png [new file with mode: 0644]
doc/help/images/display-statistics-floating.png [new file with mode: 0644]
doc/help/images/dowload.png [new file with mode: 0644]
doc/help/images/editor-rate-plans.png [new file with mode: 0644]
doc/help/images/error.png [new file with mode: 0644]
doc/help/images/filter.png [new file with mode: 0644]
doc/help/images/firebird-erd.png [new file with mode: 0644]
doc/help/images/inetaccess-main.png [new file with mode: 0644]
doc/help/images/inform-admin.png [new file with mode: 0644]
doc/help/images/information.png [new file with mode: 0644]
doc/help/images/informserver.png [new file with mode: 0644]
doc/help/images/interface.png [new file with mode: 0644]
doc/help/images/internet-access.png [new file with mode: 0644]
doc/help/images/ip-search.png [new file with mode: 0644]
doc/help/images/key-admin.png [new file with mode: 0644]
doc/help/images/key-settingsconfig.png [new file with mode: 0644]
doc/help/images/key.png [new file with mode: 0644]
doc/help/images/login.png [new file with mode: 0644]
doc/help/images/messages.png [new file with mode: 0644]
doc/help/images/network-settings.png [new file with mode: 0644]
doc/help/images/new-customer.png [new file with mode: 0644]
doc/help/images/notification-letters.png [new file with mode: 0644]
doc/help/images/of-authorities.png [new file with mode: 0644]
doc/help/images/other-settings.png [new file with mode: 0644]
doc/help/images/send-message.png [new file with mode: 0644]
doc/help/images/set-of-authorities.png [new file with mode: 0644]
doc/help/images/settings-key.png [new file with mode: 0644]
doc/help/images/sgconfig-main.png [new file with mode: 0644]
doc/help/images/statistics.png [new file with mode: 0644]
doc/help/images/tariff-plans.png [new file with mode: 0644]
doc/help/images/tariff.png [new file with mode: 0644]
doc/help/images/up-down-option.png [new file with mode: 0644]
doc/help/images/up-down.png [new file with mode: 0644]
doc/help/images/update.png [new file with mode: 0644]
doc/help/images/upload-dowload.png [new file with mode: 0644]
doc/help/images/user-button.png [new file with mode: 0644]
doc/help/images/user-key.png [new file with mode: 0644]
doc/help/images/username.png [new file with mode: 0644]
doc/help/images/view-letter.png [new file with mode: 0644]
doc/help/images/window-of-authorities.png [new file with mode: 0644]

index 47cf040..72c3bef 100644 (file)
@@ -1,5 +1,15 @@
-all:
+.PHONY: all clean
+
+all: book/index.html help.pdf
+
+book/index.html: ch*.xml help.xml
+       mkdir -p book/images
+       cp images/*.png book/images/
        xsltproc -o book/ --xinclude ../xslt/html/chunk.xsl help.xml
 
+help.pdf: ch*.xml help.xml
+       dblatex -b xetex -I. help.xml
+
 clean:
-       rm book/*html
+       rm -r book
+       rm help.pdf
diff --git a/doc/help/book/images/administrators.png b/doc/help/book/images/administrators.png
deleted file mode 100644 (file)
index b6e6b39..0000000
Binary files a/doc/help/book/images/administrators.png and /dev/null differ
diff --git a/doc/help/book/images/autoupdate.png b/doc/help/book/images/autoupdate.png
deleted file mode 100644 (file)
index ef4e976..0000000
Binary files a/doc/help/book/images/autoupdate.png and /dev/null differ
diff --git a/doc/help/book/images/change-in-tariff-user.png b/doc/help/book/images/change-in-tariff-user.png
deleted file mode 100644 (file)
index 1869902..0000000
Binary files a/doc/help/book/images/change-in-tariff-user.png and /dev/null differ
diff --git a/doc/help/book/images/coloring.png b/doc/help/book/images/coloring.png
deleted file mode 100644 (file)
index 8813f71..0000000
Binary files a/doc/help/book/images/coloring.png and /dev/null differ
diff --git a/doc/help/book/images/confirm-delete-user.png b/doc/help/book/images/confirm-delete-user.png
deleted file mode 100644 (file)
index ccf108a..0000000
Binary files a/doc/help/book/images/confirm-delete-user.png and /dev/null differ
diff --git a/doc/help/book/images/create-new-user.png b/doc/help/book/images/create-new-user.png
deleted file mode 100644 (file)
index 65eba71..0000000
Binary files a/doc/help/book/images/create-new-user.png and /dev/null differ
diff --git a/doc/help/book/images/data-editor.png b/doc/help/book/images/data-editor.png
deleted file mode 100644 (file)
index 7e86600..0000000
Binary files a/doc/help/book/images/data-editor.png and /dev/null differ
diff --git a/doc/help/book/images/delete-user.png b/doc/help/book/images/delete-user.png
deleted file mode 100644 (file)
index f526e78..0000000
Binary files a/doc/help/book/images/delete-user.png and /dev/null differ
diff --git a/doc/help/book/images/display-statistics-floating.png b/doc/help/book/images/display-statistics-floating.png
deleted file mode 100644 (file)
index aaba6d9..0000000
Binary files a/doc/help/book/images/display-statistics-floating.png and /dev/null differ
diff --git a/doc/help/book/images/dowload.png b/doc/help/book/images/dowload.png
deleted file mode 100644 (file)
index 2e59cdb..0000000
Binary files a/doc/help/book/images/dowload.png and /dev/null differ
diff --git a/doc/help/book/images/editor-rate-plans.png b/doc/help/book/images/editor-rate-plans.png
deleted file mode 100644 (file)
index a46bcd6..0000000
Binary files a/doc/help/book/images/editor-rate-plans.png and /dev/null differ
diff --git a/doc/help/book/images/error.png b/doc/help/book/images/error.png
deleted file mode 100644 (file)
index 548cebd..0000000
Binary files a/doc/help/book/images/error.png and /dev/null differ
diff --git a/doc/help/book/images/filter.png b/doc/help/book/images/filter.png
deleted file mode 100644 (file)
index 59cadd6..0000000
Binary files a/doc/help/book/images/filter.png and /dev/null differ
diff --git a/doc/help/book/images/firebird-erd.png b/doc/help/book/images/firebird-erd.png
deleted file mode 100644 (file)
index b114ec5..0000000
Binary files a/doc/help/book/images/firebird-erd.png and /dev/null differ
diff --git a/doc/help/book/images/inetaccess-main.png b/doc/help/book/images/inetaccess-main.png
deleted file mode 100644 (file)
index aba4667..0000000
Binary files a/doc/help/book/images/inetaccess-main.png and /dev/null differ
diff --git a/doc/help/book/images/inform-admin.png b/doc/help/book/images/inform-admin.png
deleted file mode 100644 (file)
index 35d45f8..0000000
Binary files a/doc/help/book/images/inform-admin.png and /dev/null differ
diff --git a/doc/help/book/images/information.png b/doc/help/book/images/information.png
deleted file mode 100644 (file)
index 629b9ef..0000000
Binary files a/doc/help/book/images/information.png and /dev/null differ
diff --git a/doc/help/book/images/informserver.png b/doc/help/book/images/informserver.png
deleted file mode 100644 (file)
index 570f9ad..0000000
Binary files a/doc/help/book/images/informserver.png and /dev/null differ
diff --git a/doc/help/book/images/interface.png b/doc/help/book/images/interface.png
deleted file mode 100644 (file)
index fb1d200..0000000
Binary files a/doc/help/book/images/interface.png and /dev/null differ
diff --git a/doc/help/book/images/internet-access.png b/doc/help/book/images/internet-access.png
deleted file mode 100644 (file)
index 86d02cd..0000000
Binary files a/doc/help/book/images/internet-access.png and /dev/null differ
diff --git a/doc/help/book/images/ip-search.png b/doc/help/book/images/ip-search.png
deleted file mode 100644 (file)
index 579d2c8..0000000
Binary files a/doc/help/book/images/ip-search.png and /dev/null differ
diff --git a/doc/help/book/images/key-admin.png b/doc/help/book/images/key-admin.png
deleted file mode 100644 (file)
index 7220623..0000000
Binary files a/doc/help/book/images/key-admin.png and /dev/null differ
diff --git a/doc/help/book/images/key-settingsconfig.png b/doc/help/book/images/key-settingsconfig.png
deleted file mode 100644 (file)
index 7ec9010..0000000
Binary files a/doc/help/book/images/key-settingsconfig.png and /dev/null differ
diff --git a/doc/help/book/images/key.png b/doc/help/book/images/key.png
deleted file mode 100644 (file)
index 5a5f3d8..0000000
Binary files a/doc/help/book/images/key.png and /dev/null differ
diff --git a/doc/help/book/images/login.png b/doc/help/book/images/login.png
deleted file mode 100644 (file)
index 8950f95..0000000
Binary files a/doc/help/book/images/login.png and /dev/null differ
diff --git a/doc/help/book/images/messages.png b/doc/help/book/images/messages.png
deleted file mode 100644 (file)
index 1b07d88..0000000
Binary files a/doc/help/book/images/messages.png and /dev/null differ
diff --git a/doc/help/book/images/network-settings.png b/doc/help/book/images/network-settings.png
deleted file mode 100644 (file)
index 66f182e..0000000
Binary files a/doc/help/book/images/network-settings.png and /dev/null differ
diff --git a/doc/help/book/images/new-customer.png b/doc/help/book/images/new-customer.png
deleted file mode 100644 (file)
index 79e2c6e..0000000
Binary files a/doc/help/book/images/new-customer.png and /dev/null differ
diff --git a/doc/help/book/images/notification-letters.png b/doc/help/book/images/notification-letters.png
deleted file mode 100644 (file)
index 51b9ccd..0000000
Binary files a/doc/help/book/images/notification-letters.png and /dev/null differ
diff --git a/doc/help/book/images/of-authorities.png b/doc/help/book/images/of-authorities.png
deleted file mode 100644 (file)
index dcfe756..0000000
Binary files a/doc/help/book/images/of-authorities.png and /dev/null differ
diff --git a/doc/help/book/images/other-settings.png b/doc/help/book/images/other-settings.png
deleted file mode 100644 (file)
index 391cb8d..0000000
Binary files a/doc/help/book/images/other-settings.png and /dev/null differ
diff --git a/doc/help/book/images/send-message.png b/doc/help/book/images/send-message.png
deleted file mode 100644 (file)
index 575434a..0000000
Binary files a/doc/help/book/images/send-message.png and /dev/null differ
diff --git a/doc/help/book/images/set-of-authorities.png b/doc/help/book/images/set-of-authorities.png
deleted file mode 100644 (file)
index e56029a..0000000
Binary files a/doc/help/book/images/set-of-authorities.png and /dev/null differ
diff --git a/doc/help/book/images/settings-key.png b/doc/help/book/images/settings-key.png
deleted file mode 100644 (file)
index 5638b9b..0000000
Binary files a/doc/help/book/images/settings-key.png and /dev/null differ
diff --git a/doc/help/book/images/sgconfig-main.png b/doc/help/book/images/sgconfig-main.png
deleted file mode 100644 (file)
index c4dfbbf..0000000
Binary files a/doc/help/book/images/sgconfig-main.png and /dev/null differ
diff --git a/doc/help/book/images/statistics.png b/doc/help/book/images/statistics.png
deleted file mode 100644 (file)
index 733cd06..0000000
Binary files a/doc/help/book/images/statistics.png and /dev/null differ
diff --git a/doc/help/book/images/tariff-plans.png b/doc/help/book/images/tariff-plans.png
deleted file mode 100644 (file)
index 5756817..0000000
Binary files a/doc/help/book/images/tariff-plans.png and /dev/null differ
diff --git a/doc/help/book/images/tariff.png b/doc/help/book/images/tariff.png
deleted file mode 100644 (file)
index de049e5..0000000
Binary files a/doc/help/book/images/tariff.png and /dev/null differ
diff --git a/doc/help/book/images/up-down-option.png b/doc/help/book/images/up-down-option.png
deleted file mode 100644 (file)
index ffa4b9e..0000000
Binary files a/doc/help/book/images/up-down-option.png and /dev/null differ
diff --git a/doc/help/book/images/up-down.png b/doc/help/book/images/up-down.png
deleted file mode 100644 (file)
index fba0144..0000000
Binary files a/doc/help/book/images/up-down.png and /dev/null differ
diff --git a/doc/help/book/images/update.png b/doc/help/book/images/update.png
deleted file mode 100644 (file)
index dda7bf4..0000000
Binary files a/doc/help/book/images/update.png and /dev/null differ
diff --git a/doc/help/book/images/upload-dowload.png b/doc/help/book/images/upload-dowload.png
deleted file mode 100644 (file)
index 826d37f..0000000
Binary files a/doc/help/book/images/upload-dowload.png and /dev/null differ
diff --git a/doc/help/book/images/user-button.png b/doc/help/book/images/user-button.png
deleted file mode 100644 (file)
index ffbd164..0000000
Binary files a/doc/help/book/images/user-button.png and /dev/null differ
diff --git a/doc/help/book/images/username.png b/doc/help/book/images/username.png
deleted file mode 100644 (file)
index 02a4bf7..0000000
Binary files a/doc/help/book/images/username.png and /dev/null differ
diff --git a/doc/help/book/images/view-letter.png b/doc/help/book/images/view-letter.png
deleted file mode 100644 (file)
index d37eeba..0000000
Binary files a/doc/help/book/images/view-letter.png and /dev/null differ
diff --git a/doc/help/book/images/window-of-authorities.png b/doc/help/book/images/window-of-authorities.png
deleted file mode 100644 (file)
index cd2df63..0000000
Binary files a/doc/help/book/images/window-of-authorities.png and /dev/null differ
index 00130ea..7374ce9 100644 (file)
@@ -3,7 +3,7 @@
   <para>После инсталляции система должна быть подвергнута процедуре настройки. Обычно следует начинать с настройки сервера.</para>
   <para>Основные конфигурационные  файлы  сервера по умолчанию находятся в каталоге /etc/stargazer. Они включают в себя: основной конфигурационный файл stargazer.conf, файл описания направлений тарификации rules, набор скриптов On* и два каталога — conf-available.d и conf-enabled.d, содержащих конфигурационные файлы отдельных модулей. Для включения какого-либо модуля нужно сделать символическую ссылку на его конфигурационный файл в каталоге conf-enabled.d или прописать его конфигурационную секцию в разделе &lt;Modules&gt; файла stargazer.conf.</para>
   <simplesect>
-    <title>Ð\9dаÑ\81Ñ\82Ñ\80ойка ÐºÐ¾Ð½Ñ\84игÑ\83Ñ\80аÑ\86ионного Ñ\84айла /etc/stargazer/stargazer.conf </title>
+    <title>Ð\9aонÑ\84игÑ\83Ñ\80аÑ\86ионнÑ\8bй Ñ\84айл /etc/stargazer/stargazer.conf </title>
     <para>Файл имеет текстовый формат, содержащий пары ПАРАМЕТР = ЗНАЧЕНИЕ и секции &lt;ИМЯ_СЕКЦИИ ПАРАМЕТРЫ_СЕКЦИИ&gt;. Комментарии в файле начинаются с символа #. В файле описываются общие параметры, которые являются глобальными значениями для всего сервера биллинга, а также параметры соответствующих модулей. Параметры модулей должны быть заключены в секции:</para>
     <programlisting linenumbering="unnumbered">
     &lt;Module имя_модуля&gt;
       <listitem><para>MessagesTimeout — необязательный параметр, устанавливающий время жизни не отправленных сообщений абонентам. Время указывается в сутках. При превышении этого времени сообщение будет удалено, в т. ч. из БД. Если указано значение 0 то не отправленные сообщения никогда не будут удаляться из базы (в частности, это приведет к постепенному росту размера базы, увеличению нагрузки на сервер при авторизации абонентов и к тому что долго отсутствовавший абонент при авторизации получит все пропущенные сообщения). По умолчанию имеет значение 0.</para></listitem>
       <listitem><para>FeeChargeType — необязательный параметр, регулирующий процесс снятия абонплаты. Может принимать значения 0, 1 и 2, по умолчанию имеет значение 0. При значении 0 абонплата снимается как обычно, при значении 1 абонплата снимается только если баланс пользователя положительный или равен нулю, при значении 2 абонплата снимается только если баланс пользователя больше или равен абонплате. Значение 2 следует использовать с осторожностью, т. к. при этом на безлимитных тарифах абоненты получат услугу бесплатно.</para></listitem>
       <listitem><para>ReconnectOnTariffChange — необязательный параметр, указывающий серверу выполнить переподключение пользователя при смене тарифа. Может принимать значения yes и no, по умолчанию имеет значение no. При указании значения yes подключенные пользователи будут отключены непосредственно перед сменой тарифа и подключены сразу после нее. Может быть полезно для управления шейпером.</para></listitem>
-      <listitem><para>ScriptParams — необязательный параметр, который определяет дополнительный набор данных передаваемых в скрипты OnConnect и OnDisconnect. По умолчанию этот параметр пуст. В нем можно указать названия полей записи пользователя, разделенных пробелами, значения которых будут переданы в скрипты после стандартного набора, включающего login, ip, cash, id и dirs. Допустимые имена полей: "cash", "upload", "download", "lastCashAdd", "passiveTime", "lastCashAddTime", "freeMb", "lastActivityTime", "password", "passive", "disabled", "disabledDetailStat", "alwaysOnline", "tariffName", "nextTariff", "address", "note", "group", "email", "phone", "realName", "credit", "creditExpire", "ips", "userdata0" ... "userdata9". Так, например, если указать ScriptParams = tariffName userdata0 то список параметров передаваемых в скрипты будет: login, ip, cash, id, dirs, tariffName, userdata0. Названия параметров регистронезависимые.</para></listitem>
+      <listitem>
+        <para>ScriptParams — необязательный параметр, который определяет дополнительный набор данных передаваемых в скрипты OnConnect и OnDisconnect. По умолчанию этот параметр пуст. В нем можно указать названия полей записи пользователя, разделенных пробелами, значения которых будут переданы в скрипты после стандартного набора, включающего login, ip, cash, id и dirs. Допустимые имена полей:</para>
+        <programlisting linenumbering="unnumbered">"cash", "upload", "download", "lastCashAdd", "passiveTime", "lastCashAddTime", "freeMb", "lastActivityTime", "password", "passive", "disabled", "disabledDetailStat", "alwaysOnline", "tariffName", "nextTariff", "address", "note", "group", "email", "phone", "realName", "credit", "creditExpire", "ips", "userdata0" ... "userdata9".</programlisting>
+        <para>Так, например, если указать ScriptParams = tariffName userdata0 то список параметров передаваемых в скрипты будет: login, ip, cash, id, dirs, tariffName, userdata0. Названия параметров регистронезависимые.</para>
+      </listitem>
       <listitem><para>DisableSessionLog — необязательный параметр позволяющий отключать запить сессий пользователя в БД. Может принимать значения yes и no. По умолчанию установлен в no, то есть запись сессий включена.</para></listitem>
       <listitem><para>FilterParamsLog — необязательный параметр который позволяет фильтровать запись в журнал изменений параметров. Может принимать значения "*" (разрешена запись жернала для всех параметров) или список названий полей записи пользователя, разделенный пробелами. Допустимые имена полей такие-же как и для ScriptParams. По умолчанию имеет значение "*", то есть разрешено журналирование всех параметров. Если указать FilterParamsLog = cash tariffName password то в журнал изменений будут попадать только изменения параметров cash, tariffName и password. Изменения других параметров, например note, group или address в журнал не попадут.</para></listitem>
       <listitem><para>Для именования направлений учета трафика в конфигурационном файле используется секция DirNames:</para>
@@ -67,7 +71,8 @@
     &lt;/Modules&gt;
     </programlisting>
     <para>Если модуль не имеет настраиваемых параметров, то он все равно должен быть указан. Некоторые модули, такие как store module, обязательно требуются при старте и без их подключения система не может быть запущена. По умолчанию для указания конфигурации модулей используются отдельные файлы из каталога conf-enabled.d. Для этого используется директива &lt;IncludeFile ПУТЬ_К_ФАЙЛУ&gt;&lt;/IncludeFile&gt;. Одна директива указана в секции Modules, а вторая в корне файла конфигурации (для store module).</para>
-    <sect2>
+  </simplesect>
+  <simplesect>
     <title>Описание параметров модуля InetAccess (auth_ia) для работы с авторизаторами абонентов:</title>
     <itemizedlist mark="opencircle">
       <listitem><para>Port – обязательный параметр, определяющий на каком порту сервер будет принимать обращения авторизаторов абонентов. Стандартное значение: 5555.</para></listitem>
       </listitem>
     </itemizedlist>
     <para>Обмен данными авторизатора с сервером осуществляется по протоколу UDP. Можно указать несколько модулей авторизатора auth_ia для авторизации с разных портов.</para>
-    </sect2>
-    <sect2>
+  </simplesect>
+  <simplesect>
     <title>Модуль авторизации auth_ao.</title>
     <para>Модуль параметров не имеет. Используется для поддержки режима Always Online у абонентов. Без включения этого модуля установка параметра alwaysOnline для абонента эффекта иметь не будет. В режиме Always Online абонент находится в авторизованном состоянии все время, независимо от использования авторизатора. Тем не менее он может быть отключен по причине отсутствия средств на счету, заблокирован администратором или «заморожен». В этом режиме так же возможно использование авторизатора за одним исключением — абонент не может сам вызвать «отключение».</para>
-    </sect2>
-    <sect2>
+  </simplesect>
+  <simplesect>
     <title>Описание параметров модуля SGConfig (conf_sg) для работы с конфигуратором:</title>
     <itemizedlist mark="opencircle">
       <listitem><para>Port – обязательный параметр, определяющий, на каком порту сервер будет принимать обращения конфигураторов. Стандартное значение: 5555.</para></listitem>
     </itemizedlist>
     <para>Обмен конфигуратора с сервером осуществляется по протоколу TCP. Можно указать несколько модулей конфигуратора с указанием разных портов.</para>
-    </sect2>
-    <sect2>
+  </simplesect>
+  <simplesect>
     <title>Описание параметров модуля файловой БД:</title>
     <itemizedlist mark="opencircle">
       <listitem><para>WorkDir – обязательный параметр, указывающий серверу где находится рабочая директория с файлами БД. Стандартное значение: /var/stargazer.</para></listitem>
       <listitem><para>StatOwner, StatGroup, StatMode – обязательные параметры, описывающие владельца, группу и права доступа на файлы статистики (stat) абонента соответственно. StatOwner должен содержать корректное имя пользователя системы (см. файл /etc/passwd), стандартное значение: root. StatGroup должен содержать корректное название группы в системе (см. файл /etc/group), стандарное значение: root. StatMode должен содержать корректные права на файл (только ugo-биты), стандартное значение: 640.</para></listitem>
       <listitem><para>UserLogOwner, UserLogGroup, UserLogMode – обязательные параметры, описывающие владельца, группу и права доступа на файлы журналов (log) абонента соответственно. UserLogOwner должен содержать корректное имя пользователя системы (см. файл /etc/passwd), стандартное значение: root. UserLogGroup должен содержать корректное название группы в системе (см. файл /etc/group), стандарное значение: root. UserLogMode должен содержать корректные права на файл (только ugo-биты), стандартное значение: 640.</para></listitem>
     </itemizedlist>
-      <para>При создании каталогов (например для записи детальной статистики) используются те-же права, но с добавлением x-бита для всех ненулевых полей. Например: для 640 будут права 750, а для 644 будут 755. Для записи детальной статистики используются параметры StatOwner, StatGroup и StatMode. Для записи сообщений используются параметры ConfOwner, ConfGroup и ConfMode.</para>
-    </sect2>
-    <sect2>
+    <para>При создании каталогов (например для записи детальной статистики) используются те-же права, но с добавлением x-бита для всех ненулевых полей. Например: для 640 будут права 750, а для 644 будут 755. Для записи детальной статистики используются параметры StatOwner, StatGroup и StatMode. Для записи сообщений используются параметры ConfOwner, ConfGroup и ConfMode.</para>
+  </simplesect>
+  <simplesect>
     <title>Описание параметров модуля для работы с СУБД Firebird:</title>
     <itemizedlist mark="opencircle">
       <listitem><para>Server – необязательный параметр, описывающий адрес сервера, на котором расположена СУБД. Может быть доменным именем или IP-адресом. Значение по умолчанию: localhost.</para></listitem>
         </itemizedlist>
         </listitem>
     </itemizedlist>
-    </sect2>
-    <sect2>
+  </simplesect>
+  <simplesect>
     <title>Описание параметров модуля для работы с СУБД PostgreSQL:</title>
     <itemizedlist mark="opencircle">
       <listitem><para>Server – необязательный параметр, описывающий адрес сервера, на котором расположена СУБД. Может быть доменным именем или IP-адресом. Значение по умолчанию: localhost.</para></listitem>
       <listitem><para>Password – необязательный параметр, описывающий пароль пользователя БД. Значение по умолчанию: 123456.</para></listitem>
       <listitem><para>Retries — необязательный параметр, описывающий количество попыток переподключения к СУБД в случае потери связи. Попытки производятся с интервалом в 1 секунду. Значение по умолчанию: 3.</para></listitem>
     </itemizedlist>
-    </sect2>
-    <sect2>
+  </simplesect>
+  <simplesect>
     <title>Описание параметров модуля для работы с СУБД MySQL:</title>
     <itemizedlist mark="opencircle">
       <listitem><para>Server – обязательный параметр, описывающий адрес сервера, на котором расположена СУБД. Стандартное значение: localhost.</para></listitem>
       <listitem><para>User – обязательный параметр, описывающий имя пользователя БД. Стандартное значение: stg.</para></listitem>
       <listitem><para>Password – обязательный параметр, описывающий пароль пользователя БД. Стандартное значение: 123456.</para></listitem>
     </itemizedlist>
-    </sect2>
-    <sect2>
+  </simplesect>
+  <simplesect>
     <title>Описание параметров модуля ping для пингования абонентов:</title>
     <itemizedlist mark="opencircle">
       <listitem><para>PingDelay – обязательный параметр, определяющий, время в секундах между пингами одного и того же абонента. Стандартное значение: 15.</para></listitem>
     </itemizedlist>
-    </sect2>
-    <sect2>
+  </simplesect>
+  <simplesect>
     <title>Описание параметров модуля Remote Script Executer (remote_script) для передачи команд на исполнение скриптов на NAS:</title>
     <itemizedlist mark="opencircle">
       <listitem><para>SendPeriod – обязательный параметр, определяющий время в секундах между посылками подтверждений того, что клиент находится в состоянии Online. Стандартное значение: 15.</para></listitem>
       <listitem><para>Port – обязательный параметр, определяющий номер порта через который будет происходить обмен данными между сервером биллинга и клиентом. Может принимать значения от 1 до 65535, стандартное значение: 9999.</para></listitem>
       <listitem><para>SubnetFile — обязательный параметр, представляющий собой путь к файлу с описанием соответствия сетей и NAS'ов. Стандартное значение: subnets. При указании относительного пути поиск будет производиться в каталоге с настройками (обычно это /etc/stargazer, но может быть переопределено указанием пути в качестве параметра при старте дэмона). Файл имеет формат: &lt;сеть в CIDR-нотации&gt; &lt;адрес NAS'а&gt;. Количество сетей не ограничено. Файл перечитывается заново при посылке процессу сигнала SIGHUP. Если файл содержит ошибки при старте дэмона — система не будет запущена. Если файл содержит ошибки при перечитывании — будут использоваться старые значения.</para></listitem>
     </itemizedlist>
-    </sect2>
-    <sect2>
+  </simplesect>
+  <simplesect>
     <title>Описание параметров модуля radius для поддержки авторизации и аккаунтинга пользователей через сервер FreeRADIUS:</title>
     <itemizedlist mark="opencircle">
       <listitem><para>Port — обязательный параметр, определяющий порт, на который будут приходить запросы от FreeRADIUS. Может принимать значение от 1 до 65535, стандартное значение: 6666.</para></listitem>
       <listitem><para>AcctServices — необязательный параметр, задающий список сервисов, по которым будет производится аккаунтинг. При успешной авторизации в этих сервисах абонент переходит в состояние Online и для него производится подсчет трафика. Необходимо заметить, что в этом случае трафик захватывается как обычно, без использования возможностей протокола RADIUS (через пакет аккаунтинга InterimUpdate), т.к. это не позволяет классифицировать полученный трафик по направлениям. Названия сервисов в списке должны разделяться пробелами, по умолчанию этот параметр пуст.</para></listitem>
     </itemizedlist>
     <para>Обмен данными между плагином и FreeRADIUS происходит по протоколу UDP.</para>
-    </sect2>
-    <sect2>
+  </simplesect>
+  <simplesect>
     <title>Описание параметров модуля XML-RPC (conf_rpc) для поддержки протокола управления XML-RPC:</title>
     <itemizedlist mark="opencircle">
       <listitem><para>Port — обязательный параметр, определяющий порт на который будут приходить запросы XML-RPC. Может принимать значения от 1 до 65535, стандартное значение: 8080.</para></listitem>
       <listitem><para>CookieTimeout — необязательный параметр, задающий время существования авторизационного Cookie в случае отсутствия активности в секундах. Значение по умолчанию: 1800 (30 минут).</para></listitem>
     </itemizedlist>
-    </sect2>
-    <sect2>
+  </simplesect>
+  <simplesect>
     <title>Модуль захвата трафика cap_ether (только для ОС Linux).</title>
     <para>Модуль не имеет параметров. Для захвата трафика используются так называемые «raw sockets», которые позволяют получить доступ к Ethernet-фреймам. Перехватывается весь трафик попадающий в сетевую подсистему ядра. При использовании обычной маршрутизации трафик будет посчитан два раза: на входящем интерфейсе и на исходящем. При использовании NAT удвоения трафика не происходит, так как NAT заменяет адрес источника. При интенсивном сетевом обмене или при высокой нагрузке на сервер, на котором происходит захват трафика, модуль может терять отдельные пакеты. Процент потерь тем выше чем выше скорость прохождения пакетов и чем выше загрузка сервера. Модуль рекомендуется использовать для ознакомления или в небольших сетях до 100 абонентов с трафиком до 100 Мбит.</para>
-    </sect2>
-    <sect2>
+  </simplesect>
+  <simplesect>
     <title>Модуль захвата трафика cap_ipq (только для ОС Linux).</title>
     <para>Модуль не имеет параметров. Для захвата трафика используются передача пакетов из пространства ядра в пространство пользователя посредством очередей (ip queue). Для его работы требуется поддержка ip queueing в ядре (модуль ip_queue.ko) и специальная настройка файрвола (правило QUEUE для iptables). Следует обратить внимание на то что обычно требуется два правила в файрволе для полного перехвата: одно для входящих пакетов и одно для исходящих. Модуль гарантирует 100% перехват трафика, но так как пакет перед отправкой обязательно проходить через плагин — может приводить к снижению пропускной способности роутера. При этом следует обратить внимание на нагрузку на процессор, возможно имеет смысл заменить его на более производительный. В противном случае стоит рассмотреть использование модуля cap_nf для захвата трафика.</para>
-    </sect2>
-    <sect2>
+  </simplesect>
+  <simplesect>
     <title>Описание параметров модуля cap_bpf для захвата трафика (только для ОС FreeBSD):</title>
     <itemizedlist mark="opencircle">
       <listitem><para>iface — обязательный параметр, определяющий на каком интерфейсе будет происходить захват трафика. Параметр может быть задан более одного раза.</para></listitem>
     </itemizedlist>
     <para>Для захвата трафика используется инфраструктура Berkeley Packet Filter, представляющая собой «продвинутый» аналог «raw sockets». Так как интерфейсы для перехвата указываются явно, дублирования трафика при обычной маршрутизации не наблюдается. Фильтрование пакетов не используется, перехват происходит по мере возможности, по этому этот модуль, как и cap_ether, тоже может терять пакеты при высокой нагрузке на сервер или высокой скорости прохождения пакетов. Рекомендуется использовать для ознакомления или для небольших сетей до 100 абонентов с трафиком до 100 Мбит.</para>
-    </sect2>
-    <sect2>
+  </simplesect>
+  <simplesect>
     <title>Модуль захвата трафика cap_divert (только для ОС FreeBSD).</title>
     <para>Модуль не имеет параметров. Для захвата трафика используются divert-сокеты. Как и IPQ эта технология использует прохождение пакетов через пространство пользователя. Для работы модуля требуется поддержка divert-сокетов в ядре и специальная настройка файрвола. Для передачи пакета в пространство пользователя в файрволе используется правило divert или tee. Первое правило работает аналогично цели QUEUE для iptables — пропускает пакет через пространство пользователя перед отправкой. Соответственно, это может вызвать те-же проблемы с пропускной способностью роутера. Правило tee передает в пространство пользователя копию пакета, а оригинал отправляет дальше. Такой подход позволяет избежать снижения пропускной способности сервера при высокой нагрузке на него, так как исключается ожидание пакета в время его нахождения в пространстве пользователя.</para>
-    </sect2>
-    <sect2>
+  </simplesect>
+  <simplesect>
     <title>Описание параметров модуля cap_nf для захвата трафика:</title>
     <itemizedlist mark="opencircle">
       <listitem><para>TCPPort — необязательный параметр, указывающий порт который будет использоваться для приема данных при работе с NetFlow-proxy. Стандартное значение: 9996. Если параметр не указан — прием по протоколу TCP производиться не будет.</para></listitem>
       <listitem><para>UDPPort — необязательный параметр, указывающий порт для приема NetFlow-дагарамм. Стандартное значение: 9996. Если параметр не указан — прием датаграмм по протоколу UDP производиться не будет.</para></listitem>
     </itemizedlist>
     <para>В явном виде захват трафика не происходит. Данные о нем поступают от NetFlow-сенсора посредством протокола NetFlow. Это позволяет физически разделить перехват трафика и его учет. NetFlow-сенсор перехватывает трафик, и собирает данные о сессиях (в контексте UDP это передача данных между двумя портами в одном направлении). Информация о сессии включает в себя IP-адреса источника и назначения потока пакетов, номера портов источника и назначения, суммарную длину пакетов и различные дополнительные данные. NetFlow-трафик существенно меньше трафика, который он описывает, так как передается мета-информация а не сами данные. С учетом этого факта и того что биллинговый сервер теперь может не заниматься маршрутизацией пакетов и NAT'ом это существенно снижает нагрузку на него. Этот плагин рекомендуется использоваться в крупных сетях с развитой топологией, включающей несколько NAS'ов. Возможно использование совместно с аппаратными маршрутизаторами Cisco (они единственные имеют лицензию на аппаратную реализацию NetFlow). В качестве NetFlow-сенсоров можно использовать такие утилиты как fprobe, softflowd или ipcad. Так же можно использовать модуль ядра ipt_netflow (Linux) или ng_netflow (FreeBSD).</para>
-    </sect2>
-    <sect2>
     <itemizedlist mark="opencircle">
       <listitem><para>Server — обязательный параметр, указывающий IP-адрес сервера на котором находится snmpd. Стандартное значение: 127.0.0.1.</para></listitem>
       <listitem><para>Port — обязательный параметр, указывающий порт на сервере через который будет происходить взаимодействие с snmpd. Стандартное значение: 199.</para></listitem>
       <listitem><para>Password — необязательный параметр, задающий пароль для авторизации плагина в snmpd. По умолчанию пароль не используется.</para></listitem>
     </itemizedlist>
+  </simplesect>
+  <simplesect>
     <title>Описание параметров модуля smux для мониторинга состояния Stargazer:</title>
     <para>Модуль позволяет производить мониторинг биллинга средствами протокола SNMP. Он не реализует полноценный SNMP-сервер а лишь взаимодействует с существующим дэмоном snmpd, регистрируясь в нем для обслуживания определенного дерева параметров. В комплекте с биллингом идет MIB, описывающий доступные параметры для мониторинга. Параметры разделены на 6 секций, находящихся в узле stg24:</para>
     <itemizedlist mark="opencircle">
     <para>Для доступа к значениями параметров можно использовать следующую команду: snmpget -v2c -ccommunity_w -m +STG-MIB 10.0.0.1 stg24.users.totalUsers. Ключ -v указывает используемую версию протокола. На сегодняшний день существует 3 версии протокола: 1, 2 и 3. Версия 1 считается устаревшей и почти не используется. Версия 2 существует в двух модификациях: user-based (с суффиксом «u») и community-based (с суффиксом «c»). Версия 3 является самой новой и предоставляет широкие средства аутентификации, контроля целостности и шифрования. Ключ -c задает community для доступа к серверу. Ключ -m позволяет подключать дополнительные mib-файлы. При использовании доступа к параметрам по названию необходимо подключить mib-файл STG-MIB. Далее следуют два аргумента: адрес SNMP-сервера и название параметра. Утилита snmpget позволяет получить значение скалярных параметров — параметров имеющих только одно значение. Для доступа к таблицам и деревьям используется утилита snmpwalk имеющая такой-же синтаксис.</para>
     <para>Можно обращаться к параметрам по цифровому OID: snmpwalk -v2c -ccommunity_w 10.0.0.1 .1.3.6.1.4.1.38313.1.2. В этом случае загружать дополнительные mib-файлы не требуется. «.1.3.6.1.4.1» - OID enterprise-ветки всего дерева SNMP. «38313» - официально полученный от IANA (http://www.iana.org) enterprise-номер, уникально идентифицирующий дерево параметров Stargazer. Следующая за ним цифра 1 говорит о том что мы работаем с узлом stg24. «.1.3.6.1.4.1.38313.1.2» - OID таблицы tariffUsageTable.</para>
     <para>Для того чтобы установить взаимодействие между плагином smux и дэмоном snmpd нужно провести дополнительную настройку последнего. А именно: указать в конфигурационном файле (обычно это /stc/snmp/snmpd.conf) параметр smuxpeer (OID обслуживаемый плагином, в нашем случае это .1.3.6.1.4.1.38313) и smuxsocket (IP-адрес с которого будут приходить пакеты от smux-плагина).</para>
-    </sect2>
   </simplesect>
   <simplesect>
-    <title>Ð\9dаÑ\81Ñ\82Ñ\80ойка ÐºÐ¾Ð½Ñ\84игÑ\83Ñ\80аÑ\86ионного Ñ\84айла /etc/stargazer/rules</title>
+    <title>Ð\9aонÑ\84игÑ\83Ñ\80аÑ\86ионнÑ\8bй Ñ\84айл /etc/stargazer/rules</title>
     <para>Файл rules описывает парвила классификации трафика по направлениям тарификации. Это текстовый файл, каждая строка которого описывает одно правило классификации. Формат строки файла:</para>
   <programlisting linenumbering="unnumbered">  
   &lt;протокол&gt; &lt;CIDR&gt;[:&lt;порт&gt;[-&lt;порт&gt;]] &lt;направление&gt;
index 9c3d6e5..741a5aa 100644 (file)
@@ -1,7 +1,7 @@
 <chapter xml:id="ch5">
-       <title>Описание работы с конфигуратором</title>
-       <para>Как и говорилось выше, конфигуратор предназначен для выполнения различных административных действий над клиентами и над некоторыми параметрами сервера.</para>
-       <para>
+  <title>Описание работы с конфигуратором</title>
+  <para>Как и говорилось выше, конфигуратор предназначен для выполнения различных административных действий над клиентами и над некоторыми параметрами сервера.</para>
+  <para>
         Общий вид окна конфигуратора при работе показан ниже:
         <mediaobject>
             <imageobject>
             </imageobject>
         </mediaobject>
     </para>
-       <para>В окне расположены: меню, кнопки быстрого доступа к элементам меню, таблица с информацией о клиентах, панель с дополнительной информацией о клиенте, панель состояния. Следует помнить что почти все команды, вызываемые из конфигуратора будут работоспособны в случае успешного входа на сервер. При этом в панели состояния изменится статус, и появиться имя пользователя, который вошел в систему:
-       <mediaobject>
+  <para>В окне расположены: меню, кнопки быстрого доступа к элементам меню, таблица с информацией о клиентах, панель с дополнительной информацией о клиенте, панель состояния. Следует помнить что почти все команды, вызываемые из конфигуратора будут работоспособны в случае успешного входа на сервер. При этом в панели состояния изменится статус, и появиться имя пользователя, который вошел в систему:
+  <mediaobject>
             <imageobject>
                 <imagedata fileref="images/username.png" format="PNG"/>
             </imageobject>
         </mediaobject>
-       </para>
-       <para>Обзор меню:</para>
-       <itemizedlist mark="opencircle">
-               <listitem><para>Файл — Сохранить — команда сохраняет таблицу с клиентами в указанный текстовый файл по указанному пути.</para></listitem>
-               <listitem><para>Файл — Login… — команда, предназначенная для доступа на сервер. При этом выведется следующее окно, в котором необходимо ввести учетные данные администратора, как они заданы при вводе администратора:
-               <mediaobject>
+  </para>
+  <para>Обзор меню:</para>
+  <itemizedlist mark="opencircle">
+    <listitem><para>Файл — Сохранить — команда сохраняет таблицу с клиентами в указанный текстовый файл по указанному пути.</para></listitem>
+    <listitem><para>Файл — Login… — команда, предназначенная для доступа на сервер. При этом выведется следующее окно, в котором необходимо ввести учетные данные администратора, как они заданы при вводе администратора:
+    <mediaobject>
             <imageobject>
                 <imagedata fileref="images/login.png" format="PNG"/>
             </imageobject>
         </mediaobject>
-               </para>
-               <para>В случае успешного входа конфигуратор отобразит список клиентов, и даст, в зависимости от ограничений администратора доступ к функциям. После первой установки и старта системы, по-умолчанию логин и пароль на вход равны admin и 123456 соответственно.</para>
-               </listitem>
-               <listitem><para>Файл — Logout… — команда, выполняющая выход из системы, при этом таблица клиентов очищается.</para></listitem>
-               <listitem><para>Файл — Печатать всех… — команда выводит предварительный просмотр списка клиентов с указанием трафика по направлениям.</para></listitem>
-               <listitem><para>Файл — Выход — выполняет выход из системы и закрытие окна конфигуратора.</para></listitem>
-               <listitem><para>Правка — Редактировать пользователя... — команда предназначена редактирования данных клиента (дублируется кнопкой
-               <mediaobject>
+    </para>
+    <para>В случае успешного входа конфигуратор отобразит список клиентов, и даст, в зависимости от ограничений администратора доступ к функциям. После первой установки и старта системы, по-умолчанию логин и пароль на вход равны admin и 123456 соответственно.</para>
+    </listitem>
+    <listitem><para>Файл — Logout… — команда, выполняющая выход из системы, при этом таблица клиентов очищается.</para></listitem>
+    <listitem><para>Файл — Печатать всех… — команда выводит предварительный просмотр списка клиентов с указанием трафика по направлениям.</para></listitem>
+    <listitem><para>Файл — Выход — выполняет выход из системы и закрытие окна конфигуратора.</para></listitem>
+    <listitem><para>Правка — Редактировать пользователя... — команда предназначена редактирования данных клиента (дублируется кнопкой
+    <mediaobject>
             <imageobject>
                 <imagedata fileref="images/user-key.png" format="PNG"/>
             </imageobject>
         </mediaobject>
-               ), при её вызове будет вызвано следующее окно:
-               <mediaobject>
+    ), при её вызове будет вызвано следующее окно:
+    <mediaobject>
             <imageobject>
                 <imagedata fileref="images/data-editor.png" format="PNG"/>
             </imageobject>
         </mediaobject>
-               </para>
-               <para>В данном окне отображаются все настройки клиента, так как они будут записаны в конфигурационный файл. Опции и настройки данного окна описаны выше. Все числовые величины должны разделяться только знаком «.» (точка), IP адреса разделяются символом «,» (запятая), если клиенту необходимо иметь доступ с любого IP адреса, то в это поле необходимо занести символ * (звёздочка). В нижней части окна расположена индивидуальная статистика клиента, её можно изменять, для этого необходимо два раза щелкнуть на подлежащему изменению числе, после редактирование подтвердить изменение кнопкой «Enter». Кнопка «?» предназначена для автоматического поиска свободного IP адреса из указанного в настройках диапазона:
-               <mediaobject>
+    </para>
+    <para>В данном окне отображаются все настройки клиента, так как они будут записаны в конфигурационный файл. Опции и настройки данного окна описаны выше. Все числовые величины должны разделяться только знаком «.» (точка), IP адреса разделяются символом «,» (запятая), если клиенту необходимо иметь доступ с любого IP адреса, то в это поле необходимо занести символ * (звёздочка). В нижней части окна расположена индивидуальная статистика клиента, её можно изменять, для этого необходимо два раза щелкнуть на подлежащему изменению числе, после редактирование подтвердить изменение кнопкой «Enter». Кнопка «?» предназначена для автоматического поиска свободного IP адреса из указанного в настройках диапазона:
+    <mediaobject>
             <imageobject>
                 <imagedata fileref="images/ip-search.png" format="PNG"/>
             </imageobject>
         </mediaobject>
-               </para>
-               <para>Признак «Заморожен» предназначен для того, чтобы на определенное время прекратить любые денежные действия со счетом клиента, при установке этого признака со счета клиента снимается сумма, указанная в тарифе. Для того чтобы увидеть пароль клиента, сгенерированный кнопкой «Сгенерировать пароль», необходимо нажать на кнопку «Показать пароль», при этом в первом окне пароля отобразится текущий пароль (через 10 секунд он сам исчезнет снова). Следует помнить что при записи пароли и в первом поле ввода и во втором должны совпадать, иначе система выведет предупреждение и не даст записать данные на клиента. Если данные после изменения успешно записаны, то будет выведено сообщение:
-               <mediaobject>
+    </para>
+    <para>Признак «Заморожен» предназначен для того, чтобы на определенное время прекратить любые денежные действия со счетом клиента, при установке этого признака со счета клиента снимается сумма, указанная в тарифе. Для того чтобы увидеть пароль клиента, сгенерированный кнопкой «Сгенерировать пароль», необходимо нажать на кнопку «Показать пароль», при этом в первом окне пароля отобразится текущий пароль (через 10 секунд он сам исчезнет снова). Следует помнить что при записи пароли и в первом поле ввода и во втором должны совпадать, иначе система выведет предупреждение и не даст записать данные на клиента. Если данные после изменения успешно записаны, то будет выведено сообщение:
+    <mediaobject>
             <imageobject>
                 <imagedata fileref="images/information.png" format="PNG"/>
             </imageobject>
         </mediaobject>
-               </para>
-               <para>В случае изменения тарифа будет выведен вопрос о времени перевода клиента на новый вид тарифа:
-               <mediaobject>
+    </para>
+    <para>В случае изменения тарифа будет выведен вопрос о времени перевода клиента на новый вид тарифа:
+    <mediaobject>
             <imageobject>
                 <imagedata fileref="images/change-in-tariff-user.png" format="PNG"/>
             </imageobject>
         </mediaobject>
-               </para>
-               <para>Если был выбран вариант «Немедленно», то тариф применится к клиентскому аккаунту немедленно, иначе в случае выбора варианта «В следующем месяце» тариф применится с 1 числа следующего месяца автоматически, при этом строка с клиентом, у которого изменится тариф примет вид:
-               <mediaobject>
+    </para>
+    <para>Если был выбран вариант «Немедленно», то тариф применится к клиентскому аккаунту немедленно, иначе в случае выбора варианта «В следующем месяце» тариф применится с 1 числа следующего месяца автоматически, при этом строка с клиентом, у которого изменится тариф примет вид:
+    <mediaobject>
             <imageobject>
                 <imagedata fileref="images/tariff.png" format="PNG"/>
             </imageobject>
         </mediaobject>
-               </para>
-               <para>Т. е. в колонке «Тариф» появится запись двойного тарифа, где перед знаком «/» находится текущий, а после – тот тариф, который будет применен со следующего месяца. Следует учитывать что при переходе на другой тариф в течении месяца (выбрана опция «Немедленно») система пересчитает средства на счёте следующим образом: если в тарифе есть абонплата, то с переходом на новый тариф с клиента будет снята часть абонплаты от того тарифа с которого переходят и в конце месяца с него будет снята часть абонплаты от того тарифа на который перевели. Аналогично клиент получит только часть бесплатных Мб от того тарифа на который его перевели.</para>
-               </listitem>
-               <listitem><para>Правка - Добавить пользователя... – команда, позволяющая добавить нового клиента в систему (дублируется кнопкой
-               <mediaobject>
+    </para>
+    <para>Т. е. в колонке «Тариф» появится запись двойного тарифа, где перед знаком «/» находится текущий, а после – тот тариф, который будет применен со следующего месяца. Следует учитывать что при переходе на другой тариф в течении месяца (выбрана опция «Немедленно») система пересчитает средства на счёте следующим образом: если в тарифе есть абонплата, то с переходом на новый тариф с клиента будет снята часть абонплаты от того тарифа с которого переходят и в конце месяца с него будет снята часть абонплаты от того тарифа на который перевели. Аналогично клиент получит только часть бесплатных Мб от того тарифа на который его перевели.</para>
+    </listitem>
+    <listitem><para>Правка - Добавить пользователя... – команда, позволяющая добавить нового клиента в систему (дублируется кнопкой
+    <mediaobject>
             <imageobject>
               <imagedata fileref="images/new-customer.png" format="PNG"/>
             </imageobject>
         </mediaobject>
-               ). При вызове этой команды будет выведено окно для заполнения свойств клиента:
-               <mediaobject>
+    ). При вызове этой команды будет выведено окно для заполнения свойств клиента:
+    <mediaobject>
             <imageobject>
               <imagedata fileref="images/create-new-user.png" format="PNG"/>
             </imageobject>
         </mediaobject>
-               </para>
-               <para>Обязательными к заполнению являются поля: логин, пароль и его подтверждение, IP-адрес(а), тарифный план. Остальные поля и опции  являются необязательными. В случае если какой то обязательный параметр не заполнен, система сообщит об ошибке и предложит ввести недостающие данные, если же все данные указаны верно, то система запишет нового клиента в систему. Также при добавлении нового клиента система выставит количество бесплатных Мб которое стоит в тарифе, установленном клиенту, пропорционально времени оставшемуся до обнуления статистики. Также с клиента будет снята абонаплата выставленная в тарифе пропорционально времени до конца месяца.</para>
-               </listitem>
-               <listitem><para>Правка - Удалить пользователя... – команда позволяющая удалить клиента из системы, при этом все клиентские настройки не удаляются физически на сервере, а переносятся в специальную папку /deleted_users.Команда дублируется кнопкой
-               <mediaobject>
+    </para>
+    <para>Обязательными к заполнению являются поля: логин, пароль и его подтверждение, IP-адрес(а), тарифный план. Остальные поля и опции  являются необязательными. В случае если какой то обязательный параметр не заполнен, система сообщит об ошибке и предложит ввести недостающие данные, если же все данные указаны верно, то система запишет нового клиента в систему. Также при добавлении нового клиента система выставит количество бесплатных Мб которое стоит в тарифе, установленном клиенту, пропорционально времени оставшемуся до обнуления статистики. Также с клиента будет снята абонаплата выставленная в тарифе пропорционально времени до конца месяца.</para>
+    </listitem>
+    <listitem><para>Правка - Удалить пользователя... – команда позволяющая удалить клиента из системы, при этом все клиентские настройки не удаляются физически на сервере, а переносятся в специальную папку /deleted_users.Команда дублируется кнопкой
+    <mediaobject>
             <imageobject>
               <imagedata fileref="images/delete-user.png" format="PNG"/>
             </imageobject>
         </mediaobject>.
-               При вызове этой команды будет вызвано подтверждение на удаление:
-               <mediaobject>
+    При вызове этой команды будет вызвано подтверждение на удаление:
+    <mediaobject>
             <imageobject>
               <imagedata fileref="images/confirm-delete-user.png" format="PNG"/>
             </imageobject>
         </mediaobject>.
-               </para>
-               </listitem>
-               <listitem><para>Правка – Тарифные планы... – команда вызывающая редактор тарифных планов (дублируется кнопкой 
-               <mediaobject>
+    </para>
+    </listitem>
+    <listitem><para>Правка – Тарифные планы... – команда вызывающая редактор тарифных планов (дублируется кнопкой 
+    <mediaobject>
             <imageobject>
               <imagedata fileref="images/tariff-plans.png" format="PNG"/>
             </imageobject>
         </mediaobject>
-               ):
-               <mediaobject>
+    ):
+    <mediaobject>
             <imageobject>
               <imagedata fileref="images/editor-rate-plans.png" format="PNG"/>
             </imageobject>
         </mediaobject>
-               </para>
-               <para>Цены вводятся через знак «/» - это разделение цены до/после перехода порога по направлению, если цена будет введена без знака «/», то она будет применена как к трафику до, так и после превышения одинаково. Порог устанавливается в поле «Порог (Мб)», если установлен признак «Без порога», то цена вводиться одна. В стоимость заморозки устанавливается сумма, которая будет снята с клиента при установке признака «Заморожен».</para>
-               <para>После изменения тарифного плана необходимо нажать кнопку «Сохранить» для записи данных. Измененный тарифный план начинает применяться сразу после записи.</para>
-               </listitem>
-               <listitem><para>Правка – Администраторы – команда, позволяющая изменять права администраторов и добавлять/удалять их. Дублируется кнопкой
-               <mediaobject>
+    </para>
+    <para>Цены вводятся через знак «/» - это разделение цены до/после перехода порога по направлению, если цена будет введена без знака «/», то она будет применена как к трафику до, так и после превышения одинаково. Порог устанавливается в поле «Порог (Мб)», если установлен признак «Без порога», то цена вводиться одна. В стоимость заморозки устанавливается сумма, которая будет снята с клиента при установке признака «Заморожен».</para>
+    <para>После изменения тарифного плана необходимо нажать кнопку «Сохранить» для записи данных. Измененный тарифный план начинает применяться сразу после записи.</para>
+    </listitem>
+    <listitem><para>Правка – Администраторы – команда, позволяющая изменять права администраторов и добавлять/удалять их. Дублируется кнопкой
+    <mediaobject>
             <imageobject>
               <imagedata fileref="images/key-admin.png" format="PNG"/>
             </imageobject>
         </mediaobject>
-               , при вызове команды будет выдано окно со списком текущих администраторов:
-               <mediaobject>
+    , при вызове команды будет выдано окно со списком текущих администраторов:
+    <mediaobject>
             <imageobject>
               <imagedata fileref="images/administrators.png" format="PNG"/>
             </imageobject>
         </mediaobject>
-               </para>
-               <para>Пароль и подтверждение пароля в целях безопасности не отображаются, при записи если оставить незаполненными поля пароля, то он изменен не будет. Для сохранения сделанных изменений необходимо нажать кнопку «Сохранить». В случае успешного сохранения данных администратора будет выведено сообщение:
-               <mediaobject>
+    </para>
+    <para>Пароль и подтверждение пароля в целях безопасности не отображаются, при записи если оставить незаполненными поля пароля, то он изменен не будет. Для сохранения сделанных изменений необходимо нажать кнопку «Сохранить». В случае успешного сохранения данных администратора будет выведено сообщение:
+    <mediaobject>
             <imageobject>
               <imagedata fileref="images/inform-admin.png" format="PNG"/>
             </imageobject>
         </mediaobject>
-               </para>
-               <para>Если имела место какая-либо ошибка, сервер сообщит об ней.</para>
-               </listitem>
-               <listitem><para>Инструменты - Статистика – команда отображает общую статистику по направлениям, с визуальным обзором на диаграмме:
-               <mediaobject>
+    </para>
+    <para>Если имела место какая-либо ошибка, сервер сообщит об ней.</para>
+    </listitem>
+    <listitem><para>Инструменты - Статистика – команда отображает общую статистику по направлениям, с визуальным обзором на диаграмме:
+    <mediaobject>
             <imageobject>
               <imagedata fileref="images/statistics.png" format="PNG"/>
             </imageobject>
         </mediaobject>
-               </para>
-               <para>При выборе вариантов внизу соответственно будет перерисована диаграмма. Также можно указать по каким клиентам показывать суммарную статистику: по всем или только по отфильтрованным, и какую собственно на диаграмме прорисовывать статистику.</para>
-               </listitem>
-               <listitem><para>Инструменты – Фильтр – команда позволяет отфильтровать текущую таблицу с данными о клиентах по заданному фильтру:
-               <mediaobject>
+    </para>
+    <para>При выборе вариантов внизу соответственно будет перерисована диаграмма. Также можно указать по каким клиентам показывать суммарную статистику: по всем или только по отфильтрованным, и какую собственно на диаграмме прорисовывать статистику.</para>
+    </listitem>
+    <listitem><para>Инструменты – Фильтр – команда позволяет отфильтровать текущую таблицу с данными о клиентах по заданному фильтру:
+    <mediaobject>
             <imageobject>
               <imagedata fileref="images/filter.png" format="PNG"/>
             </imageobject>
         </mediaobject>
-               </para>
-               </listitem>
-               <listitem><para>Инструменты - Разослать письма... – команда позволяет разослать письма указанным клиентам с сервера:
-               <mediaobject>
+    </para>
+    </listitem>
+    <listitem><para>Инструменты - Разослать письма... – команда позволяет разослать письма указанным клиентам с сервера:
+    <mediaobject>
             <imageobject>
               <imagedata fileref="images/notification-letters.png" format="PNG"/>
             </imageobject>
         </mediaobject>
-               </para>
-               <para>В поля From, Subject заносятся электронный адрес отправителя и тема писем соответственно.</para>
+    </para>
+    <para>В поля From, Subject заносятся электронный адрес отправителя и тема писем соответственно.</para>
     <para>Кнопка «Все» позволяет выделить всех клиентов из списка, «Никто» - убирает выделение со всех в списке, «Должники» - выделяет клиентов, у которых баланс меньше нуля и превысил «Кредит», «Инверсия» - позволяет инвертировать выделение, т. е. все кто был помеченными станут непомеченными и наоборот. Кнопки «Загрузить шаблон» и «Сохранить шаблон» позволяют загружать исходный и сохранять текущий шаблоны соответственно. В «Подстановках» можно выбрать спец. Макросы, которые потом при отправке каждому клиенту заменяться на реальные для него цифры или информацию. Пример сохраненного шаблона:</para>
 <programlisting numbering="unnumbered">
-               admin@my.net
+    admin@my.net
 Состояние счета
 Уважаемый пользователь %name!
 
 
 С уважением, администрация сети my.net
 </programlisting>
-               <para>Кнопка «Просмотр» позволяет просмотреть итоговое сообщение для выбранного клиента:
-               <mediaobject>
+    <para>Кнопка «Просмотр» позволяет просмотреть итоговое сообщение для выбранного клиента:
+    <mediaobject>
             <imageobject>
               <imagedata fileref="images/view-letter.png" format="PNG"/>
             </imageobject>
         </mediaobject>
-               </para>
-               <para>Следует помнить что для корректной рассылки писем в настройках необходимо указать SMTP сервер. Рассылка писем предусматривает сохранение и восстановление шаблонов.</para>
-               </listitem>
-               <listitem><para>Инструменты – Отправить сообщение – команда предназначена для отправки сообщений клиентам, в данный момент находящимся в OnLine или в OffLine (следует учитывать, что сообщение дойдет моментально только лишь в том случае, если клиент пользуется в данный момент авторизатором, если же клиент в данный момент находится в состоянии OffLine, то сообщение дойдет сразу же после первого подключения):
-               <mediaobject>
+    </para>
+    <para>Следует помнить что для корректной рассылки писем в настройках необходимо указать SMTP сервер. Рассылка писем предусматривает сохранение и восстановление шаблонов.</para>
+    </listitem>
+    <listitem><para>Инструменты – Отправить сообщение – команда предназначена для отправки сообщений клиентам, в данный момент находящимся в OnLine или в OffLine (следует учитывать, что сообщение дойдет моментально только лишь в том случае, если клиент пользуется в данный момент авторизатором, если же клиент в данный момент находится в состоянии OffLine, то сообщение дойдет сразу же после первого подключения):
+    <mediaobject>
             <imageobject>
               <imagedata fileref="images/send-message.png" format="PNG"/>
             </imageobject>
         </mediaobject>
-               </para>
-               <para>При отправке сообщения можно задать пользователей, которым уйдет сообщение, интервал повторения сообщения в минутах, количество повторений, а также время в секундах, в течении которого окно с сообщением будет держаться на экране у пользователя.</para>
-               </listitem>
-               <listitem><para>Инструменты – Очистить таблицу пользователей – команда позволяет очистить таблицу клиентов и их статистики, однако следует понимать что таблица очищается только в окне конфигуратора, никакие данные на сервере изменены не будут.</para></listitem>
-               <listitem><para>Настройки – Настройки... – команда вызывает окно с настройками конфигуратора (дублируется кнопкой
-               <mediaobject>
+    </para>
+    <para>При отправке сообщения можно задать пользователей, которым уйдет сообщение, интервал повторения сообщения в минутах, количество повторений, а также время в секундах, в течении которого окно с сообщением будет держаться на экране у пользователя.</para>
+    </listitem>
+    <listitem><para>Инструменты – Очистить таблицу пользователей – команда позволяет очистить таблицу клиентов и их статистики, однако следует понимать что таблица очищается только в окне конфигуратора, никакие данные на сервере изменены не будут.</para></listitem>
+    <listitem><para>Настройки – Настройки... – команда вызывает окно с настройками конфигуратора (дублируется кнопкой
+    <mediaobject>
             <imageobject>
               <imagedata fileref="images/key-settingsconfig.png" format="PNG"/>
             </imageobject>
         </mediaobject>
-               ):</para>
-               <para>
-               <mediaobject>
+    ):</para>
+    <para>
+    <mediaobject>
             <imageobject>
               <imagedata fileref="images/network-settings.png" format="PNG"/>
             </imageobject>
         </mediaobject>
-               </para>
-               <para>В данном окне задаются настройки конфигуратора: адрес сервера, порт, адрес почтового сервера и его порт, интервал авто обновления, длина генерируемого пароля и прочие параметры конфигуратора. На закладке «Интерфейс»
-               <mediaobject>
+    </para>
+    <para>В данном окне задаются настройки конфигуратора: адрес сервера, порт, адрес почтового сервера и его порт, интервал авто обновления, длина генерируемого пароля и прочие параметры конфигуратора. На закладке «Интерфейс»
+    <mediaobject>
             <imageobject>
               <imagedata fileref="images/interface.png" format="PNG"/>
             </imageobject>
         </mediaobject>
-               задаются: видимость колонок в окне клиентов, а так же ширина. Признак «Загружать последний шаблон» определяет загружать ли конфигуратору последний шаблон, который был использован при последней отправке писем клиентам.</para>
-               <para>На закладке «Раскраска» можно задать цвета, шрифт и другие параметры отображения в основной таблице и в панели информации.
-               <mediaobject>
+    задаются: видимость колонок в окне клиентов, а так же ширина. Признак «Загружать последний шаблон» определяет загружать ли конфигуратору последний шаблон, который был использован при последней отправке писем клиентам.</para>
+    <para>На закладке «Раскраска» можно задать цвета, шрифт и другие параметры отображения в основной таблице и в панели информации.
+    <mediaobject>
             <imageobject>
               <imagedata fileref="images/coloring.png" format="PNG"/>
             </imageobject>
         </mediaobject>
-               </para>
-               <para>На закладке «Прочее» можно указать, сохранять ли логин и (или) пароль администратора. Пароль шифруется и привязывается к HDD компьютера, однако, НЕ РЕКОМЕНДУЕТСЯ сохранять пароль администратора !!! Также здесь можно задать имена полей типа UserDataN для отображения в конфигураторе и параметры, которые будут показываться в нижней панели информации. В разделе «Подсети и IP–адреса» можно задать имя и начальный адрес для автоматического поиска свободного IP адреса.
-               <mediaobject>
+    </para>
+    <para>На закладке «Прочее» можно указать, сохранять ли логин и (или) пароль администратора. Пароль шифруется и привязывается к HDD компьютера, однако, НЕ РЕКОМЕНДУЕТСЯ сохранять пароль администратора !!! Также здесь можно задать имена полей типа UserDataN для отображения в конфигураторе и параметры, которые будут показываться в нижней панели информации. В разделе «Подсети и IP–адреса» можно задать имя и начальный адрес для автоматического поиска свободного IP адреса.
+    <mediaobject>
             <imageobject>
               <imagedata fileref="images/other-settings.png" format="PNG"/>
             </imageobject>
         </mediaobject>
-               </para>
-               </listitem>
-               <listitem><para>Настройки – Информация о сервере – команда позволяет узнать некоторую информацию о сервере, о его версии и некоторые другие данные:
-               <mediaobject>
+    </para>
+    </listitem>
+    <listitem><para>Настройки – Информация о сервере – команда позволяет узнать некоторую информацию о сервере, о его версии и некоторые другие данные:
+    <mediaobject>
             <imageobject>
               <imagedata fileref="images/informserver.png" format="PNG"/>
             </imageobject>
         </mediaobject>
-               </para>
-               <para>Кнопка
-               <mediaobject>
+    </para>
+    <para>Кнопка
+    <mediaobject>
             <imageobject>
               <imagedata fileref="images/update.png" format="PNG"/>
             </imageobject>
         </mediaobject>
-               позволяет обновить данные о клиентах в таблице.</para>
-               <para>Кнопка
-               <mediaobject>
+    позволяет обновить данные о клиентах в таблице.</para>
+    <para>Кнопка
+    <mediaobject>
             <imageobject>
               <imagedata fileref="images/autoupdate.png" format="PNG"/>
             </imageobject>
         </mediaobject>
-               позволяет включать или отключать авто обновление данных. В настройках конфигуратора можно задать интервал авто обновления.</para>
-               </listitem>
-       </itemizedlist>
+    позволяет включать или отключать авто обновление данных. В настройках конфигуратора можно задать интервал авто обновления.</para>
+    </listitem>
+  </itemizedlist>
 </chapter>
index 118704c..5325f75 100644 (file)
@@ -1,29 +1,29 @@
 <chapter xml:id="ch6">
-       <title>Описание работы с GUI-авторизатором</title>
-       <para>Клиентский авторизатор предназначен для выдачи клиентам сети. С помощью него возможно узнать состояние счета, а так же состояние перекачанного трафика по направлениям. Сервер системы может работать со старыми версиями авторизаторов, т. е. сохраняется обратная совместимость, однако по мере возможности необходимо обновлять клиентские авторизаторы до последних версий.</para>
-       <para>Основное окно авторизатора показано ниже:
+    <title>Описание работы с авторизатором InetAccess.</title>
+    <para>Клиентский авторизатор предназначен для выдачи клиентам сети. С помощью него возможно узнать состояние счета, а так же состояние перекачанного трафика по направлениям. Сервер системы может работать со старыми версиями авторизаторов, т. е. сохраняется обратная совместимость, однако по мере возможности необходимо обновлять клиентские авторизаторы до последних версий.</para>
+    <para>Основное окно авторизатора показано ниже:
         <mediaobject>
             <imageobject>
                 <imagedata fileref="images/inetaccess-main.png" format="PNG"/>
             </imageobject>
         </mediaobject>
     </para>
-         <para>В поля Имя и Пароль вводятся, выданные администрацией сети, логин и пароль соответственно.</para>
-         <para>Кнопка «Сообщения» служит для просмотра истории сообщений, отправленных администрацией сети:
-         <mediaobject>
+    <para>В поля Имя и Пароль вводятся, выданные администрацией сети, логин и пароль соответственно.</para>
+    <para>Кнопка «Сообщения» служит для просмотра истории сообщений, отправленных администрацией сети:
+    <mediaobject>
         <imageobject>
             <imagedata fileref="images/messages.png" format="PNG"/>
         </imageobject>
     </mediaobject>
-       </para>
-       <para>В отключенном состоянии авторизатор имеет следующий вид:
+    </para>
+    <para>В отключенном состоянии авторизатор имеет следующий вид:
         <mediaobject>
             <imageobject>
                 <imagedata fileref="images/of-authorities.png" format="PNG"/>
             </imageobject>
         </mediaobject>
-               </para>
-               <para>Для того чтобы авторизоваться, необходимо заполнить все поля, выбрать при необходимости те направления, к которым следует подключиться и нажать кнопку «Подключиться». Направления необходимо выбрать с помощью кнопки
+    </para>
+    <para>Для того чтобы авторизоваться, необходимо заполнить все поля, выбрать при необходимости те направления, к которым следует подключиться и нажать кнопку «Подключиться». Направления необходимо выбрать с помощью кнопки
         <mediaobject>
             <imageobject>
                 <imagedata fileref="images/key.png" format="PNG"/>
                 <imagedata fileref="images/internet-access.png" format="PNG"/>
             </imageobject>
         </mediaobject>
-               </para>
-               <para>После подключения направления, выбранные для подключения будут отмечены символом «V», а направления к которым подключаться не требуется, будете отмечены символом «Х» в колонке авторизатора «V/X».</para>
-               <para>При успешном подключении окно авторизатора примет следующий вид:
+    </para>
+    <para>После подключения направления, выбранные для подключения будут отмечены символом «V», а направления к которым подключаться не требуется, будете отмечены символом «Х» в колонке авторизатора «V/X».</para>
+    <para>При успешном подключении окно авторизатора примет следующий вид:
         <mediaobject>
             <imageobject>
                 <imagedata fileref="images/window-of-authorities.png" format="PNG"/>
             </imageobject>
         </mediaobject>
-               </para>
-               <para>Если же по каким-то причинам подключение не удастся, то авторизатор сообщит об этом:
+    </para>
+    <para>Если же по каким-то причинам подключение не удастся, то авторизатор сообщит об этом:
         <mediaobject>
             <imageobject>
                 <imagedata fileref="images/error.png" format="PNG"/>
             </imageobject>
         </mediaobject>
-               </para>
-               <para>При этом будет сообщено именно о той ошибке, которая имеет место в вашей ситуации.</para>
-               <simplesect>
+    </para>
+    <para>При этом будет сообщено именно о той ошибке, которая имеет место в вашей ситуации.</para>
+    <simplesect>
         <title>Описание настроек авторизатора.</title>
         <para>Для вызова диалога настроек авторизатора нажмите кнопку
           <mediaobject>
         </itemizedlist>
         <para>В конфигурационном файле авторизатора (InetAccess.ini) можно указать параметры, которые не могут быть изменены с помощью окна «Настройка». Параметр IPEditable, если он принимает значение 1, то в окне настроек авторизатора становится недоступным поле IP адрес сервера. Параметр PortEditable, если он принимает значение 1, то в окне настроек авторизатора становится недоступным поле порт сервера. Рекомендуется при выдаче пользователям авторизатора, выдавать и файл настроек с прописанными значениями IP и порта сервера биллинга, а также прописывать IPEditable=1 и PortEditable=1. Параметр NeverSavePassword отвечает за возможность установки флага «Сохранять пароль». Если значение данного параметра равно 1, то авторизатор не позволит установить этот признак, и соответственно не будет сохранять и восстанавливать пароль. Параметр Currency позволяет задать название валюты для отображения в авторизаторе, в которой ведется учет в биллинговой системе.</para>
         <para>Авторизатор имеет возможность смены иконок, которые будут отображаться в системном трее. Для того, чтобы авторизатор принял пользовательские иконки, следует в том каталоге, где расположен InetAccess.exe создать папку ico и положить туда файлы с иконками. Файлы должны иметь определенные имена: ia_green.bmp, ia_grey.bmp, ia_red.bmp, ia_yellow.bmp. Если пользовательские иконки не будут заданы или будет отсутствовать папка ico, то будут использованы стандартные иконки, встроенные в авторизатор.</para>
-               </simplesect>
+    </simplesect>
 </chapter>
index cdc2ef1..c83533a 100644 (file)
@@ -1,9 +1,9 @@
 <chapter xml:id="ch9">
-       <title>Лицензия, авторы, копирайты, благодарности.</title>
-       <para>Система распространяется по лицензии GPL v2.</para>
-       <para>Авторами системы являются Борис Михайленко aka stg-34 stg34@stargazer.dp.ua, Максим Мороз, Максим Мамонтов aka madf faust@stargazer.dp.ua, Игорь Лысейко и другие.</para>
-       <para>Авторами файлов справки являются Георгий Филонов aka egor2fsys egor2fsys@gmail.com, Максим Мамонтов aka madf faust@stargazer.dp.ua и Елена Шевелева burmuar@gmail.com.</para>
-       <para>В системе использована библиотека LibExpat (http://expat.sourceforge.net/).</para>
-       <para>Модуль БД на основе СУБД Firebird использует библиотеки fbclient (http://www.firebirdsql.org) и IBPP (http://www.ibpp.org). Модуль БД на основе СУБД MySQL использует библиотеку mysqlclient_r (http://dev.mysql.com). Модуль БД на основе СУБД PostgreSQL использует библиотеку pq (http://www.postgresql.org).</para>
-       <para>Авторы выражают благодарность всем администраторам и пользователям Stargazer за сообщения об ошибках и предложения новых возможностей системы. Также выражаем благодарность форумам «Локальные сети Украины» и «Домашние сети России». </para>
+  <title>Лицензия, авторы, копирайты, благодарности.</title>
+  <para>Система распространяется по лицензии GPL v2.</para>
+  <para>Авторами системы являются Борис&nbsp;Михайленко aka <ulink url="mailto:stg32@stargazer.dp.ua">stg-34</ulink>, Максим&nbsp;Мороз, Максим&nbsp;Мамонтов aka <ulink url="mailto:faust@stargazer.dp.ua">madf</ulink>, Игорь&nbsp;Лысейко и другие.</para>
+  <para>Авторами файлов справки являются Георгий&nbsp;Филонов aka <ulink url="mailto:egor2fsys@gmail.com">egor2fsys</ulink>, Максим&nbsp;Мамонтов aka <ulink url="mailto:faust@stargazer.dp.ua">madf</ulink> и Елена&nbsp;Шевелева.</para>
+  <para>В системе использована библиотека <ulink url="http://expat.sourceforge.net/">LibExpat</ulink>.</para>
+  <para>Модуль БД на основе СУБД&nbsp;Firebird использует библиотеки <ulink url="http://www.firebirdsql.org">libfbclient</ulink> и <ulink url="http://www.ibpp.org">IBPP</ulink>. Модуль БД на основе СУБД&nbsp;MySQL использует библиотеку <ulink url="http://dev.mysql.com">libmysqlclient_r</ulink>. Модуль БД на основе СУБД&nbsp;PostgreSQL использует библиотеку <ulink url="http://www.postgresql.org">libpq</ulink>.</para>
+  <para>Авторы выражают благодарность всем администраторам и пользователям Stargazer за сообщения об ошибках и предложения новых возможностей системы. Также выражаем благодарность форумам «Локальные сети Украины» и «Домашние сети России». </para>
 </chapter>
index c1eef8a..f9e703a 100644 (file)
@@ -1,30 +1,42 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V5.0//EN"
-               "docbook.dtd" [
-<!ENTITY % local.common.attrib
-"xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2001/XInclude'">
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V4.5//EN"
+                      "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+
+<!ENTITY ch1  SYSTEM "ch1.xml">
+<!ENTITY ch2  SYSTEM "ch2.xml">
+<!ENTITY ch3  SYSTEM "ch3.xml">
+<!ENTITY ch4  SYSTEM "ch4.xml">
+<!ENTITY ch5  SYSTEM "ch5.xml">
+<!ENTITY ch6  SYSTEM "ch6.xml">
+<!ENTITY ch7  SYSTEM "ch7.xml">
+<!ENTITY ch8  SYSTEM "ch8.xml">
+<!ENTITY ch9  SYSTEM "ch9.xml">
+<!ENTITY ch10 SYSTEM "ch10.xml">
+<!ENTITY ch11 SYSTEM "ch11.xml">
+<!ENTITY ch12 SYSTEM "ch12.xml">
+<!ENTITY ch13 SYSTEM "ch13.xml">
+
 ]>
-<book xmlns="http://docbook.org/ns/docbook"
-      xmlns:xi="http://www.w3.org/2001/XInclude" version="5.0"
-      lang="ru">
-    <info>
-        <title>Stargazer - руководство пользователя</title>
-        <author>
-            <personname><firstname>Maxim</firstname><surname>Mamontov</surname></personname>
-        </author>
-        <copyright><year>2011</year><holder>Maxim Mamontov</holder></copyright>
-    </info>
-    <xi:include href="ch1.xml"/>
-    <xi:include href="ch2.xml"/>
-    <xi:include href="ch3.xml"/>
-    <xi:include href="ch4.xml"/>
-    <xi:include href="ch5.xml"/>
-    <xi:include href="ch6.xml"/>
-    <xi:include href="ch7.xml"/>
-    <xi:include href="ch8.xml"/>
-    <xi:include href="ch9.xml"/>
-    <xi:include href="ch10.xml"/>
-    <xi:include href="ch11.xml"/>
-    <xi:include href="ch12.xml"/>
-    <xi:include href="ch13.xml"/>
+
+<book lang="ru">
+  <bookinfo>
+    <title>Stargazer — руководство пользователя</title>
+    <author>
+      <personname><firstname>Maxim</firstname><surname>Mamontov</surname></personname>
+    </author>
+    <copyright><year>2016</year><holder>Maxim Mamontov</holder></copyright>
+  </bookinfo>
+  &ch1;
+  &ch2;
+  &ch3;
+  &ch4;
+  &ch5;
+  &ch6;
+  &ch7;
+  &ch8;
+  &ch9;
+  &ch10;
+  &ch11;
+  &ch12;
+  &ch13;
 </book>
diff --git a/doc/help/images/administrators.png b/doc/help/images/administrators.png
new file mode 100644 (file)
index 0000000..b6e6b39
Binary files /dev/null and b/doc/help/images/administrators.png differ
diff --git a/doc/help/images/autoupdate.png b/doc/help/images/autoupdate.png
new file mode 100644 (file)
index 0000000..ef4e976
Binary files /dev/null and b/doc/help/images/autoupdate.png differ
diff --git a/doc/help/images/change-in-tariff-user.png b/doc/help/images/change-in-tariff-user.png
new file mode 100644 (file)
index 0000000..1869902
Binary files /dev/null and b/doc/help/images/change-in-tariff-user.png differ
diff --git a/doc/help/images/coloring.png b/doc/help/images/coloring.png
new file mode 100644 (file)
index 0000000..8813f71
Binary files /dev/null and b/doc/help/images/coloring.png differ
diff --git a/doc/help/images/confirm-delete-user.png b/doc/help/images/confirm-delete-user.png
new file mode 100644 (file)
index 0000000..ccf108a
Binary files /dev/null and b/doc/help/images/confirm-delete-user.png differ
diff --git a/doc/help/images/create-new-user.png b/doc/help/images/create-new-user.png
new file mode 100644 (file)
index 0000000..65eba71
Binary files /dev/null and b/doc/help/images/create-new-user.png differ
diff --git a/doc/help/images/data-editor.png b/doc/help/images/data-editor.png
new file mode 100644 (file)
index 0000000..7e86600
Binary files /dev/null and b/doc/help/images/data-editor.png differ
diff --git a/doc/help/images/delete-user.png b/doc/help/images/delete-user.png
new file mode 100644 (file)
index 0000000..f526e78
Binary files /dev/null and b/doc/help/images/delete-user.png differ
diff --git a/doc/help/images/display-statistics-floating.png b/doc/help/images/display-statistics-floating.png
new file mode 100644 (file)
index 0000000..aaba6d9
Binary files /dev/null and b/doc/help/images/display-statistics-floating.png differ
diff --git a/doc/help/images/dowload.png b/doc/help/images/dowload.png
new file mode 100644 (file)
index 0000000..2e59cdb
Binary files /dev/null and b/doc/help/images/dowload.png differ
diff --git a/doc/help/images/editor-rate-plans.png b/doc/help/images/editor-rate-plans.png
new file mode 100644 (file)
index 0000000..a46bcd6
Binary files /dev/null and b/doc/help/images/editor-rate-plans.png differ
diff --git a/doc/help/images/error.png b/doc/help/images/error.png
new file mode 100644 (file)
index 0000000..548cebd
Binary files /dev/null and b/doc/help/images/error.png differ
diff --git a/doc/help/images/filter.png b/doc/help/images/filter.png
new file mode 100644 (file)
index 0000000..59cadd6
Binary files /dev/null and b/doc/help/images/filter.png differ
diff --git a/doc/help/images/firebird-erd.png b/doc/help/images/firebird-erd.png
new file mode 100644 (file)
index 0000000..b114ec5
Binary files /dev/null and b/doc/help/images/firebird-erd.png differ
diff --git a/doc/help/images/inetaccess-main.png b/doc/help/images/inetaccess-main.png
new file mode 100644 (file)
index 0000000..aba4667
Binary files /dev/null and b/doc/help/images/inetaccess-main.png differ
diff --git a/doc/help/images/inform-admin.png b/doc/help/images/inform-admin.png
new file mode 100644 (file)
index 0000000..35d45f8
Binary files /dev/null and b/doc/help/images/inform-admin.png differ
diff --git a/doc/help/images/information.png b/doc/help/images/information.png
new file mode 100644 (file)
index 0000000..629b9ef
Binary files /dev/null and b/doc/help/images/information.png differ
diff --git a/doc/help/images/informserver.png b/doc/help/images/informserver.png
new file mode 100644 (file)
index 0000000..570f9ad
Binary files /dev/null and b/doc/help/images/informserver.png differ
diff --git a/doc/help/images/interface.png b/doc/help/images/interface.png
new file mode 100644 (file)
index 0000000..fb1d200
Binary files /dev/null and b/doc/help/images/interface.png differ
diff --git a/doc/help/images/internet-access.png b/doc/help/images/internet-access.png
new file mode 100644 (file)
index 0000000..86d02cd
Binary files /dev/null and b/doc/help/images/internet-access.png differ
diff --git a/doc/help/images/ip-search.png b/doc/help/images/ip-search.png
new file mode 100644 (file)
index 0000000..579d2c8
Binary files /dev/null and b/doc/help/images/ip-search.png differ
diff --git a/doc/help/images/key-admin.png b/doc/help/images/key-admin.png
new file mode 100644 (file)
index 0000000..7220623
Binary files /dev/null and b/doc/help/images/key-admin.png differ
diff --git a/doc/help/images/key-settingsconfig.png b/doc/help/images/key-settingsconfig.png
new file mode 100644 (file)
index 0000000..7ec9010
Binary files /dev/null and b/doc/help/images/key-settingsconfig.png differ
diff --git a/doc/help/images/key.png b/doc/help/images/key.png
new file mode 100644 (file)
index 0000000..5a5f3d8
Binary files /dev/null and b/doc/help/images/key.png differ
diff --git a/doc/help/images/login.png b/doc/help/images/login.png
new file mode 100644 (file)
index 0000000..8950f95
Binary files /dev/null and b/doc/help/images/login.png differ
diff --git a/doc/help/images/messages.png b/doc/help/images/messages.png
new file mode 100644 (file)
index 0000000..1b07d88
Binary files /dev/null and b/doc/help/images/messages.png differ
diff --git a/doc/help/images/network-settings.png b/doc/help/images/network-settings.png
new file mode 100644 (file)
index 0000000..66f182e
Binary files /dev/null and b/doc/help/images/network-settings.png differ
diff --git a/doc/help/images/new-customer.png b/doc/help/images/new-customer.png
new file mode 100644 (file)
index 0000000..79e2c6e
Binary files /dev/null and b/doc/help/images/new-customer.png differ
diff --git a/doc/help/images/notification-letters.png b/doc/help/images/notification-letters.png
new file mode 100644 (file)
index 0000000..51b9ccd
Binary files /dev/null and b/doc/help/images/notification-letters.png differ
diff --git a/doc/help/images/of-authorities.png b/doc/help/images/of-authorities.png
new file mode 100644 (file)
index 0000000..dcfe756
Binary files /dev/null and b/doc/help/images/of-authorities.png differ
diff --git a/doc/help/images/other-settings.png b/doc/help/images/other-settings.png
new file mode 100644 (file)
index 0000000..391cb8d
Binary files /dev/null and b/doc/help/images/other-settings.png differ
diff --git a/doc/help/images/send-message.png b/doc/help/images/send-message.png
new file mode 100644 (file)
index 0000000..575434a
Binary files /dev/null and b/doc/help/images/send-message.png differ
diff --git a/doc/help/images/set-of-authorities.png b/doc/help/images/set-of-authorities.png
new file mode 100644 (file)
index 0000000..e56029a
Binary files /dev/null and b/doc/help/images/set-of-authorities.png differ
diff --git a/doc/help/images/settings-key.png b/doc/help/images/settings-key.png
new file mode 100644 (file)
index 0000000..5638b9b
Binary files /dev/null and b/doc/help/images/settings-key.png differ
diff --git a/doc/help/images/sgconfig-main.png b/doc/help/images/sgconfig-main.png
new file mode 100644 (file)
index 0000000..e82f325
Binary files /dev/null and b/doc/help/images/sgconfig-main.png differ
diff --git a/doc/help/images/statistics.png b/doc/help/images/statistics.png
new file mode 100644 (file)
index 0000000..733cd06
Binary files /dev/null and b/doc/help/images/statistics.png differ
diff --git a/doc/help/images/tariff-plans.png b/doc/help/images/tariff-plans.png
new file mode 100644 (file)
index 0000000..5756817
Binary files /dev/null and b/doc/help/images/tariff-plans.png differ
diff --git a/doc/help/images/tariff.png b/doc/help/images/tariff.png
new file mode 100644 (file)
index 0000000..de049e5
Binary files /dev/null and b/doc/help/images/tariff.png differ
diff --git a/doc/help/images/up-down-option.png b/doc/help/images/up-down-option.png
new file mode 100644 (file)
index 0000000..ffa4b9e
Binary files /dev/null and b/doc/help/images/up-down-option.png differ
diff --git a/doc/help/images/up-down.png b/doc/help/images/up-down.png
new file mode 100644 (file)
index 0000000..fba0144
Binary files /dev/null and b/doc/help/images/up-down.png differ
diff --git a/doc/help/images/update.png b/doc/help/images/update.png
new file mode 100644 (file)
index 0000000..dda7bf4
Binary files /dev/null and b/doc/help/images/update.png differ
diff --git a/doc/help/images/upload-dowload.png b/doc/help/images/upload-dowload.png
new file mode 100644 (file)
index 0000000..826d37f
Binary files /dev/null and b/doc/help/images/upload-dowload.png differ
diff --git a/doc/help/images/user-button.png b/doc/help/images/user-button.png
new file mode 100644 (file)
index 0000000..ffbd164
Binary files /dev/null and b/doc/help/images/user-button.png differ
diff --git a/doc/help/images/user-key.png b/doc/help/images/user-key.png
new file mode 100644 (file)
index 0000000..b35b12d
Binary files /dev/null and b/doc/help/images/user-key.png differ
diff --git a/doc/help/images/username.png b/doc/help/images/username.png
new file mode 100644 (file)
index 0000000..02a4bf7
Binary files /dev/null and b/doc/help/images/username.png differ
diff --git a/doc/help/images/view-letter.png b/doc/help/images/view-letter.png
new file mode 100644 (file)
index 0000000..d37eeba
Binary files /dev/null and b/doc/help/images/view-letter.png differ
diff --git a/doc/help/images/window-of-authorities.png b/doc/help/images/window-of-authorities.png
new file mode 100644 (file)
index 0000000..cd2df63
Binary files /dev/null and b/doc/help/images/window-of-authorities.png differ