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 On-disk Metadata Analyzerによって特定のタイプの破損したメタデータを含むファイルで実行されている仮想マシンをシャットダウンすると、仮想マシンとそのデータが永続的に使用できなくなる場合があります。このため、環境内の仮想マシンの最新のバックアップを保持することが常に推奨されます。
2. VMFS-5/VMFS-6データストアの場合、データストアはすべてのESXi 7.x/8.xホストでマウント解除されます。
   • 1つまたは複数のESXiホストへのアクセス権を持つボリュームに対してVOMAを実行すると、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

出力の[Device Name]列と[Partition]列で、デバイスが特定されます。例：

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 On-disk Metadata Analyzer (VOMA)を使用したVMFSメタデータの整合性のチェック(broadcom.com)
Checking Metadata Consistency with VOMA (vmware.com)