H5. Server proxy Dr.Web

Per configurare i parametri del Server proxy, avviare con le opzioni corrispondenti il file eseguibile drwcsd-proxy che si trova nella sottodirectory bin della directory di installazione di Server proxy.

Formato del comando di avvio

drwcsd-proxy [<opzioni>] [<comandi> [<argomenti_dei_comandi>]]

Opzioni valide

Opzioni multipiattaforma:

--сonsole=yes|no — avvia il Server proxy in modalità interattiva. In questo caso il log di funzionamento del Server proxy viene visualizzato nella console.

Di default: no.

--etc-root=<percorso> — percorso della directory con i file di configurazione (drwcsd-proxy.conf, drwcsd.proxy.auth ecc.).

Di default: $var/etc

--home=<percorso> — percorso della directory di installazione del Server proxy.

Di default: $exe-dir/

--log-root=<percorso> — percorso della directory con i file di log di funzionamento del Server proxy.

Di default: $var/log

--pool-size=<N> — numero di thread per l'elaborazione dei dati dei client.

Di default: il numero di core del computer su cui è installato il Server proxy (ma non meno di 2).

--rotate=<N><f>,<M><u> — modalità di rotazione del log di funzionamento del Server proxy, dove:

Parametro

Descrizione

<N>

Numero totale di file di log (compresi il file attuale e quelli di archivio).

<f>

Formato di memorizzazione dei file di log, i valori possibili sono:

z (gzip) — comprimi i file, si usa di default,

p (plain) — non comprimere i file.

<M>

Dimensione del file di log o tempo di rotazione a seconda del valore di <u>;

<u>

Unità di misura, i valori possibili sono:

per impostare la rotazione per dimensione del file di log:

k — Kb,

m — Mb,

g — Gb.

per impostare la rotazione per tempo:

H — ore,

D — giorni,

W — settimane.

Se è impostata la rotazione per tempo, la sincronizzazione viene eseguita a prescindere dall'ora di avvio del comando: se il valore è H — la sincronizzazione viene eseguita all'inizio dell'ora, se è D — all'inizio del giorno, se è W — all'inizio della settimana (alle 00:00 lunedì) secondo il multiplo indicato nel parametro <u>.

Il punto di partenza è il 01 gennaio del 01 anno d.C., UTC+0.

Di default 10,10m che significa "conserva 10 file da 10 megabyte, utilizza compressione".

--trace=yes|no — attiva la registrazione dettagliata delle richieste al Server proxy. È disponibile solo se la build del Server proxy supporta la registrazione dettagliata dello stack di chiamate (nel caso di un’eccezione, lo stack viene scritto nel log).

Di default: no.

--tmp-root=<percorso> — percorso della directory con i file temporanei. Si usa all'aggiornamento automatico del Server proxy.

Di default, è $var/tmp.

--var-root=<percorso> — percorso della directory di lavoro del Server proxy per la conservazione della cache e del database.

Di default:

SO Windows: %ALLUSERSPROFILE%\Doctor Web\drwcs

SO Linux: /var/opt/drwcs

SO FreeBSD: /var/drwcs

--verbosity=<livello_di_dettaglio> — livello di dettaglio del log. Di default è TRACE. I valori ammissibili sono: ALL, DEBUG3, DEBUG2, DEBUG1, DEBUG, TRACE3, TRACE2, TRACE1, TRACE, INFO, NOTICE, WARNING, ERROR, CRIT. I valori ALL e DEBUG3 sono sinonimi.

Se necessario, è possibile impostare determinati livelli di dettaglio per più fonti di messaggi contemporaneamente nel seguente formato:

-verbosity=<fonte_messaggio1>:<livello1>,<fonte_messaggio2>:<livello2>,<fonte_messaggio3>:<livello3> ecc. L'ereditarietà di <livello> si effettua secondo il principio generale, cioè viene trovata la fonte padre più vicina con il livello di dettaglio impostato. L'opzione formato -verbosity=all:all equivale all'opzione -verbosity=all (vedi inoltre Allegato K. Formato dei file di log).

Tutte le opzioni di configurazione dei parametri del funzionamento del Server proxy possono essere utilizzate contemporaneamente.

Opzioni sotto i sistemi operativi della famiglia UNIX:

--user — imposta l'identificatore dell'utente. L'opzione è valida sia per il funzionamento in modalità normale che per il funzionamento in modalità daemon.

--group — imposta l'identificatore del gruppo. L'opzione è valida sia per il funzionamento in modalità normale che per il funzionamento in modalità daemon.

--pid=<percorso> — percorso della directory con l'identificatore del processo.

Di default: /var/opt/drwcs/run/drwcsd-proxy.pid

Comandi ammissibili e i relativi argomenti

Se il comando non è specificato, di default si usa il comando run.

import <percorso> [<revisione>] [<prodotti>] — importa i file dal repository di Server Dr.Web nella cache di Server proxy.

<percorso> — percorso della directory con il repository di Server Dr.Web. Il repository di Server Dr.Web deve prima essere scaricato sul computer su cui è installato Server proxy.

<revisione> — numero massimo di revisioni da importare. Se il valore non è indicato, verranno importate tutte le revisioni.

<prodotti> — lista dei prodotti da importare, separati dallo spazio. Di default viene utilizzata una lista vuota, cioè importa tutti i prodotti del repository, tranne Server Dr.Web. Se è specificata una lista, verranno importati solo i prodotti dalla lista.

help — visualizza la guida alle opzioni per la configurazione di Server proxy.

run — avvia Server proxy in modalità normale.

Comandi disponibili solo per SO Windows:

install — installa il servizio.

start — avvia il servizio istallato.

stop — termina il servizio in esecuzione.

uninstall — rimuovi il servizio.

Comandi disponibili solo per SO della famiglia UNIX:

daemon — avvia Server proxy in modalità daemon (vedi inoltre Opzioni sotto i sistemi operativi della famiglia UNIX).

Script di gestione del Server proxy e variabili disponibili sotto i SO della famiglia UNIX

Per semplificare la gestione del Server proxy sotto i SO della famiglia UNIX, all'amministratore vengono fornite variabili che si trovano nel file di script drwcsd-proxy.sh situato nella seguente directory:

Linux: /etc/init.d/dwcp_proxy

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

Lo script accetta i seguenti comandi:

import <percorso> [<revisione>] [<prodotti>] — importa i file dal repository di Server Dr.Web nella cache di Server proxy (analogo al comando di Server proxy, v. sopra).

interactive — avvia Server proxy in modalità interattiva. In questo caso il log di funzionamento del Server proxy viene visualizzato nella console.

start — avvia Server proxy in modalità daemon.

status — controlla se il daemon è in esecuzione.

stop — termina il daemon in esecuzione.

La corrispondenza tra le variabili e le opzioni della riga di comando per drwcsd-proxy è riportata in Tabella H-3.

Tabella H-3.

Opzione

Variabile

Parametri predefiniti

--home=<percorso>

$DRWCS_PROXY_HOME

$exe-dir/

--var-root=<percorso>

$DRWCS_PROXY_VAR

SO Linux: /var/opt/drwcs

SO FreeBSD: /var/drwcs

--etc-root=<percorso>

$DRWCS_PROXY_ETC

$var/etc

--tmp-root=<percorso>

$DRWCS_PROXY_TMP

$var/tmp

--log-root=<percorso>

$DRWCS_PROXY_LOG

$var/log

-

$DRWCS_PROXY_LIB

$DRWCS_PROXY_HOME/lib

-

$DRWCS_PROXY_BIN

$DRWCS_PROXY_HOME/bin

--verbosity=<livello_di_dettaglio>

$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

Se è assegnato qualsiasi valore, $DRWCS_PROXY_USER viene ignorato.

--user

$DRWCS_PROXY_USER

-

-

$NO_DRWCS_PROXY_GROUP

Se è assegnato qualsiasi valore, $DRWCS_PROXY_GROUP viene ignorato.

--group

$DRWCS_PROXY_GROUP

-

-

$DRWCS_PROXY_FILES

131170, ma non inferiore al limite attuale.