Überprüfen der VMFS-Metadatenkonsistenz mit vSphere On-disk Metadata Analyzer (VOMA)

Summary: Das VOMA-Tool kann verwendet werden, um eine Dateisystemprüfung von Metadaten durchzuführen.

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.

Symptoms

  • Bei Problemen beim Zugriff auf bestimmte Dateien in einem VMFS-Datenspeicher
  • Wenn es nicht möglich ist, Dateien auf einem VMFS-Datenspeicher zu ändern oder zu löschen
  • Beim Versuch, Dateien auf einem VMFS-Datenspeicher zu lesen, schlägt dies mit einem Fehler fehl

 

Unzulässiges Argument
Beim Versuch, die Partitionstabelle zu ändern, tritt folgender Fehler auf:

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

In der Datei /var/log/vmkernel werden Einträge ähnlich den folgenden angezeigt:

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 $

 

Cause

Die folgenden Szenarien gelten für die Durchführung einer Metadatenprüfung:

  • In der Umgebung kommt es zu einem Speicherausfall.
  • Nach einer RAID-Volume-Neuerstellung oder einem Festplattenaustausch
  • Die vmkernel.log Datei enthält Metadatenfehler.
  • Es kann nicht auf Dateien auf einem VMFS-Datenspeicher zugegriffen werden, die nicht auf einem anderen Host vorhanden sind.

 

Resolution

Voraussetzungen:
Bevor Sie VOMA ausführen, muss Folgendes sichergestellt sein:

  1. Schalten Sie alle virtuellen Maschinen auf dem betroffenen Datenspeicher aus oder migrieren Sie zu einem anderen Datenspeicher.
    • Das Herunterfahren einer virtuellen Maschine, die auf Dateien mit bestimmten Arten von beschädigten Metadaten durch vSphere On-disk Metadata Analyzer ausgeführt wird, kann dazu führen, dass die virtuelle Maschine und ihre Daten dauerhaft nicht verfügbar sind. Aus diesem Grund ist es immer ratsam, aktuelle Backups der virtuellen Maschinen in der Umgebung zu haben.
  2. Bei VMFS-5/VMFS-6-Datenspeichern wird die Bereitstellung des Datenspeichers auf allen ESXi 7.x/8.x-Hosts aufgehoben.
    • Wenn VOMA auf einem Volume mit Zugriff auf einen oder mehrere ESXi-Hosts ausgeführt wird, erzeugt VOMA eine Meldung ähnlich der folgenden:
      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

Um die Metadatenkonsistenz zu überprüfen, führen Sie VOMA über die CLI eines ESXi-Hosts aus. VOMA kann verwendet werden, um kleinere Inkonsistenzprobleme für einen VMFS-Datenspeicher oder logische Volumes, die den VMFS-Datenspeicher sichern, zu prüfen und zu beheben.

 

VOMA kann die folgenden Elemente überprüfen und korrigieren.

VOMA-Funktionen Beschreibung
Metadata
check and fix
Beispiele für die Überprüfung und Korrektur von Metadaten sind unter anderem:
  • Validierung des VMFS-Volume-Headers auf grundlegende Metadatenkonsistenz
  • Überprüfen der Konsistenz von VMFS-Ressourcendateien
  • Überprüfen des Pfadnamens und der Konnektivität aller Dateien
Affinity metadata
check and fix
Um die Affinitätsprüfung für VMFS6 zu aktivieren, verwenden Sie die -a|--affinityChk .
Beispiele für die Überprüfung und Korrektur von Affinitätsmetadaten sind die folgenden:
  • Affinitätskennzeichnungen in Ressourcentypen und FS3_ResFileMetadata.
  • Validierung von Affinitäts-Flags in SFB-RC-Meta (FS3_ResourceClusterMDVMFS6).
  • Validierung aller Einträge in den affinityInfo-Einträgen in rcMeta von RC, einschließlich des Überlaufschlüssels, um sicherzustellen, dass keine ungültigen Einträge vorhanden sind. Prüfen Sie, ob Einträge fehlen.
Directory validation
VOMA kann die folgenden Fehler erkennen und beheben:
  • Beschädigung des Verzeichnis-Hash-Blocks
  • Alloc-Zuordnungsbeschädigung
  • Beschädigungen von Linkblöcken
  • Beschädigung im Verzeichniseintragsblock
Lost and found files
Während einer Dateisystemprüfung kann VOMA Dateien finden, die nirgendwo im Dateisystem referenziert werden. Diese verwaisten Dateien sind gültig und vollständig, haben aber keinen Namen oder Verzeichniseintrag im System.
Wenn VOMA während des Scannens auf verwaiste Dateien stößt, wird ein Verzeichnis mit dem Namen lost+found im Stammverzeichnis des Volumes erstellt, in dem die verwaisten Dateien gespeichert werden. Für die Namen der Dateien wird das Format der Dateisequenznummer verwendet.

Zu den Befehlsoptionen, die das VOMA-Tool verwendet, gehören die folgenden.

Befehlsoption Beschreibung
-m|--module
Verfügbare Module sind:
  • lvm
  • vmfs
  • ptbl
-f|--func
Funktionen, die das Modul unterstützt:
  • Abfrage: Liste der unterstützten Funktionen.
  • Überprüfen: Prüfen auf Fehler.
  • Korrigieren – überprüfen und korrigieren.
  • Advfix: Überprüfung und Korrektur für VMFS- und LVM-Module.
  • Dump: Metadaten-Speicherabbild erfassen.
-a|--affinityChk
Schließen Sie eine affinitätsbezogene Prüfung/Korrektur für VMFS6 ein.
-d|--device
Zu verwendendes Gerät und Festplatte.
Zum Beispiel:
voma -m vmfs -f check -d /vmfs/devices/disks/naa.xxxx:x
-b|--blockSize
Geben Sie die Festplattenblockgröße an.
-s|--logfile
Geben Sie den Pfad zur Protokolldatei an, um die Ergebnisse auszugeben.
-x|--extractDump
Extrahieren Sie das erfasste Speicherabbild mithilfe von VOMA.
-D|--dumpfile
Geben Sie die Speicherabbilddatei an, in der das erfasste Metadatenspeicherabbild gespeichert werden soll.
-v|--version
Zeigen Sie die Version von VOMA an.
-h|--help
Zeigt die Hilfemeldung für den VAMA-Befehl an.
-Y
Zeigt an, dass VOMA ohne Verwendung von PE-Tabellen für die Adressauflösung ausgeführt wird.
-Z| --file
Zeigen Sie an, dass VOMA auf extrahierten Gerätedateien ausgeführt wird.

 

Verfahren:
Rufen Sie den Namen und die Partitionsnummer des Geräts ab, das den zu überprüfenden VMFS-Datenspeicher sichert.

#esxcli storage vmfs extent list

Die Spalten Gerätename und Partition in der Ausgabe identifizieren das Gerät. Zum Beispiel:

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

Überprüfen Sie auf VMFS-Fehler.
Geben Sie den absoluten Pfad zur Gerätepartition an, die den VMFS-Datenspeicher sichert, und geben Sie eine Partitionsnummer mit dem Gerätenamen an. Zum Beispiel:

# 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

 

Referenzdokumentation:
Verwenden von vSphere On-disk Metadata Analyzer (VOMA) zur Prüfung der VMFS-Metadatenkonsistenz (broadcom.com)Dieser Hyperlink führt Sie zu einer Website außerhalb von Dell Technologies.
Überprüfen der Metadatenkonsistenz mit VOMA (vmware.com)Dieser Hyperlink führt Sie zu einer Website außerhalb von Dell Technologies.

 

Affected Products

VMware ESXi 7.x, VMware ESXi 8.x
Article Properties
Article Number: 000226655
Article Type: Solution
Last Modified: 28 Jan 2025
Version:  2
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.