H3. Dr.Web Enterprise Agent

Les paramètres de l'Agent sont enregistrés dans la base de registre Windows, dans la branche HKEY_LOCAL_MACHINE\SOFTWARE\IDAVLab\Enterprise Suite\Dr.Web Enterprise Agent\Settings,
pour les paramètres spécifiés par les clés, le nom du paramètre correspond au nom de la clé.

La liste des Serveurs SGMAJ auxquels l'Agent peut se connecter est sauvegardée dans les fichiers .config se trouvant dans les sous-répertoires du dépôt des produits (sous Windows : DrWeb Enterprise Server\var\repository\).

En cas de démarrage de l'Agent avec des paramètres spécifiés de manière explicite, ceux-ci seront non seulement utilisés dans la session courante mais également enregistrés dans la base de registre en tant que paramètres permanents. Ainsi, une fois lancé avec tous les paramètres nécessaires, Enterprise Agent ne requiert aucune spécification des paramètres lors des lancements ultérieurs.

L'Agent Enterprise démarre par le système en tant que service, et est géré via le Panneau de configuration.

Syntaxe de la commande de démarrage :

drwagntd [<clés>] [<Serveurs>]

Clés

Clés admissibles :

◆-compression=<mode> — mode de compression du trafic de Serveur. Les valeurs possibles sont les suivantes : yes, no, possible (la valeur par défaut est possible).

◆-control=<action> — gestion du statut du service de l'Agent. Les actions possibles :

•install — installer le service,

•uninstall — supprimer le service,

•start — lancer le service (uniquement sous Windows NT ou supérieur),

•stop — arrêter le service (uniquement sous Windows NT ou supérieur),

•restart — redémarrer le service (uniquement sous Windows NT ou supérieur).

◆-crypt=<mode> — mode de chiffrement du trafic de Serveur. Les valeurs possibles sont les suivantes : yes, no, possible (la valeur par défaut est yes).

◆-drweb-key=<clé_de_licence> — la clé de licence de l'utilisateur. Cette clé sera utilisée par le logiciel client en cas d'absence prolongée de connexion avec le Serveur ainsi que lorsque la clé reçue depuis le Serveur a expiré. Lorsque la connexion avec le Serveur est opérationnelle, la clé n'est pas nécessaire. Par défaut — n'importe quelle clé valide se trouvant dans le répertoire spécifié avec la clé -home.

◆-help — afficher la rubrique d'aide relative au format de la commande et à ses paramètres. L'option est analogue à la clé -help du module d'interface, voir l'Annexe H2. Module d'interface de l'Agent Dr.Web Enterprise Agent.

◆-home=<répertoire> — le répertoire vers lequel est installé l'Agent. Si la clé n'est pas spécifiée, le répertoire dans lequel se trouve le fichier exécutable de l'Agent sera pris en compte.

◆-key=<clé_publique_du_Serveur> — le fichier de la clé publique du Serveur, par défaut - drwcsd.pub dans le répertoire paramétré par la clé -home.

◆-log=<fichier_de_log> — le fichier de log de l'Agent, par défaut ce fichier de trouve dans le sous-répertoire logs du répertoire d'installation de l'Agent. Pour sauvegarder le fichier de log relatif à la suppression de l'Agent, le répertoire temporaire système est utilisé.

◆-retry=<nombre> — nombre de tentatives de recherche du Serveur par envoi de requêtes multicast (en cas d'utilisation de la recherche), avant que le message d'échec ne s'affiche. La valeur par défaut est 3.

◆-rotate=<N><f>,<M><u> — mode de rotation du journal de l'Agent avec :

•<N> — nombre total de fichiers de log (y compris le journal courant et ceux d'archive) ;

•<f> — format de sauvegarde des fichiers de log, les valeurs possibles sont les suivantes : z (gzip) - compresser les fichiers (utilisé par défaut) ou p (plain) - ne pas compresser les fichiers ;

•<M> — taille du fichier ;

•<u> — unité de mesure, les valeurs possibles sont les suivantes : k (kilo), m (mega), g (giga).

Les valeurs par défaut sont 10,10m, ce qui enjoint de sauvegarder 10 fichiers, de 10 Mo chacun, et d'utiliser la compression. Il est également possible d'utiliser le format spécialisé none (-rotate=none) - ce qui désigne "ne pas utiliser la rotation, écrire toujours dans le même fichier à taille illimitée".

Dans le mode de rotation, les noms des fichiers de log sont générés au format suivant : file.<N>.log ou file.<N>.log.dz, avec <N> - numéro d'ordre : 1, 2, etc.

Si le nom du fichier de log (voir ci-dessus la clé -log) est, par exemple, file.log. Dans ce cas-là :

•file.log — le fichier courant (vers lequel l'écriture est effectuée),

•file.1.log — le fichier précédent,

•file.2.log etc. — l'ordre croissant des nombres correspond aux versions plus anciennes du fichier.

◆-save <adresse IP> — vérifie la validité de l’adresse IP du Serveur et sauvegarde les paramètres dans la base de registre.

◆-spiderstat=<espacement> — intervalle en minutes d'envoi vers le Serveur de statistiques de SpIDer Guard, la valeur par défaut est 30. Les statistiques seront envoyées vers le Serveur avec les espacements spécifiés à condition qu'il y ait des changements.

◆-timeout=<durée> — délai maximum d'attente pour chaque réponse en secondes lors de la recherche du Serveur. La réception des messages de réponse continue jusqu'au moment où la durée d'attende ne dépasse pas la valeur spécifiée. La valeur par défaut est 5.

◆-trace — réaliser une journalisation détaillée de l'emplacement de l'erreur survenue, la clé est applicable dans d'autres applications.

◆-verbosity=<niveau_de_détail> — niveau de détail du journal. La valeur par défaut est INFO, il est possible de mettre les valeurs suivantes ALL, DEBUG3, DEBUG2, DEBUG1, DEBUG, TRACE3, TRACE2, TRACE1, TRACE, INFO, NOTICE, WARNING, ERROR, CRIT.  Les valeurs ALL et DEBUG3 sont les synonymes (voir aussi Annexe L. Format des fichiers de log).

Serveurs

<Serveurs> — liste des Serveurs. Par défaut - drwcs@udp/231.0.0.1:2193, ce qui enjoint de rechercher le Serveur drwcs en utilisant les requêtes multicast pour le groupe 231.0.0.1 port 2193.