Kontrol af ensartethed i VMFS-metadata ved hjælp af vSphere On-Disk Metadata Analyzer (VOMA)

Summary: VOMA-værktøjet kan bruges til at udføre en filsystemkontrol af metadata.

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

  • Når der er problemer med at få adgang til bestemte filer på et VMFS-datalager
  • Når det ikke er muligt at ændre eller slette filer på et VMFS-datalager
  • Når du forsøger at læse filer på et VMFS-datalager, mislykkes det med en fejl

 

Ugyldigt argument
Når du forsøger at ændre partitionstabellen, mislykkes med fejl:

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

I filen /var/log/vmkernel kan man se poster, der ligner:

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

Følgende scenarier gælder for udførelse af en metadatakontrol:

  • Miljøet oplever lagerafbrydelse.
  • Efter en genopbygning af RAID-diskenheden eller udskiftning af en disk
  • Der er metadatafejl i vmkernel.log filen.
  • Det kan ikke få adgang til filer på et VMFS-datalager, der ikke findes på nogen anden vært.

 

Resolution

Forudsætninger:
Før du kører VOMA, skal du sikre dig, at:

  1. Sluk for alle virtuelle maskiner på det berørte datalager eller migreret til et andet datalager.
    • Hvis du lukker en virtuel maskine, der kører på filer med bestemte typer beskadigede metadata af vSphere On-disk Metadata Analyzer, kan det gøre den virtuelle maskine og dens data permanent utilgængelige. På grund af dette tilrådes det altid at have aktuelle sikkerhedskopier af de virtuelle maskiner i miljøet.
  2. For VMFS-5/VMFS-6-datalagre er datalageret frakoblet på alle ESXi 7.x/8.x-værter.
    • Hvis VOMA køres mod en diskenhed med adgang til en eller flere ESXi-værter, producerer VOMA en meddelelse, der ligner:
      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

Du kan kontrollere konsistensen af metadata ved at køre VOMA fra CLI på en ESXi-vært. VOMA kan bruges til at kontrollere og løse mindre uoverensstemmelser for et VMFS-datalager eller logiske diskenheder, der understøtter VMFS-datalageret.

 

VOMA kan kontrollere og rette følgende elementer.

VOMA-funktioner Beskrivelse
Metadata
check and fix
Eksempler på kontrol og rettelse af metadata omfatter, men er ikke begrænset til, følgende:
  • Validering af VMFS-diskenhedsheader for grundlæggende metadatakonsistens
  • Kontrol af konsistensen af VMFS-ressourcefiler
  • Kontrol af stinavnet og tilslutningsmulighederne for alle filer
Affinity metadata
check and fix
Hvis du vil aktivere affinitetskontrollen for VMFS6, skal du bruge ikonet -a|--affinityChk .
Flere eksempler på kontrol og rettelse af affinitetsmetadata omfatter følgende:
  • Tilknytningsflag i ressourcetyper og FS3_ResFileMetadata.
  • Validering af affinitetsflag i SFB RC-meta (FS3_ResourceClusterMDVMFS6).
  • Validering af alle poster i affinityInfo-posterne i rcMeta af RC, herunder overløbsnøglen, for at sikre, at der ikke findes ugyldige poster. Kontroller, om der er manglende poster.
Directory validation
VOMA kan registrere og rette følgende fejl:
  • Beskadigelse af mappehashblok
  • Beskadigelse af Alloc-kortet
  • Link blokerer korruption
  • Beskadigelse i mappeindtastningsblok
Lost and found files
Under en filsystemkontrol kan VOMA finde filer, der ikke refereres til nogen steder i filsystemet. Disse forældreløse filer er gyldige og komplette, men har ikke et navn eller en mappepost på systemet.
Hvis VOMA støder på forældreløse filer under scanning, oprettes der en mappe med navnet lost+found i roden af diskenheden til lagring af de forældreløse filer. Navnene på filerne bruger filformatet Filsekvensnummer.

De kommandoindstillinger, som VOMA-værktøjet tager, omfatter følgende.

Kommando Option Beskrivelse
-m|--module
Tilgængelige moduler er:
  • lvm
  • vmfs
  • ptbl
-f|--func
Funktioner modulet understøtter:
  • Forespørgsel - liste over understøttede funktioner.
  • Kontroller - kontroller for fejl.
  • Fix - tjek og ret.
  • Advfix - tjek og ret til VMFS- og LVM-moduler.
  • Dump - indsamle metadata dump.
-a|--affinityChk
Medtag en kontrol/rettelse relateret til tilknytning til VMFS6.
-d|--device
Enhed og disk, der skal bruges.
F.eks.:
voma -m vmfs -f check -d /vmfs/devices/disks/naa.xxxx:x
-b|--blockSize
Angiv diskblokstørrelsen.
-s|--logfile
Angiv stien til logfilen for at sende resultaterne.
-x|--extractDump
Udpak den indsamlede dump ved hjælp af VOMA.
-D|--dumpfile
Angiv dumpfilen for at gemme det indsamlede metadatadump.
-v|--version
Vis VOMA-versionen.
-h|--help
Vis hjælpemeddelelsen til VOMA-kommandoen.
-Y
Angiv, at VOMA kører uden brug af PE-tabeller til adresseopløsning.
-Z| --file
Angiv, at VOMA kører på udpakkede enhedsfiler.

 

Procedure:
Få navnet og partitionsnummeret på den enhed, der sikkerhedskopierer det VMFS-datalager, du vil kontrollere.

#esxcli storage vmfs extent list

Kolonnerne Enhedsnavn og Partition i outputtet identificerer enheden. F.eks.:

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

Kontroller, om der er VMFS-fejl.
Angiv den absolutte sti til enhedspartitionen, der sikkerhedskopierer VMFS-datalageret, og angiv et partitionsnummer med enhedsnavnet. F.eks.:

# 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

 

Referencedokumentation:
Brug af vSphere On-Disk Metadata Analyzer (VOMA) til at kontrollere VMFS-metadatakonsistens (broadcom.com)Dette hyperlink fører dig til et websted uden for Dell Technologies.
Kontrol af metadataoverensstemmelse med VOMA (vmware.com)Dette hyperlink fører dig til et websted uden for 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.