ESXi のインストールまたはパッチ適用が MetadataDownloadError: "Unable to find index.xml" で失敗する

Products

• VMware vSphere ESXi 8.0

Issue/Introduction

免責事項： これは英文の記事 ESXi installation or patching fails with MetadataDownloadError: "Unable to find index.xml" の日本語訳です。記事はベストエフォートで翻訳を進めているため、ローカライズ化コンテンツは最新情報ではない可能性があります。最新情報は英語版の記事で参照してください。

esxcli コマンドを使用し、オフラインバンドル (.zipファイル) 経由で ESXi パッチまたはサードパーティ製 VIB (例：PowerPath) をインストールしようとすると、メタデータの抽出中にタスクが失敗します。

エラーメッセージ :

[MetadataDownloadError] Could not download from depot at zip:/vmfs/volumes/.../patch.zip?index.xml Error extracting index.xml: "There is no item named 'index.xml' in the archive"

Environment

• VMware ESXi 7.0.x
• VMware ESXi 8.0.x

Cause

この問題は、esxcli コマンドで指定された .zip ファイルが、有効な「オフラインデポ (Offline Depot)」ではなく、「配布パッケージ (ネストされたアーカイブ)」である場合に発生します。
esxcli software vib install -d コマンドは、アーカイブのルートに index.xml および vendor-index.xml を含む特定のディレクトリ構造を期待しています。
提供されたファイルにサブ zip ファイルが含まれている場合や、単に個別の VIB ファイルを圧縮したフォルダである場合、メタデータのダウンロードは失敗します。

Resolution

この問題を解決するには、実際のインストールバンドルまたは個別の VIB ファイルを特定して指定する必要があります。

1. ソースファイルの展開： ローカルマシン上でメインの .zip ファイルをダウンロードして展開し、その内容を確認します。
2. 正しいバンドルの特定： 展開されたフォルダ内に、「Offline Bundle」または「Depot」と明示的にラベル付けされたサブ zip ファイルがないか確認します。
3. コンテンツ構造の確認： 有効なデポ用 zip ファイルは、圧縮ツール (7-Zip や WinZip など) で表示した際に、ルートに index.xml ファイルが含まれています。
4. インストールの再試行：

• • 確認した正しいサブ zip ファイルを ESXi のデータストアにアップロードします。
  • 検証済みのオフラインバンドルを使用してインストールコマンドを実行します： esxcli software vib install -d /vmfs/volumes/[データストアID]/[正しいバンドル名].zip

代替案 (VIBインストール) : パッケージに個別の .vib ファイルのみが含まれている場合は、-d (デポ) フラグの代わりに -v (viburl) フラグを使用してください : esxcli software vib install -v /vmfs/volumes/[データストアID]/[フォルダ名]/[特定のVIB名].vib