Kontrollera VMFS-metadatakonsekvens med vSphere On-disk Metadata Analyzer (VOMA)

Summary: VOMA-verktyget kan användas för att utföra 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.
Check out other resources

Symptoms

  • När det uppstår problem med att komma åt vissa filer i ett VMFS-datalager
  • När det inte går att ändra eller ta bort filer i ett VMFS-datalager
  • När du försöker läsa filer i ett VMFS-datalager misslyckas det med ett fel

 

Ogiltigt argument
Vid försök att ändra partitionstabellen misslyckas med felet:

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

I filen /var/log/vmkernel kan du se poster som liknar:

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öljande scenarier gäller för att utföra en metadatakontroll:

  • Miljön drabbas av lagringsavbrott.
  • Efter en ombyggnad av RAID-volym eller byte av disk
  • Det finns metadatafel i vmkernel.log-filen.
  • Det går inte att komma åt filer i ett VMFS-datalager som inte finns på någon annan värd.

 

Resolution

Förutsättningar:
Innan du kör VOMA, måste du säkerställa att:

  1. Stäng av alla virtuella datorer i det berörda datalagret eller migrera till ett annat datalager.
    • Om du stänger av en virtuell dator som körs på filer med vissa typer av skadade metadata av vSphere On-disk Metadata Analyzer kan den virtuella datorn och dess data bli permanent otillgängliga. På grund av detta är det alltid tillrådligt att ha aktuella säkerhetskopior av de virtuella maskinerna i miljön.
  2. För VMFS-5/VMFS-6-datalager är datalagret avmonterat på alla ESXi 7.x/8.x-värdar.
    • Om VOMA körs mot en volym med åtkomst till en eller flera ESXi-värdar genererar VOMA ett meddelande som liknar: 
      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

Kontrollera metadatakonsekvens genom att köra VOMA från CLI för en ESXi-värd. VOMA kan användas för att kontrollera och åtgärda mindre inkonsekvensproblem för ett VMFS-datalager eller logiska volymer som säkerhetskopierar VMFS-datalagringen.

 

VOMA kan kontrollera och åtgärda följande punkter.

VOMA-funktioner Beskrivning 
Metadata
check and fix
 Exempel på kontroll och korrigering av metadata är, men är inte begränsade till, följande:
  • Validering av VMFS-volymhuvud för grundläggande metadatakonsekvens
  • Kontrollera konsekvensen för VMFS-resursfiler
  • Kontrollera sökväg och anslutning för alla filer
 
Affinity metadata
check and fix
 Om du vill aktivera tillhörighetskontrollen för VMFS6 använder du -a|--affinityChk .
Flera exempel på kontroll och korrigering av tillhörighetsmetadata är följande:
  • Tillhörighetsflaggor i resurstyper och FS3_ResFileMetadata.
  • Validering av tillhörighetsflaggor i SFB RC meta (FS3_ResourceClusterMDVMFS6).
  • Validering av alla poster i affinityInfo-posterna i rcMeta för RC, inklusive spillnyckeln, för att säkerställa att inga ogiltiga poster finns. Kontrollera om det saknas poster.
 
Directory validation
 VOMA kan upptäcka och korrigera följande fel:
  • Skadade kataloghashblock
  • Skada på allokeringskarta
  • Länk blockerar skadade data
  • Skadade katalogposter
 
Lost and found files
 Under en filsystemkontroll kan VOMA hitta filer som inte refereras någonstans i filsystemet. Dessa överblivna filer är giltiga och fullständiga, men har inget namn eller någon katalogpost i systemet.
Om VOMA stöter på överblivna filer under genomsökningen skapas en katalog med namnet lost+found i roten av volymen för att lagra de överblivna filerna. Namnen på filerna använder formatet Filsekvensnummer.

Kommandoalternativ som VOMA-verktyget använder inkluderar följande.

Kommandoalternativ Beskrivning 
-m|--module
 Tillgängliga moduler är:
  • lvm
  • vmfs
  • ptbl
 
-f|--func
 Funktioner som modulen stöder:
  • Fråga – lista över funktioner som stöds.
  • Kontrollera - kontrollera om det finns fel.
  • Fix - kontrollera och fixa.
  • Advfix – kontroll och korrigering för VMFS- och LVM-moduler.
  • Dump – samla in metadatadump.
 
-a|--affinityChk
 Inkludera en tillhörighetsrelaterad kontroll/korrigering för VMFS6. 
-d|--device
 Enhet och disk som ska användas.
Till exempel: 
voma -m vmfs -f check -d /vmfs/devices/disks/naa.xxxx:x
 
-b|--blockSize
 Ange diskblockstorleken. 
-s|--logfile
 Ange sökvägen till loggfilen för att mata ut resultatet. 
-x|--extractDump
 Extrahera den insamlade dumpen med VOMA. 
-D|--dumpfile
 Ange dumpfilen för att spara den insamlade metadatadumpen. 
-v|--version
 Visa versionen av VOMA. 
-h|--help
 Visa hjälpmeddelandet för VOMA-kommandot. 
-Y
 Ange att VOMA körs utan att använda PE-tabeller för adressmatchning. 
-Z| --file
 Ange att VOMA körs på extraherade enhetsfiler.

 

Procedur:
Hämta namn och partitionsnummer för den enhet som säkerhetskopierar det VMFS-datalager som du vill kontrollera.

#esxcli storage vmfs extent list

Kolumnerna Enhetsnamn och Partition i utdata identifierar enheten. Till exempel:

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

Kontrollera om det finns VMFS-fel.
Ange den absoluta sökvägen till enhetspartitionen som säkerhetskopierar VMFS-datalagringen och ange ett partitionsnummer med enhetsnamnet. Till exempel:

# 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

 

Referensdokumentation:
Använda vSphere On-disk Metadata Analyzer (VOMA) för att kontrollera VMFS-metadatakonsistens (broadcom.com)Den här hyperlänken tar dig till en webbplats utanför Dell Technologies.
Kontrollera metadatakonsistens med VOMA (vmware.com)Den här hyperlänken tar dig till en webbplats utanför 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.