H7.3. Utility di diagnostica remota del Server Dr.Web

Utility di diagnostica remota del Server Dr.Web consente di connettersi al Server Dr.Web su remoto per effettuare la gestione base e visualizzare le statistiche di funzionamento. La versione grafica dell'utility è disponibile solo in SO Windows.

L'utility è disponibile nelle seguenti versioni:

In caso di SO Windows — versione con interfaccia grafica.

In caso di SO della famiglia UNIX — versione console.

Si mettono a disposizione le seguenti versioni dell'utility di diagnostica remota del Server Dr.Web:

File eseguibile

Posizione

Descrizione

drweb-cntl-<sistema_operativo>-<numero_di_bit>

Pannello di controllo, sezione Amministrazione → Utility

Versione indipendente dell'utility. Può essere avviata da qualsiasi directory e su qualsiasi computer con il sistema operativo corrispondente.

Directory di Server Dr.Web webmin/utilities

drwcntl

Directory di Server Dr.Web bin

La versione dell'utility dipende dalla disponibilità delle librerie del server. Può essere avviata solo dalla directory della sua posizione.

Le versioni dell'utility drweb-cntl-<sistema_operativo>-<numero_di_bit> e drwcntl hanno le funzionalità simili. Di seguito nella sezione viene riportata la versione drwcntl, tuttavia, tutti gli esempi sono adatti per entrambe le versioni.

Per connettere l'utility di diagnostica remota del Server Dr.Web, è necessario attivare l'estensione Dr.Web Server FrontDoor. Per farlo, nella sezione Configurazione del Server Dr.Web, nella scheda Moduli spuntare il flag Estensione Dr.Web Server FrontDoor.

 

Per connettere l'utility di diagnostica remota del Server Dr.Web è necessario che per l'amministratore che si connette attraverso l'utility sia consentito il permesso Utilizzo delle funzioni addizionali. Altrimenti sarà negato l'accesso al Server Dr.Web attraverso l'utility di diagnostica remota.

 

Per connettere l'utility (sia grafica che console) con l'utilizzo di TLS, è necessario impostare direttamente il protocollo quando viene indicato l'indirizzo di Server Dr.Web: ssl://<indirizzo IP o nome DNS>.

Le impostazioni di Server Dr.Web per la connessione dell'utility di diagnostica remota di Server Dr.Web sono descritte nel Manuale dell'amministratore, p. Accesso remoto al Server Dr.Web.

Versione console dell'utility

Formato del comando di avvio:

drwcntl [-?|-h|--help] [+<file_di_log>] [<server> [<nome_utente> [<password>]]]

dove:

-? -h --help — visualizza la guida ai comandi per l'utilizzo dell'utility.

<file_di_log> — scrivi tutte le azioni dell'utility nel file di log sul percorso impostato.

<server> — la stringa di indirizzo del Server Dr.Web, a cui l'utility si connette, nel formato [(tcp|ssl)://]<indirizzo IP o nome DNS>[:<porta>].

Per la possibilità di una connessione attraverso uno dei protocolli supportati, è necessario soddisfare le seguenti condizioni:

a)Per la connessione attraverso ssl, nel file di configurazione frontdoor.conf deve essere presente il tag <ssl />. In questo caso la connessione sarà possibile solamente attraverso ssl.

b)Per la connessione attraverso tcp, nel file di configurazione frontdoor.conf deve essere disattivato (commentato) il tag <ssl />. In questo caso la connessione sarà possibile solamente attraverso tcp.

Se nella stringa di indirizzo di Server Dr.Web i parametri di connessione non sono impostati, vengono utilizzati i seguenti valori:

Parametro

Valore predefinito

Protocollo di connessione

tcp

Per la connessione attraverso TCP deve essere deselezionato il flag Utilizza TLS nel Pannello di controllo, nella sezione Amministrazione → Accesso remoto al Server Dr.Web. Ciò disattiva il tag <ssl /> nel file di configurazione frontdoor.conf.

Indirizzo IP o nome DNS del Server Dr.Web

L'utility chiederà di inserire l'indirizzo del Server Dr.Web in formato corrispondente.

Porta

10101

Sul lato Server Dr.Web la porta consentita viene impostata nella sezione Accesso remoto al Server Dr.Web e viene salvata nel file di configurazione frontdoor.conf. Se in questa sezione viene utilizzata una porta alternativa, è necessario specificare in modo esplicito questa porta alla connessione dell'utility.

<nome_utente> — il nome utente dell'amministratore del Server Dr.Web.

<password> — la password dell'amministratore per l'accesso al Server Dr.Web.

Se il nome utente e la password dell'amministratore non sono stati impostati nella stringa di connessione, l'utility richiederà di immettere le relative credenziali.

Comandi ammissibili:

cache <operazione> — gestione della cache di file. Per invocare una specifica operazione, utilizzare i seguenti comandi:

clear — ripulisci la cache di file,

list — mostra tutti i contenuti della cache di file,

matched <espressione regolare> — mostra i contenuti della cache di file che soddisfano l'espressione regolare impostata,

maxfilesize [<dimensione>] — mostra/imposta la dimensione massima degli oggetti di file pre-caricati. Se eseguito senza parametri aggiuntivi, mostra la dimensione corrente. Per impostare una dimensione, specificare la dimensione richiesta in byte dopo il nome del comando.

statistics — mostra le statistiche sull'utilizzo della cache di file.

calculate <funzione> — calcolo di una data sequenza. Per invocare una sequenza specifica, utilizzare i seguenti comandi:

hash [<standard>] [<stringa>] — calcola l'hash di una data stringa. Per impostare uno standard specifico, utilizzare i seguenti comandi:

gost — calcola l'hash di una data stringa secondo lo standard GOST,

md5 — calcola l'hash MD5 di una data stringa,

sha — calcola l'hash di una data stringa secondo lo standard SHA,

sha1 — calcola l'hash di una data stringa secondo lo standard SHA1,

sha224 — calcola l'hash di una data stringa secondo lo standard SHA224,

sha256 — calcola l'hash di una data stringa secondo lo standard SHA256,

sha384 — calcola l'hash di una data stringa secondo lo standard SHA384,

sha512 — calcola l'hash di una data stringa secondo lo standard SHA512.

hmac [<standard>] [<stringa>] — calcola l'HMAC di una data stringa. Per impostare uno standard specifico, utilizzare i seguenti comandi:

md5 — calcola l'HMAC-MD5 per la stringa impostata,

sha256 — calcola l'HMAC-SHA256 per la stringa impostata.

random — generazione di un numero casuale,

uuid — generazione di un identificatore univoco casuale.

clients <operazione> — ricezione di informazioni e gestione dei client connessi al Server Dr.Web. Per invocare una funzione specifica, utilizzare i seguenti comandi:

addresses [<espressione regolare>] — mostra gli indirizzi di rete delle postazioni che soddisfano l'espressione regolare impostata. Se nessuna espressione regolare è impostata, mostra gli indirizzi di tutte le postazioni.

caddresses [<espressione regolare>] — mostra il numero di indirizzi IP delle postazioni che soddisfano l'espressione regolare impostata. Se nessuna espressione regolare è impostata, mostra il numero totale di postazioni.

chosts [<espressione regolare>] — mostra il numero di nomi di computer delle postazioni che soddisfano l'espressione regolare impostata. Se nessuna espressione regolare è impostata, mostra il numero totale di postazioni.

cids [<espressione regolare>] — mostra il numero di identificatori delle postazioni che soddisfano l'espressione regolare impostata. Se nessuna espressione regolare è impostata, mostra il numero totale di postazioni.

cnames [<espressione regolare>] — mostra il numero di nomi delle postazioni che soddisfano l'espressione regolare impostata. Se nessuna espressione regolare è impostata, mostra il numero totale di postazioni.

disconnect [<espressione regolare>] — interrompi la connessione corrente attiva con le postazioni di cui gli identificatori soddisfano l'espressione regolare impostata. Se nessuna espressione regolare è impostata, interrompi la connessione con tutte le postazioni connesse.

enable [<modalità>] — mostra/imposta la modalità di connessione dei client al Server Dr.Web. Se eseguito senza parametri aggiuntivi, mostra la modalità corrente. Per impostare una modalità, utilizzare i seguenti comandi aggiuntivi:

on — accetta tutte le connessioni dei client.

off — nega tutte le connessioni dei client.

hosts <espressione regolare> — mostra i nomi di computer di postazioni che soddisfano l'espressione regolare impostata.

ids <espressione regolare> — mostra gli identificatori di postazioni che soddisfano l'espressione regolare impostata.

names <espressione regolare> — mostra i nomi di postazioni che soddisfano l'espressione regolare impostata.

online <espressione regolare> — mostra la durata di connessione delle postazioni di cui l'identificatore, il nome o l'indirizzo soddisfano l'espressione regolare impostata. La durata di connessione viene calcolata dal momento dell'ultima connessione delle postazioni al Server Dr.Web.

statistics <espressione regolare> — mostra le statistiche sul numero di client che soddisfano l'espressione regolare impostata.

traffic <espressione regolare> — mostra i dati sul traffico dei client attualmente connessi che soddisfano l'espressione regolare impostata.

core — scrivi il dump del processo Server Dr.Web.

cpu <parametro> — mostra le statistiche di utilizzo della CPU del computer su cui è installato il Server Dr.Web. Per invocare un parametro specifico, utilizzare i seguenti comandi:

clear — cancella tutti i dati statistici accumulati,

day — mostra il grafico di utilizzo della CPU per il giorno corrente,

disable — disattiva il monitoraggio dell'utilizzo della CPU,

enable — attiva il monitoraggio dell'utilizzo della CPU,

hour — mostra il grafico di utilizzo della CPU per l'ora corrente,

load — mostra il livello medio di utilizzo della CPU,

minute — mostra il grafico di utilizzo della CPU per il minuto passato,

rawd — mostra le statistiche numeriche di utilizzo della CPU per il giorno,

rawh — mostra le statistiche numeriche di utilizzo della CPU per l'ora passata,

rawl — mostra le statistiche numeriche di utilizzo medio della CPU,

rawm — mostra le statistiche numeriche di utilizzo della CPU per il minuto passato,

status — mostra lo stato del monitoraggio delle statistiche di utilizzo della CPU.

debug <parametro> — configurazione del debug. Per impostare un parametro specifico, utilizzare i comandi aggiuntivi. Per consultare l'elenco dei comandi aggiuntivi, invocare la guida tramite il comando: ? debug.

Il comando debug signal è disponibile solo per i Server Dr.Web sotto SO della famiglia UNIX.

die — arresta il Server Dr.Web e scrivi il dump del processo Server Dr.Web.

Il comando die è disponibile solo per i Server Dr.Web sotto SO della famiglia UNIX.

dwcp <parametro> — imposta/mostra le impostazioni di Dr.Web Control Protocol (comprende i log di Server Dr.Web, Agent e installer di Agent). I parametri ammissibili:

compression <modalità> — imposta una delle seguenti modalità di compressione del traffico:

on — compressione attivata,

off — compressione disattivata,

possible — la compressione è possibile.

encryption <modalità> — imposta una delle seguenti modalità di cifratura del traffico:

on — cifratura attivata,

off — cifratura disattivata,

possible — la cifratura è possibile.

show — visualizza le impostazioni correnti di Dr.Web Control Protocol.

io <parametro> — mostra le statistiche di lettura/scrittura dei dati da parte del processo Server Dr.Web. Per invocare un parametro specifico, utilizzare i seguenti comandi:

clear — cancella tutti i dati statistici accumulati,

disable — disattiva il monitoraggio delle statistiche,

enable — attiva il monitoraggio delle statistiche,

rawdr — mostra le statistiche numeriche di lettura dei dati per il giorno,

rawdw — mostra le statistiche numeriche di scrittura dei dati per il giorno,

rawh — mostra le statistiche numeriche per l'ora passata,

rawm — mostra le statistiche numeriche per il minuto passato,

rday — mostra il grafico delle statistiche di lettura dei dati per il giorno,

rhour — mostra il grafico delle statistiche di lettura dei dati per l'ora passata,

rminute — mostra il grafico delle statistiche di lettura dei dati per il minuto passato,

status — mostra lo stato del monitoraggio delle statistiche,

wday — mostra il grafico delle statistiche di scrittura dei dati per il giorno,

whour — mostra il grafico delle statistiche di scrittura dei dati per l'ora passata,

wminute — mostra il grafico delle statistiche di scrittura dei dati per il minuto passato.

log <parametro> — scrivi una stringa nel file di log di Server Dr.Web o imposta/visualizza il livello di dettaglio del log. A seconda dei parametri impostati, vengono eseguite le seguenti azioni:

log <stringa> — scrivi nel log di Server Dr.Web la stringa impostata con il livello di dettaglio NOTICE.

log \s [<livello>] — imposta/visualizza il livello di dettaglio del log. Se viene eseguito con l'opzione \s senza indicare il livello, viene visualizzato il livello di dettaglio corrente. I valori ammissibili del livello di dettaglio: ALL, DEBUG3, DEBUG2, DEBUG1, DEBUG, TRACE3, TRACE2, TRACE1, TRACE, INFO, NOTICE, WARNING, ERROR, CRIT.

lua <script> — esegui lo script LUA impostato.

mallopt <parametro> — configura le impostazioni di allocazione della memoria. Per configurare un'impostazione specifica, utilizzare i comandi aggiuntivi. Per consultare l'elenco dei comandi aggiuntivi, invocare la guida tramite il comando: ? mallopt.

Il comando mallopt è disponibile solo per i Server Dr.Web sotto SO della famiglia Linux.

Per avere dettagli circa le particolarità dei parametri di questo comando, consultare la descrizione della funzione mallopt() dalla libreria glibc. Per avere la guida a questa funzione, si può utilizzare, per esempio, il comando man mallopt.

memory <parametro> — mostra le statistiche di utilizzo della memoria del computer su cui è installato il Server Dr.Web. Per invocare un parametro specifico, utilizzare i seguenti comandi:

all — visualizza tutte le informazioni e statistiche,

heap — visualizza informazioni sulla memoria dinamica,

malloc — visualizza statistiche sull'allocazione della memoria,

sizes — visualizza statistiche sulle dimensioni della memoria allocata,

system — visualizza informazioni sulla memoria di sistema.

Il comando memory è disponibile solo per i Server Dr.Web sotto SO Windows, SO della famiglia Linux e SO della famiglia FreeBSD. Si applicano le seguenti limitazioni ai parametri aggiuntivi del comando memory:

system — solo per i Server Dr.Web sotto SO Windows, SO della famiglia Linux,

heap — solo per i Server Dr.Web sotto SO Windows, SO della famiglia Linux,

malloc — solo per i Server Dr.Web sotto SO della famiglia Linux e SO della famiglia FreeBSD,

sizes — solo per i Server Dr.Web sotto SO della famiglia Linux e SO della famiglia FreeBSD.

monitoring <modalità> — imposta/visualizza la modalità di monitoraggio dell'utilizzo delle risorse CPU (opzione cpu <parametro>) e di input/output (opzione io <parametro>) da parte del processo Server Dr.Web. I comandi ammissibili:

disable — disattiva il monitoraggio,

enable — attiva il monitoraggio,

show — mostra la modalità attuale.

printstat — scrivi le statistiche di funzionamento di Server Dr.Web nel log.

reload — riavvia l'estensione Dr.Web Server FrontDoor.

repository <parametro> — gestione del repository. Per invocare una funzione specifica, utilizzare i seguenti comandi:

all — visualizza l'elenco di tutti i prodotti del repository e il numero totale di file dei prodotti,

clear — ripulisci i contenuti della cache a prescindere dal valore TTL degli oggetti collocati nella cache,

fill — colloca tutti i file del repository nella cache,

keep — conserva sempre tutti i file del repository attualmente presenti nella cache a prescindere dal loro valore TTL,

loaded — visualizza l'elenco di tutti i prodotti del repository e il numero totale di file per i prodotti attualmente presenti nella cache,

reload — ricarica il repository da disco,

statistics — mostra le statistiche degli aggiornamenti del repository.

restart — riavvia il Server Dr.Web.

show <parametro> — mostra informazioni sul sistema su cui è installato il Server Dr.Web. Per impostare un parametro specifico, utilizzare i comandi aggiuntivi. Per consultare l'elenco dei comandi aggiuntivi, invocare la guida tramite il comando: ? show.

Si applicano le seguenti limitazioni ai parametri aggiuntivi del comando show:

memory — solo per i Server Dr.Web sotto SO Windows, SO della famiglia Linux,

mapping — solo per i Server Dr.Web sotto SO Windows, SO della famiglia Linux,

limits — solo per i Server Dr.Web sotto SO della famiglia UNIX,

processors — solo per i Server Dr.Web sotto SO della famiglia Linux.

sql <query> — esegui una data query SQL.

stop — arresta il Server Dr.Web.

traffic <parametro> — mostra statistiche sul traffico di rete del Server Dr.Web. Per invocare un parametro specifico, utilizzare i seguenti comandi:

all — mostra l'intera quantità di traffico dall'inizio del funzionamento di Server Dr.Web.

incremental — mostra l'incremento del traffico rispetto all'ultima esecuzione del comando traffic incremental.

last — mostra il cambio del traffico dall'ultimo punto fisso.

store — creazione di un punto fisso per l'opzione last.

update <parametro> — ottenimento di informazioni e gestione degli aggiornamenti. Per invocare una funzione specifica, utilizzare le seguenti opzioni:

active — mostra l'elenco degli Agent che attualmente eseguono l'aggiornamento.

agent [<modalità>] — mostra/imposta la modalità di aggiornamento degli Agent dal Server Dr.Web. Se eseguito senza parametri aggiuntivi, mostra la modalità corrente. Per impostare una modalità, utilizzare le seguenti opzioni aggiuntive:

on — attiva gli aggiornamenti degli Agent.

off — disattiva gli aggiornamenti degli Agent.

gus — avvia l'aggiornamento del repository da SAM a prescindere dallo stato del processo di aggiornamento da SAM.

http [<modalità>] — mostra/imposta la modalità di aggiornamento del repository del Server Dr.Web da SAM. Se eseguito senza parametri aggiuntivi, mostra la modalità corrente. Per impostare una modalità, utilizzare le seguenti opzioni aggiuntive:

on — attiva gli aggiornamenti del repository da SAM.

off — disattiva gli aggiornamenti del repository da SAM.

inactive — mostra l'elenco degli Agent che attualmente non eseguono l'aggiornamento.

track [<modalità>] — mostra/imposta la modalità di monitoraggio degli aggiornamenti degli Agent. Se eseguito senza parametri aggiuntivi, mostra la modalità corrente. Per impostare una modalità, utilizzare i seguenti comandi aggiuntivi:

on — attiva il monitoraggio degli aggiornamenti degli Agent.

off — disattiva il monitoraggio degli aggiornamenti degli Agent. In tale caso l'opzione update active non visualizzerà l'elenco degli Agent che vengono aggiornati.

version — visualizza informazioni sulla versione dell'utility.