H3.3. Comandi di gestione del database

Inizializzazione del database

Ad inizializzazione il database deve essere assente o vuota.

drwcsd [<opzioni>] modexecdb database-init [<chiave_di_licenza> [<password>]] — inizializzazione del database.

<chiave_di_licenza> — percorso della chiave di licenza Dr.Web agent.key. Se la chiave di licenza non è specificata, dovrà essere aggiunta in seguito dal Pannello di controllo o ottenuta attraverso la comunicazione tra i server da un Server Dr.Web adiacente.

<password> — password iniziale dell'amministratore del Server Dr.Web (il nome utente è admin). Di default è root.

Se è necessario omettere uno o più parametri nel comando che viene scritto, invece di ciascuno di essi va utilizzato un valore speciale %nil.

%nil può essere omesso se sono assenti i parametri seguenti.

Impostazione dei parametri di inizializzazione del database

Se si utilizza il database incorporato, i parametri di inizializzazione si possono impostare via un file esterno. Per farlo, si utilizza il comando:

drwcsd.exe modexecdb database-init@<response-file>

<response-file> — file in cui sono scritti i parametri di inizializzazione del database, riga per riga, nello stesso ordine dei parametri del comando database-init.

Formato del file:

<nome_di_file_completo_della_chiave_di_licenza>

<password_amministratore>

Si il response-file viene utilizzato in SO Windows, è possibile utilizzare qualsiasi carattere nella password dell'amministratore.

Se nella riga è indicato il valore %nil, verrà utilizzato il valore di default (come in database-init).

Aggiornamento della versione del database

drwcsd modexecdb database-upgrade [pretend=false] — per avviare il Server Dr.Web per aggiornare la struttura del database durante il passaggio a una nuova versione tramite gli script interni.

pretend=false — prescrive di solo controllare se lo schema del database è aggiornato invece di aggiornare effettivamente la sua struttura. Di default è false. Se è indicato il valore true, viene solo controllato se lo schema del database è aggiornato.

Esportazione del database

a)drwcsd modexecdb database-export <file> — esportazione del database nel file indicato.

Esempio per SO Windows:

C:\Program Files\DrWeb Server\bin\drwcsd.exe -home="C:\Program Files\DrWeb Server" -var-root="C:\Program Files\DrWeb Server\var" -verbosity=all modexecdb database-export "C:\Program Files\DrWeb Server\esbase.es"

Sotto SO della famiglia UNIX l'azione viene eseguita dall'account utente drwcs:drwcs nella directory $DRWCS_VAR (eccetto SO FreeBSD che di default salva il file nella directory da cui è avviato lo script; se il percorso viene indicato esplicitamente, la directory deve essere provvista dei permessi di scrittura per <utente>:<gruppo> che sono stati creati durante l'installazione, di default è drwcs:drwcs).

b)drwcsd modexecdb database-export-xml <file-xml> — esportazione del database nel file xml indicato.

Se viene indicata l'estensione di file gz, il file di database verrà compresso all'esportazione in un archivio gzip.

Se nessun'estensione viene indicata o viene indicata un'estensione diversa da gz, il file di esportazione non verrà compresso in archivio.

Esempio per SO Windows:

Per esportare il database in un file xml senza compressione:

"C:\Program Files\DrWeb Server\bin\drwcsd.exe" "-home=C:\Program Files\DrWeb Server" "-bin-root=C:\Program Files\DrWeb Server" "-var-root=C:\Program Files\DrWeb Server\var" -verbosity=ALL -rotate=10,10m -log=export.log modexecdb database-export-xml database.db

Per esportare il database in un file xml compresso in archivio:

"C:\Program Files\DrWeb Server\bin\drwcsd.exe" "-home=C:\Program Files\DrWeb Server" "-bin-root=C:\Program Files\DrWeb Server" "-var-root=C:\Program Files\DrWeb Server\var" -verbosity=ALL -rotate=10,10m -log=export.log modexecdb database-export-xml database.gz

Esempio per il SO della famiglia UNIX:

Per esportare il database in un file xml senza compressione:

/etc/init.d/drwcsd modexecdb database-export-xml /es/database.db

Per esportare il database in un file xml compresso in archivio:

/etc/init.d/drwcsd modexecdb database-export-xml /es/database.gz

Importazione del database

a)drwcsd modexecdb database-import <file> — importazione del database dal file indicato (il vecchio contenuto del database viene cancellato).

b)drwcsd modexecdb database-import-and-upgrade <file> — importazione e aggiornamento di un database ottenuto attraverso l'esportazione da un Server Dr.Web delle versioni precedenti (il vecchio contenuto del database viene cancellato).

Prima di utilizzare il comando database-import-and-upgrade, è necessario eseguire il backup del database.

Qualsiasi problema nel processo dell'esecuzione di questo comando può portare alla rimozione di tutte le informazioni dal database.

 

L'uso del comando database-import-and-upgrade per l'importazione con l'aggiornamento della versione database è solo possibile all'interno dello stesso DBMS.

Verifica del database

drwcsd modexecdb database-verify [full=false [ignore-version=false]] — avvia il Server Dr.Web per verificare il database. Per scrivere informazioni sui risultati nel file di log, il comando deve essere inserito con l'opzione -log. L'utilizzo di questa opzione è descritto in maggior dettaglio in p. H3.8. Descrizione delle opzioni.

full=false — definisce la modalità di verifica. Con il valore di default (false) viene eseguita la verifica rapida, con il valore true la verifica completa.

ignore-version=false — determina se la versione dello schema del database va ignorata durante la verifica. Di default è false. Se è indicato il valore true, la verifica continuerà anche se la versione dello schema non è corretta.

Accelerazione del database

drwcsd [<opzioni>] modexecdb database-speedup — esegui i comandi VACUUM, CLUSTER, ANALYZE per accelerare l'utilizzo del database.

Ripristino del database

drwcsd repairdb — esegui il ripristino di un'immagine danneggiata del database incorporato SQLite3 o di tabelle danneggiate del database esterno MySQL.

Il ripristino di SQLite3 può anche essere effettuato automaticamente durante l'avvio del Server Dr.Web, se nelle impostazioni del database SQLite3 nel Pannello di controllo è selezionato il flag Ripristina immagine corrotta in automatico (v. Manuale dell'amministratore, p. Ripristino del database).

Pulizia del database

drwcsd modexecdb database-clean — ripulisci il database di Server Dr.Web rimuovendo tutte le tabelle.

Cambio della password amministratore

drwcsd modexecdb set-admin-password <nome_utente> <nuova_password> — imposta una nuova password per l'account amministratore specificato.