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.
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:
- 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.
- 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
- 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:
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:
|
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:
|
Directory validation |
VOMA może wykryć i skorygować następujące błędy:
|
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:
|
-f|--func |
Funkcje obsługiwane przez moduł:
|
-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)
Sprawdzanie spójności metadanych z VOMA (vmware.com)