Écrivains

Writers sont des applications ou des services qui stockent des informations persistantes dans des fichiers sur disque et qui fournissent les noms et emplacements de ces fichiers aux demandeurs à l’aide de l’interface de cliché instantané.

Pendant les opérations de sauvegarde, les enregistreurs s’assurent que leurs données sont qui quittent et sont stables, adaptées aux clichés instantanés et à la sauvegarde. Les enregistreurs collaborent avec des restaurations en déverrouillant les fichiers lorsque cela est possible et en indiquant d’autres emplacements si nécessaire.

Si aucun enregistreur n’est présent lors d’une opération de sauvegarde VSS, une cliché instantané peut toujours être créée. Dans ce cas, toutes les données du volume copié en ombre sont dans l’état de cohérence des incidents .

État de l’enregistreur

Les enregistreurs conservent leur état dans un objet de métadonnées XML, le document de métadonnées de l’enregistreur .

Ces métadonnées d’enregistreur sont la seule structure de données qui contient le jeu de fichiers (chemin d’accès, spécification de fichier et indicateur de récursivité) des données à sauvegarder et à restaurer.

Le document de métadonnées de l’enregistreur organise les jeux de fichiers de l’enregistreur en groupes ou composants. La relation entre l’un de ces composants lors des opérations de sauvegarde et de restauration sur les autres composants gérés par l’enregistreur est décrite dans le document de métadonnées de l’enregistreur par la sélection du composant pour lade sauvegarde, sa la sélection pour la restaurationet ses chemins logiques . (Pour plus d’informations, consultez Configuration de l’organisation de composants et Utilisation de la sélection et des chemins logiques.)

Des informations supplémentaires qui régissent la restauration des fichiers et d’autres problèmes sont également contenues dans ce document.

Le demandeur a besoin des métadonnées de l’enregistreur, conjointement avec son propre document de composants de sauvegarde, pour traiter une sauvegarde ou une restauration.

Contrairement au document composants de sauvegarde, le document de métadonnées writer doit être considéré comme une structure en lecture seule. Une fois qu’un enregistreur l’a créé, le document n’est pas modifié.

Gestion des événements writer

Les opérations VSS d’un enregistreur sont lancées par le biais de la réception d’événements COM.

Lorsqu’aucun événement n’est présent, un enregistreur n’effectue pas d’opérations VSS (par exemple, une sauvegarde ou une restauration VSS). Au lieu de cela, il effectue son travail normal, comme répondre aux requêtes de base de données, gérer les données utilisateur ou fournir d’autres services.

Pour vous assurer que la gestion des erreurs pour plusieurs sessions de sauvegarde et de restauration parallèles est effectuée correctement, et pour vous assurer qu’une session de sauvegarde ou de restauration n’endommage pas une autre session, vous devez effectuer les opérations suivantes :

• Si le gestionnaire d’événements d’un enregistreur (tel que CVssWriter ::OnFreeze) appelle le CVssWriterEx2 ::GetSessionId, CVssWriter ::SetWriterFailureou CVssWriterEx2 ::SetWriterFailureEx, le gestionnaire d’événements doit appeler la méthode dans le même thread que celui qui a appelé le gestionnaire d’événements.
• L’implémentation de votre enregistreur d’un gestionnaire d’événements tel que OnFreeze peut décharger le travail sur les threads de travail si vous le souhaitez, tant que chaque thread de travail marshale les erreurs nécessaires pour renvoyer au thread de gestionnaire d’événements d’origine.

Gestion des événements d’identification

À l’exception de l’événement Identifier, le type et l’ordre des événements reçus par un enregistreur dépendent de manière unique du type d’opérations VSS actuellement en cours.

L’événement Identifier nécessite que les enregistreurs fournissent les informations système sur leur configuration et les fichiers qu’ils gèrent via leur document de métadonnées d’enregistreur . Un événement Identifier est généré en prise en charge de presque toutes les opérations VSS, notamment les requêtes système, ainsi que les opérations de sauvegarde et de restauration. Par conséquent, toute implémentation de l’enregistreur du gestionnaire d’événements Identifier CVssWriter ::OnIdentify doit être en mesure de gérer un événement Identifier à tout moment, y compris au milieu du traitement d’une autre opération VSS, telle qu’une sauvegarde ou une restauration. Un événement Identifier ne doit jamais être considéré comme faisant partie du cycle de vie d’une opération VSS, même si sa génération peut être attendue et requise avant le début de cette opération.

Il est particulièrement important que les informations d’état relatives à une opération VSS ne soient pas modifiées dans CVssWriter ::OnIdentify, car la réception d’un événement hors commande réinitialise ces informations.

Événements de sauvegarde et de restauration

Selon qu’il participe à une sauvegarde ou à une restauration, un enregistreur reçoit entre deux et sept événements, en plus d’un événement Identifier initial.

La gestion de ces événements constitue (du point de vue d’un enregistreur) le cycle de vie d’une opération de sauvegarde ou de restauration.

Dans une opération de sauvegarde classique (consultez Vue d’ensemble du traitement d’une sauvegarde sous VSS), un enregistreur gère les événements suivants (en plus d’un événement Identifier initial) :

• PrepareForBackup
• PrepareForSnapshot
• Geler
• Dégel
• PostSnapshot
• BackupComplete
• BackupShutdown

Dans une opération de restauration classique (consultez Vue d’ensemble du traitement d’une restauration sous VSS), un enregistreur gère les événements suivants :

• PreRestore
• PostRestore