Vérification de la cohérence des métadonnées VMFS à l’aide de vSphere On-disk Metadata Analyzer (VOMA)

• En cas de problème d’accès à certains fichiers sur un datastore VMFS
• Lorsqu’il n’est pas possible de modifier ou d’effacer des fichiers sur un datastore VMFS
• Lorsque vous tentez de lire des fichiers sur un datastore VMFS, celui-ci échoue avec une erreur

Argument
non valideLa tentative de modification de la table de partitions échoue avec l’erreur suivante :

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

Dans le fichier /var/log/vmkernel, on peut voir des entrées similaires à :

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 $

Les scénarios suivants s’appliquent pour effectuer une vérification des métadonnées :

• L’environnement subit une panne de stockage.
• Après la reconstruction d’un volume RAID ou le remplacement d’un disque
• Il existe des erreurs de métadonnées dans le fichier vmkernel.log.
• Il ne peut pas accéder aux fichiers d’un datastore VMFS qui n’est présent sur aucun autre hôte.

Conditions préalables:
Avant d’exécuter VOMA, il est nécessaire de s’assurer que :

1. Mettez hors tension toutes les machines virtuelles sur le datastore concerné ou migrées vers un autre datastore.
   • L’arrêt d’une machine virtuelle s’exécutant sur des fichiers contenant certains types de métadonnées corrompues par vSphere On-disk Metadata Analyzer peut rendre la machine virtuelle et ses données définitivement indisponibles. Pour cette raison, il est toujours conseillé d’avoir des sauvegardes actuelles des machines virtuelles dans l’environnement.
2. Pour les datastores VMFS-5/VMFS-6, le datastore est démonté sur tous les hôtes ESXi 7.x/8.x.
   • Si VOMA est exécuté sur un volume ayant accès à un ou plusieurs hôtes ESXi, VOMA génère un message similaire à :

     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

Pour vérifier la cohérence des métadonnées, exécutez VOMA à partir de la CLI d’un hôte ESXi. VOMA peut être utilisé pour vérifier et corriger les problèmes mineurs d’incohérence d’un datastore VMFS ou des volumes logiques qui sauvegardent le datastore VMFS.

VOMA peut vérifier et corriger les éléments suivants.

Metadata
check and fix

Affinity metadata
check and fix

Directory validation

Lost and found files

Les options de commande prises en charge par l’outil VOMA sont les suivantes.

-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

Procédure:
Obtenez le nom et le numéro de partition du périphérique qui sauvegarde le datastore VMFS que vous souhaitez vérifier.

#esxcli storage vmfs extent list

Les colonnes Device Name et Partition de la sortie identifient l’appareil. Par exemple :

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

Recherchez les erreurs VMFS.
Indiquez le chemin absolu de la partition de périphérique qui sauvegarde le datastore VMFS, puis indiquez un numéro de partition avec le nom du périphérique. Par exemple :

# 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

Documentation de référence :
utilisation de vSphere On-disk Metadata Analyzer (VOMA) pour vérifier la cohérence des métadonnées VMFS (broadcom.com)
Vérification de la cohérence des métadonnées avec VOMA (vmware.com)