H9.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 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 webmin/utilities

drwcntl

Directory di Server 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, è 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 è 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 attraverso l'utility di diagnostica remota.

 

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

Le impostazioni di Server 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:

--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, 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 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. Questo disabilita il tag <ssl /> nel file di configurazione frontdoor.conf.

Indirizzo IP o nome DNS del Server

L'utility richiederà di inserire l'indirizzo del Server in formato opportuno.

Porta

10101

Sul lato Server 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 si usa un'altra porta, è necessario specificare in modo esplicito questa porta al momento della connessione dell'utiilty.

<nome_utente> – il nome utente dell'amministratore del Server.

<password> – la password dell'amministratore per l'accesso al Server.

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> – utilizzo della cache di file. Per invocare una concreta 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 dell'utilizzo della cache di file.

calculate <funzione> – il calcolo di una data sequenza. Per invocare una sequenza concreta, utilizzare i seguenti comandi:

hash [<standard>] [<stringa>] – calcola l'hash di una data stringa. Per impostare uno standard concreto, 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 concreto, 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. Per invocare una funzione concreta, utilizzare i seguenti comandi:

addresses [<espressione regolare>]– mostra gli indirizzi di rete delle postazioni che soddisfano l'espressione regolare impostata. Se nessun'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 nessun'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. 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.

statistics <espressione regolare> – mostra le statistiche per 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 – registra il dump del processo di Server.

cpu <parametro> – mostra le statistiche dell'utilizzo della CPU del computer su cui è installato il Server. Per invocare un concreto parametro, utilizzare i seguenti comandi:

clear – cancella tutti i dati statistici accumulati,

day – mostra un 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 un grafico di utilizzo della CPU per il minuto passato,

rawd – mostra le statistiche numeriche dell'utilizzo della CPU per il giorno,

rawh – mostra le statistiche numeriche dell'utilizzo della CPU per l'ora passata,

rawl – mostra le statistiche numeriche dell'utilizzo medio della CPU,

rawm – mostra le statistiche numeriche dell'utilizzo della CPU per il minuto passato,

status – mostra lo stato del monitoraggio delle statistiche dell'utilizzo della CPU.

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

Il comando debug signal è disponibile soltanto per i Server sotto SO della famiglia UNIX.

die arresta il Server e registra il dump del processo Server.

Il comando die è disponibile soltanto per i Server sotto SO della famiglia UNIX.

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

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

on – compressione attivata,

off – compressione disattivata,

possible – la compressione è possibile.

encryption <modalità> – imposta una delle seguenti modalità di cifratura di 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 di dati da parte del processo Server. Per invocare un concreto parametro, 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 di dati per il giorno,

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

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

rawm – mostra le statistiche numeriche per il minuto passato,

rday – mostra un grafico delle statistiche di lettura di dati per il giorno,

rhour – mostra un grafico delle statistiche di lettura di dati per l'ora passata,

rminute – mostra un grafico delle statistiche di lettura di dati per il minuto passato,

status – mostra lo stato del monitoraggio delle statistiche,

wday – mostra un grafico delle statistiche di scrittura di dati per il giorno,

whour – mostra un grafico delle statistiche di scrittura di dati per l'ora passata,

wminute – mostra un grafico delle statistiche di scrittura di dati per il minuto passato.

log <parametro> – scrivi la stringa nel file di log di Server oppure imposta/visualizza il livello di dettaglio del log. A seconda dei parametri impostati, vengono eseguite le seguenti azioni:

log <stringa> – scrivi la stringa nel log di Server 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 di memoria. Per configurare un'impostazione concreta, utilizzare i comandi aggiuntivi. Per consultare l'elenco dei comandi aggiuntivi, invocare la guida tramite il comando: ? mallopt.

Il comando mallopt è disponibile soltanto per i Server 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. Per invocare un concreto parametro, utilizzare i seguenti comandi:

all – visualizza tutte le informazioni e statistiche,

heap – visualizza le informazioni su memoria dinamica,

malloc – visualizza le statistiche su allocazione di memoria,

sizes – visualizza le statistiche su dimensioni della memoria allocata,

system – visualizza le informazioni su memoria di sistema.

Il comando memory è disponibile soltanto per i Server 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 sotto SO Windows, SO della famiglia Linux,

heap – solo per i Server sotto SO Windows, SO della famiglia Linux,

malloc – solo per i Server sotto SO della famiglia Linux e SO della famiglia FreeBSD,

sizes – solo per i Server 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. I comandi ammissibili:

disable – disattiva il monitoraggio,

enable – attiva il monitoraggio,

show – visualizza la modalità attuale.

printstat – scrivi le statistiche del funzionamento di Server nel log.

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

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

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

clear – cancella i contenuti della cache a prescindere dal valore TTL degli oggetti locati nella cache,

fill – memorizza tutti i file del repository nella cache,

keep – conserva tutti i file del repository, che si trovano attualmente nella cache, sempre, a prescindere dal loro valore TTL,

loaded – visualizza l'elenco di tutti i prodotti del repository e il numero totale di file dei prodotti che si trovano attualmente nella cache,

reload – riavvia il repository da disco,

statistics – mostra le statistiche degli aggiornamenti del repository.

restart – riavvia il Server.

show <parametro> – mostra informazioni sul sistema su cui è installato il Server. Per impostare un parametro concreto, 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 sotto SO Windows, SO della famiglia Linux,

mapping – solo per i Server sotto SO Windows, SO della famiglia Linux,

limits – solo per i Server sotto SO della famiglia UNIX,

processors – solo per i Server sotto SO della famiglia Linux.

sql <query> – esegui una data query SQL.

stop – arresta il Server.

traffic <parametro> – mostra le statistiche del traffico di rete del Server. Per invocare un concreto parametro, utilizzare i seguenti comandi:

all – mostra l'intera entità di traffico dall'inizio del funzionamento di Server.

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 concreta, utilizzare le seguenti opzioni:

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

agent [<modalità>] – mostra/imposta la modalità di aggiornamento degli Agent dal Server. 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 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 di aggiornamenti di 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 di Agent.

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