BETest Tool

BETest ist ein VSS-Anforderer, der erweiterte Sicherungs- und Wiederherstellungsvorgänge testet. Dieses Tool kann verwendet werden, um die Verwendung komplexer VSS-Features einer Anwendung zu testen, z. B. die folgenden:

  • Inkrementelle und differenzielle Sicherung
  • Komplexe Wiederherstellungsoptionen, z. B. autoritative Wiederherstellung
  • Rollforward-Optionen

Hinweis

BETest ist im Microsoft Windows Software Development Kit (SDK) für Windows Vista und höher enthalten. Das VSS 7.2 SDK enthält eine Version von BETest, die nur unter Windows Server 2003 ausgeführt wird. In diesem Thema wird die Windows SDK-Version von BETest und nicht die im VSS 7.2 SDK enthaltene Windows Server 2003-Version beschrieben. Informationen zum Herunterladen des Windows SDK und des VSS 7.2 SDK finden Sie unter Volumeschattenkopie-Dienst.

 

In der Windows SDK-Installation finden Sie das BETest-Tool in %Program Files(x86)%\Windows Kits\8.1\bin\x64 (für 64-Bit-Windows) und %Program Files(x86)%\Windows Kits\8.1\bin\x86 (für 32-Bit-Windows).

Ausführen des BETest-Tools

Verwenden Sie die folgende Syntax, um das BETest-Tool über die Befehlszeile auszuführen:

BETest -Befehlszeilenoptionen

Das folgende Verwendungsbeispiel zeigt, wie Sie das BETest-Tool zusammen mit dem VSS Test Writer-Tool verwenden, das ein VSS Writer ist.

BETest-Toolverwendung (Beispiel)

  1. Erstellen Sie ein Testverzeichnis mit dem Namen C:\BETest. Kopieren Sie die folgenden Dateien in dieses Verzeichnis:

  2. Erstellen Sie ein Verzeichnis mit dem Namen C:\TestPath. Stellen Sie einige Testdatendateien in diesem Verzeichnis bereit.

  3. Erstellen Sie ein Verzeichnis mit dem Namen C:\BackupDestination. Lassen Sie dieses Verzeichnis leer.

  4. Öffnen Sie zwei Eingabeaufforderungsfenster, und legen Sie das Arbeitsverzeichnis in jedem auf C:\BETest fest.

  5. Starten Sie im ersten Befehlsfenster das VSS Test Writer-Tool wie folgt:

    vswriter.exe VswriterSample.xml

    Die Datei „vswriterSample.xml“ konfiguriert das VSS Test Writer-Tool (vswriter), um den Inhalt des Verzeichnisses c:\TestPath zur Vorbereitung eines Sicherungsvorgangs zu melden. Beachten Sie, dass das VSS Test Writer-Tool keine Ausgabe erzeugt, bis es eine Aktivität von einem Anforderer wie BETest erkennt. Um das VSS Test Writer-Tool zu stoppen, drücken Sie STRG+C.

  6. Verwenden Sie im zweiten Befehlsfenster das Tool BETest, um einen Sicherungsvorgang wie folgt durchzuführen:

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

    BETest sichert die Dateien aus dem Verzeichnis „C:\TestPath“ im Verzeichnis „C:\BackupDestination“. Das Sicherungskomponentendokument wird in C:\BETest\backup.xml gespeichert.

  7. Wenn der Sicherungsvorgang erfolgreich ist, löschen Sie den Inhalt des Verzeichnisses C:\TestPath und führen Sie mit dem Tool BETest einen Wiederherstellungsvorgang wie folgt durch:

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

Befehlszeilenoptionen des BETest-Tools

Das BETest-Tool verwendet die folgenden Befehlszeilenoptionen, um die auszuführende Arbeit zu identifizieren.

/Auth

Führt einen autoritativen Wiederherstellungsvorgang für Active Directory oder den Active Directory-Anwendungsmodus aus.

Windows Server 2003: Diese Befehlszeilenoption wird nicht unterstützt.

/B

Führt einen Sicherungsvorgang aus, jedoch keine Wiederherstellung.

/BC

Führt nur den abgeschlossenen Sicherungsvorgang aus.

Windows Server 2003: Diese Befehlszeilenoption wird nicht unterstützt.

/C Filename

Hinweis

Diese Befehlszeilenoption wird nur aus Gründen der Abwärtskompatibilität bereitgestellt. Stattdessen sollte die Befehlszeilenoption /X verwendet werden.

 

Wählt die zu sichernden oder wiederherzustellenden Komponenten auf der Grundlage des Inhalts der Konfigurationsdatei aus, die durch Filename angegeben wird. Diese Datei darf nur ANSI-Zeichen im Bereich von 0 bis 127 enthalten und darf nicht größer als 1 MB sein. Jede Zeile in der Datei muss das folgende Format verwenden:

WriterId : ComponentName;

Dabei ist WriterId die Writer-ID, und ComponentName ist der Name einer der Komponenten des Writer. Die Writer-ID und die Komponentennamen müssen in Anführungszeichen stehen und vor und nach dem Doppelpunkt (:) müssen Leerzeichen angegeben werden. Wenn zwei oder mehr Komponenten angegeben werden, müssen diese durch Kommas getrennt werden. Zum Beispiel:

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

/D Path

Speichern Sie die gesicherten Dateien, oder stellen Sie sie aus dem durch Path angegebenen Sicherungsverzeichnis wieder her.

/NBC

Lässt den Sicherungsvorgang aus.

Windows Server 2003: Diese Befehlszeilenoption wird nicht unterstützt.

/O

Gibt an, dass die Sicherung einen startfähigen Systemzustand enthält.

/P

Erstellt eine persistente Schattenkopie.

Windows Server 2003: Diese Befehlszeilenoption wird nicht unterstützt.

/Pre Filename

Wenn der in der Befehlszeilenoption /T angegebene Sicherungstyp INKREMENTELL oder DIFFERENZIELL ist, legen Sie das Sicherungsdokument auf die Datei fest, die von Filename für die vorherige vollständige oder inkrementelle Sicherung angegeben wurde.

Windows Server 2003 und Windows XP: Diese Befehlszeilenoption wird nicht unterstützt.

/R

Führt die Wiederherstellung aus, jedoch keine Sicherung. Muss zusammen mit der Befehlszeilenoption /S verwendet werden.

/Rollback

Erstellt eine Schattenkopie, die für den Anwendungsrollback verwendet werden kann.

Windows Server 2003: Diese Befehlszeilenoption wird nicht unterstützt.

/S Filename

Speichert das Sicherungsdokument im Fall der Sicherung in der durch Filename angegebenen Datei. Bei der Wiederherstellung wird das Sicherungsdokument nur aus dieser Datei geladen.

/Snapshot

Erstellt eine Volumeschattenkopie, führt jedoch keine Sicherung oder Wiederherstellung durch.

Windows Server 2003: Diese Befehlszeilenoption wird nicht unterstützt.

/StopError

Beendet BETest, wenn der erste Writer-Fehler aufgetreten ist.

Windows Server 2003: Diese Befehlszeilenoption wird nicht unterstützt.

/T BackupType

Gibt den Sicherungstyp an. BackupType kann kann FULL, LOG, COPY, INCREMENTAL oder DIFFERENTIAL sein. Weitere Informationen zu Sicherungstypen finden Sie unter VSS_BACKUP_TYPE.

/V

Generiert ausführliche Ausgaben, die zur Problembehandlung verwendet werden können.

Windows Server 2003: Diese Befehlszeilenoption wird nicht unterstützt.

/X Filename

Wählt die Komponenten aus, die basierend auf dem Inhalt der durch Filename angegebenen XML-Konfigurationsdatei gesichert oder wiederhergestellt werden sollen. Diese Datei darf nur ANSI-Zeichen im Bereich von 0 bis 127 enthalten. Das Format der XML-Datei wird durch das Schema in der BETest.xml-Datei definiert. Eine Beispielkonfigurationsdatei finden Sie unter BetestSample.xml. Beide Dateien befinden sich im Vsstools-Verzeichnis.

Hinweis

Sie können die BETest.xml-Datei in Internet Explorer anzeigen. Stellen Sie vor dem Öffnen dieser Datei sicher, dass sich die Datei „xdr-schema.xsl“ im selben Verzeichnis wie BETest.xml befindet. Die Datei „xdr-schema.xsl“ enthält Renderinganweisungen, mit denen die BETest.xml-Datei besser lesbar ist.

 

Windows Server 2003: Diese Befehlszeilenoption wird nicht unterstützt.

Beispiel für eine XML-Konfigurationsdatei: BetestSample.xml

Die folgende Beispielkonfigurationsdatei, BetestSample.xml, finden Sie im Vsstools-Verzeichnis.

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

Dieses Beispiel einer einfachen Konfigurationsdatei wählt eine Komponente aus, die gesichert oder wiederhergestellt werden soll.

XML-Beispielkonfigurationsdatei: VswriterSample.xml

Die folgende Beispielkonfigurationsdatei, VswriterSample.xml, finden Sie im Vsstools-Verzeichnis.

<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>

Das Stammelement in dieser Konfigurationsdatei heißt TestWriter. Alle anderen Elemente sind unter dem TestWriter-Element angeordnet.

Das erste mit TestWriter verknüpfte Attribut ist das Verwendungsattribut. Dieses Attribut gibt die über IVssExamineWriterMetadata::GetIdentity gemeldete Methode an. Einer der möglichen Werte für dieses Attribut ist USER_DATA.

Das zweite Attribut ist das deleteFiles-Attribut. Dieses Attribut wird unter Konfigurieren von Writer-Attributen beschrieben.

Das erste untergeordnete Element des Stammelements ist ein RestoreMethod-Element. Dieses Element gibt Folgendes an:

  • Die Wiederherstellungsmethode (in diesem Fall RESTORE_IF_CAN_BE_REPLACED)
  • Gibt an, ob der Writer Wiederherstellungsereignisse erfordert (in diesem Fall immer)
  • Gibt an, ob ein Neustart erforderlich ist, nachdem der Writer wiederhergestellt wurde (in diesem Fall nein)

Dieses Element kann optional eine alternative Speicherortzuordnung angeben. (In diesem Fall wird kein alternativer Speicherort angegeben.) Weitere Informationen finden Sie unter Angeben alternativer Speicherortzuordnungen.

Das zweite untergeordnete Element ist ein Component-Element. Dieses Element bewirkt, dass der Writer eine Komponente zu seinen Metadaten hinzufügt. Ein Component-Element enthält Attribute zur Beschreibung der Komponente und untergeordnete Elemente zur Beschreibung des Inhalts der Komponente, beispielsweise die folgenden:

  • componentType, um anzugeben, ob es sich um eine Dateigruppe oder eine Datenbank handelt (in diesem Fall eine Dateigruppe)
  • logicalPath für den logischen Pfad der Komponente (in diesem Fall wird keine angegeben)
  • componentName für den Namen der Komponente (in diesem Fall „TestFiles“)
  • Auswählbar, um den auswählbaren Status für die Sicherung anzugeben

Das Component-Element verfügt außerdem über ein untergeordnetes Element namens ComponentFile, um dieser Komponente eine Dateispezifikation hinzuzufügen. (Ein Component-Element kann eine beliebige Anzahl von ComponentFile-Elementen aufweisen, die für jede Komponente angegeben werden können.) Dieses ComponentFile-Element weist die folgenden Attribute auf:

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