Avamar : Échec des sauvegardes Hyper-V | Expiration du délai d’attente d’un snapshot VSS

Summary: Cet article traite d’un scénario d’échec dans les sauvegardes de cluster Avamar Hyper-V où les retards de communication entre les nœuds de cluster entraînent des délais d’expiration de synchronisation des snapshots VSS. Le problème est résolu en ajustant les paramètres de délai d’expiration dans le fichier de configuration avhypervvss.cmd. ...

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.
Check out other resources

Symptoms

Les sauvegardes de cluster Hyper-V échouent avec les erreurs suivantes :
À partir du cluster partagé var Journaux de répertoire :

  • avhypervvss Error <0000>: The plugin on remote client HYPERVNODE4 (192.168.1.1) terminated with code 10007: miscellaneous error
avhypervvss Error <0000>: The remote client HYPERNODE4 failed to start its backup sub-workorder in predefined time. Please examine the log 'Hyper-V_5pm-Hyper-_V-123456789-3032-Hyper-V_VSS.log' on client HYPERVNODE4 for more information.
avhypervvss Error <13810>: Unable to forward a ctl message to the remote client '192.168.1.1', result code: 3.
avhypervvss Error <41106>: [AV-CLUSTER0] is unable to wakeup sub-workorder on [HYPERVNODE4].
avhypervvss Error <42468>: Failed to update snapshot details from remote clients
avhypervvss Error <41659>: Backup did not complete successfully

     

À partir du log de sauvegarde sur le nœud concerné (C:\Program Files\avs\var) : 

  • avhypervvss Error <17114>: Timed out while waiting for a VSS snapshot synchronization event from the primary plugin.
avhypervvss Error <41632>: Failed to setup and notify primary.
avhypervvss Error <41659>: Backup did not complete successfully

Cause

L’échec est dû à des retards de communication dans les échanges de messages CTL entre les nœuds principal et secondaire du cluster Hyper-V. Ces retards empêchent la synchronisation en temps opportun des snapshots VSS, ce qui entraîne l’échec de la sauvegarde. 
 

Resolution

Pour résoudre le problème, augmentez les valeurs du délai d’expiration dans avhypervvss.cmd Fichier situé dans le cluster partagé var répertoire (comme dans, C:\ClusterStorage\Volume1\Avamar\var) :

Ajoutez les balises suivantes :

--request-ctl-timeout=600000
--subworkorder-timeout=20
  • --request-ctl-timeout=600000: Augmente le délai d’expiration CTL interne entre les nœuds (la valeur par défaut est de 60 secondes).
  • --subworkorder-timeout=20: Définit le temps d’attente (en minutes) pour que les clients back-end démarrent les sous-ordres de travail (la valeur par défaut est 5 minutes).

⚠️ Assurez-vous que le fichier est mis à jour sur tous les nœuds pertinents et redémarrez le processus de sauvegarde.

Affected Products

Avamar, Avamar Plug-in for Hyper-V VSS
Article Properties
Article Number: 000199557
Article Type: Solution
Last Modified: 30 Oct 2025
Version:  2
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.