snmpconfig.xml

Le fichier server.xml contient la configuration des serveurs snmpconfig avec lesquels une instance peut communiquer.

Note

Les changements dans ce fichier sont pris en compte au redémarrage du serveur.

Les directives de configuration sont réparties en 3 sections :

  • config: paramétrage du système SNMP de l’instance Waarp
  • targets: liste des serveurs SNMP à utiliser
  • securities: données d’authentification SNMP

Section config

Balise Type Obl. Défaut Signification
localaddress string O   Adresse IP sur laquelle le service SNMP doit écouter au format udp:address/port ou tcp:address/port (peut être renseigné plusieurs fois)
nbthread string N 4 Nombre de threads à utiliser pour le serveur SNMP
filtered boolean N False Active le filtrage des connexions SNMPv1 or SNMPv2c entrantes sur l’adresse IP du client.
usetrap string N True Utilise des messages « traps » (True) ou « inform » (False) Lors de l’envoi d’événement à un serveur SNMP
trapinformlevel integer N 0 Défini le niveau de criticité des messages à envoyer : 0: Aucun ; 1: Démarrage/Arrêt du serveur ; 2: messages de niveau critique ; 3: messages de niveau erreur ; 4: messages de niveau warning ; 5: tous les événements

Section targets

La section targets regroupe la liste des serveurs SNMP auxquels envoyer des événements.

Chaque serveur est défini dans un bloc XML target acceptant les balises suivantes (voir Exemple complet) :

Balise Type Obl. Défaut Signification
name string O   Nom à utiliser pour le serveur
domain string N UdpIpv4 Domaine à utiliser pour le serveur. Doit être une des valeurs suivantes : UdpIpV4, UdpIpv6, UdpIpV4e, UdpIpv6z, TcpIpv4, TcpIpv6, TcpIpv4z, TcpIpv6z
address string O   Adresse du serveur au format adress/port
timeout integer N 200 Délais maximum d’attente de réponse pour les messages « inform » (en ms)
retries integer N 1 Nombre de tentative d’envoi des messages « inform » non acquittés par le serveur
isv2 boolean N True Défini si les serveur utilise le protocole SNMPv2c (True) ou SNMPv3 (False)

Section securities

La section securities défini les paramètres de sécurité pour SNMPv3. Plusieurs profils peuvent être définis.

Chaque profil est défini dans un bloc XML security acceptant les balises suivantes (voir Exemple complet) :

Balise Type Obl. Défaut Signification
securityname string O   Nom à utiliser
securityauthprotocol string N   Protocole à utiliser pour l’authentification. Doit être une des valeurs suivantes : MD5, SHA
securityauthpass string N   Mot de passe pour l’authentification (peut être vide)
securityprivprotocol string N   Protocole à utiliser pour le chiffrement. Doit être une des valeurs suivantes : P3DES, PAES128, PAES192, PAES256, PDES
securityprivpass string N   Mot de passe pour le chiffrement (peut être vide)

Exemple complet

<?xml version="1.0" encoding="UTF-8"?>
<snmpconfig xmlns:x0="http://www.w3.org/2001/XMLSchema">
   <config>
      <localaddress>udp:0.0.0.0/2001</localaddress>
      <localaddress>tcp:0.0.0.0/2002</localaddress>
      <nbthread>4</nbthread>
      <filtered>False</filtered>
      <usetrap>True</usetrap>
      <trapinformlevel>4</trapinformlevel>
   </config>
   <targets>
      <target>
         <name>notificationV2c</name>
         <domain>UdpIpv4</domain>
         <address>127.0.0.1/162</address>
         <timeout>200</timeout>
         <retries>1</retries>
         <isv2>True</isv2>
      </target>
      <target>
         <name>notificationV3</name>
         <domain>UdpIpv4</domain>
         <address>127.0.0.1/162</address>
         <timeout>200</timeout>
         <retries>1</retries>
         <isv2>False</isv2>
      </target>
   </targets>
   <securities>
      <security>
         <securityname>SHADES</securityname>
         <securityauthprotocol>SHA</securityauthprotocol>
         <securityauthpass>SHADESAuthPassword</securityauthpass>
         <securityprivprotocol>PDES</securityprivprotocol>
         <securityprivpass>SHADESPrivPassword</securityprivpass>
      </security>
   </securities>
</snmpconfig>