OUTIL BETest

BETest est un demandeur VSS qui teste les opérations avancées de sauvegarde et de restauration. Cet outil peut être utilisé pour tester l’utilisation par une application de fonctionnalités VSS complexes telles que les suivantes :

• Sauvegarde incrémentielle et différentielle
• Options de restauration complexes, telles que la restauration faisant autorité
• Options rollforward

Notes

BETest est inclus dans le Kit de développement logiciel (SDK) Microsoft Windows pour Windows Vista et versions ultérieures. Le Kit de développement logiciel (SDK) VSS 7.2 inclut une version de BETest qui s’exécute uniquement sur Windows Server 2003. Cette rubrique décrit la version du Kit de développement logiciel (SDK) Windows de BETest, et non la version Windows Server 2003 incluse dans le Kit de développement logiciel (SDK) VSS 7.2. Pour plus d’informations sur le téléchargement du Kit de développement logiciel (SDK) Windows et du Kit de développement logiciel (SDK) VSS 7.2, consultez Service de cliché instantané de volume.

 

Dans l’installation du Kit de développement logiciel (SDK) Windows, l’outil BETest se trouve dans %Program Files(x86)%\Windows Kits\8.1\bin\x64 (pour Windows 64 bits) et %Program Files(x86)%\Windows Kits\8.1\bin\x86 (pour Windows 32 bits).

Exécution de l’outil BETest

Pour exécuter l’outil BETest à partir de la ligne de commande, utilisez la syntaxe suivante :

OPTIONS de ligne de commandeBETest

L’exemple d’utilisation suivant montre comment utiliser l’outil BETest avec l’outil Enregistreur de tests VSS, qui est un enregistreur VSS.

Exemple d’utilisation de l’outil BETest

1. Créez un répertoire de test nommé C:\BETest. Copiez les fichiers suivants dans ce répertoire :

   • betest.exe
   • vswriter.exe
   • BetestSample.xml
   • VswriterSample.xml

2. Créez un répertoire nommé C:\TestPath. Placez des fichiers de données de test dans ce répertoire.

3. Créez un répertoire nommé C:\BackupDestination. Laissez ce répertoire vide.

4. Ouvrez deux fenêtres de commande avec élévation de privilèges et définissez le répertoire de travail dans chacune d’elles sur C:\BETest.

5. Dans la première fenêtre de commande, démarrez l’outil Enregistreur de tests VSS comme suit :

   vswriter.exe VswriterSample.xml

   Le fichier vswriterSample.xml configure l’outil VsS Test Writer (vswriter) pour signaler le contenu du répertoire c:\TestPath en préparation d’une opération de sauvegarde. Notez que l’outil Enregistreur de tests VSS ne produit pas de sortie tant qu’il n’a pas détecté l’activité d’un demandeur tel que BETest. Pour arrêter l’outil Enregistreur de tests VSS, appuyez sur Ctrl+C.

6. Dans la deuxième fenêtre de commande, utilisez l’outil BETest pour effectuer une opération de sauvegarde comme suit :

   betest.exe /B /S backup.xml /D C:\BackupDestination /X BetestSample.xml

   BETest sauvegarde les fichiers du répertoire C:\TestPath dans le répertoire C:\BackupDestination. Il enregistre le document du composant de sauvegarde dans C:\BETest\backup.xml.

7. Si l’opération de sauvegarde réussit, supprimez le contenu du répertoire C:\TestPath et utilisez l’outil BETest pour effectuer une opération de restauration comme suit :

   betest.exe /R /S backup.xml /D C:\BackupDestination /X BetestSample.xml

BETest Tool Command-Line Options

L’outil BETest utilise les options de ligne de commande suivantes pour identifier le travail à effectuer.

/Auth

Effectue une opération de restauration faisant autorité pour Active Directory ou le mode Application Active Directory.

Windows Server 2003 : Cette option de ligne de commande n’est pas prise en charge.

/B

Effectue une opération de sauvegarde, mais n’effectue pas de restauration.

/BC

Effectue uniquement l’opération de sauvegarde terminée.

Windows Server 2003 : Cette option de ligne de commande n’est pas prise en charge.

/CFilename

Notes

Cette option de ligne de commande est fournie uniquement pour la compatibilité descendante. L’option de ligne de commande /X doit être utilisée à la place.

 

Sélectionne les composants à sauvegarder ou à restaurer en fonction du contenu du fichier de configuration spécifié par Filename. Ce fichier doit contenir uniquement des caractères ANSI compris entre 0 et 127, et ne doit pas dépasser 1 Mo. Chaque ligne du fichier doit utiliser le format suivant :

WriterId : ComponentName;

Où WriterId est l’ID de l’enregistreur et ComponentName est le nom de l’un des composants de l’enregistreur. L’ID de l’enregistreur et les noms des composants doivent être entre guillemets, et il doit y avoir des espaces avant et après les deux-points (:). Si plusieurs composants sont spécifiés, ils doivent être séparés par des virgules. Exemple :

« 5affb034-969f-4919-8875-88f830d0ef89 » : « TestFiles1 », « TestFiles2 », « TestFiles3 »;

/DPath

Enregistrez les fichiers sauvegardés dans ou restaurez-les à partir du répertoire de sauvegarde spécifié par Path.

/NBC

Omet l’opération de sauvegarde terminée.

Windows Server 2003 : Cette option de ligne de commande n’est pas prise en charge.

/O

Spécifie que la sauvegarde inclut un état système démarrable.

/P

Crée un cliché instantané persistant.

Windows Server 2003 : Cette option de ligne de commande n’est pas prise en charge.

/PreFilename

Si le type de sauvegarde spécifié dans l’option de ligne de commande /T est INCRÉMENTIEL ou DIFFÉRENTIEL, définissez le document de sauvegarde sur le fichier spécifié par Filename pour la sauvegarde complète ou incrémentielle précédente.

Windows Server 2003 et Windows XP : Cette option de ligne de commande n’est pas prise en charge.

/R

Effectue la restauration, mais n’effectue pas de sauvegarde. Doit être utilisé avec l’option de ligne de commande /S .

/Restauration

Crée un cliché instantané qui peut être utilisé pour la restauration d’application.

Windows Server 2003 : Cette option de ligne de commande n’est pas prise en charge.

/SFilename

En cas de sauvegarde, enregistre le document de sauvegarde dans le fichier spécifié par Filename. En cas de restauration uniquement, charge le document de sauvegarde à partir de ce fichier.

/Instantané

Crée un cliché instantané de volume, mais n’effectue pas de sauvegarde ou de restauration.

Windows Server 2003 : Cette option de ligne de commande n’est pas prise en charge.

/StopError

Arrête BETest lorsque la première erreur d’enregistreur est rencontrée.

Windows Server 2003 : Cette option de ligne de commande n’est pas prise en charge.

/TBackupType

Spécifie le type de sauvegarde. BackupType peut être COMPLET, LOG, COPY, INCRÉMENTIEL ou DIFFÉRENTIEL. Pour plus d’informations sur les types de sauvegarde, consultez VSS_BACKUP_TYPE.

/C

Génère une sortie détaillée qui peut être utilisée pour la résolution des problèmes.

Windows Server 2003 : Cette option de ligne de commande n’est pas prise en charge.

/XFilename

Sélectionne les composants à sauvegarder ou à restaurer en fonction du contenu du fichier de configuration XML spécifié par Filename. Ce fichier doit contenir uniquement des caractères ANSI dans la plage comprise entre 0 et 127. Le format du fichier XML est défini par le schéma dans le fichier BETest.xml. Pour obtenir un exemple de fichier de configuration, consultez BetestSample.xml. Ces deux fichiers se trouvent dans le répertoire vsstools.

Notes

Vous pouvez afficher le fichier BETest.xml dans Internet Explorer. Avant d’ouvrir ce fichier, assurez-vous que le fichier xdr-schema.xsl se trouve dans le même répertoire que BETest.xml. Le fichier xdr-schema.xsl contient des instructions de rendu qui rendent le fichier BETest.xml plus lisible.

 

Windows Server 2003 : Cette option de ligne de commande n’est pas prise en charge.

Exemple de fichier de configuration XML : BetestSample.xml

L’exemple de fichier de configuration suivant, BetestSample.xml, se trouve dans le répertoire Vsstools.

<BETest>
    <Writer writerid="5affb034-969f-4919-8875-88f830d0ef89">
        <Component componentName="TestFiles">
        </Component>
    </Writer>
</BETest>

Cet exemple de fichier de configuration simple sélectionne un composant à sauvegarder ou à restaurer.

Exemple de fichier de configuration XML : VswriterSample.xml

L’exemple de fichier de configuration suivant, VswriterSample.xml, se trouve dans le répertoire Vsstools.

<TestWriter   usage="USER_DATA"
                    deleteFiles="no">

    <RestoreMethod method="RESTORE_IF_CAN_BE_REPLACED" 
                   writerRestore="always"
                   rebootRequired="no" />
    
    <Component componentType="filegroup" 
               componentName="TestFiles">
               <ComponentFile path="c:\TestPath" filespec="*" recursive="no" />
    </Component>

</TestWriter>

L’élément racine de ce fichier de configuration est nommé TestWriter. Tous les autres éléments sont organisés sous l’élément TestWriter.

Le premier attribut associé à TestWriter est l’attribut d’utilisation. Cet attribut spécifie le type d’utilisation signalé via la méthode IVssExamineWriterMetadata::GetIdentity . L’une des valeurs possibles pour cet attribut est USER_DATA.

Le deuxième attribut est l’attribut deleteFiles. Cet attribut est décrit dans Configuration des attributs de l’enregistreur.

Le premier élément enfant de l’élément racine est un élément RestoreMethod. Cet élément spécifie les éléments suivants :

• Méthode de restauration (dans ce cas, RESTORE_IF_CAN_BE_REPLACED)
• Indique si l’enregistreur nécessite des événements de restauration (dans ce cas, toujours)
• Si un redémarrage est nécessaire après la restauration de l’enregistreur (dans ce cas, non)

Cet élément peut éventuellement spécifier un mappage d’emplacement de substitution. (Dans ce cas, aucun autre emplacement n’est spécifié.) Pour plus d’informations, consultez Spécification de mappages d’emplacements de remplacement.

Le deuxième élément enfant est un élément Component. Cet élément oblige l’enregistreur à ajouter un composant à ses métadonnées. Un élément Component contient des attributs pour décrire le composant et des éléments enfants pour décrire le contenu du composant, tels que les suivants :

• componentType pour indiquer s’il s’agit d’un groupe de fichiers ou d’une base de données (dans ce cas, un groupe de fichiers)
• logicalPath pour le chemin logique du composant (dans ce cas, aucun n’est spécifié)
• componentName pour le nom du composant (dans ce cas, « TestFiles »)
• sélectionnable pour indiquer le status selectable-for-backup

L’élément Component a également un élément enfant nommé ComponentFile pour ajouter une spécification de fichier à ce composant. (Un élément Component peut avoir un nombre arbitraire d’éléments ComponentFile qui peuvent être spécifiés pour chaque composant.) Cet élément ComponentFile possède les attributs suivants :

• path="c:\TestPath »
• filespec="* »
• recursive="no »