Outil BETest

BETest est un requester 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 autoritaire
• Options de progression

Remarque

BETest est inclus dans le Microsoft Windows Software Development Kit (SDK) pour Windows Vista et les versions ultérieures. Le SDK VSS 7.2 inclut une version de BETest qui fonctionne uniquement sur Windows Server 2003. Cette rubrique décrit la version du SDK Windows de BETest, et non la version Windows Server 2003 incluse dans le SDK VSS 7.2. Pour plus d’informations sur le téléchargement du SDK Windows et du SDK VSS 7.2, veuillez consulter la section Volume Shadow Copy Service.

 

Dans l’installation du 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 :

BETest command-line-options

L’exemple d’utilisation suivant montre comment utiliser l’outil BETest avec l’outil VSS Test Writer, qui est un writer 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. Mettez 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 élevées et définissez le répertoire de travail dans chacune sur C:\BETest.

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

   vswriter.exe VswriterSample.xml

   Le fichier vswriterSample.xml configure l’outil VSS Test Writer (vswriter) pour qu’il signale le contenu du répertoire c:\TestPath en préparation d’une opération de sauvegarde. Notez que l’outil VSS Test Writer ne produira aucune sortie tant qu’il ne détectera pas d’activité d’un requester tel que BETest. Pour arrêter l’outil VSS Test Writer, 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 sauvegardera les fichiers du répertoire C:\TestPath vers le répertoire C:\BackupDestination. Il enregistrera le document de 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

Options de ligne de commande de l’outil BETest

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

/Auth

Effectue une opération de restauration autoritaire pour Active Directory ou Active Directory Application Mode.

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

/B

Effectue une opération de sauvegarde mais ne réalise pas de restauration.

/BC

Effectue uniquement l’opération de sauvegarde complète.

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

/C Filename

Remarque

Cette option de ligne de commande est fournie uniquement pour la compatibilité ascendante. 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 dans la plage de 0 à 127, et il ne doit pas dépasser 1 Mo. Chaque ligne du fichier doit utiliser le format suivant :

WriterId : ComponentName;

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

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

/D Path

Enregistre les fichiers sauvegardés ou les restaure à partir du répertoire de sauvegarde spécifié par Path.

/NBC

Omet l’opération de sauvegarde complète.

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 amorçable.

/P

Crée une capture instantanée persistante.

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

/Pre Filename

Si le type de sauvegarde spécifié dans l’option de ligne de commande /T est INCREMENTAL ou DIFFERENTIAL, définit 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 ne réalise pas de sauvegarde. Doit être utilisée avec l’option de ligne de commande /S.

/Rollback

Crée une capture instantanée pouvant être utilisée pour le retour en arrière d’une application.

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

/S Filename

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.

/Snapshot

Crée une capture instantanée de volume mais ne réalise 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 dès que la première erreur de writer est rencontrée.

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

/T BackupType

Spécifie le type de sauvegarde. BackupType peut être FULL, LOG, COPY, INCREMENTAL ou DIFFERENTIAL. Pour plus d’informations sur les types de sauvegarde, veuillez consulter VSS_BACKUP_TYPE.

/V

Génère une sortie détaillée qui peut être utilisée pour le dépannage.

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

/X Filename

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 de 0 à 127. Le format du fichier XML est défini par le schéma dans le fichier BETest.xml. Pour un fichier de configuration exemple, consultez BetestSample.xml. Ces deux fichiers se trouvent dans le répertoire vsstools.

Remarque

Vous pouvez visualiser 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 les 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.

Fichier de configuration XML exemple : BetestSample.xml

Le fichier de configuration exemple 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.

Fichier de configuration XML exemple : VswriterSample.xml

Le fichier de configuration exemple 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 disposés sous l’élément TestWriter.

Le premier attribut associé à TestWriter est l’attribut usage. 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 writer.

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

• La méthode de restauration (dans ce cas, RESTORE_IF_CAN_BE_REPLACED)
• Si le writer nécessite des événements de restauration (dans ce cas, toujours)
• Si un redémarrage est nécessaire après la restauration du writer (dans ce cas, non)

Cet élément peut éventuellement spécifier un mappage d’emplacement alternatif. (Dans ce cas, aucun emplacement alternatif n’est spécifié.) Pour plus d’informations, veuillez consulter Spécification des mappages d’emplacement alternatif.

Le deuxième élément enfant est un élément Component. Cet élément amène le writer à 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 »)
• selectable pour indiquer le statut de sélection pour la sauvegarde

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 pouvant être spécifiés pour chaque composant.) Cet élément ComponentFile a les attributs suivants :

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