Avamar: A restauração de imagem do VMware é executada por horas, mostrando o progresso em GB ou TB, mas falha com "Tempo de espera excedido ao aguardar a conclusão do processo avtar gerado"

A restauração de imagem do VMware é executada por horas, mostra o progresso de GB ou TB, mas falha com:

avvcbimage Error <0000>: [IMG0011] Timeout on wait for spawned avtar process to complete

No log de restauração, observe que o plug-in do VMware se desconectou da máquina virtual após a restauração de um dos discos virtuais:

 avvcbimage Info <9679>: Virtual disk connection to '[datastore] testvm-Restore_1714653538862/testvm-Restore_4.vmdk' has been closed
 avvcbimage Info <40654>: isExitOK()=0
 avvcbimage Info <40654>: isExitOK()=0
 avvcbimage Info <12060>: Getting next pax element in VMFile directory
 avvcbimage Info <16041>: VDDK:VixDiskLib: VixDiskLib_Disconnect: Disconnect.

 avvcbimage Info <42222>: Using vSphere revertSnapshotTask snapshot moref (snapshot-414916)
 avvcbimage Info <14629>: Snapshot (snapshot-414916) removal for VM '[datastore] testvm-Restore1714653538862/Testvm-Restore.vmx' task queued, sleep for 1 sec

Após 300 s, observe que o processo avtar ainda está em execução e precisa de mais tempo. Por padrão, o tempo de espera excedido do subprocesso é de 5 minutos ou 300 segundos.

avvcbimage Error <0000>: [IMG0011] Timeout on wait for spawned avtar process to complete

Por exemplo, no registro a seguir, o plug-in de imagem esperou 5 minutos:

2024-05-03 12:53:04 avvcbimage Error <0000>: [IMG0011] Timeout on wait for spawned avtar process to complete

Posteriormente, no log, observe que o processo avtar foi concluído com sucesso (código 0), mas exigiu 1 hora, 32 minutos e 23 segundos:

2024-05-03 14:25:27 avvcbimage Info <6688>: Process 16763 (/usr/local/avamarclient/bin/avtar) finished (code 0: success)

No log avtar, as linhas de status (impressas a cada 15 minutos por padrão) mostram que, durante esse tempo, o avtar ainda estava restaurando um disco virtual. No entanto, como o plug-in de imagem está desconectado, esses dados não estão sendo gravados na máquina virtual.

2024-05-03 13:00:20 avtar Info <8688>: Status 2024-05-03 13:00:20, 24 files, 6 directories, 2,404 GB (24 files, 4,807 GB, 100.00% new) 1250MB  82% CPU  VMFiles/5/virtdisk-flat.vmdk

A causa raiz exata está sob investigação. No entanto, o gatilho comum em cada caso é quando o tamanho do disco virtual não é um múltiplo de 8.192 KB ou 1.048.576 KB.

Soluções temporárias:

• Execute uma restauração de acesso instantâneo em vez de uma restauração de imagem. Esse tipo de restauração é imune a esse problema.

OU

• Faça download e instale a versão mais recente da ferramenta GoAV do Avamar. A validate-size foi adicionado na versão 1.72 do GoAV.

Para obter mais informações sobre validate-size , consulte a seção Informações adicionais deste artigo ou a documentação do GoAV. 

1. Usando o GoAV, execute o comando: 

./goav vm validate-size 

2. Para redimensionar a máquina virtual:
   1. No vSphere Client, localize a máquina virtual.
   2. Edite a máquina virtual e selecione o disco identificado usando a ferramenta.
   3. Altere as unidades para MB e, na ferramenta GoAV, defina o tamanho como RESIZE TO.
3. Inicie um novo backup no Avamar. Depois que o backup for concluído, execute uma nova restauração de imagem no backup mais recente para confirmar se o problema foi resolvido. 

Mais informações sobre o recurso de tamanho de validação do GoAV: 
Esse recurso detecta máquinas virtuais com tamanhos de disco virtual que não sejam múltiplos de 8.192 KB ou 1.048.576 KB (1 MB). Se encontrado, ele recomenda um tamanho maior e mais novo para aumentar o disco virtual. 

./goav vm  validate-size --help
Validate Virtual Machine disk size by checking each disk for the VM on vcenter.
Verifies that disk sizes are properly divisible by 1MB and 8KB.

Usage:
  goav vm validate-size [flags]

Examples:
./goav vm validate-size --name testing8kb-invalidlength --vc myvcenter.fqdn.tld


DEVICE KEY |                                VMDK                                 | DISK SIZE |  8KB  |  1MB  | RESIZE TO
-------------+---------------------------------------------------------------------+-----------+-------+-------+------------
  2001       | [localDatastore] testing8kb-invalidlength/invalidSize.vmdk | 1536000   | false | false | 2 MB


Flags:
  -h, --help          help for validate-size
      --hide-valid    Set output to hide valid VMs
      --name string   VM Name
      --prompt        Prompts to select vCenters
      --vc string     Vcenter Name

Global Flags:
  -d, --debug      debug output
  -f, --force      Ignore Configuration
  -n, --noheader   Do not display header

Comandos explicados:

goav vm validate-size 

• Recupera uma lista de máquinas virtuais (VMs) do Avamar
• Estabelece uma conexão com cada vCenter da máquina virtual correspondente
• Obtém o tamanho do disco virtual e verifica se o tamanho é múltiplo de 8 KB ou 1 MB
• Se o tamanho do disco não for válido, recomenda-se um tamanho para aumentar o disco no VMware.

 Indicadores opcionais:

--hide-valid  -  Does print the VM names that have valid disk sizes  
--name   The virtual machine name to check  
--vc   The virtual center server to checks
--prompts Prompts to select vCenters

Exemplo de resultado: 

admin@ave:~/>: ./goav vm  validate-size --name 1mb-clone 

========================= vc.example.com  =========================


1mb-clone                                                                INVALID

  DEVICE KEY |                   VMDK                    |   DISK SIZE   | 8KB  |  1MB  | RESIZE TO
-------------+-------------------------------------------+---------------+------+-------+------------
  2000       | [Datastore] 1mb-clone/1mb-clone.vmdk | 1572864 Bytes | true | false | 2 MB