Truedoc

[[TracNav(TOC)]]

h2. Configurare AWStats

Uno dei programmi più interessanti per la gestione delle statistiche dei siti

web è "AWStats":http://awstats.sourceforge.net/, che su una Debian può essere

installato semplicemente con:

<pre>

apt-get install awstats

</pre>

oltre a questo comunque, per poter utilizzare i plugin più interessanti, occorrerà anche installare i seguenti pacchetti:

<pre>

apt-get install libgeo-ipfree-perl liburi-perl libnet-xwhois-perl 

</pre>

Con la configurazione di default si potranno raggiungere le statistiche

<pre>

presente però che per una visualizzazione corretta delle varie icone ed

<pre>

occorre definire un opportuno _alias_ nella configurazione di Apache,

inserendo una riga come la seguente nella configurazione dei virtual host dei

siti che lo utilizzano:

<pre>

Alias /awstats-icon/ /usr/share/awstats/icon/

</pre>

Una volta installato la configurazione deve essere effettuata con i file

<pre>

<pre>

si abbia un singolo sito da tenere sotto controllo. 

Se però si hanno vari _virtual host_ es si gestiscono più siti per ciascuna

macchine si deve usare un file di configurazione per ogni sito che si vuole

tenere sotto osservazione. Per gestire questa configurazione il pacchetto

Debian fornisce alcuni script di ausilio, ma questi richiedono che detti file

abbiano un nome nella forma _awstats.www.sito.it.conf_ (ad esempio per il 

sito http://www.fountainpen.it si dovrà creare

<pre>

All'interno di ciascuno di questi file occorrerà specificare dove si trovano

le statistiche e per quale sito esse sono raccolte, per quanto riguarda le

statistiche occorre specificare in quale file sono mantenuti log di accesso ad

<pre>

tipo: 

<pre>

[[LogFile]]="/var/log/apache2/fountainpen.it-access.log" 

</pre>

dove il file dei log deve essere stato opportunamente generato in maniera

separata per il sito in questione, ad esempio inserendo la riga seguente

nella definizione del relativo virtual host di Apache:

<pre>

[[CustomLog]] /var/log/apache2/fountainpen.it-access.log combined

</pre>

<pre>

dominio per il sito in questione, che andrà impostata con qualcosa del tipo:

<pre>

[[SiteDomain]]="www.fountainpen.it"

</pre>

Si tenga conto che il programma è pensato per aggiornare le statistiche in

maniera incrementale, esso cioè legge dal file di log solo le voci relativi ad

accessi più recenti rispetto agli ultimi che ha classificato. Questo significa

che il programma deve essere fatto eseguire periodicamente tramite _cron_,

in modo da aggiornare le statistiche. 

Il pacchetto Debian installa già uno script per AWStats in

<pre>

ma il default lo esegue solo per un singolo sito. Con Debian viene però

distribuito anche uno script che consente di effettuare la stessa operazione

per una serie di siti, posto che si siano create le rispettive configurazione

con la convenzione esposta in precedenza. Il file si trova sotto

<pre>

<pre>

ritoccare il precedente script di cron per renderlo qualcosa del tipo:

<pre>

0,10,20,30,40,50 * * * * www-data /usr/local/bin/awstats-update

</pre>

Si deve inoltre avere cura di far sì che i file di log siano leggibili dal

programma, che essendo uno script CGI gira con i privilegi del server web,

mentre in genere i log non sono leggibili da esso, per questo occorrerà

aggiustarne i permessi, ed assicurarsi che tali restino nella loro rotazione,

<pre>

seguente:

<pre>

create 640 root www-data

</pre>

Qualora si vogliano ottenere le statistiche per un sito che era già attivo

prima dell'installazione di AWStats le cose si complicano, dato che questo

gestisce gli aggiornamenti in maniera incrementale, per cui leggerà solo dal

log corrente e non da quelli che sono stati ruotati in precedenza. 

Per risolvere questa situazione si può utilizzare un altro script fornito con

<pre>

(su Etch il file è codificato in DOS, occorre eseguire una conversione con il

<pre>

questo caso ci si potrà generare un singolo file contenente tutti i dati

ordinati correttamente con qualcosa del tipo:

<pre>

cd /usr/share/doc/awstats/examples/

./logresolvemerge.pl /var/log/apache2/fountainpen.it-access.* > /root/access.log

</pre>

A questo punto si potranno importare tutti i dati correttamente correggendo il

file di configurazione per utilizzare questo file, inserendovi temporaneamente

la direttiva:

<pre>

[[LogFile]]="/root/access.log" 

</pre>

ed eseguendo a mano il comando:

<pre>

/usr/lib/cgi-bin/awstats.pl -config=www.fountainpen.it -update 

</pre>

<pre>

una volta importati i dati. 

Si tenga presente però che se per sbaglio è stato tentato un update prima di

questa operazione, AWStats avrà già registrato alcuni dati statistici, e

siccome lo script funziona sempre in modalità di aggiornamento, il precedente

comando non aggiungerà i dati risalenti ad accessi anteriori a quelli già

presenti nelle statistiche. Per risolvere questo inconveniente sarà necessario

<pre>

delle statistiche, e rigenerarli dal file completo creato con la procedura

appena illustrata. Questi sono con nomi nella forma

<pre>