Kontrola konzistence metadat VMFS pomocí nástroje vSphere On-disk Metadata Analyzer (VOMA)

Summary: K provedení kontroly metadat v souborovém systému lze použít nástroj VOMA.

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

  • Pokud dojde k problémům s přístupem k určitým souborům v datovém úložišti VMFS
  • Když není možné upravit nebo vymazat soubory v datovém úložišti VMFS
  • Při pokusu o čtení souborů na datovém úložišti VMFS dojde k selhání s chybou

 

Argument
je neplatnýPři pokusu o úpravu tabulky oddílů selže s chybou:

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

V souboru /var/log/vmkernel se zobrazují položky podobné této:

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

K provedení kontroly metadat by se použily následující scénáře:

  • V prostředí došlo k výpadku úložiště.
  • Po přebudování svazku RAID nebo výměně disku
  • V souboru vmkernel.log jsou chyby metadat.
  • Nelze přistupovat k souborům na datovém úložišti VMFS, které se nenachází na žádném jiném hostiteli.

 

Resolution

Požadavky:
Před spuštěním programu VOMA je nutné zajistit, aby:

  1. Vypněte všechny virtuální počítače v dotčeném datovém úložišti nebo migrované do jiného datového úložiště.
    • Pokud nástroj vSphere On-disk Metadata Analyzer vypne virtuální počítač spuštěný na souborech s určitými typy poškozených metadat, může dojít k trvalé nedostupnosti virtuálního počítače a jeho dat. Z tohoto důvodu je vždy vhodné mít aktuální zálohy virtuálních strojů v prostředí.
  2. U datových úložišť VMFS-5/VMFS-6 je datové úložiště odpojeno na všech hostitelích ESXi 7.x/8.x.
    • Pokud je funkce VOMA spuštěna na svazku s přístupem k jednomu nebo více hostitelům ESXi, software VOMA zobrazí zprávu podobnou této:
      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

Chcete-li zkontrolovat konzistenci metadat, spusťte program VOMA z rozhraní příkazového řádku hostitele ESXi. Jazyk VOMA lze použít ke kontrole a opravě drobných problémů s nekonzistencí datového úložiště VMFS nebo logických svazků, které datové úložiště VMFS zálohují.

 

VOMA může zkontrolovat a opravit následující položky.

Funkce VOMA Popis
Metadata
check and fix
Mezi příklady kontroly a opravy metadat patří mimo jiné následující:
  • Ověření hlavičky svazku VMFS pro základní konzistenci metadat
  • Kontrola konzistence souborů prostředků VMFS
  • Kontrola cesty a konektivity všech souborů
Affinity metadata
check and fix
Chcete-li povolit kontrolu spřažení pro VMFS6, použijte -a|--affinityChk .
Mezi několik příkladů kontroly a opravy metadat spřažení patří:
  • Příznaky spřažení v typech prostředků a FS3_ResFileMetadata.
  • Validace afinitních příznaků v SFB RC meta (FS3_ResourceClusterMDVMFS6).
  • Ověření všech položek v položkách affinityInfo v rcMeta RC, včetně klíče přetečení, aby se zajistilo, že neexistují žádné neplatné položky. Zkontrolujte, zda nechybí položky.
Directory validation
Program VOMA dokáže rozpoznat a opravit následující chyby:
  • Poškození bloku hash adresáře
  • Poškození mapy alokace
  • Odkazy blokují poškození
  • Poškození bloku položky adresáře
Lost and found files
Během kontroly souborového systému může VOMA najít soubory, které nejsou nikde v souborovém systému odkazovány. Tyto osamocené soubory jsou platné a úplné, ale nemají název ani položku adresáře v systému.
Pokud VOMA během skenování narazí na osamocené soubory, vytvoří v kořenovém adresáři svazku adresář s názvem lost+found, kam se osamocené soubory uloží. Názvy souborů používají formát pořadového čísla souboru.

Mezi možnosti příkazů, které nástroj VOMA používá, patří následující.

Možnost příkazu Popis
-m|--module
Dostupné moduly jsou:
  • lvm
  • vmfs
  • ptbl
-f|--func
Funkce, které modul podporuje:
  • Dotaz - seznam podporovaných funkcí.
  • Kontrola - kontrola chyb.
  • Oprava - kontrola a oprava.
  • Advfix - kontrola a oprava pro moduly VMFS a LVM.
  • Dump – shromáždí výpis metadat.
-a|--affinityChk
Zahrňte kontrolu/opravu související s přidružením pro VMFS6.
-d|--device
Zařízení a disk, které se mají použít.
Například:
voma -m vmfs -f check -d /vmfs/devices/disks/naa.xxxx:x
-b|--blockSize
Uveďte velikost bloku disku.
-s|--logfile
Zadejte cestu k souboru protokolu pro výstup výsledků.
-x|--extractDump
Extrahujte shromážděný výpis pomocí jazyka VOMA.
-D|--dumpfile
Označte soubor výpisu, do kterého se má shromážděný výpis metadat uložit.
-v|--version
Zobrazí verzi VOMA.
-h|--help
Zobrazte zprávu nápovědy k příkazu VOMA.
-Y
Označuje, že se program VOMA spustil bez použití tabulek PE k překladu adres.
-Z| --file
Označuje, že VOMA je spuštěn na extrahovaných souborech zařízení.

 

Procedura:
Získejte název a číslo oddílu zařízení, které zálohuje datové úložiště VMFS, které chcete zkontrolovat.

#esxcli storage vmfs extent list

Sloupce Device Name (Název zařízení) a Partition (Oddíl) ve výstupu identifikují zařízení. Například:

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

Zkontrolujte chyby VMFS.
Zadejte absolutní cestu k oddílu zařízení, který zálohuje datové úložiště VMFS, a zadejte číslo oddílu s názvem zařízení. Například:

# 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

 

Referenční dokumentace:
Použití nástroje vSphere On-disk Metadata Analyzer (VOMA) ke kontrole konzistence metadat VMFS (broadcom.com)Tento hypertextový odkaz vás zavede na webové stránky mimo společnost Dell Technologies.
Kontrola konzistence metadat s VOMA (vmware.com)Tento hypertextový odkaz vás zavede na webové stránky mimo společnost 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.