AWStats в ALTLinux
==================

Для минимальной настройки AWStats достаточно:

* Создать конфигурационный файл/файлы в /etc/awstats/. Проще всего
это сделать скопировав входящий в пакет пример:

  cp /usr/share/doc/awstats-6.95/awstats.model.conf /etc/awstats/awstats.<name>.conf

* в созданном файле необходимо как как минимум проверить/задать значения для:

 LogFile=
 LogFormat=
 SiteDomain=
 HostAliases=

Все опции конфигурационного хорошо документированы в комментариях. Полную
информацию о AWStats вы можете получить из html документации, доступной в пакете
awstats-docs.

Обратите внимание на то, что реально используемый формат Log-файлов зависит от
настроек сервера, генерирующего эти файлы. Например, для получения более полной
статистики web-сервера рекомендуется использовать combined формат Log-файлов,
что нужно указать в настройках самого web-сервера.

Обновление статистики
---------------------

cron
~~~~
По умолчанию статистика обновляется автоматически каждый час для всех
конфигурационных файлов, находящихся в /etc/awstats/, и сохраняется в каталоге
/var/lib/awstats/.

Обратите внимание на то, что по умолчанию скрипт обновления статистики
запускается от пользователя awstats, что в случае работы с Log-файлами Apache2
может потребовать, например, добавление этого пользователя в группу apache2 для
возможности чтения Log-файлов. Сделать это можно выполнив:

   usermod -g awstats -G apache,apache2 awstats

CGI
~~~
Обновление статистики из браузера при использовании CGI (опция
AllowToUpdateStatsFromBrowser=1 в конфигурационном файле) не работает с
умолчательным значением DirData (/var/lib/awstats). Если вы желаете использовать
AllowToUpdateStatsFromBrowser=1, то необходимо переназначить DirData в каталог,
доступный для записи web-серверу.

вручную
~~~~~~~
Запуская поставляемые с AWStats скрипты, находящиеся в /usr/share/awstats/tools/
(а также основной скрипт awstats.pl в /usr/share/awstats/wwwroot/cgi-bin/),
можно обновлять статистику и генерировать отчёты самостоятельно.

Ротация
-------
Если по отношению к Log-файлам применяется процедура ротации, то во избежание
потери части статистики рекомендуется добавить скрипт обновления статистики в
prerotate:

Например, для Apache2 в файл /etc/logrotate.d/apache2 добавить:

  prerotate
    if [ -x /usr/share/awstats/tools/awstats_updateall.pl ]; then
      su - -c "/usr/share/awstats/tools/awstats_updateall.pl now \
      -confdir=/etc/awstats \
      -awstatsprog=/usr/share/awstats/wwwroot/cgi-bin/awstats.pl > /dev/null" \
      -s /bin/sh
      awstats
    fi
  endscript

При этом в файле конфигурации awstats может быть полезно использовать параметр
EnableLockForUpdate=1, чтобы быть уверенным, что одновременно запускается только
один процесс обновления.

Просмотр статистики
-------------------
Просмотр автоматически cгенерированной статистики доступен по ссылке:

http://<www.myserver.mydomain>/awstats/awstats.pl?config=<mysite>

Обратите внимание, что для просмотра статистики необходима установка
дополнительного пакета для интеграции с web-сервером.

Обновление с версий ниже 0.95-alt1
----------------------------------

Начиная с версии 0.95-alt1 были изменены пути к некоторым ресурсам. Поэтому для
конфигурационных файлов, созданных для работы с более старыми версиями, может
потребоваться изменение некоторых параметров на новые значения:

 DirIcons="/awstatsicons"
 MiscTrackerUrl="/awstatsjs/awstats_misc_tracker.js"
 StyleSheet="/awstatscss"
 LoadPlugin="graphapplet /awstatsclasses"