Strumento BETest

BETest è un richiedente vss che testa le operazioni avanzate di backup e ripristino. Questo strumento può essere usato per testare l'uso di un'applicazione di funzionalità vss complesse, ad esempio le seguenti:

  • Backup incrementale e differenziale
  • Opzioni di ripristino complesse, ad esempio il ripristino autorevole
  • Opzioni rollforward

Nota

BETest è incluso in Microsoft Windows Software Development Kit (SDK) per Windows Vista e versioni successive. VSS 7.2 SDK include una versione di BETest che viene eseguita solo in Windows Server 2003. Questo argomento descrive la versione di WINDOWS SDK di BETest, non la versione di Windows Server 2003 inclusa in VSS 7.2 SDK. Per informazioni sul download di Windows SDK e VSS 7.2 SDK, vedere Servizio Copia Shadow del volume.

 

Nell'installazione di Windows SDK, lo strumento BETest è disponibile in %Program Files(x86)%\Windows Kits\8.1\bin\x64 (per Windows a 64 bit) e %Program Files(x86)%\Windows Kits\8.1\bin\x86 (per Windows a 32 bit).

Esecuzione dello strumento BETest

Per eseguire lo strumento BETest dalla riga di comando, usare la sintassi seguente:

Opzioni della riga di comando BETest

L'esempio di utilizzo seguente illustra come usare lo strumento BETest insieme allo strumento VSS Test Writer, ovvero un writer VSS.

Esempio di utilizzo dello strumento BETest

  1. Creare una directory di test denominata C:\BETest. Copiare i file seguenti in questa directory:

  2. Creare una directory denominata C:\TestPath. Inserire alcuni file di dati di test in questa directory.

  3. Creare una directory denominata C:\BackupDestination. Lasciare vuota questa directory.

  4. Aprire due finestre dei comandi con privilegi elevati e impostare la directory di lavoro in ognuna su C:\BETest.

  5. Nella prima finestra di comando avviare lo strumento VSS Test Writer come indicato di seguito:

    vswriter.exe VswriterSample.xml

    Il file vswriterSample.xml configura lo strumento VSS Test Writer (vswriter) per segnalare il contenuto della directory c:\TestPath in preparazione a un'operazione di backup. Si noti che lo strumento VSS Test Writer non produrrà output finché non rileva l'attività da un richiedente, ad esempio BETest. Per arrestare lo strumento VSS Test Writer, premere CTRL+C.

  6. Nella seconda finestra di comando usare lo strumento BETest per eseguire un'operazione di backup come indicato di seguito:

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

    BETest eseguirà il backup dei file dalla directory C:\TestPath alla directory C:\BackupDestination. Salva il documento del componente di backup in C:\BETest\backup.xml.

  7. Se l'operazione di backup ha esito positivo, eliminare il contenuto della directory C:\TestPath e usare lo strumento BETest per eseguire un'operazione di ripristino come indicato di seguito:

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

Opzioni della riga di comando dello strumento BETest

Lo strumento BETest usa le opzioni della riga di comando seguenti per identificare il lavoro da eseguire.

/Auth

Esegue un'operazione di ripristino autorevole per Active Directory o la modalità applicazione Active Directory.

Windows Server 2003: questa opzione della riga di comando non è supportata.

/B

Esegue un'operazione di backup ma non esegue un ripristino.

/A.C

Esegue solo l'operazione di completamento del backup.

Windows Server 2003: questa opzione della riga di comando non è supportata.

/C Filename

Nota

Questa opzione della riga di comando è disponibile solo per la compatibilità con le versioni precedenti. È consigliabile usare invece l'opzione della riga di comando /X .

 

Seleziona i componenti di cui eseguire il backup o il ripristino in base al contenuto del file di configurazione specificato da Filename. Questo file deve contenere solo caratteri ANSI nell'intervallo compreso tra 0 e 127 e non deve essere maggiore di 1 MB. Ogni riga del file deve usare il formato seguente:

WriterId : ComponentName;

Dove WriterId è l'ID writer e ComponentName è il nome di uno dei componenti del writer. L'ID writer e i nomi dei componenti devono essere tra virgolette e devono essere presenti spazi prima e dopo i due punti (:). Se vengono specificati due o più componenti, devono essere separati da virgole. Ad esempio:

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

Percorso /D

Salvare i file di cui è stato eseguito il backup o ripristinarli dalla directory di backup specificata da Path.

/NBC

Omette l'operazione di completamento del backup.

Windows Server 2003: questa opzione della riga di comando non è supportata.

/O

Specifica che il backup include uno stato del sistema di avvio.

/P

Crea una copia shadow permanente.

Windows Server 2003: questa opzione della riga di comando non è supportata.

/Pre Filename

Se il tipo di backup specificato nell'opzione della riga di comando /T è INCREMENTAL o DIFFERENTIAL, impostare il documento di backup sul file specificato da Filename per il backup completo o incrementale precedente.

Windows Server 2003 e Windows XP: questa opzione della riga di comando non è supportata.

/R

Esegue il ripristino ma non esegue il backup. Deve essere usato insieme all'opzione della riga di comando /S .

/Replica

Crea una copia shadow che può essere usata per il rollback dell'applicazione.

Windows Server 2003: questa opzione della riga di comando non è supportata.

/S Filename

In caso di backup, salva il documento di backup nel file specificato da Filename. In caso di solo ripristino, carica il documento di backup da questo file.

/Istantanea

Crea una copia shadow del volume, ma non esegue il backup o il ripristino.

Windows Server 2003: questa opzione della riga di comando non è supportata.

/StopError

Arresta BETest quando viene rilevato il primo errore del writer.

Windows Server 2003: questa opzione della riga di comando non è supportata.

/T BackupType

Specifica il tipo di backup. BackupType può essere FULL, LOG, COPY, INCREMENTAL o DIFFERENTIAL. Per altre informazioni sui tipi di backup, vedere VSS_BACKUP_TYPE.

/V

Genera un output dettagliato che può essere usato per la risoluzione dei problemi.

Windows Server 2003: questa opzione della riga di comando non è supportata.

/X Filename

Seleziona i componenti di cui eseguire il backup o il ripristino in base al contenuto del file di configurazione XML specificato da Filename. Questo file deve contenere solo caratteri ANSI compresi nell'intervallo compreso tra 0 e 127. Il formato del file XML viene definito dallo schema nel file BETest.xml. Per un file di configurazione di esempio, vedere BetestSample.xml. Entrambi questi file si trovano nella directory vsstools.

Nota

È possibile visualizzare il file BETest.xml in Internet Explorer. Prima di aprire questo file, assicurarsi che il file xdr-schema.xsl si trovi nella stessa directory di BETest.xml. Il file xdr-schema.xsl contiene istruzioni di rendering che rendono il file BETest.xml più leggibile.

 

Windows Server 2003: questa opzione della riga di comando non è supportata.

File di configurazione XML di esempio: BetestSample.xml

Il file di configurazione di esempio seguente, BetestSample.xml, è disponibile nella directory Vsstools.

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

In questo esempio di un file di configurazione semplice viene selezionato un componente di cui eseguire il backup o il ripristino.

File di configurazione XML di esempio: VswriterSample.xml

Il file di configurazione di esempio seguente, VswriterSample.xml, è disponibile nella directory 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'elemento radice in questo file di configurazione è denominato TestWriter. Tutti gli altri elementi vengono disposti sotto l'elemento TestWriter.

Il primo attributo associato a TestWriter è l'attributo di utilizzo. Questo attributo specifica il tipo di utilizzo segnalato tramite il metodo IVssExamineWriterMetadata::GetIdentity. Uno dei valori possibili per questo attributo è USER_DATA.

Il secondo attributo è l'attributo deleteFiles. Questo attributo è descritto in Configurazione degli attributi del writer.

Il primo elemento figlio dell'elemento radice è un elemento RestoreMethod. Questo elemento specifica quanto segue:

  • Metodo restore (in questo caso, RESTORE_IF_CAN_BE_REPLACED)
  • Indica se il writer richiede eventi di ripristino (in questo caso, sempre)
  • Indica se è necessario un riavvio dopo il ripristino del writer (in questo caso, no)

Questo elemento può facoltativamente specificare un mapping di percorso alternativo. In questo caso, non viene specificata alcuna posizione alternativa. Per altre informazioni, vedere Specifica di mapping di percorsi alternativi.

Il secondo elemento figlio è un elemento Component. Questo elemento fa in modo che il writer aggiunga un componente ai relativi metadati. Un elemento Component contiene attributi per descrivere il componente e gli elementi figlio per descrivere il contenuto del componente, ad esempio quanto segue:

  • componentType per indicare se si tratta di un filegroup o di un database (in questo caso, un filegroup)
  • logicalPath per il percorso logico del componente (in questo caso non è specificato nessuno)
  • componentName per il nome del componente (in questo caso "TestFiles")
  • selezionabile per indicare lo stato selezionabile per il backup

L'elemento Component include anche un elemento figlio denominato ComponentFile per aggiungere una specifica di file a questo componente. Un elemento Component può avere un numero arbitrario di elementi ComponentFile che possono essere specificati per ogni componente. Questo elemento ComponentFile ha gli attributi seguenti:

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