BETest-Tool
BETest ist eine VSS-Anfordernde, die erweiterte Sicherungs- und Wiederherstellungsvorgänge testet. Dieses Tool kann verwendet werden, um zu testen, ob eine Anwendung komplexe VSS-Features wie die folgenden verwendet:
- Inkrementelle und differenzielle Sicherung
- Komplexe Wiederherstellungsoptionen, z. B. autoritative Wiederherstellung
- Rollforwardoptionen
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 auf Windows Server 2003 ausgeführt wird. In diesem Thema wird die Windows SDK-Version von BETest beschrieben, nicht die Windows Server 2003-Version, die im VSS 7.2 SDK enthalten ist. 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 unter %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-Toolverwenden, bei dem es sich um einen VSS Writer handelt.
Beispiel für die Verwendung des BETest-Tools
Erstellen Sie ein Testverzeichnis mit dem Namen C: \ BETest. Kopieren Sie die folgenden Dateien in dieses Verzeichnis:
- betest.exe
- vswriter.exe
- BetestSample.xml
- VswriterSample.xml
Erstellen Sie ein Verzeichnis mit dem Namen C: \ TestPath. Speichern Sie einige Testdatendateien in diesem Verzeichnis.
Erstellen Sie ein Verzeichnis mit dem Namen C: \ BackupDestination. Lassen Sie dieses Verzeichnis leer.
Öffnen Sie zwei Befehlsfenster mit erhöhten Rechten, und legen Sie jeweils das Arbeitsverzeichnis auf C: \ BETest fest.
Starten Sie im ersten Befehlsfenster das VSS Test Writer-Tool wie folgt:
vswriter.exe VswriterSample.xml
Die vswriterSample.xml-Datei konfiguriert das VSS Test Writer-Tool (vswriter), um den Inhalt des Verzeichnisses c: TestPath als Vorbereitung auf einen \ Sicherungsvorgang zu melden. Beachten Sie, dass das VSS Test Writer-Tool erst dann eine Ausgabe erzeugt, wenn es Aktivitäten von einem Anfordernden wie BETest erkennt. Drücken Sie STRG+C, um das VSS Test Writer-Tool zu beenden.
Verwenden Sie im zweiten Befehlsfenster das BETest-Tool, um einen Sicherungsvorgang wie folgt auszuführen:
betest.exe /B /S backup.xml /D C: \ BackupDestination /X BetestSample.xml
BETest gesichert die Dateien aus dem Verzeichnis C: \ TestPath im Verzeichnis C: \ BackupDestination. Das Sicherungskomponentendokument wird in C: \ BETest-backup.xml. \
Wenn der Sicherungsvorgang erfolgreich ist, löschen Sie den Inhalt des Verzeichnisses C: TestPath, und verwenden Sie das BETest-Tool, um einen Wiederherstellungsvorgang \ wie folgt durchzuführen:
betest.exe /R /S backup.xml /D C: \ BackupDestination /X BetestSample.xml
BETest-Tool Command-Line Optionen
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, führt jedoch keine Wiederherstellung durch.
-
/BC
-
Führt nur den Sicherungsvorgang aus.
Windows Server 2003: Diese Befehlszeilenoption wird nicht unterstützt.
-
/C Dateiname
-
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 basierend auf dem Inhalt der Konfigurationsdatei aus, die von Dateiname 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 der Name einer der Komponenten des Writers. Die Writer-ID und komponentennamen müssen in Anführungszeichen gesetzt werden, und es müssen Leerzeichen vor und nach dem Doppelpunkt (:). Wenn mindestens zwei Komponenten angegeben werden, müssen sie durch Kommas getrennt werden. Beispiel:
"5affb034-969f-4919-8875-88f830d0ef89" : "TestFiles1", "TestFiles2", "TestFiles3";
-
/D-Pfad
-
Speichern Sie die gesicherten Dateien in dem sicherungsverzeichnis, das unter Pfad angegeben ist, oder stellen Sie sie wieder her.
-
/NBC
-
Lässt den Sicherungsvorgang aus.
Windows Server 2003: Diese Befehlszeilenoption wird nicht unterstützt.
-
/O
-
Gibt an, dass die Sicherung einen startbaren Systemstatus 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 INCREMENTAL oder DIFFERENTIAL ist, legen Sie das Sicherungsdokument auf die Datei fest, die durch Dateiname für die vorherige vollständige oder inkrementelle Sicherung angegeben wird.
Windows Server 2003 und Windows XP: Diese Befehlszeilenoption wird nicht unterstützt.
-
/R
-
Führt eine Wiederherstellung durch, führt jedoch keine Sicherung durch. Muss zusammen mit der Befehlszeilenoption /S verwendet werden.
-
/Rollback
-
Erstellt eine Schattenkopie, die für das Anwendungsrollback verwendet werden kann.
Windows Server 2003: Diese Befehlszeilenoption wird nicht unterstützt.
-
/S Dateiname
-
Im Falle einer Sicherung speichert das Sicherungsdokument in der Datei, die unter Dateiname angegeben ist. Nur bei der Wiederherstellung lädt das Sicherungsdokument aus dieser Datei.
-
/Snapshot
-
Erstellt eine Volumeschattenkopie, führt aber keine Sicherung oder Wiederherstellung durch.
Windows Server 2003: Diese Befehlszeilenoption wird nicht unterstützt.
-
/StopError
-
Beendet BETest, wenn der erste Writerfehler auftritt.
Windows Server 2003: Diese Befehlszeilenoption wird nicht unterstützt.
-
/T BackupType
-
Gibt den Sicherungstyp an. BackupType kann FULL, LOG, COPY, INCREMENTAL oder DIFFERENTIAL sein. Weitere Informationen zu Sicherungstypen finden Sie unter VSS _ BACKUP _ TYPE.
-
/V
-
Generiert eine ausführliche Ausgabe, die für die Problembehandlung verwendet werden kann.
Windows Server 2003: Diese Befehlszeilenoption wird nicht unterstützt.
-
/X Dateiname
-
Wählt die Zu sichernden oder wiederherzustellenden Komponenten basierend auf dem Inhalt der XML-Konfigurationsdatei aus, die von Dateiname angegeben wird. Diese Datei darf nur ANSI-Zeichen im Bereich von 0 bis 127 enthalten. Das Format der XML-Datei wird durch das Schema in der datei BETest.xml definiert. Eine Beispielkonfigurationsdatei finden Sie unter BetestSample.xml. Beide Dateien befinden sich im Verzeichnis vsstools.
Hinweis
Sie können die BETest.xml-Datei in Internet Explorer anzeigen. Bevor Sie diese Datei öffnen, stellen Sie sicher, dass sich die Datei xdr-schema.xsl im selben Verzeichnis wie BETest.xml befindet. Die Datei xdr-schema.xsl enthält Renderinganweisungen, die die BETest.xml Datei lesbarer machen.
Windows Server 2003: Diese Befehlszeilenoption wird nicht unterstützt.
XML-Beispielkonfigurationsdatei: BetestSample.xml
Die folgende Beispielkonfigurationsdatei, BetestSample.xml, befindet sich im Verzeichnis Vsstools.
<BETest>
<Writer writerid="5affb034-969f-4919-8875-88f830d0ef89">
<Component componentName="TestFiles">
</Component>
</Writer>
</BETest>
In diesem Beispiel einer einfachen Konfigurationsdatei wird eine Komponente ausgewählt, die gesichert oder wiederhergestellt werden soll.
XML-Beispielkonfigurationsdatei: VswriterSample.xml
Die folgende Beispielkonfigurationsdatei, VswriterSample.xml, befindet sich im Verzeichnis 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>
Das Stammelement in dieser Konfigurationsdatei heißt TestWriter. Alle anderen Elemente werden unter dem TestWriter-Element angeordnet.
Das erste TestWriter-Attribut ist das Verwendungsattribut. Dieses Attribut gibt den Verwendungstyp an, der über die IVssExwriterMetadata::GetIdentity-Methode gemeldet wird. 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 Writerattributenbeschrieben.
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 nach der Wiederherstellung des Writers ein Neustart erforderlich ist (in diesem Fall nein).
Dieses Element kann optional eine Zuordnung alternativer Speicherorte 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 den Metadaten eine Komponente hinzufügt. Ein Component-Element enthält Attribute, um die Komponente und untergeordnete Elemente zu beschreiben, um den Inhalt der Komponente zu beschreiben, z. B.:
- 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 Sicherungsstatus anzugeben, der ausgewählt werden kann
Das Component-Element verfügt auch über ein untergeordnetes Element mit dem Namen ComponentFile, um dieser Komponente eine Dateispezifikation hinzuzufügen. (Ein Component-Element kann über eine beliebige Anzahl von ComponentFile-Elementen verfügen, die für jede Komponente angegeben werden können.) Dieses ComponentFile-Element weist die folgenden Attribute auf:
- path="c: \ TestPath"
- filespec=" * "
- recursive="no"