Controllo della coerenza dei metadati VMFS utilizzando vSphere On-disk Metadata Analyzer (VOMA)

• In caso di problemi di accesso a determinati file su un datastore VMFS
• Quando non è possibile modificare o cancellare i file su un datastore VMFS
• Quando si tenta di leggere i file su un datastore VMFS, l'operazione ha esito negativo con un errore

Argomento
non validoQuando si tenta di modificare la tabella delle partizioni, l'operazione ha esito negativo con errore:

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

Nel file /var/log/vmkernel possono essere visualizzate voci simili 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 $

Per eseguire un controllo dei metadati si applicano i seguenti scenari:

• L'ambiente presenta un'interruzione dell'attività dello storage.
• Dopo la ricostruzione di un volume RAID o la sostituzione di un disco
• Nel file vmkernel.log sono presenti errori di metadati.
• Non è in grado di accedere ai file su un datastore VMFS non presente su nessun altro host.

Prerequisiti:
Prima di eseguire VOMA, è necessario verificare che:

1. Spegnere tutte le macchine virtuali sul datastore interessato o migrate a un altro datastore.
   • L'arresto di una macchina virtuale in esecuzione su file contenenti determinati tipi di metadati danneggiati da parte di vSphere On-Disk Metadata Analyzer può rendere la macchina virtuale e i relativi dati permanentemente non disponibili. Per questo motivo, è sempre consigliabile disporre di backup aggiornati delle macchine virtuali nell'ambiente.
2. Per i datastore VMFS-5/VMFS-6, il datastore viene disinstallato su tutti gli host ESXi 7.x/8.x.
   • Se VOMA viene eseguito su un volume con accesso a uno o più host ESXi, VOMA genera un messaggio simile al seguente:

     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

Per verificare la coerenza dei metadati, eseguire VOMA dalla CLI di un host ESXi. VOMA può essere utilizzato per controllare e risolvere problemi di incoerenza minori per un datastore VMFS o per i volumi logici che supportano il datastore VMFS.

VOMA è in grado di controllare e correggere i seguenti elementi.

Metadata
check and fix

Affinity metadata
check and fix

Directory validation

Lost and found files

Di seguito sono riportate le opzioni di comando disponibili per lo strumento VOMA.

-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:
Ottenere il nome e il numero di partizione del dispositivo che supporta il datastore VMFS che si desidera controllare.

#esxcli storage vmfs extent list

Le colonne Device Name e Partition nell'output identificano il dispositivo. Ad esempio:

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

Verificare la presenza di errori VMFS.
Fornire il percorso assoluto della partizione del dispositivo che supporta il datastore VMFS e fornire un numero di partizione con il nome del dispositivo. Ad esempio:

# 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

Documentazione di riferimento:
Utilizzo di vSphere On-disk Metadata Analyzer (VOMA) per controllare la coerenza dei metadati VMFS (broadcom.com)
Controllo della coerenza dei metadati con VOMA (vmware.com)