`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.	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>

snmpconfig.xml¶

Section config¶

Section targets¶

Section securities¶