Utilisez vSphere On-disk Metadata Analyser (VOMA) pour identifier et corriger les incidents d'altération des métadonnées qui affectent les systèmes de fichiers ou les volumes logiques sous-jacents.

Problème

Vous pouvez vérifier la cohérence des métadonnées lorsque vous rencontrez des problèmes avec une banque de données VMFS ou une ressource Virtual Flash. Par exemple, effectuez une vérification des métadonnées si l'un des incidents suivants se produit :

  • Vous rencontrez des pannes de stockage.

  • Après avoir reconstruit RAID ou effectué un remplacement de disque.

  • Le fichier vmkernel.log présente des erreurs de métadonnées similaires aux suivantes :

    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 $
  • Vous ne pouvez pas accéder aux fichiers sur un système VMFS.

  • Un rapport de corruption s'affiche pour une banque de données dans les onglets d'événements de vCenter Server.

Solution

Pour vérifier la cohérence des métadonnées, exécutez VOMA à partir de l'interface de ligne de commande d'un hôte ESXi. VOMA peut être utilisé pour vérifier et corriger les problèmes d'incohérence mineurs d'une banque de données VMFS ou des volumes logiques soutenant la banque de données VMFS.

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

Tableau 1. Fonctions VOMA

Fonctions VOMA

Description

Correctif et vérification des métadonnées

Voici quelques exemples de vérification et de correctif des métadonnées :

  • Validation d'un en-tête de volume VMFS pour la cohérence des métadonnées de base.

  • Vérification de la cohérence des fichiers de ressources VMFS (fichier système).

  • Vérification du chemin d'accès et la connectivité de tous les fichiers.

Correctif et vérification des métadonnées d'affinité

Pour activer la vérification d'affinité pour VMFS6, utilisez l'option -a|--affinityChk.

Voici quelques exemples de vérification et de correctif des métadonnées d'affinité :

  • Indicateurs d'affinité dans les types de ressources et FS3_ResFileMetadata.

  • Validation des indicateurs d'affinité dans SFB RC méta (FS3_ResourceClusterMDVMFS6).

  • Validation de toutes les entrées affinityInfo rcMeta rc, y compris la clé de dépassement de capacité, pour vérifier l'absence d'entrée non valide. Vérification d'entrées manquantes.

Validation du répertoire

VOMA peut détecter et corriger les erreurs suivantes :

  • Altération de bloc de hachage de répertoire.

  • Altération de mappage d'allocation.

  • Altérations des blocs de liaison.

  • Altérations de blocs d'entrée de répertoire.

En fonction de la nature de l'altération des données, VOMA peut corriger uniquement les entrées altérées ou entièrement reconstruire le bloc de hachage, les blocs de mappage d'allocation et les blocs de liaison.

Fichiers perdus et trouvés

Lors d'une vérification du système de fichiers, VOMA peut rechercher des fichiers qui ne sont pas référencés dans le système de fichiers. Ces fichiers inactifs sont valides et complets, mais vous ne disposez pas d'une entrée de nom ou de répertoire sur le système.

Si VOMA rencontre des fichiers inactifs lors de l'analyse, il crée un répertoire nommé lost+found à la racine du volume pour stocker les fichiers inactifs. Les noms des fichiers utilisent le format Filesequence-number.

Les options de commande utilisées par l'outil de VOMA comprennent les éléments suivants.

Tableau 2. Options de commande VOMA

Option de commande

Description

-m|--module

Les modules à exécuter sont notamment les suivants :

vmfs

Si vous ne spécifiez pas le nom du module, cette option est utilisée par défaut.

Vous pouvez vérifier les systèmes de fichiers VMFS et les systèmes de fichiers qui sauvegardent les ressources Virtual Flash. Si vous spécifiez ce module, les vérifications minimales sont également effectuées pour LVM.

lvm

Vérifiez les volumes logiques qui sauvegardent les banques de données VMFS.

ptbl

Vérifiez et validez les partitions VMFS telles que MBR ou GPT. Si aucune partition n'existe, déterminez si des partitions doivent exister.

-f|--func

Les fonctions à exécuter sont notamment les suivantes :

query

Fonctions de liste prises en charge par le module.

check

Recherche des erreurs.

fix

Recherche et correction des erreurs.

dump

Collectez le vidage des métadonnées.

-a|--affinityChk

Incluez la vérification et le correctif associé à l'affinité pour VMFS6.

-d|--device

Indiquez le périphérique ou le disque à inspecter. Assurez-vous de fournir le chemin absolu de la partition du périphérique qui prend en charge la banque de données VMFS. Si la banque de données s'étend sur plusieurs périphériques, fournissez l'UUID de l'extension de tête.

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

Si vous utilisez la commande -x|--extractDump, entrez plusieurs chemins de périphérique, avec un qualificateur de partition, séparés par une virgule. Le nombre de chemins de périphérique que vous entrez est égal au nombre de périphériques couverts.

-b|--blockSize

Indiquez la taille du bloc de disque.

-s|--logfile

Spécifiez le chemin d’accès au fichier journal pour obtenir les résultats.

-x|--extractDump

Extrayez le vidage de mémoire collecté à l'aide de VOMA.

-D|--dumpfile

Indiquez le fichier de vidage pour enregistrer le vidage de métadonnées collecté.

-v|--version

Afficher la version de VOMA.

-h|--help

Afficher le message d'aide de la commande VOMA.

-Y

Indiquez que vous exécutez VOMA sans utiliser les tables PE pour la résolution d'adresses.

-Z| --file

Indiquez que vous exécutez VOMA sur des fichiers de périphérique extraits.

Exemple

Collectez le vidage des métadonnées à partir d'un volume couvert :

voma -m vmfs -f dump -d head_extent -D dump_filename

Extrayez le vidage collecté sur les périphériques d'un volume couvert :

voma -x dump_filename -d head_extent,extent_2,extent_3...extent_n

Utiliser VOMA pour vérifier la cohérence des métadonnées

La tâche explique comment utiliser VOMA pour vérifier la cohérence des métadonnées VMFS. VOMA peut être utilisé pour vérifier et corriger les problèmes d'incohérence mineurs concernant une banque de données VMFS ou une ressource Virtual Flash. Exécutez VOMA depuis l'interface de ligne de commande d'un hôte d'ESXi.

Conditions préalables

Mettez hors tension les machines virtuelles en cours d'exécution ou déplacez-les vers une autre banque de données.

Procédure

  1. Obtenez le nom et le numéro de la partition du périphérique qui prend en charge la banque de données VMFS que vous souhaitez vérifier.
    #esxcli storage vmfs extent list
    Les colonnes Nom périphérique et Partition dans la sortie identifient le périphérique. Par exemple :
    Volume Name  .....  Device Name                             Partition  
    1TB_VMFS6    .....  naa.xxxx                                   3
  2. Recherchez les erreurs VMFS.

    Indiquez le chemin absolu de la partition du périphérique qui prend en charge la banque de données VMFS et entrez 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

    La sortie répertorie les erreurs possibles. Par exemple, la sortie suivante indique que l'adresse de signal de pulsation n'est pas valide.

    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