VOMA によるメタデータの整合性の確認

vSphere On-disk Metadata Analyzer (VOMA) を使用して、ファイルシステムまたは基盤となる論理ボリュームに影響するメタデータの破損インシデントを特定します。

問題

VMFS データストアまたは仮想フラッシュリソースで問題が発生した場合は、メタデータの整合性を確認できます。たとえば、次のいずれかの問題が発生した場合は、メタデータの確認を行います。

ストレージが停止する。
RAID を再構築した後またはディスク交換を行った後。

vmkernel.log ファイルに、次のようなメタデータエラーが記録されている。

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 $

VMFS 上のファイルにアクセスできない。
vCenter Server のイベントタブに、データストアが破損したことが表示される。

解決方法

メタデータの整合性を確認するには、ESXi ホストの CLI から VOMA を実行します。VOMA を使用して、VMFS データストアまたは仮想フラッシュリソースの小さい不整合問題を確認し、修正します。VOMA によって報告されるエラーを解決するには、VMware サポートに問い合わせてください。

VOMA ツールを使用するときは、これらのガイドラインに従います。

分析する VMFS データストアが複数のエクステントにまたがっていないことを確認します。VOMA は、単一のエクステントのデータストアのみに対して実行できます。
実行中の仮想マシンをパワーオフするか、それらを別のデータストアに移行します。

次の例は、VOMA を使用して VMFS メタデータの整合性を確認する方法を示しています。

確認する VMFS データストアをバッキングするデバイスの名前とパーティション番号を取得します。
#esxcli storage vmfs extent list
出力されたデバイス名およびパーティション列によりデバイスを特定します。例：
```
Volume Name  XXXXXXXX  Device Name                             Partition  
1TB_VMFS5    XXXXXXXX  naa.00000000000000000000000000000703    3
```
VMFS エラーをチェックします。
VMFS データストアをバッキングするデバイスパーティションへの絶対パスを指定し、パーティション番号をデバイス名とともに指定します。例：
# voma -m vmfs -f check -d /vmfs/devices/disks/naa.00000000000000000000000000000703:3
出力リストに可能性のあるエラーが表示されます。たとえば、次の出力は、ハートビートアドレスが無効であることを示しています。
```
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
```

VOMA ツールで指定できるコマンドオプションを次に示します。

表 1. VOMA コマンドオプション
コマンドオプション	説明
-m\|--module	実行するモジュールには次のようなものがあります。
	vmfs	モジュールの名前を指定しない場合は、このオプションがデフォルトで使用されます。 VMFS ファイルシステムと、仮想フラッシュリソースをバッキングするファイルシステムを確認することができます。このモジュールを指定すると、LVM の最小確認も同様に行われます。
	lvm	VMFS データストアをバッキングする論理ボリュームを確認します。
	ptbl	MBR、GPT などの VMFS パーティションを確認して検証します。パーティションが存在しない場合は、パーティションが必要かどうかを判断します。
-f\|--func	実行される機能には次のようなものがあります。
	query	モジュールでサポートされる機能をリストします。
	check	エラーの有無を確認します。
-d\|--device	検査されるデバイスまたはディスク。VMFS データストアをバッキングするデバイスパーティションへの絶対パスを指定します。例、/vmfs/devices/disks/naa.00000000000000000000000000:1。
-s\|--logfile	結果を出力するログファイルを指定します。
-v\|--version	VOMA のバージョンを表示します。
-h\|--help	VOMA コマンドのヘルプメッセージを表示します。

詳細については、VMware のナレッジベースの記事 KB 2036767 を参照してください。