Sprawdzanie spójności metadanych VMFS przy użyciu vSphere On-disk Metadata Analyzer (VOMA)

Summary: Narzędzie VOMA może być używane do sprawdzania systemu plików metadanych.

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

  • W przypadku problemów z dostępem do niektórych plików w magazynie danych VMFS
  • Gdy nie można zmodyfikować lub usunąć plików w magazynie danych VMFS
  • Próba odczytu plików w magazynie danych VMFS kończy się niepowodzeniem z powodu błędu

 

Nieprawidłowy argument
Próba modyfikacji tabeli partycji kończy się niepowodzeniem z błędem:

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

W pliku /var/log/vmkernel można zobaczyć wpisy podobne do:

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

Do sprawdzenia metadanych mają zastosowanie następujące scenariusze:

  • W środowisku występuje awaria pamięci masowej.
  • Po odbudowie woluminu RAID lub wymianie dysku
  • W pliku vmkernel.log występują błędy metadanych.
  • Nie można uzyskać dostępu do plików w magazynie danych VMFS, który nie znajduje się na żadnym innym hoście.

 

Resolution

Warunki wstępne:
Przed uruchomieniem VOMA należy upewnić się, że:

  1. Wyłącz wszystkie maszyny wirtualne w magazynie danych, których dotyczy problem, lub zmigrowane do innego magazynu danych.
    • Wyłączenie maszyny wirtualnej działającej na plikach z pewnymi typami uszkodzonych metadanych przez analizator metadanych vSphere On-disk może spowodować, że maszyna wirtualna i jej dane będą trwale niedostępne. Z tego powodu zawsze zaleca się posiadanie aktualnych kopii zapasowych maszyn wirtualnych w środowisku.
  2. W przypadku magazynów danych VMFS-5/VMFS-6 magazyn danych jest odmontowany na wszystkich hostach ESXi 7.x/8.x.
    • Jeśli VOMA zostanie uruchomiona na woluminie z dostępem do jednego lub większej liczby hostów ESXi, VOMA generuje komunikat podobny do następującego:
      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

Aby sprawdzić spójność metadanych, uruchom polecenie VOMA z wiersza poleceń hosta ESXi. Za pomocą metody VOMA można sprawdzać i naprawiać drobne problemy z niespójnością magazynu danych VMFS lub woluminów logicznych, które stanowią kopię zapasową magazynu danych VMFS.

 

VOMA może sprawdzić i naprawić następujące elementy.

Funkcje VOMA Opis
Metadata
check and fix
Przykłady sprawdzania i naprawiania metadanych obejmują między innymi:
  • Walidacja nagłówka woluminu VMFS dla podstawowej spójności metadanych
  • Sprawdzanie spójności plików zasobów VMFS
  • Sprawdzanie ścieżki i łączności wszystkich plików
Affinity metadata
check and fix
Aby włączyć sprawdzanie powinowactwa dla systemu plików VMFS6, użyj polecenia -a|--affinityChk .
Oto kilka przykładów sprawdzania i naprawiania metadanych powinowactwa:
  • Flagi koligacji w typach zasobów i FS3_ResFileMetadata.
  • Walidacja flag powinowactwa w meta SFB RC (FS3_ResourceClusterMDVMFS6).
  • Walidacja wszystkich wpisów we wpisach affinityInfo w rcMeta RC, w tym klucza przepełnienia, aby upewnić się, że nie istnieją żadne nieprawidłowe wpisy. Sprawdź, czy nie brakuje wpisów.
Directory validation
VOMA może wykryć i skorygować następujące błędy:
  • Uszkodzenie bloku skrótu katalogu
  • Uszkodzenie mapy alokacji
  • Uszkodzenie bloków linków
  • Uszkodzenie bloku wpisów katalogu
Lost and found files
Podczas sprawdzania systemu plików narzędzie VOMA może odnaleźć pliki, do których nie ma odniesień w systemie plików. Osierocone pliki są prawidłowe i kompletne, ale nie mają nazwy ani wpisu katalogu w systemie.
Jeśli VOMA napotka osierocone pliki podczas skanowania, tworzy katalog o nazwie lost+found w katalogu głównym woluminu do przechowywania osieroconych plików. Nazwy plików używają formatu numeru sekwencji plików.

Opcje poleceń przyjmowane przez narzędzie VOMA obejmują następujące elementy.

Opcja polecenia Opis
-m|--module
Dostępne moduły to:
  • lvm
  • vmfs
  • ptbl
-f|--func
Funkcje obsługiwane przez moduł:
  • Zapytanie - lista obsługiwanych funkcji.
  • Sprawdź - sprawdź, czy nie ma błędów.
  • Poprawka - sprawdź i napraw.
  • Advfix — sprawdź i napraw moduły VMFS i LVM.
  • Dump - zrzut metadanych.
-a|--affinityChk
Uwzględnij kontrolę/poprawkę związaną z koligacją dla systemu plików VMFS6.
-d|--device
Urządzenie i dysk, które mają być używane.
Na przykład:
voma -m vmfs -f check -d /vmfs/devices/disks/naa.xxxx:x
-b|--blockSize
Wskaż rozmiar bloku dysku.
-s|--logfile
Określ ścieżkę do pliku dziennika, aby wyświetlić wyniki.
-x|--extractDump
Wyodrębnij zebrany zrzut przy użyciu VOMA.
-D|--dumpfile
Wskaż plik zrzutu, aby zapisać zebrany zrzut metadanych.
-v|--version
Wyświetla wersję narzędzia VOMA.
-h|--help
Wyświetla komunikat pomocy dotyczący polecenia VOMA.
-Y
Wskazuje, że VOMA działa bez użycia tabel PE do rozpoznawania adresów.
-Z| --file
Wskazuje, że VOMA działa na wyodrębnionych plikach urządzeń.

 

Procedura:
Uzyskaj nazwę i numer partycji urządzenia stanowiącego kopię zapasową magazynu danych VMFS, który chcesz sprawdzić.

#esxcli storage vmfs extent list

Kolumny Nazwa urządzenia i Partycja w danych wyjściowych identyfikują urządzenie. Na przykład:

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

Sprawdź, czy nie występują błędy VMFS.
Podaj ścieżkę bezwzględną do partycji urządzenia, która stanowi kopię zapasową magazynu danych VMFS, i podaj numer partycji z nazwą urządzenia. Na przykład:

# 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

 

Dokumentacja referencyjna:
Korzystanie z analizatora metadanych vSphere na dysku (VOMA) do sprawdzania spójności metadanych VMFS (broadcom.com)Kliknięcie tego hiperłącza powoduje wyświetlenie strony spoza witryny Dell Technologies.
Sprawdzanie spójności metadanych z VOMA (vmware.com)Kliknięcie tego hiperłącza powoduje wyświetlenie strony spoza witryny 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.