Le module SNMP est une extension permettant de déterminer l'état d'Apache HTTP Server via le protocole SNMP (Simple Network Management Protocol). SNMP est une structure de gestion connue pour Internet qui permet au matériel (tels que les routeurs, les passerelles et les modems) et la partie logicielle (systèmes d'exploitation, couches réseau et applications) de fournir un statut via une base d'informations de gestion (MIB). MIB représente un ensemble d'objets gérés de périphériques distants accessibles via les agents SNMP. Les gestionnaires peuvent demander à un agent les valeurs des objets gérés par l'agent.
IBM HTTP Server prend en charge les bases MIB suivantes :
MIB | Description |
SNMPv2-MIB | Base MIB obligatoire pour chaque agent SNMP. La base MIB a été définie par le groupe de travail SNMPv2. |
WWW-MIB | Base MIB définie pour la gestion des services WWW. La base MIB est définie dans le groupe de travail SYSAPPL MIB du projet IETF. |
APACHE-MIB | Base MIB créée spécifiquement pour Apache HTTP Server. |
Le module SNMP Module doit être chargé via la directive LoadModule afin d'activer SNMP.
Pour Windows NT :
Syntaxe :LoadModule snmp_agt_module modules/IBMModuleSNMP.dll
Pour Unix :
Syntaxe :LoadModule snmp_agt_module libexec/mod_snmp.so
La directive AddModule correspondante est : AddModule
mod_snmp.c
Syntaxe :SNMPenable
L'absence de directive SNMPenable désactive SNMP.
Syntaxe :<SNMP number>...</SNMP>
Module :snmp_agt_module
Le numéro définit le port réseau de réception de l'agent SNMP. Numéro correspond à un nombre entre 0 et 65635. Certains numéros de port (particulièrement ceux inférieurs à 1024) sont réservés pour des protocoles particuliers. Pour obtenir une liste de certains ports définis, reportez-vous à /etc/services. Le port standard du protocole SNMP est 161.
Le port 161 est un des ports spéciaux d'Unix. Tous les ports dont le numéro est inférieur à 1024 sont réservés pour l'utilisation système, les utilisateurs ordinaires (non root) ne peuvent pas les utiliser. Ils ne peuvent utiliser que des numéros de port supérieurs. Pour utiliser le port 161, vous devez démarrer le serveur à partir du compte root.
Si vous ne pouvez pas utiliser le port 161, choisissez un autre port non utilisé. Les utilisateurs non root doivent choisir un numéro de port supérieur à 1023, tel que 8000.
Exemple :
<SNMP 80>
SNMPcommunity public
sysContact Admins@adresse.électronique
sysLocation mon-emplacement.mon-pays.ma-terre.mon-univers
</SNMP>
Voir aussi SNMPcommunity, sysDescr, sysContact et sysLocation.
Syntaxe : SNMPcommunity string
Valeur par défaut : community public
Module :snmp_agt_module
La communauté permet de définir des communautés accessibles par l'agent SNMP. Dans SNMP version 1 et version 2C, la communauté est utilisée pour la 'sécurité'. Seules les communautés valides ont accès aux informations à partir de l'agent SNMP.
La communauté la plus répandue est 'public'. Cette fonction est utilisée par un grand nombre de personnes mais elle n'est pas obligatoire. Si aucune communauté n'est donnée, la communauté par défaut est utilisée. La longueur de la chaîne du nom de la communauté est limitée à 64 caractères.
SECURITE : Si vous ne voulez pas que ces informations provenant de l'agent SNMP soient disponibles pour d'autres utilisateurs, vous devez utiliser des noms connus ou des mots extraits du dictionnaire.
Exemple :
SNMPcommunity public
Syntaxe : sysDescr string
Valeur par défaut :si la compilation se fait en
utilisant les valeurs par défaut, elle reflète les
différents indicateurs de version et de protocole ainsi que
d'autres détails.
Module :snmp_agt_module
La directive sysDescr permet de définir la description du système de l'hôte sur lequel l'agent SNMP (donc le serveur) est exécuté et est utilisée pour l'instance d'objet sysDescr de SNMPv2-MIB (également connue sous le nom de MIB-II).
La définition comprend :
"Une description de l'entité. Cette valeur doit inclure le nom complet et l'identification de la version du type matériel du système, du système d'exploitation et du logiciel réseau."
Exemple :
sysDescr IHS HTTP/1.1 avec SNMP
Voir aussi sysContact et sysLocation.
Syntaxe : sysContact string
Module :snmp_agt_module
La directive sysContact permet de définir l'adresse de contact utilisée pour l'instance de l'objet sysContact de SNMPv2-MIB (également connue sous le nom de MIB-II).
La définition comprend :
"Le texte permettant d'identifier la personne à contacter pour ce noeud géré ainsi que les informations indiquant comment contacter cette personne. Si aucune information concernant le contact n'est fournie, la valeur est une chaîne de longueur zéro."
Exemple :
sysContact Admins@adresse.électronique
Voir aussi sysDescr et sysLocation.
Syntaxe :
sysLocation string
Module :snmp_agt_module
La directive sysLocation permet de définir l'emplacement de l'hôte sur lequel l'agent SNMP (donc le serveur) est exécuté et est utilisée pour l'instance de l'objet sysLocation de SNMPv2-MIB (également connue sous le nom de MIB-II).
La définition comprend :
"L'emplacement physique de ce noeud ('téléphone, 3ème étage, par exemple'). Si l'emplacement est inconnu, la valeur est une chaîne de longueur nulle."
Exemple :
sysLocation Etage inférieur du bâtiment, pièce 44
Voir aussi sysDescr et sysContact.
Le module Status Module doit être chargé via la directive LoadModule pour la MIB apScoreBoardGroup.
Pour Windows NT :
Syntaxe :LoadModule status_module modules/ApacheModuleStatus.dll
Pour Unix :
Syntaxe :LoadModule status_module libexec/mod_status.so
La directive AddModule correspondante est : AddModule
mod_status.c
Syntaxe :<ExtendedStatus On>
Module :mod_status
L'absence de ExtendedStatus empêche toute requête de données apScoreBoardGroup d'aboutir.
Syntaxe :<LocationMatch server-status>...</LocationMatch>
Module :mod_status
Exemple :
<LocationMatch server-status>
SetHandler server-status
</LocationMatch>