Funzione BackupClusterDatabase (clusapi.h)

Articolo
08/22/2023

[Questa funzione è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Il supporto per questa funzione è stato rimosso in Windows Server 2008 e questa funzione non restituisce nulla e restituisce ERROR_CALL_NOT_IMPLEMENTED.]

Crea un backup del database del cluster e tutti i checkpoint del Registro di sistema.

Sintassi

DWORD BackupClusterDatabase(
  [in] HCLUSTER hCluster,
  [in] LPCWSTR  lpszPathName
);

Parametri

[in] hCluster

Gestire il cluster da eseguire il backup.

[in] lpszPathName

Stringa Unicode con terminazione null che specifica il percorso in cui deve essere creato il backup. Le informazioni di configurazione del cluster verranno salvate in questa posizione; si tratta di dati sensibili che devono essere protetti. Ad esempio, questi dati possono essere protetti usando un elenco di controllo di accesso per limitare l'accesso alla posizione in cui vengono archiviati i dati.

Valore restituito

Se la funzione ha esito positivo, restituisce ERROR_SUCCESS.

Se la funzione ha esito negativo, restituisce uno dei codici di errore di sistema.

Commenti

Idealmente, il percorso specificato deve essere un percorso visibile a tutti i nodi del cluster, ad esempio un percorso UNC. Almeno, il percorso deve essere visibile al nodo proprietario della risorsa quorum. Non includere un nome file nel percorso o la funzione avrà esito negativo, restituendo ERROR_DIRECTORY. Il percorso può includere una barra rovesciata finale.

Un modo per assicurarsi che esista un percorso appropriato consiste nel creare una condivisione di rete temporanea, come indicato di seguito:

Chiamare la funzione NetShareAdd per creare una condivisione di rete temporanea. Tutti i nodi del cluster devono avere accesso in scrittura a questa condivisione.
Chiamare BackupClusterDatabase, specificando la condivisione temporanea nel parametro lpszPathName .
Copiare i file di backup (vedere di seguito) in uno o più percorsi di archiviazione sicuri.
Chiamare la funzione NetShareDel per eliminare la condivisione.

Il backup contiene i file seguenti.

Percorso\File	Descrizione
lpszPathName\chk????. Tmp	File snapshot.
lpszPathName\quolog.log	File di log del quorum.
lpszPathName\<GUID della risorsa>\*. CPT	File di checkpoint del Registro di sistema per la risorsa identificata dal GUID.
lpszPathName\<GUID della risorsa>\*. CPR	I file di checkpoint di crittografia per la risorsa identificata dal GUID.
lpszPathName\Clusbackup.dat	File di marcatore di completamento del backup (file di sola lettura, nascosto, 0 byte)

Le operazioni successive di BackupClusterDatabase che usano lo stesso parametro lpszPath sovrascriveranno i file di backup esistenti.

Se possibile, eseguire più copie della directory di backup in supporti diversi e archiviare queste copie in posizioni separate.

Esempio

Nell'esempio seguente viene illustrata una routine di backup statica. Per un esempio più completo che incorpora RestoreClusterDatabase, vedere Backup e ripristino della configurazione del cluster. In questo esempio viene usato il file di intestazione ClusDocEx.h definito nella documentazione del cluster di failover.


int main( void )
 {
  HCLUSTER hCluster     = NULL;
  WCHAR szClusterName[] = L"CLUSTER_NAME";
  WCHAR szPath[]        = L"\\\\ClusBack\\19991215";
  DWORD dwResult        = ERROR_SUCCESS;
 
  if( ( hCluster = OpenCluster( szClusterName ) ) != NULL )
   {
    dwResult = BackupClusterDatabase( hCluster, szPath );
    CloseCluster( hCluster );
   }
  else
    dwResult = GetLastError();

  if( dwResult == ERROR_SUCCESS )
   {
    wprintf( L"\nDone. The cluster database has been backed up to %s. ", szPath );
    wprintf( L"The backup consists of the following files:\n    chk????.tmp\n"
             L"    quolog.log\n    *.cpt\n    *.cpr\n\n" );
    return 0;
   }
  else
   {
    wprintf( L"The operation failed (%d)\n", dwResult );
    return 1;
   }
 }

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows Server 2003 Enterprise, Windows Server 2003 Datacenter
Piattaforma di destinazione	Windows
Intestazione	clusapi.h
Libreria	ClusAPI.lib
DLL	ClusAPI.dll

Vedi anche

Funzioni di backup e ripristino

RestoreClusterDatabase

Condividi tramite