使用 vSphere On-Disk Metadata Analyzer （VOMA） 檢查 VMFS 中繼資料一致性

• 存取 VMFS 資料存放區的某些檔案時發生問題
• 無法修改或清除 VMFS 資料存放區上的檔案時
• 嘗試讀取 VMFS 資料存放區上的檔案時失敗並顯示錯誤

無效的引數
嘗試修改磁碟分割表時，失敗並顯示錯誤：

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

在 /var/log/vmkernel 檔案中，可以看到類似以下的項目：

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 $

下列情況適用於執行中繼資料檢查：

• 環境發生儲存裝置中斷。
• 在 RAID 磁碟區重建或磁碟更換後
• vmkernel.log檔案中存在中繼資料錯誤。
• 它無法存取任何其他主機上不存在的 VMFS 資料存放區上的檔案。

先決條件：
執行 VOMA 之前，必須先確定以下事項：

1. 關閉受影響資料存放區上的所有虛擬機器，或將其遷移至其他資料存放區的所有虛擬機器。
   • 關閉 vSphere 磁碟上元數據分析器在具有某些類型的損壞元數據的檔上運行的虛擬機，可能會使虛擬機及其數據永久不可用。因此，始終建議在環境中進行虛擬機的最新備份。
2. 若為 VMFS-5/VMFS-6 資料存放區，會在所有 ESXi 7.x/8.x 主機上取消掛接資料存放區。
   • 如果 VOMA 是針對可存取一或多個 ESXi 主機的磁碟區執行，VOMA 會產生類似下列訊息：

     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

若要檢查中繼資料的一致性，請從 ESXi 主機的 CLI 執行 VOMA。VOMA 可用來檢查和修正 VMFS 資料存放區或支援 VMFS 資料存放區邏輯磁碟區的輕微不一致問題。

VOMA 可以檢查並修正下列項目。

Metadata
check and fix

Affinity metadata
check and fix

Directory validation

Lost and found files

VOMA 工具採用的命令選項包括以下內容。

-m|--module

-f|--func

-a|--affinityChk

-d|--device

voma -m vmfs -f check -d /vmfs/devices/disks/naa.xxxx:x

-b|--blockSize

-s|--logfile

-x|--extractDump

-D|--dumpfile

-v|--version

-h|--help

-Y

-Z| --file

手續：
取得支援您要檢查之 VMFS 資料存放區的裝置名稱和分割區編號。

#esxcli storage vmfs extent list

輸出中的裝置名稱和分割區欄可識別裝置。例如：

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

檢查 VMFS 錯誤。
提供備份 VMFS 資料存放區的裝置分割區的絕對路徑，並提供含裝置名稱的分割區號碼。例如：

# 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

參考文件：
使用 vSphere 磁碟上元數據分析器 （VOMA） 檢查 VMFS 元數據一致性 （broadcom.com）
使用 VOMA 檢查元數據一致性 （vmware.com）