Avamar: El respaldo de VM falla en ESXI 5.x debido a una falla de la API de VIXDISKLIB_QUERYALLOCATEDBLOCKS

Resumen: Falla de ESXi de la máquina virtual (VM) 5.x; Los registros muestran errores de VixDiskLib_QueryAllocatedBlocks de ESXi (NBD_ERR_GENERIC) causados por el motivo de cumplimiento de la interfaz de programación de aplicaciones (API). ...

Este artículo se aplica a Este artículo no se aplica a Este artículo no está vinculado a ningún producto específico. No se identifican todas las versiones del producto en este artículo.

Síntomas

Los respaldos de imágenes de VM fallan cuando Changed Block Tracking (CBT) está habilitado en un ESXi versión 5.x no compatible.
 

  1. El registro de respaldo muestra la siguiente línea que indica que la VM objetivo se ejecuta en una versión de VMware no compatible:
avvcbimage Info <40638>: VM Host Name=esxi.example.com(5.5 build-2068190)
  1. El registro de respaldo muestra que CBT está habilitado, pero el respaldo es un respaldo completo de CBT de nivel cero: 
avvcbimage Info <11988>: A reference to a valid prior backup is not available so this will be a full level zero backup.

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. El registro de respaldo muestra que se puede crear una instantánea correcta:
avvcbimage Info <14632>: Snapshot 'Avamar-16763996243af4ead6dea4e3e0d24ea86d327bebed43a19e42' creation for VM '[datastore1] vmname/vmname.vmx' task completed, moref=snapshot-91273 
  1. El registro de respaldo muestra el disco conectado mediante hotadd o Dispositivo de bloque de red (NBD).
    Por ejemplo:
avvcbimage Info <40634>: Connected with hotadd transport to virtual disk [datastore1] vmname/vmname-000001.vmdk. Time to connect: 16300 msecs  

O  

avvcbimage Info <40634>: Connected with nbd transport to virtual disk [datastore)] vmname/vmname-000001.vmdk. Time to connect: 1025 msecs
  1. El registro de respaldo muestra que el VixDiskLib_QueryAllocatedBlocks Se realiza una llamada a la API y falla con Illegal messageNBD_ERR_GENERIC Errores:
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. El registro de respaldo muestra una finalización correcta debido a lo siguiente: VixDiskLib_Read falla del Paso 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)

 

Causa

La versión de VMware ESXi no es compatible. Avamar 19.2 y versiones posteriores utilizan una nueva API denominada VixDiskLib_QueryAllocatedBlocks para consultar los bloques en uso de un disco virtual.
Sin embargo, esta API no es compatible con versiones anteriores de ESXi 5.x.

Resolución

El servidor VMware se debe actualizar a una versión soportada. ESXi 5.5 no es compatible.

Como solución alternativa, establezca la marca avanzada '--enable_query_allocated_block' a falso.

Aquí hay dos métodos para hacer esto:

Método 1 (sobre archivo CMD)

En el proxy, edite el siguiente archivo: /usr/local/avamarclient/var/avvcbimageAll.cmd y modifique o agregue estas líneas: 

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


Método 2 (por conjunto de datos en la interfaz de usuario de Avamar) 

  1. Edite el conjunto de datos que utiliza la política de respaldo.
  2. Seleccione el plug-in > Windows VMware Image Mostrar forma libre ADD > 
    Key: 
    [avvcbimage]enable_query_allocated_block   
    Value: 
    False 
  3. Seleccione Linux VMware Image plug-in > Mostrar forma > libre ADD 
    Key: 
    [avvcbimage]enable_query_allocated_block   
    Value: 
    False 

    Consulte el ejemplo a continuación: 
     Editar conjunto de datos
Figura 1. Mostrar forma libre

Productos afectados

Avamar
Propiedades del artículo
Número del artículo: 000210227
Tipo de artículo: Solution
Última modificación: 20 abr 2026
Versión:  3
Encuentre respuestas a sus preguntas de otros usuarios de Dell
Servicios de soporte
Compruebe si el dispositivo está cubierto por los servicios de soporte.