BETest ツール
BETest は、高度なバックアップ操作と復元操作をテストする VSS リクエスターです。 このツールを使用すると、次のような複雑な VSS 機能のアプリケーションの使用をテストできます。
- 増分バックアップと差分バックアップ
- 権限のある復元などの複雑な復元オプション
- ロールフォワード オプション
注意
BETest は、Windows Vista 以降の Microsoft Windows ソフトウェア開発キット (SDK) に含まれています。 VSS 7.2 SDK には、Windows Server 2003 でのみ実行される BETest のバージョンが含まれています。 このトピックでは、VSS 7.2 SDK に含まれる Windows Server 2003 バージョンではなく、BETest の Windows SDK バージョンについて説明します。 Windows SDK と VSS 7.2 SDK のダウンロードについて詳しくは、「ボリューム シャドウ コピー サービス」をご覧ください。
Windows SDK インストールでは、BETest ツールは %Program Files(x86)%\Windows Kits\8.1\bin\x64
(64 ビット Windows の場合) と %Program Files(x86)%\Windows Kits\8.1\bin\x86
(32 ビット Windows の場合) にあります。
コマンド ラインから BETest ツールを実行するには、次の構文を使用します。
BETest command-line-options
次の使用例は、BETest ツールを、VSS ライターである VSS テスト ライター ツールと共に使用する方法を示しています。
BETest ツールの使用例
C:\BETest という名前のテスト ディレクトリを作成します。 次のファイルをこのディレクトリにコピーします。
- betest.exe
- vswriter.exe
- BetestSample.xml
- VswriterSample.xml
C:\TestPath という名前のディレクトリを作成します。 このディレクトリにいくつかのテスト データ ファイルを配置します。
C:\BackupDestination という名前のディレクトリを作成します。 このディレクトリは空のままにします。
2 つの管理者特権のコマンド ウィンドウを開き、それぞれの作業ディレクトリを C:\BETest に設定します。
最初のコマンド ウィンドウで、次のように VSS テスト ライター ツールを起動します。
vswriter.exe VswriterSample.xml
vswriterSample.xml ファイルは、バックアップ操作の準備中に c:\TestPath ディレクトリの内容を報告するよう VSS テスト ライター ツール (vswriter) を構成します。 VSS テスト ライター ツールは、BETest などのリクエスターからのアクティビティを検出するまで出力を生成しないことに注意してください。 VSS テスト ライター ツールを停止するには、Ctrl キーを押しながら C キーを押します。
2 番目のコマンド ウィンドウで、BETest ツールを使用し、次のようにバックアップ操作を実行します。
betest.exe /B /S backup.xml /D C:\BackupDestination /X BetestSample.xml
BETest は、C:\TestPath ディレクトリから C:\BackupDestination ディレクトリにファイルをバックアップします。 バックアップ コンポーネント ドキュメントが C:\BETest\backup.xml に保存されます。
バックアップ操作に成功した場合、C:\TestPath ディレクトリの内容を削除し、BETest ツールを使用して次のように復元操作を実行します。
betest.exe /R /S backup.xml /D C:\BackupDestination /X BetestSample.xml
BETest ツールでは、次のコマンド ライン オプションを使用して、実行する作業を識別します。
-
/Auth
-
Active Directory または Active Directory アプリケーション モードの権限のある復元操作を実行します。
Windows Server 2003: このコマンド ライン オプションはサポートされていません。
-
/B
-
バックアップ操作を実行しますが、復元は実行しません。
-
/BC
-
バックアップの完了操作のみ実行します。
Windows Server 2003: このコマンド ライン オプションはサポートされていません。
-
/C Filename
-
注意
このコマンド ライン オプションは、下位互換性のためにのみ用意されています。 代わりに、/X コマンド ライン オプションを使用する必要があります。
Filename によって指定された構成ファイルの内容に基づいて、バックアップまたは復元するコンポーネントを選択します。 このファイルには、0 ~ 127 の範囲の ANSI 文字のみを含める必要があり、1 MB 以下にする必要があります。 ファイル内の各行は、次の形式を使用する必要があります。
WriterId : ComponentName;
ここで、WriterId はライター ID、ComponentName はライターのコンポーネントの 1 つの名前です。 ライター ID とコンポーネント名は引用符で囲む必要があり、コロン (:) の前後にはスペースが必要です。 複数のコンポーネントを指定する場合、コンマで区切る必要があります。 次に例を示します。
"5affb034-969f-4919-8875-88f830d0ef89" : "TestFiles1", "TestFiles2", "TestFiles3";
-
/D Path
-
バックアップされたファイルを、Path により指定されたバックアップ ディレクトリに保存するか復元します。
-
/NBC
-
バックアップの完了操作を省略します。
Windows Server 2003: このコマンド ライン オプションはサポートされていません。
-
/O
-
バックアップに起動可能なシステム状態が含まれていることを指定します。
-
/P
-
永続的なシャドウ コピーを作成します。
Windows Server 2003: このコマンド ライン オプションはサポートされていません。
-
/Pre Filename
-
/T コマンドライン オプションで指定されたバックアップ タイプが INCREMENTAL または DIFFERENTIAL の場合、バックアップ ドキュメントを、以前の完全バックアップまたは増分バックアップの Filename により指定されたファイルに設定します。
Windows Server 2003 および Windows XP: このコマンド ライン オプションはサポートされていません。
-
/R
-
復元を実行しますが、バックアップは実行しません。 /S コマンドライン オプションと共に使用する必要があります。
-
/Rollback
-
アプリケーションのロールバックに使用できるシャドウ コピーを作成します。
Windows Server 2003: このコマンド ライン オプションはサポートされていません。
-
/S Filename
-
バックアップの場合、バックアップ ドキュメントを Filename により指定されたファイルに保存します。 復元のみの場合、このファイルからバックアップ ドキュメントを読み込みます。
-
/Snapshot
-
ボリューム シャドウ コピーを作成しますが、バックアップや復元は実行しません。
Windows Server 2003: このコマンド ライン オプションはサポートされていません。
-
/StopError
-
最初のライター エラーが発生したら、BETest を停止します。
Windows Server 2003: このコマンド ライン オプションはサポートされていません。
-
/T BackupType
-
バックアップの種類を指定します。 BackupType には、FULL、LOG、COPY、INCREMENTAL、または DIFFERENTIAL を指定できます。 バックアップの種類について詳しくは、「VSS_BACKUP_TYPE」をご覧ください。
-
/V
-
トラブルシューティングに使用できる詳細出力を生成します。
Windows Server 2003: このコマンド ライン オプションはサポートされていません。
-
/X Filename
-
Filename によって指定された XML 構成ファイルの内容に基づいて、バックアップまたは復元するコンポーネントを選択します。 このファイルには、0 ~ 127 の範囲の ANSI 文字のみを含める必要があります。 XML ファイルの形式は、BETest.xml ファイル内のスキーマによって定義されます。 サンプル構成ファイルについては、BetestSample.xml をご覧ください。 これらのファイルはどちらも vsstools ディレクトリにあります。
注意
Internet Explorer で BETest.xml ファイルを表示できます。 このファイルを開く前に、xdr-schema.xsl ファイルが BETest.xml と同じディレクトリにあることを確認します。 xdr-schema.xsl ファイルには、BETest.xml ファイルをより読みやすくするためのレンダリング命令が含まれています。
Windows Server 2003: このコマンド ライン オプションはサポートされていません。
次のサンプル構成ファイル (BetestSample.xml) は、Vsstools ディレクトリにあります。
<BETest>
<Writer writerid="5affb034-969f-4919-8875-88f830d0ef89">
<Component componentName="TestFiles">
</Component>
</Writer>
</BETest>
この単純な構成ファイルの例では、バックアップまたは復元するコンポーネントを 1 つ選択します。
次のサンプル構成ファイル (VswriterSample.xml) は、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>
この構成ファイルのルート要素の名前は TestWriter です。 他のすべての要素は TestWriter 要素の下に配置されます。
TestWriter に関連付けられている最初の属性は usage 属性です。 この属性は、IVssExamineWriterMetadata::GetIdentity メソッドによって報告される使用状況の種類を指定します。 この属性に使用できる値の 1 つは USER_DATA です。
2 番目の属性は deleteFiles 属性です。 この属性については、「ライター属性の構成」をご覧ください。
ルート要素の最初の子要素は RestoreMethod 要素です。 この要素は、以下を指定します。
- 復元方法 (この場合は RESTORE_IF_CAN_BE_REPLACED)
- ライターに復元イベントが必要かどうか (この場合は常時)
- ライターの復元後に再起動が必要かどうか (この場合は、いいえ)
この要素は、必要に応じて代替場所マッピングを指定できます。 (この場合、代替場所は指定されません)。詳しくは、「代替場所マッピングの指定」をご覧ください。
2 番目の子要素は Component 要素です。 この要素により、ライターはメタデータにコンポーネントを追加します。 Component 要素には、コンポーネントを記述する属性と、コンポーネントの内容を記述する子要素が含まれています。以下に例を示します。
- これがファイル グループかデータベースかを示す componentType (この場合はファイル グループ)
- コンポーネントの論理パスの logicalPath (この場合、何も指定されていません)
- コンポーネントの名前の componentName (この場合は "TestFiles")
- selectable-for-backup ステータスを示す selectable
Component 要素には、このコンポーネントにファイル仕様を追加するための ComponentFile という名前の子要素もあります。 (Component 要素には、コンポーネントごとに指定できる任意の数の ComponentFile 要素を含めることができます)。この ComponentFile 要素には、以下の属性があります。
- path="c:\TestPath"
- filespec="*"
- recursive="no"