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:

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:

•-? -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, 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:

•<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> — 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> — 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 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 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 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. 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 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 — registra il dump del processo Server.

•cpu <parametro> — mostra le statistiche di 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 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 concreto, utilizzare i comandi aggiuntivi. Per consultare l'elenco dei comandi aggiuntivi, invocare la guida tramite il comando: ? debug.

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

•dwcp <parametro> — imposta/mostra le impostazioni di Dr.Web Control Protocol (comprende i log di Server, 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. 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 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 la stringa nel file di log di Server o 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 della memoria. Per configurare un'impostazione concreta, utilizzare i comandi aggiuntivi. Per consultare l'elenco dei comandi aggiuntivi, invocare la guida tramite il comando: ? mallopt.

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 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.

•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 — mostra 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 — 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.

•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.

•sql <query> — esegui una data query SQL.

•stop — arresta il Server.

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

▫all — mostra l'intera quantità 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 l'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 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.