Avamar : Échec de la sauvegarde de la machine virtuelle sur ESXI 5.x en raison d’une défaillance de VIXDISKLIB_QUERYALLOCATEDBLOCKS API

Résumé: Défaillance de la machine virtuelle (VM) ESXi) 5.x ; Les journaux affichent des erreurs de VixDiskLib_QueryAllocatedBlocks ESXi (NBD_ERR_GENERIC) causées par un motif de conformité de l’API (Application Programming Interface). ...

Cet article concerne Cet article ne concerne pas Cet article n’est associé à aucun produit spécifique. Toutes les versions du produit ne sont pas identifiées dans cet article.

Symptômes

Les sauvegardes d’image de machine virtuelle échouent lorsque la fonction Changed Block Tracking (CBT) est activée sur un ESXi version 5.x non pris en charge.
 

  1. Le journal de sauvegarde affiche la ligne suivante indiquant que la machine virtuelle cible est en cours d’exécution sur une version VMware non prise en charge :
avvcbimage Info <40638>: VM Host Name=esxi.example.com(5.5 build-2068190)
  1. Le journal de sauvegarde indique que CBT est activé, mais la sauvegarde est une sauvegarde CBT complète de niveau zéro : 
avvcbimage Info <11988>: A reference to a valid prior backup is not available so this will be a full level zero backup.

OU 

avvcbimage Info <14681>: Change block tracking (CTK) is supported for this VM but has been declined. This will increase proxy CPU and IOP consumption.
  1. Le journal de sauvegarde indique qu’un snapshot peut être créé avec succès :
avvcbimage Info <14632>: Snapshot 'Avamar-16763996243af4ead6dea4e3e0d24ea86d327bebed43a19e42' creation for VM '[datastore1] vmname/vmname.vmx' task completed, moref=snapshot-91273 
  1. Le journal de sauvegarde affiche le disque connecté à l’aide de hotadd ou NBD (Network Block Device).
    Par exemple :
avvcbimage Info <40634>: Connected with hotadd transport to virtual disk [datastore1] vmname/vmname-000001.vmdk. Time to connect: 16300 msecs  

OU  

avvcbimage Info <40634>: Connected with nbd transport to virtual disk [datastore)] vmname/vmname-000001.vmdk. Time to connect: 1025 msecs
  1. Le journal de sauvegarde indique que le VixDiskLib_QueryAllocatedBlocks L’appel d’API est effectué et échoue avec Illegal message et NBD_ERR_GENERIC Erreurs:
avvcbimage Info <16041>: VDDK:VixDiskLib: VixDiskLib_QueryAllocatedBlocks: Query allocated blocks.
avvcbimage Warning <16041>: VDDK:[NFC ERROR]NfcFssrvrProcessErrorMsg: received NFC error 2 from server: Illegal message during fssrvr session, id = 49
avvcbimage Info <16041>: VDDK:DISKLIB-LIB_MISC   : DiskLibGetAllocatedSectorChunksInRangeInt: failed to get allocated sector bitmap with 'NBD_ERR_GENERIC' (290).
avvcbimage Info <16041>: VDDK:VixDiskLib: Detected DiskLib error 290 (NBD_ERR_GENERIC).
avvcbimage Info <16041>: VDDK:VixDiskLib: VixDiskLibQueryBlockList: Fail to query blocks (offset 0, chunkSize 128, chunkNumber 524288). Error 1 (Unknown error) (DiskLib error 290: NBD_ERR_GENERIC) at 591.
  1. Le journal de sauvegarde affiche une suspension appropriée pour la raison de VixDiskLib_Read échec de l’étape 5. 
avvcbimage Error <0000>: [IMG0008] VixDiskLib_Read() (datastore)] vmname/vmname.vmdk) at offset 0 length 128 sectors returned (1) (1)Unknown error
avvcbimage Info <9772>: Starting graceful (staged) termination, VixDiskLib_Read returned an error (wrap-up stage)

 

Cause

La version de VMware ESXi n’est pas prise en charge. Avamar 19.2 et versions supérieures utilisent une nouvelle API appelée VixDiskLib_QueryAllocatedBlocks Pour interroger les blocs utilisés d’un disque virtuel.
Toutefois, cette API n’est pas rétrocompatible avec les versions ESXi 5.x.

Résolution

Le serveur VMware doit être mis à niveau vers une version prise en charge. ESXi 5.5 n’est pas pris en charge.

Pour contourner ce problème, définissez la balise avancée '--enable_query_allocated_block' à faux.

Voici deux méthodes pour le faire :

Méthode 1 (sur fichier CMD)

Sur le proxy, modifiez le fichier suivant : /usr/local/avamarclient/var/avvcbimageAll.cmd et modifiez ou ajoutez ces lignes : 

# If enabled, use QueryAllocatedBlock instead of QueryChangedDiskAreas for full backup/in-use query
#    Default is true.
--enable_query_allocated_block=false


Méthode 2 (par jeu de données dans l’interface utilisateur Avamar) 

  1. Modifier le jeu de données utilisé par la règle de sauvegarde.
  2. Sélectionnez le plug-in > Windows VMware Image Afficher le formulaire > libre AJOUTER 
    Key: 
    [avvcbimage]enable_query_allocated_block   
    Value: 
    False 
  3. Sélectionnez Linux VMware Image plug-in > Show Free form > ADD 
    Key: 
    [avvcbimage]enable_query_allocated_block   
    Value: 
    False 

    Voir l’exemple ci-dessous : 
     Modifier le jeu de données
Figure 1. Afficher le formulaire libre

Produits concernés

Avamar
Propriétés de l’article
Numéro d’article: 000210227
Type d’article: Solution
Dernière modification: 20 avr. 2026
Version:  3
Trouvez des réponses à vos questions auprès d’autres utilisateurs Dell
Services de support
Vérifiez si votre appareil est couvert par les services de support.