H3.3. Commandes de gestion de la base de données

Initialisation de la base de données

Lors de l’initialisation, la base de données doit être absente ou vide.

drwcsd [<clés>] modexecdb database-init [<clé_de_licence> [<mot_de_passe>]] : initialisation de la base de données.

<clé_de_licence>  : chemin vers la clé de licence Dr.Web agent.key. Si la clé de licence n’est pas indiquée, il faudra l’ajouter plus tard depuis le Centre de gestion ou bien la recevoir du Serveur voisin Dr.Web par la liaison entre serveurs.

<mot_de_passe> : mot de passe initial de l’administrateur du Serveur Dr.Web (le nom est admin). Par défaut c’est root.

S’il faut sauter un ou plusieurs paramètres lors de l’écriture d’une commande, utilisez la valeur spéciale %nil à la place de chaque paramètre.

%nil peut être omis s’il n’y a pas de paramètres après.

Configuration de l’initialisation de la base de données

En cas d’utilisation de la BD interne, les paramètres d’initialisation peuvent être spécifiés depuis un fichier externe. Dans ce cas-là, la commande suivante est utilisée :

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

<response-file> : fichier dans lequel sont enregistrés les paramètres d’initialisation de la BD, chacun d’eux à la ligne et dans le même ordre que les paramètres de la commande database-init.

Format du fichier :

<nom_complet_du_fichier_de_clé_de_licence>

<mot_de_passe_d’administrateur>

En cas d’utilisation du fichier response sous Windows, il est possible d’utiliser n’importe quels symboles dans le mot de passe administrateur.

Si la valeur %nil est indiquée dans la ligne, la valeur par défaut sera utilisée (comme dans database-init).

Mise à niveau de la version de la base de données

drwcsd modexecdb database-upgrade [pretend=false]  : démarrer le Serveur Dr.Web pour mettre à jour la structure de la base de données lors de la migration vers une nouvelle version par les scripts internes.

pretend=false indique de vérifier seulement l’actualité du schéma de la base de données à la place d’une mise à jour de sa structure. Par défaut : false. Si la valeur true est indiquée, seule la vérification de l’actualité du schéma de la base de données est effectuée.

Exportation de la base de données

a)drwcsd modexecdb database-export <fichier> : exportation de la base de données vers le fichier spécifié.

Exemple pour 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"

Sous les OS de la famille UNIX, l’action s’exécute du nom de l’utilisateur drwcs:drwcs vers le répertoire $DRWCS_VAR (excepté FreeBSD, qui enregistre par défaut le fichier vers le répertoire depuis lequel a été lancé le script ; si le chemin est spécifié de manière explicite, le répertoire doit être disponible en écriture pour <utilisateur>:<groupe> qui ont été créés lors de l’installation, par défaut c’est drwcs:drwcs).

b)drwcsd modexecdb database-export-xml <xml-file> : exportation de la base de données vers le fichier xml spécifié.

Si vous indiquez pour le fichier l’extension gz, lors de exportation le fichier de la base de données sera placé dans une archive gzip.

Si vous n’indiquez aucune extension ou que vous indiquez l’extension autre que gz, le fichier d’exportation ne sera pas archivé.

Exemple pour Windows :

Pour exporter la base de données vers le fichier xml sans compression :

"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

Pour exporter la base de données vers le fichier xml archivé :

"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

Exemple pour les OS de la famille UNIX :

Pour exporter la base de données vers le fichier xml sans compression :

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

Pour exporter la base de données vers le fichier xml archivé :

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

Importer la base de données

a)drwcsd modexecdb database-import <fichier> : importation de la base de données depuis le fichier spécifié (le contenu précédent de la BD sera effacé).

b)drwcsd modexecdb database-import-and-upgrade <fichier>  : importation et mise à jour de la base de données obtenue lors de l’exportation depuis le Serveur Dr.Web des versions précédentes (l’ancien contenu de la BD est effacé).

Avant d’exécuter la commande database-import-and-upgrade, il est nécessaire de réaliser une copie de sauvegarde de la base de données.

Tous problèmes survenus lors de l’exécution de cette commande peuvent provoquer la suppression de toutes les informations de la base de données.

 

L’utilisation de la commande database-import-and-upgrade pour l’importation avec la mise à niveau de la version de la base de données est possible uniquement au sein d’un seul SGBD.

Vérification de la base de données

drwcsd modexecdb database-verify [full=false [ignore-version=false]] : lancer le Serveur Dr.Web pour la vérification de la base de données. Pour enregistrer les informations sur les résultats dans le fichier de journal, il faut entrer la commande avec la clé -log. Pour en savoir plus sur l’utilisation de cette clé, consultez le p. H3.8. Description des clés.

full=false : détermine le mode d’analyse. Si la valeur par défaut (false) est spécifiée, l’analyse rapide sera effectuée, si la valeur true est spécifiée, c’est l’analyse compète qui sera effectuée.

ignore-version=false : détermine s’il faut ignorer le version du schéma de la base de données lors de l’analyse. Par défaut : false. Si la valeur true est indiquée, l’analyse continuera même si la version de schéma est incorrecte.

Accélération de la base de données

drwcsd [<clés>] modexecdb database-speedup  : exécuter les commandes VACUUM, CLUSTER, ANALYZE pour accélérer le fonctionnement de la BD.

Restauration de la base de données

drwcsd repairdb : restaurer l’image endommagée de la base de données embarquée SQLite3 ou des tableaux endommagés de la base de données externe MySQL.

La restauration de SQLite3 peut également s’effectuer automatiquement au lancement du Serveur Dr.Web, si la case Restaurer automatiquement l’image endommagée a été cochée dans les paramètres de la base de données SQLite3, dans le Centre de gestion (voir le Manuel administrateur, le p. Restauration de la base de données).

Nettoyer la base de données

drwcsd modexecdb database-clean : nettoyer la base de données du Serveur Dr.Web par la suppression de tous les tableaux.

Changement du mot de passe de l’administrateur

drwcsd modexecdb set-admin-password <nom_d’utilisateur> <nouveau_mot_de_passe>  : spécifier un nouveau mot de passe pour le compte d’administrateur indiqué.