Préambule
La majorité des actions décrites ici impliquent que la base de données ne soit pas être exploitée par le service de sauvegarde. Celui-ci doit donc être arrêté :
Soit en utilisant le Gestionnaire de Services (Démarrer | Exécuter | "services.msc" | OK), et en stoppant le service "Astase ThalliumBackup Storage Service".
Soit, en ligne de commande, en utilisant la commande :
net stop ThalliumServer
Une fois les opérations terminées, le service de sauvegarde pourra être relancé en utilisant la procédure inverse, ou, en ligne de commande :
net start ThalliumServer
Les manipulations décrites sur cette page se réalisent côté serveur à l'aide de l'application "thdb.exe" placée dans le répertoire "bin" d'UltraBackup NetStation (par défaut "C:\Program Files\Astase\UltraBackup NetStation\Serveur\bin").
Notes:
Lorsque les caractères
[
et]
apparaissent dans les lignes de commandes reportées dans cette page - par exemple,[foo]
-, cela signifie quefoo
est une chaîne de caractères facultative dont la présence peut changer la suite d'actions effectuée par le logiciel.Par défaut, la base de données UltraBackup a l'extension ".FDB" lorsqu'elle est exploitée en production et prends l'extension ".FBK" lorsqu'elle est dans un état sauvegardé.
Export / Remplacement
L'export et le remplacement permettent de dupliquer la base de données locale ou de définir la nouvelle base de données locale à utiliser. Ces commandes effectuent de simples copies de fichier, mais par défaut effectuent un contrôle d'intégrité en utilisant un hash MD5 afin d'annuler la copie ou le remplacement si les données dupliquées sont corrompues.
Ces opérations n'effectuent pas des sauvegardes de la base. Les fichiers sont copiés "tels quels", sans opérations supplémentaires.
Export
La syntaxe d'utilisation pour une exportation de base est la suivante :
thdb -export[:"base de données"] [-noverify] [-username:"nom d'utilisateur de la base"] [-password:"mot de passe de la base"] [-driver:"chemin d'accès au pilote de base de données"]
'-export' est un paramètre obligatoire : il indique à l'application qu'il faut réaliser l'exportation. Si vous n'indiquez aucun paramètre additionnel, le fichier est copié dans le répertoire de l'application. Sinon, la base est copiée à l'emplacement fourni en paramètre.
'-noverify' n'active pas la vérification post-copie. Sinon, le logiciel vérifie l'intégrité du fichier copié et annule l'opération si la copie ne correspond pas.
'-username' et '-password' sont facultatifs et permettent de préciser l'utilisateur de la base à exploiter pour l'opération. Si vous n'avez pas changé ces données, n'utilisez pas ces paramètres pour que le logiciel utilise les valeurs par défaut.
'-driver' est facultatif et permet de préciser le pilote de base de données à exploiter pour l'opération. Si ce paramètre n'est pas utilisé, c'est le pilote intégré à UltraBackup qui sera utilisé.
Pour effectuer une copie de la base de données courante dans "D:\Sauvegarde BD\Sauvegarde_Brute.fdb", la ligne de commande suivante peut être utilisée :
C:\Program Files\Astase\UltraBackup NetStation\Serveur\bin>thdb -export:"D:\Sauvegarde BD\Sauvegarde_Brute.fdb" UltraBackup NetStation (Windows) Copyright (c) 2004-2007 Adrien Reboisson - Astase Database exported succesfully as "D:\Sauvegarde BD\Sauvegarde_Brute.fdb".
Par sécurité, si le fichier de destination existe, il ne sera pas remplacé et le processus sera arrêté.
Remplacement
Le remplacement est l'opération inverse. Cela permet de remplacer la base locale par une copie brute réalisée avec -export. La base de données n'est remplacée que si la copie du fichier est correctement réalisée. Par défaut, le transfert est contrôlé en utilisant un hash MD5, comme c'est le cas lors de l'export.
La syntaxe d'utilisation pour un remplacement de base est la suivante :
thdb -replace:"base de données" [-noverify] [-username:"nom d'utilisateur de la base"] [-password:"mot de passe de la base"] [-driver:"chemin d'accès au pilote de base de données"]
'-replace' est un paramètre obligatoire : il indique à l'application qu'il faut réaliser l'exportation. La chaîne de caractères qui suit doit indiquer la base de données qui remplacera le fichier local.
'-noverify' n'active pas la vérification post-copie. Sinon, le logiciel vérifie l'intégrité du fichier copié et annule l'opération si la copie ne correspond pas.
'-username' et '-password' sont facultatifs et permettent de préciser l'utilisateur de la base à exploiter pour l'opération. Si vous n'avez pas changé ces données, n'utilisez pas ces paramètres pour que le logiciel utilise les valeurs par défaut.
'-driver' est facultatif et permet de préciser le pilote de base de données à exploiter pour l'opération. Si ce paramètre n'est pas utilisé, c'est le pilote intégré à UltraBackup qui sera utilisé.
Pour remplacer la base de données locale par le fichier précédemment exporté en "D:\Sauvegarde BD\Sauvegarde_Brute.fdb", la ligne de commande suivante peut être utilisée :
C:\Program Files\Astase\UltraBackup NetStation\Serveur\bin>thdb -replace:"D:\Sauvegarde BD\Sauvegarde_Brute.fdb" UltraBackup NetStation (Windows) Copyright (c) 2004-2007 Adrien Reboisson - Astase Database replaced succesfully as "C:\ProgramData\ThalliumBackup\database\backupdb.fdb".
En cas d'échec, la base de données locale est conservée sans altération.
Packing/optimisation
L'optimisation de la base est constituée d'une opération de sauvegarde puis de restauration. L'opération permet d'effectuer entre autres du garbage collecting, de réduire la taille de la base et donc d'en améliorer au final les performances.
Il est recommandé d'effectuer régulièrement cette opération pour que la base de données utilisée par le logiciel soit dans un état optimal.
La syntaxe d'utilisation pour une optimisation de base est la suivante :
thdb -pack[:"base de données"] [-username:"nom d'utilisateur de la base"] [-password:"mot de passe de la base"] [-driver:"chemin d'accès au pilote de base de données"]
'-pack' est un paramètre obligatoire : il indique à l'application qu'il faut réaliser l'opération de maintenance. Si vous n'indiquez aucun paramètre additionnel, c'est la base de données locale qui est utilisée. Sinon, une autre base peut être traitée par le logiciel.
'-username' et '-password' sont facultatifs et permettent de préciser l'utilisateur de la base à exploiter pour l'opération. Si vous n'avez pas changé ces données, n'utilisez pas ces paramètres pour que le logiciel utilise les valeurs par défaut.
'-driver' est facultatif et permet de préciser le pilote de base de données à exploiter pour l'opération. Si ce paramètre n'est pas utilisé, c'est le pilote intégré à UltraBackup qui sera utilisé.
Ainsi, pour compresser la base de données locale, la commande suivante peut être utilisée :
C:\Program Files\Astase\UltraBackup NetStation\Serveur\bin>thdb -pack UltraBackup NetStation (Windows) Copyright (c) 2004-2007 Adrien Reboisson - Astase Database "C:\ProgramData\ThalliumBackup\database\backupdb.fdb" has been packed successfully.
Si une erreur survient durant l'opération, la base de données d'origine est normalement remise en service et les fichiers temporaires supprimés.
Sauvegarde & restauration
Création d'une copie de sauvegarde
Sauvegarder la base de données revient à créer une copie "optimisée" d'une base de données UltraBackup. L'opération réalise une sauvegarde normalement plus légère et plus compacte, pouvant être restaurée par la suite.
La base de données contenant tous les enregistrements liés aux fichiers sauvegardés, elle est indissociable d'un état serveur, c'est à dire du contenu des dossiers accueillant les données sauvegardés par les clients.
La syntaxe d'utilisation pour une sauvegarde est la suivante :
thdb -backup[:"destination de sauvegarde"] [-source:"source de sauvegarde"] [-username:"nom d'utilisateur de la base"] [-password:"mot de passe de la base"] [-driver:"chemin d'accès au pilote de base de données"]
'-backup' est un paramètre obligatoire : il indique à l'application qu'il faut réaliser une sauvegarde. Si vous n'indiquez aucun paramètre additionnel, le fichier de sauvegarde sera créée dans le répertoire courant. Sinon il sera créée à la localisation indiquée en paramètre.
'-source' est facultatif, s'il n'est pas présent le logiciel fera une sauvegarde de la base de données locale. Si vous précisez le chemin d'accès à une base de données valide, c'est celle-ci qui sera sauvegardée.
'-username' et '-password' sont facultatifs et permettent de préciser l'utilisateur de la base à exploiter pour l'opération. Si vous n'avez pas changé ces données, n'utilisez pas ces paramètres pour que le logiciel utilise les valeurs par défaut.
'-driver' est facultatif et permet de préciser le pilote de base de données à exploiter pour l'opération. Si ce paramètre n'est pas utilisé, c'est le pilote intégré à UltraBackup qui sera utilisé.
Pour plus de sécurité, la sauvegarde n'est pas générée si le fichier de destination existe déjà.
Pour effectuer une sauvegarde de la base de données courante dans "D:\Sauvegarde BD\SauvegardeBase.fbk", la ligne de commande suivante peut être utilisée :
C:\Program Files\Astase\UltraBackup NetStation\Serveur\bin>thdb -backup:"D:\Sauvegarde BD\SauvegardeBase.fbk" UltraBackup NetStation (Windows) Copyright (c) 2004-2007 Adrien Reboisson - Astase Database backup has been done, backup file is "D:\Sauvegarde BD\SauvegardeBase.fbk"
Restauration à partir d'une copie de sauvegarde
L'opération inverse consiste à restaurer une base de données à partir d'un fichier de sauvegarde généré à l'aide de la commande -backup.
La syntaxe d'utilisation pour une restauration est la suivante :
thdb -restore[:"destination de restauration"] -source:"fichier de restauration" [-username:"nom d'utilisateur de la base"] [-password:"mot de passe de la base"] [-driver:"chemin d'accès au pilote de base de données"]
'-restore' est un paramètre obligatoire : il indique à l'application qu'il faut réaliser une restauration. Si vous n'indiquez aucun paramètre additionnel, la base de données sera restaurée à l'emplacement de la base de données locale du poste. Sinon, la base sera restaurée au chemin d'accès spécifié.
'-source' indique quel fichier de restauration utiliser.
'-username' et '-password' sont facultatifs et permettent de préciser l'utilisateur de la base à exploiter pour l'opération. Si vous n'avez pas changé ces données, n'utilisez pas ces paramètres pour que le logiciel utilise les valeurs par défaut.
'-driver' est facultatif et permet de préciser le pilote de base de données à exploiter pour l'opération. Si ce paramètre n'est pas utilisé, c'est le pilote intégré à UltraBackup qui sera utilisé.
Pour effectuer une restauration de la base de données courante à partir de "D:\Sauvegarde BD\SauvegardeBase.fbk", la ligne de commande suivante peut être utilisée :
C:\Program Files\Astase\UltraBackup NetStation\Serveur\bin>thdb -restore -source:"D:\Sauvegarde BD\SauvegardeBase.fbk" UltraBackup NetStation (Windows) Copyright (c) 2004-2007 Adrien Reboisson - Astase Database restore has been done, restored file is "C:\ProgramData\ThalliumBackup\database\backupdb.fdb"
Reconstruction des indicateurs de la base
La reconstruction des indicateurs permet de réinitialiser certains champs calculés en cas de défaillance de la base. Cette commande peut être utilisée après un crash serveur pour restaurer l'intégrité de la base.
La syntaxe d'utilisation pour la reconstruction de la base est la suivante :
thdb -rebuild-flags[:"base de données"] [-username:"nom d'utilisateur de la base"] [-password:"mot de passe de la base"] [-driver:"chemin d'accès au pilote de base de données"]
'-rebuild-flags' est un paramètre obligatoire : il indique à l'application qu'il faut réaliser la reconstruction. Si aucun paramètre n'est spécifié, la base de données locale est exploitée, sinon, la base de donnée passée en paramètre est utilisée.
'-username' et '-password' sont facultatifs et permettent de préciser l'utilisateur de la base à exploiter pour l'opération. Si vous n'avez pas changé ces données, n'utilisez pas ces paramètres pour que le logiciel utilise les valeurs par défaut.
'-driver' est facultatif et permet de préciser le pilote de base de données à exploiter pour l'opération. Si ce paramètre n'est pas utilisé, c'est le pilote intégré à UltraBackup qui sera utilisé.
Pour effectuer la reconstruction des champs de la base de données locale, la commande suivante peut être utilisée :
C:\Program Files\Astase\UltraBackup NetStation\Serveur\bin>thdb -rebuild-flags UltraBackup NetStation (Windows) Copyright (c) 2004-2007 Adrien Reboisson - Astase Flags for the database "C:\ProgramData\ThalliumBackup\database\backupdb.fdb" have been rebuilt.
Export de la structure de la base
L'export de la structure de la base correspond à la création d'une base similaire à la base locale, sans les données correspondant au contenu des sauvegardes. Autrement dit, la base conserve les définitions des sauvegardes (et toutes celles relatives aux utilisateurs, groupes, etc.) mais est exempt de toutes métadonnées relatives aux fichiers et aux versions sauvegardées.
Cette commande peut être utilisée pour des opéations de maintenance spécifiques, mais ne doit jamais être utilisée comme commande de backup de base. La nouvelle base ne possèdant plus d'informations sur les fichiers, il ne serait pas possible de réassocier les données sauvegardées avec les données de la base.
La syntaxe d'utilisation pour un export de la structure est la suivante :
thdb -export-schema[:"base de données"] [-noverify] [-username:"nom d'utilisateur de la base"] [-password:"mot de passe de la base"] [-driver:"chemin d'accès au pilote de base de données"]
'-export-schema' est un paramètre obligatoire : il indique à l'application qu'il faut réaliser l'exportation. Si vous n'indiquez aucun paramètre additionnel, la nouvelle base est copiée dans le répertoire de l'application. Sinon, la base est copiée à l'emplacement fourni en paramètre.
'-noverify' n'active pas la vérification post-copie. Sinon, le logiciel vérifie l'intégrité du fichier copié et annule l'opération si la copie ne correspond pas.
'-username' et '-password' sont facultatifs et permettent de préciser l'utilisateur de la base à exploiter pour l'opération. Si vous n'avez pas changé ces données, n'utilisez pas ces paramètres pour que le logiciel utilise les valeurs par défaut.
'-driver' est facultatif et permet de préciser le pilote de base de données à exploiter pour l'opération. Si ce paramètre n'est pas utilisé, c'est le pilote intégré à UltraBackup qui sera utilisé.
Pour effectuer un export de la structure de la base de données courante dans "D:\Sauvegarde BD\Sauvegarde_Structure.fdb", la ligne de commande suivante peut être utilisée :
C:\Program Files\Astase\UltraBackup NetStation\Serveur\bin>thdb -export-schema:"D:\Sauvegarde BD\Sauvegarde_Structure.fdb" UltraBackup NetStation (Windows) Copyright (c) 2004-2007 Adrien Reboisson - Astase Exporting full database file "C:\ProgramData\EmbeddedThalliumBackup\database\backupdb.fdb"... Opening database... Deleting file versions information... Deleting files information... Deleting backup versions information... Updating backup definitions... Packing database... Database structure successfully exported as "D:\Sauvegarde BD\Sauvegarde_Structure.fdb".
Codes de retour
Le code de retour de l'application peut être utilisé dans un script batch ou une application externe pour vérifier la bonne exécution de la commande.
Les codes de retour suivant sont renvoyés :
0 : Action reconnue, et exécutée avec succès.
1 : Action reconnue, dont l'exécution a été un échec.
2 : Action non supportée, ou syntaxe de commande erronnée.
![[top]](/images/gotop.png)