Avamar: O backup da VM falha no ESXI 5.x devido a VIXDISKLIB_QUERYALLOCATEDBLOCKS falha da API

Resumo: Falha na máquina virtual (VM) ESXi) 5.x; Os logs mostram os erros de VixDiskLib_QueryAllocatedBlocks (NBD_ERR_GENERIC) do ESXi causados pelo motivo de conformidade da interface de programação de aplicativos (API). ...

Este artigo aplica-se a Este artigo não se aplica a Este artigo não está vinculado a nenhum produto específico. Nem todas as versões do produto estão identificadas neste artigo.

Sintomas

Os backups de imagem da VM falham quando o rastreamento de blocos alterados (CBT) está habilitado em um ESXi versão 5.x não compatível.
 

  1. O log de backup mostra a seguinte linha indicando que a VM de destino está em execução em uma versão incompatível do VMware:
avvcbimage Info <40638>: VM Host Name=esxi.example.com(5.5 build-2068190)
  1. O log de backup mostra que o CBT está ativado, mas o backup é um backup completo de nível zero do CBT: 
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. O log de backup mostra que um snapshot bem-sucedido pode ser criado:
avvcbimage Info <14632>: Snapshot 'Avamar-16763996243af4ead6dea4e3e0d24ea86d327bebed43a19e42' creation for VM '[datastore1] vmname/vmname.vmx' task completed, moref=snapshot-91273 
  1. O log de backup mostra o disco conectado usando hotadd ou Network Block Device (NBD).
    Por exemplo:
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. O log de backup mostra que o VixDiskLib_QueryAllocatedBlocks A chamada API é feita e falha com Illegal messageNBD_ERR_GENERIC Erros:
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. O log de backup mostra o encerramento normal devido a VixDiskLib_Read falha da etapa 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

A versão do VMware ESXi não é compatível. O Avamar 19.2 e versões posteriores usam uma nova API chamada VixDiskLib_QueryAllocatedBlocks para consultar blocos em uso de um disco virtual.
No entanto, essa API não é compatível com versões anteriores do ESXi 5.x.

Resolução

O VMware Server deve receber upgrade para uma versão compatível. ESXi 5.5 não é compatível.

Como solução temporária, defina o indicador avançado '--enable_query_allocated_block' a falso.

Aqui estão dois métodos para fazer isso:

Método 1 (sobre o arquivo CMD)

No Proxy, edite o seguinte arquivo: /usr/local/avamarclient/var/avvcbimageAll.cmd e modifique ou adicione estas linhas: 

# 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 dados na interface do usuário do Avamar) 

  1. Edite o Dataset usado pela política de backup.
  2. Selecione o plug-in > Windows VMware Image Show Free form > ADD 
    Key: 
    [avvcbimage]enable_query_allocated_block   
    Value: 
    False 
  3. Selecione o plug-in > Linux VMware Image Show Free form > ADD 
    Key: 
    [avvcbimage]enable_query_allocated_block   
    Value: 
    False 

    Consulte o exemplo abaixo: 
     Editar conjunto de dados
Figura 1. Mostrar formulário gratuito

Produtos afetados

Avamar
Propriedades do artigo
Número do artigo: 000210227
Tipo de artigo: Solution
Último modificado: 20 abr. 2026
Versão:  3
Encontre as respostas de outros usuários da Dell para suas perguntas.
Serviços de suporte
Verifique se o dispositivo está coberto pelos serviços de suporte.