H5. Serveur proxy Dr.Web

Pour configurer les paramètres du Serveur proxy, lancez avec les clés correspondantes le fichier exécutable drwcsd-proxy qui se trouve dans le sous-répertoire bin du répertoire d’installation du Serveur proxy.

Syntaxe de la commande de démarrage

drwcsd-proxy [<clés>] [<commandes> [<arguments_des_commandes>]]

Clés possibles

Clés cross-plateforme :

--console=[yes/no] : lancer le Serveur proxy en mode interactif. Dans ce cas, le journal du Serveur proxy s’affiche dans la console.

Par défaut : no.

--etc-root=<chemin> : chemin vers le répertoire contenant les fichiers de configuration (drwcsd-proxy.conf, drwcsd.proxy.auth, etc.).

Par défaut : $var/etc

--home=<chemin> : chemin vers le répertoire d’installation du Serveur proxy.

Par défaut : $exe-dir/

--log-root=<chemin> : chemin vers le répertoire contenant les fichiers journaux du Serveur proxy.

Par défaut : $var/log

--pool-size=<N> : nombre des flux pour le travail avec les clients.

Par défaut : le nombre de noyaux de l’ordinateur sur lequel le Serveur proxy est installé (pas moins de 2).

-rotate=<N><f>,<M><u> : mode de rotation du journal de fonctionnement du Serveur proxy, avec :

Paramètre

Description

<N>

Nombre total de fichiers de journal (y compris le fichier actuel et les archives).

<f>

Format de sauvegarde des fichiers de journal, valeurs possibles :

z (gzip) : compresser les fichiers, utilisé par défaut,

p (plain) : ne pas compresser les fichiers.

<M>

Taille du fichier de journal ou période de rotation, en fonction de la valeur <u> ;

<u>

Unité de mesure, valeurs possibles :

pour paramétrer la rotation par taille de fichier de journal :

k : Ko,

m : Mo,

g : Go.

pour paramétrer la rotation en fonction de la période :

H : heures,

D : jours,

W : semaines.

Si la rotation par période est définie, la synchronisation s’effectue indépendamment en fonction de l’heure du lancement de la commande : la valeur H indique une synchronisation effectuée au début d’une heure, D — au début d’un jour, W — au début d’une semaine (00h00 le lundi) en fonction de la périodicité indiquée dans le paramètre <u>.

Éléments de référence initiaux — Janvier 01, année 01 AD, UTC+0.

Les valeurs par défaut sont 10,10m, ce qui enjoint de sauvegarder 10 fichiers, de 10 Mo chacun, et d’utiliser la compression.

--trace=[yes/no] : activer la journalisation détaillée des appels au Serveur proxy. Disponible uniquement si l’assemblage du Serveur Proxy supporte le suivi détaillé de la pile d’appels (en cas d’exclusion, la pile est enregistrée dans le journal).

Par défaut : no.

--tmp-root=<chemin> : chemin vers le répertoire contenant les fichiers temporaires. Utilisé lors de la mise à jour automatique du Serveur proxy.

Par défaut : $var/tmp.

--var-root=<chemin> : chemin d’accès au répertoire de travail du Serveur proxy pour la sauvegarde du cache et de la base de données.

Par défaut :

OS Windows : %ALLUSERSPROFILE%\Doctor Web\drwcs

OS Linux : /var/opt/drwcs

OS FreeBSD : /var/drwcs

--verbosity=<niveau_de_détails> : niveau de détails du journal. Par défaut, TRACE. Les valeurs autorisées sont : ALL, DEBUG3, DEBUG2, DEBUG1, DEBUG, TRACE3, TRACE2, TRACE1, TRACE, INFO, NOTICE, WARNING, ERROR, CRIT. Les valeurs ALL et DEBUG3 sont identiques.

Si nécessaire, vous pouvez spécifier les niveaux de détails particuliers pour plusieurs sources de messages en même temps au format suivant :

-verbosity=<source_du_message1>:<niveau1>,<source_du_message2>:<niveau2>,<source_du_message3>:<niveau3>, etc. Dans ce cas, <niveau> est hérité conformément au principe général, c’est-à-dire, on trouve la source parente la plus proche avec le niveau de détails spécifié. La clé au format -verbosity=all:all équivaut à la clé -verbosity=all (voir également Annexe K. Format des fichiers de journal).

Toutes les commandes de configuration des paramètres du Serveur Proxy peuvent être définies simultanément.

Postes tournant sous les OS de la famille UNIX :

--user : spécifier l’identificateur de l’utilisateur. La clé peut être utilisée en mode standard et en mode de daemon.

--group : spécifier l’identificateur du groupe. La clé peut être utilisée en mode standard et en mode de daemon.

--pid=<chemin> : chemin vers le répertoire avec l’identificateur du processus.

Par défaut : /var/opt/drwcs/run/drwcsd-proxy.pid

Commandes possibles et leurs arguments

Si la commande n’est pas indiquée, la commande run est utilisée par défaut.

import <chemin> [<révision>] [<produits>] : importer les fichiers du référentiel du Serveur Dr.Web vers le cache du Serveur proxy.

<chemin> : chemin vers le répertoire contenant le référentiel du Serveur Dr.Web. Le référentiel du Serveur Dr.Web doit être téléchargé sur l’ordinateur avec le Serveur proxy installé.

<révision> : nombre maximum des révisions à importer. Si la valeur n’est pas indiquée, toutes les révisions seront importées.

<produits> : liste des produits à importer séparés par des espaces. La liste vide est utilisée par défaut, c’est-à-dire, importer tous les produits du référentiel sauf le Serveur Dr.Web. Si la liste est spécifiée, seuls les produits listés sont importés.

help : afficher un message d’aide sur les clés pour la configuration du Serveur Proxy.

run : lancer le Serveur proxy en mode ordinaire.

Commandes disponibles uniquement sous Windows :

install : installer le service.

start : lancer le service installé.

stop : arrêter le service lancé.

uninstall : désinstaller le service.

Commandes disponibles uniquement sous les OS de la famille UNIX :

daemon : lancer le Serveur proxy en mode de daemon (voir également Clés sous les OS de la famille UNIX).

Script de gestion du Serveur proxy et variables disponibles sous les OS de la famille UNIX

Afin de faciliter la gestion du Serveur proxy sous les OS de la famille UNIX, l’administrateur dispose des variables se trouvant dans le fichier de script drwcsd-proxy.sh qui est sauvegardé dans le répertoire suivant :

Linux : /etc/init.d/dwcp_proxy

FreeBSD : /usr/local/etc/rc.d/dwcp_proxy

Le script accepte les commandes suivantes :

import <chemin> [<révision>] [<produits>] : importer les fichiers du référentiel du Serveur Dr.Web vers le cache du Serveur proxy (équivalent à la commande du Serveur proxy — voir ci-dessus).

interactive : lancer le Serveur proxy en mode interactif. Dans ce cas, le journal du Serveur proxy s’affiche dans la console.

start : lancer le Serveur proxy en mode de démon.

status : vérifier si le démon est lancé.

stop : arrêter le démon lancé.

Le Tableau H-3 présente la correspondance entre les variables et les clés de la ligne de commande pour drwcsd-proxy.

Tableau H-3.

Clé

Variable

Paramètres par défaut

--home=<chemin>

$DRWCS_PROXY_HOME

$exe-dir/

--var-root=<chemin>

$DRWCS_PROXY_VAR

OS Linux : /var/opt/drwcs

OS FreeBSD : /var/drwcs

--etc-root=<chemin>

$DRWCS_PROXY_ETC

$var/etc

--tmp-root=<chemin>

$DRWCS_PROXY_TMP

$var/tmp

--log-root=<chemin>

$DRWCS_PROXY_LOG

$var/log

-

$DRWCS_PROXY_LIB

$DRWCS_PROXY_HOME/lib

-

$DRWCS_PROXY_BIN

$DRWCS_PROXY_HOME/bin

--verbosity=<niveau_de_détails>

$DRWCS_PROXY_VERBOSITY

INFO

--rotate=<N><f>,<M><u>

$DRWCS_PROXY_ROTATE

10,10m

--pid

$DRWCS_PROXY_PID

/var/opt/drwcs/run/drwcsd-proxy.pid

-

$NO_DRWCS_PROXY_USER

Si une valeur est attribuée, $DRWCS_PROXY_USER sera ignoré.

--user

$DRWCS_PROXY_USER

-

-

$NO_DRWCS_PROXY_GROUP

Si une valeur est attribuée, $DRWCS_PROXY_GROUP sera ignoré.

--group

$DRWCS_PROXY_GROUP

-

-

$DRWCS_PROXY_FILES

131170 mais pas moins de la limite actuelle.