手動VIBインストールを使用したNSX-Tホストアップグレード失敗の回避策
search cancel

手動VIBインストールを使用したNSX-Tホストアップグレード失敗の回避策

book

Article ID: 441010

calendar_today

Updated On:

Products

VMware NSX

Issue/Introduction

免責事項：これは英文の記事「Workaround for NSX-T Host Upgrade Failure using Manual VIB Installation」の日本語訳です。記事はベストエフォートで翻訳を進めているため、ローカライズ化コンテンツは最新情報ではない可能性があります。最新情報は英語版の記事で参照してください。

 

  • NSX Manager UI から NSX-T ホストトランスポートノードをアップグレードすると失敗します。
  • ホストの状態は、[システム] > [ファブリック] > [ノード] ビューで「NSX インストール失敗」、「切断済み」、または「利用不可」と表示されます。
  • NSXのユーザーインターフェースで「解決」ボタンをクリックしても、問題は解決しません。
  • ESXiホストを再起動しても、アップグレードの失敗は解決しません。
  • 場合によっては、最初の試行時に [LockingError] 別のプロセスが ESX イメージを更新しています、というエラー メッセージが表示されることがあります。

Environment

  • VMware NSX-T Data Center 4.x
  • VMware ESXi 8.0.x

Cause

NSX Managerの自動エージェントが、必要なカーネルモジュール（VIB）をESXiホストに正常にプッシュまたはインストールできません。これは以下の原因が考えられます。

  • ESXiのesxupdateプロセスは、以前の試行の失敗またはサードパーティエージェント（HA/FDMなど）によってロックされています。

  •  管理プレーンにおけるネットワーク接続の断続的な不安定さのため、NSX Managerはインストールバンドルをホストに確実に転送することができません。

  •  ホストは、新しい自動ワークフローがトリガーされない為に、自身が「保留中」のアップグレード状態にあると認識しています。

Resolution

この問題を解決するには、コマンドラインインターフェイス（CLI）を使用して、NSXカーネルモジュール（VIB）をESXiホストに直接手動でインストールしてください。

前提条件：

  • ESXiホストがメンテナンスモードになっていることを確認してください。

  • 対象の NSX バージョンに対応する NSX オフライン バンドル (ZIP) を入手してください (例: nsx-lcp-bundle-4.2.****-esx80.zip)。これは Broadcom サポート ポータルからダウンロードするか、NSX Manager リポジトリから抽出できます。

手順：

  1. バンドルのアップロード：WinSCPやvSphere Datastore Browserなどのツールを使用して、NSXオフラインバンドルZIPファイルをESXiホストにアップロードします。

    • /tmp/ ディレクトリ、または永続的なデータストアパス (例: /vmfs/volumes/datastore1/) に配置できます。

  2. SSHでホストにログイン：SSH経由でrootユーザーとしてESXiホストにログインします。

  3. 場所の確認：ファイルをアップロードしたディレクトリに移動して、パスを確認してください。

    ls -l /path/to/your/bundle.zip

  4. VIBのインストール：VIBを手動でインストールするには、次のコマンドを実行します。（注：zipファイルへのフルパスを使用してください。）

    esxcli software vib install -d /path/to/nsx-lcp-bundle-4.2.3.1.x-esx80.zip

    （注：既存の破損したインストールに上書きインストールする場合は、必要に応じて --no-live-install を追加できますが、通常は標準インストールで十分です。）

  5. 再起動: コマンドが「メッセージ: アップデートが正常に完了しました」を返したら、ホストを再起動します。

    reboot

  6. インストールの確認：ホストがオンラインに戻ったら、SSH経由でログインしNSX VIBが存在することを確認します。

    esxcli software vib list | grep nsx

  7. NSX Manager の同期: NSX Manager UI にログインします。システム > ファブリック > ノード > ホストトランスポートノードに移動します。ホストがまだ緑色になっていない場合は、ホストを選択し、[解決] または [同期] をクリックして管理プレーン接続を確立します。

Additional Information

  • ドキュメント参照: 手動インストールのスイッチと要件の詳細については、Broadcom のドキュメント Manually Install NSX-T Data Center Kernel Modules on ESXi Hypervisorsを参照してください。

  • ログ: 手動で実行したesxcliコマンドが失敗した場合は、/var/log/esxupdate.logにあるESXiアップデートログを確認し、特定のロックエラーまたは依存関係エラーを探してください。

Powered by Wolken Software