Verificando a consistência de metadados do VMFS usando o vSphere On-disk Metadata Analyzer (VOMA)

• Quando há problemas para acessar determinados arquivos em um datastore VMFS
• Quando não for possível modificar ou apagar arquivos em um datastore VMFS
• Ao tentar ler arquivos em um datastore VMFS, ocorre uma falha com um erro

Argumento
inválidoAo tentar modificar a tabela de partições, ocorre uma falha com o erro:

Error: Read-only file system during write on /dev/disks/naa.600601603b503400de93e0a87e9ce211
SetPtableGpt: Unable to commit to disk

No arquivo /var/log/vmkernel podem ser vistas entradas semelhantes a:

vmkernel: 0:00:20:51.964 cpu3:1085)WARNING: Swap: vm 1086: 2268: Failed to open swap file '/volumes/4730e995-faa64138-6e6f-001a640a8998/mule/mule-560e1410.vswp': Invalid metadata
vmkernel: 0:00:20:51.964 cpu3:1085)WARNING: Swap: vm 1086: 3586: Failed to initialize swap file '/volumes/4730e995-faa64138-6e6f-001a640a8998/mule/mule-560e1410.vswp': Invalid metadata
cpu11:268057)WARNING: HBX: 599: Volume 50fd60a3-3aae1ae2-3347-0017a4770402 ("<Datastore name>") may be damaged on disk. Corrupt heartbeat detected at offset 3305472: [HB state 0 offset 6052837899185946624 gen 15439450 stampUS 5 $

Os seguintes cenários se aplicam para executar uma verificação de metadados:

• O ambiente passa por uma interrupção do armazenamento.
• Após uma recriação de volume RAID ou uma substituição de disco
• Há erros de metadados no arquivo vmkernel.log.
• Não é possível acessar arquivos em um datastore VMFS que não está presente em nenhum outro host.

Pré-requisitos:
Antes de executar o VOMA, é necessário garantir que:

1. Desligue todas as máquinas virtuais no datastore afetado ou migre para outro datastore.
   • O desligamento de uma máquina virtual em execução em arquivos com determinados tipos de metadados corrompidos pelo vSphere On-disk Metadata Analyzer pode tornar a máquina virtual e seus dados permanentemente indisponíveis. Por isso, é sempre aconselhável ter backups atuais das máquinas virtuais no ambiente.
2. Para datastores VMFS-5/VMFS-6, o datastore é desmontado em todos os hosts ESXi 7.x/8.x.
   • Se o VOMA for executado em um volume com acesso a um ou mais hosts do ESXi, o VOMA produzirá uma mensagem semelhante a:

     voma -m vmfs -d /vmfs/devices/disks/naa.00000000000000000000000000:
     Checking if device is actively being used by other hosts
     Found 1 actively heart beating hosts on device '/vmfs/devices/disks/naa.00000000000000000000000000:1'
     1): MAC Address xx:xx:xx:xx:xx:xx

Para verificar a consistência dos metadados, execute o VOMA a partir da CLI de um host do ESXi. O VOMA pode ser usado para verificar e corrigir pequenos problemas de inconsistência para um datastore VMFS ou volumes lógicos que fazem backup do datastore VMFS.

O VOMA pode verificar e corrigir os seguintes itens.

Metadata
check and fix

Affinity metadata
check and fix

Directory validation

Lost and found files

As opções de comando da ferramenta VOMA incluem o seguinte.

-m|--module

-f|--func

-a|--affinityChk

-d|--device

voma -m vmfs -f check -d /vmfs/devices/disks/naa.xxxx:x

-b|--blockSize

-s|--logfile

-x|--extractDump

-D|--dumpfile

-v|--version

-h|--help

-Y

-Z| --file

Procedimento:
Obtenha o nome e o número da partição do dispositivo que faz backup do datastore VMFS que você deseja verificar.

#esxcli storage vmfs extent list

As colunas Device Name e Partition na saída identificam o dispositivo. Por exemplo:

Volume Name  .....  Device Name                             Partition  
1TB_VMFS6    .....  naa.xxxx                                   3

Verifique se há erros VMFS.
Forneça o caminho absoluto para a partição do dispositivo que faz backup do datastore VMFS e forneça um número de partição com o nome do dispositivo. Por exemplo:

# voma -m vmfs -f check -d /vmfs/devices/disks/naa.xxxx:x
The output lists possible errors. For example, the following output indicates that the heartbeat address is invalid.
XXXXXXXXXXXXXXXXXXXXXXX
Phase 2: Checking VMFS heartbeat region
 ON-DISK ERROR: Invalid HB address
Phase 3: Checking all file descriptors.
Phase 4: Checking pathname and connectivity.
Phase 5: Checking resource reference counts.
Total Errors Found:           1

Documentação de referência:
como usar o vSphere On-disk Metadata Analyzer (VOMA) para verificar a consistência de metadados do VMFS (broadcom.com)
Verificando a consistência de metadados com o VOMA (vmware.com)