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 wie die folgenden zu testen:

• 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 Windows Server 2003-Version beschrieben, die im VSS 7.2 SDK enthalten ist. Informationen zum Herunterladen des Windows SDK und des VSS 7.2 SDK finden Sie unter Volume Shadow Copy Service.

 

In der Windows SDK-Installation befindet sich 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

Im folgenden Verwendungsbeispiel wird gezeigt, wie Sie das BETest-Tool zusammen mit dem VSS Test Writer-Tool verwenden, bei dem es sich um einen VSS-Writer handelt.

Beispiel für die Verwendung des BETest-Tools

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

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

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

4. Öffnen Sie zwei Befehlsfenster mit erhöhten Rechten, 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 vswriterSample.xml-Datei 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 erst dann eine Ausgabe erzeugt, wenn aktivität von einem Anforderer wie BETest erkannt wird. Um das VSS Test Writer-Tool zu beenden, drücken Sie STRG+C.

6. 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 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 verwenden Sie das BETest-Tool, um einen Wiederherstellungsvorgang wie folgt auszufü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 autorisierenden 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, aber keine Wiederherstellung.

/BC

Führt nur den Vorgang zum Abschließen der Sicherung 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 Komponenten aus, die gesichert oder wiederhergestellt werden sollen, basierend auf dem Inhalt der Konfigurationsdatei, 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 aufweisen:

WriterId : ComponentName;

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

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

Pfad "/D"

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

/NBC

Der Vorgang zum Abschließen der Sicherung wird weggelassen.

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

/O

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

/P

Erstellt eine persistente Schattenkopie.

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

/PreFilename

Wenn der in der Befehlszeilenoption /T angegebene Sicherungstyp INCREMENTAL oder DIFFERENTIAL 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 eine Wiederherstellung aus, aber keine Sicherung. 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

Speichert im Falle einer Sicherung das Sicherungsdokument in der durch Filename angegebenen Datei. Im Falle einer Wiederherstellung lädt das Sicherungsdokument aus dieser Datei.

/Snapshot

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

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.

/TBackupType

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 Komponenten aus, die gesichert oder wiederhergestellt werden sollen, basierend auf dem Inhalt der XML-Konfigurationsdatei, die durch 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 BETest.xml-Datei definiert. Eine Beispielkonfigurationsdatei finden Sie unter BetestSample.xml. Beide Dateien befinden sich im Verzeichnis vsstools.

Hinweis

Sie können die BETest.xml-Datei im 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 finden Sie im Verzeichnis Vsstools.

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

In diesem Beispiel für eine einfache Konfigurationsdatei wird eine Komponente ausgewählt, die gesichert oder wiederhergestellt werden soll.

XML-Beispielkonfigurationsdatei: VswriterSample.xml

Die folgende Beispielkonfigurationsdatei VswriterSample.xml finden Sie 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 sind unter dem TestWriter-Element angeordnet.

Das erste Attribut, das TestWriter zugeordnet ist, ist das Usage-Attribut. Dieses Attribut gibt den Verwendungstyp an, der über die IVssExamineWriterMetadata::GetIdentity-Methode gemeldet wird. Einer der möglichen Werte für dieses Attribut ist USER_DATA.

Das zweite Attribut ist das attribut deleteFiles. Dieses Attribut wird unter Konfigurieren von Writerattributen 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 nach der Wiederherstellung des Writers ein Neustart erforderlich ist (in diesem Fall nein).

Dieses Element kann optional eine Zuordnung mit alternativen Speicherorten angeben. (In diesem Fall wird kein alternativer Speicherort angegeben.) Weitere Informationen finden Sie unter Angeben von Alternativen Speicherortzuordnungen.

Das zweite untergeordnete Element ist ein Component-Element. Dieses Element bewirkt, dass der Writer seinen Metadaten eine Komponente hinzu fügt. Ein Component-Element enthält Attribute zum Beschreiben der Komponente und untergeordneter Elemente, um den Inhalt der Komponente zu beschreiben, z. B. folgendes:

• componentType, um anzugeben, ob es sich um eine Dateigruppe oder eine Datenbank handelt (in diesem Fall eine Dateigruppe).
• logicalPath für den logischen Komponentenpfad (in diesem Fall wird keiner angegeben)
• componentName für den Namen der Komponente (in diesem Fall "TestFiles")
• auswählbar, um die status für die Sicherung auszuwählen

Das Component-Element verfügt auch ü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"