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.
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:
- 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í.
- 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
- 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:
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í:
|
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ří:
|
Directory validation |
Program VOMA dokáže rozpoznat a opravit následující chyby:
|
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:
|
-f|--func |
Funkce, které modul podporuje:
|
-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)
Kontrola konzistence metadat s VOMA (vmware.com)