Voici le fichier /var/www/html/awstats/tools/httpd_conf fourni par le fichier awstats décompressé :

/var/www/html/awstats/tools/httpd_conf

#
# Content of this file, with correct values, can be automatically added to
# your Apache server by using the AWStats configure.pl tool.
#


# If using Windows and Perl ActiveStat, this is to enable Perl script as CGI.
#ScriptInterpreterSource registry


#
# Directives to add to your Apache conf file to allow use of AWStats as a CGI.
# Note that path "/usr/local/awstats/" must reflect your AWStats install path.
#
Alias /awstatsclasses "/usr/local/awstats/wwwroot/classes/"
Alias /awstatscss "/usr/local/awstats/wwwroot/css/"
Alias /awstatsicons "/usr/local/awstats/wwwroot/icon/"
ScriptAlias /awstats/ "/usr/local/awstats/wwwroot/cgi-bin/"


#
# This is to permit URL access to scripts/files in AWStats directory.
#
<Directory "/usr/local/awstats/wwwroot">
    Options None
    AllowOverride None
    Order allow,deny
    Allow from all
</Directory>

Apache 2.4 a quelques changements :

AllowOverride

est désormais par défaut à None

; Require all granted

remplace le couple Order/Allow

; Require all denied

remplace le couple Order/Deny

; Define

possibilité de définir une variable :

Define variable valeur

à utiliser comme suit :

${variable}

même entre des doubles quotes.

</WRAP>

Pour que le serveur web exécute les scripts Perl (comme awstats.pl), le répertoire qui les contient doit être défini comme un répertoire « cgi », c'est-à-dire un répertoire qui contient des fichiers « exécutables » et non des fichiers de documents.

Pour cela, nous allons créer un hôte virtuel spécial pour Awstats et nous y définirons le répertoire des scripts avec l'option ExecCGI :

Créez avec les droits d'administration le fichier /etc/apache2/sites-available/awstats.conf pour y écrire ceci :

/etc/apache2/sites-available/awstats.conf

Define RACINE /var/www/html

DocumentRoot "/${RACINE}"

# Pour utiliser AWStats comme CGI.
Alias /awstatsclasses "/${RACINE}/awstats/wwwroot/classes/"
Alias /awstatscss "/${RACINE}/awstats/wwwroot/css/"
Alias /awstatsicons "/${RACINE}/awstats/wwwroot/icon/"
ScriptAlias /awstats/ "/${RACINE}/awstats/wwwroot/cgi-bin/"

# Autoriser l'accès par URL aux fichiers et scripts contenus dans le répertoire AWStats
<Directory "/${RACINE}/awstats/wwwroot">
    Require all granted
</Directory>    </Directory>

# Le répertoire cgi-bin contient des scripts accessibles par URL
<Directory "/${RACINE}/awstats/wwwroot/cgi-bin">
    Options +ExecCGI
    Require all granted
</Directory>

<VirtualHost *:80>
    ServerAdmin contact@monsite.tld
    
    ServerName awstats.monsite.tld
    ServerAlias stats.monsite.tld
    VirtualDocumentRoot /${RACINE}/awstats
</VirtualHost>

Redémarrez Apache pour appliquer les modifications :

• sudo systemctl restart apache2.service

Pour être sûr que le changement de format de journal est actif, allez à votre page d'accueil et ouvrez votre fichier journal.

Voici un exemple du type d'enregistrements que vous devriez voir dans votre nouveau fichier journal après le redémarrage d'Apache :

62.161.78.75 - - [dd/mmm/yyyy:hh:mm:ss +0000] "GET / HTTP/1.1" 200 1234 "http://www.from.com/from.html" "Mozilla/4.0 (compatible; MSIE 5.01; Windows NT 5.0)"

Cas d'un serveur lighty

• Ouvrez avec les droits d'administration le fichier /etc/lighttpd/lighttpd.conf pour vérifier les modules activés (dé-commentés au début du fichier). C'est en principe le cas du module mod_alias qui est activé par défaut.
• Activez le module cgi :

  sudo lighty-enable-mod cgi

• Ouvrez avec les droits d'administration le fichier /etc/lighttpd/conf-available/50-awstats.conf pour y écrire ceci :

  /etc/lighttpd/conf-available/50-awstats.conf

  alias.url += ( "/icon/" => "/var/www/awstats/wwwroot/icon/" )
  alias.url += ( "/stat" => "/var/www/awstats/wwwroot/cgi-bin/" )
  
  $HTTP["url"] =~ "^/stat($|/)" {
    # Pour que http://.../stat/ renvoie sur http://.../stats/awstats.pl
    index-file.names = ("awstats.pl")
    
    # perl et cgi
    cgi.assign = (
      ".pl" => "/usr/bin/perl",
      ".cgi" => "/usr/bin/perl"
    )
  }

• Activez le module awstats :

  sudo lighty-enable-mod awstats

• Redémarrez lighty :

  sudo service lighttpd restart

• Redonnez les droits voulus :

  cd /var/www
  sudo chown -R www-data:www-data *
  sudo chmod -R 6770 *

Mise à jour toutes les 10 minutes (multi-domaines)

Si vous êtes en multi domaines, donc avec plusieurs fichiers de configuration dans [RACINE]/awstats/, le plus simple est de faire appel à awstats_updateall ( © Laurent Destailleur)

Pour chaque domaine ou sous-domaine à surveiller, créez ou ouvrez avec les droits d'administration le fichier /etc/cron.d/awstats pour y ajouter une ligne :

/etc/cron.d/awstats

0,10,20,30,40,50 * * * * www-data [RACINE]/awstats/wwwroot/cgi-bin/awstats.pl -config=domaine.tld
0,10,20,30,40,50 * * * * www-data [RACINE]/awstats/wwwroot/cgi-bin/awstats.pl -config=sub.domaine.tld

Utilisation

• Pour afficher les les statistiques pour le domaine domaine.tld, visitez la page http://domaine.tld/stat.
• Pour afficher les les statistiques pour le sous-domaine sub.domaine.tld, visitez la page http://sub.domaine.tld/stat.

Désinstallation

Pour supprimer complètement cette application, il suffit de :

• effacer la ligne du fichier /etc/cron.d/awstats (cf Mise à jour toutes les 10 minutes (multi-domaines))
• désactiver le module awstats de lighty :

  sudo lighty-disable-mod awstats

• effacer le fichier /etc/lighttpd/conf-available/50-awstats.conf :

  sudo rm /etc/lighttpd/conf-available/50-awstats.conf

• effacer le répertoire /var/www/awstats

Voir aussi

• (en) http://www.awstats.org/ (site officiel du logiciel)
• (fr) https://technique.arscenic.org/monitoring/awstats/article/installation-et-configuration-de-base-d-awstats
• (fr) http://www.jouvinio.net/wiki/index.php/Awstats_sous_Apache
• (en) http://server.vijge.net/archive/awstats-statistics-with-sub-domains-on-lighttpd/ (tutoriel bien fait)
• (en) doc officielle : http://www.awstats.org/docs/awstats_setup.html
• (en) https://www.fladi.at/posts/separate-awstats-for-multiple-apache2-vhosts/
• (en) https://debian-administration.org/article/277/Setting_Up_Awstats__for_Apache
• (en) https://wiki.apache.org/httpd/ConfigureApacheForAwStats

Basé sur « [(http://server.vijge.net/archive/awstats-statistics-with-sub-domains-on-lighttpd/]]//