Kontrollere VMFS-metadatakonsekvens ved hjelp av vSphere On-disk Metadata Analyzer (VOMA)

Summary: VOMA-verktøyet kan brukes til å utføre en filsystemkontroll av 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 det er problemer med tilgang til bestemte filer på en VMFS-datalagring
  • Når det ikke er mulig å endre eller slette filer på et VMFS-datalager
  • Når du prøver å lese filer på en VMFS-datalagring, mislykkes det og viser en feil

 

Ugyldig argument
Når du prøver å endre partisjonstabellen, mislykkes med feil:

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

I /var/log/vmkernel-filen kan du se oppføringer som ligner på:

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 gjelder for å utføre en metadatakontroll:

  • Miljøet opplever lagringsavbrudd.
  • Etter gjenoppbygging av RAID-volum eller utskifting av disk
  • Det er metadatafeil i vmkernel.log-filen.
  • Det er ikke mulig å få tilgang til filer på en VMFS-datalagring som ikke finnes på en annen vert.

 

Resolution

Forutsetninger:
Før du kjører VOMA, er det nødvendig å sikre at:

  1. Slå av alle virtuelle maskiner på det berørte datalageret eller migrert til et annet datalager.
    • Hvis du slår av en virtuell maskin som kjører på filer som har bestemte typer ødelagte metadata av vSphere On-disk Metadata Analyzer, kan den virtuelle maskinen og tilhørende data bli permanent utilgjengelige. På grunn av dette er det alltid tilrådelig å ha nåværende sikkerhetskopier av de virtuelle maskinene i miljøet.
  2. For VMFS-5/VMFS-6-datalagre demonteres datalageret på alle ESXi 7.x/8.x-verter.
    • Hvis VOMA kjøres mot et volum med tilgang til én eller flere ESXi-verter, produserer VOMA en melding som ligner på:
      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

Hvis du vil kontrollere konsekvensen i metadataene, kjører du VOMA fra kommandolinjegrensesnittet til en ESXi-vert. VOMA kan brukes til å kontrollere og løse mindre inkonsekvensproblemer for et VMFS-datalager eller logiske volumer som støtter VMFS-datalageret.

 

VOMA kan sjekke og fikse følgende elementer.

VOMA-funksjoner Beskrivelse
Metadata
check and fix
Eksempler på metadatakontroll og -rettelse inkluderer, men er ikke begrenset til, følgende:
  • Validering av VMFS-volumhode for grunnleggende metadatakonsekvens
  • Kontrollere konsekvensen til VMFS-ressursfiler
  • Kontrollerer banenavnet og tilkoblingen til alle filer
Affinity metadata
check and fix
Hvis du vil aktivere affinitetskontroll for VMFS6, bruker du -a|--affinityChk -alternativet.
Flere eksempler på affinitetsmetadatakontroll og -korrigering omfatter følgende:
  • Affinitetsflagg i ressurstyper og FS3_ResFileMetadata.
  • Validering av affinitetsflagg i SFB RC meta (FS3_ResourceClusterMDVMFS6).
  • Validering av alle oppføringer i affinityInfo-oppføringene i rcMeta for RC, inkludert overflytnøkkelen, for å sikre at ingen ugyldige oppføringer eksisterer. Se etter manglende oppføringer.
Directory validation
VOMA kan oppdage og rette opp følgende feil:
  • Skade i hashblokk for katalog
  • Ødelagt Alloc-kart
  • Kobling blokkerer korrupsjon
  • Skade i katalogoppføringsblokk
Lost and found files
Under en filsystemkontroll kan VOMA finne filer som det ikke refereres til noe sted i filsystemet. Disse isolerte filene er gyldige og fullstendige, men har ikke et navn eller en katalogoppføring på systemet.
Hvis VOMA støter på foreldreløse filer under skanning, oppretter den en katalog med navnet lost+found ved roten av volumet for å lagre de foreldreløse filene. Navnene på filene bruker nummerformatet Filsekvens.

Kommandoalternativer som VOMA-verktøyet tar, inkluderer følgende.

Kommandoalternativ Beskrivelse
-m|--module
Tilgjengelige moduler er:
  • lvm
  • vmfs
  • ptbl
-f|--func
Funksjoner modulen støtter:
  • Spørring - liste over støttede funksjoner.
  • Sjekk - se etter feil.
  • Fix - sjekk og fiks.
  • Advfix - kontroll og reparasjon for VMFS- og LVM-moduler.
  • Dump - samle metadata dump.
-a|--affinityChk
Inkluder en affinitetsrelatert sjekk/reparasjon for VMFS6.
-d|--device
Enhet og disk som skal brukes.
Eksempel:
voma -m vmfs -f check -d /vmfs/devices/disks/naa.xxxx:x
-b|--blockSize
Angi størrelsen på diskblokken.
-s|--logfile
Angi banen til loggfilen for å sende ut resultatene.
-x|--extractDump
Pakk ut den innsamlede dumpen ved hjelp av VOMA.
-D|--dumpfile
Angi dumpfilen for å lagre den innsamlede metadatadumpen.
-v|--version
Vis versjonen av VOMA.
-h|--help
Vis hjelpemeldingen for VOMA-kommandoen.
-Y
Angi at VOMA kjører uten å bruke PE-tabeller for adresseløsing.
-Z| --file
Angi at VOMA kjører på utpakkede enhetsfiler.

 

Prosedyre:
Få navnet og partisjonsnummeret til enheten som støtter VMFS-datalageret du vil kontrollere.

#esxcli storage vmfs extent list

Enhetsnavn- og partisjonskolonnene i utdataene identifiserer enheten. Eksempel:

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

Se etter VMFS-feil.
Angi den absolutte banen til enhetspartisjonen som støtter VMFS-datalageret, og angi et partisjonsnummer med enhetsnavnet. Eksempel:

# 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

 

Referansedokumentasjon:
Bruke vSphere On-disk Metadata Analyzer (VOMA) til å kontrollere VMFS-metadatakonsistens (broadcom.com)Denne hyperkoblingen tar deg til et nettsted utenfor Dell Technologies.
Kontrollere metadatakonsistens med VOMA (vmware.com)Denne hyperkoblingen tar deg til et nettsted utenfor 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.