Sisyphus
: 1 2023 | : 18631 | : 37047785
en ru br
ALT
S:7.9-alt0.2
5.1: 6.9-alt0.b2008.11.30.M51.1
4.1: 6.9-alt0.0.b2008.08.05.M41.1
4.0: 6.9-alt0.b2008.11.30.M40.1
3.0: 6.4-alt1
www.altlinux.org/Changes


::
: awstats

                   Gear   Bugs and FR  Repocop 

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"
 
: Vladimir Lettiev aka crux © 2004-2005, Andrew Avramenko aka liks © 2007-2008
: Michael Shigorin