33.7. cachemgr.cgi

Le gestionnaire de cache (cachemgr.cgi) est un programme CGI utilisé pour générer des statistiques sur l'espace mémoire utilisé par un processus Squid en cours. Il constitue aussi un moyen plus pratique pour gérer le cache et afficher des statistiques sans avoir à tenir un journal de l'activité du serveur.

33.7.1. Mise en place

Vous avez tout d'abord besoin d'un serveur web en état de marche sur le système. En tant que root, saisissez la commande suivante pour savoir si Apache fonctionne déjà : rcapache status. Si un message comme celui-ci s'affiche :

Checking for service httpd: OK 
Server uptime: 1 day 18 hours 29 minutes 39 seconds   

Dans le cas contraire, vous devez saisir la commande suivante : rcapache start. Cela vous permet de démarrer Apache avec les paramètres par défaut de SUSE LINUX. Enfin, il faut copier le fichier cachemgr.cgi du répertoire /usr/share/doc/packages/squid/scripts/ dans le répertoire /srv/www/cgi-bin d'Apache.

cp /usr/share/doc/packages/squid/scripts/cachemgr.cgi /srv/www/cgi-bin/

33.7.2. Les ACL du gestionnaire de cache dans /etc/squid/squid.conf

Vous disposez de quelques paramètres par défaut pour le gestionnaire de cache dans le fichier original. La première ACL est la plus importante car le gestionnaire de cache essaie de communiquer avec Squid en utilisant le protocole cache_object.

acl manager proto cache_object
acl localhost src 127.0.0.1/255.255.255.255

Les règles suivantes doivent également être contenues :

http_access allow manager localhost
http_access deny manager

Les règles suivantes précisent que le serveur web et Squid s'exécutent sur le même ordinateur. Si la communication entre le gestionnaire de cache et Squid se passe au niveau du serveur web sur un autre ordinateur, ajoutez une ACL supplémentaire comme dans l'Exemple 33.2, « Règles d'accès ».

Exemple 33.2. Règles d'accès

acl manager proto cache_object
acl localhost src 127.0.0.1/255.255.255.255
acl webserver src 192.168.1.7/255.255.255.255 # adresse du serveur web

Ajoutez ensuite les règles de l'Exemple 33.3, « Règles d'accès ».

Exemple 33.3. Règles d'accès

http_access allow manager localhost
http_access allow manager webserver
http_access deny manager

Il est également possible de configurer un mot de passe pour le gestionnaire s'il faut accéder à des options comme par exemple la fermeture du cache à distance ou l'affichage d'informations étendues sur le cache. Vous devez alors configurer le paramètre cachemgr_passwd et la liste des options qui s'affichent avec un mot de passe du gestionnaire. Cette liste apparaît en tant que partie des commentaires dans /etc/squid/squid.conf.

Redémarrez Squid à chaque fois que vous avez modifié le fichier de configuration. Pour ce faire, le plus simple est d'utiliser la commande rcsquid reload.

33.7.3. Affichage des statistiques

Rendez-vous sur la page web correspondante—http://webserver.example.org/cgi-bin/cachemgr.cgi. Cliquez sur Continuer pour afficher les différentes statistiques. Vous trouverez des informations supplémentaires (en anglais) au sujet des différents éléments fournis par le gestionnaire de cache dans la FAQ de Squid : http://www.squid-cache.org/Doc/FAQ/FAQ-9.html.


SUSE LINUX Guide de l'administrateur 9.2