Unpreparing the Stateless ESXi host in NSX fails with the error: Agent VIB module is not installed
search cancel

Unpreparing the Stateless ESXi host in NSX fails with the error: Agent VIB module is not installed

book

Article ID: 341987

calendar_today

Updated On:

Products

VMware NSX Networking VMware vSphere ESXi

Issue/Introduction

Symptoms:
In VMware NSX for vSphere 6.x environment with Stateless ESXi 6.0.x hosts, you experience these symptoms:
  • Unpreparing an ESXi host fails
  • In the /var/log/vmware/eam/eam.log file or the C:\ProgramData\VMware\vCenterServer\logs\eam\eam.log file of the ESX Agent Manager (EAM), you see entries similar to:

    Agent VIB module is not installed. Cause : 15 The installation transaction failed. The transaction is not supported: VIB VMware_bootbank_esx-vxlan_6.0.0-0.0.3234748 cannot be removed live.

    For more information, see Troubleshooting vSphere ESX Agent Manager (EAM) with NSX (2122392).


Environment

VMware NSX for vSphere 6.2.x
VMware NSX for vSphere 6.1.x
VMware vSphere ESXi 6.0

Cause

This issue occurs because the ESX Agent Manager (EAM) sends uninstall operations to Stateless ESXi hosts which should not be occurring during an unprepare task.

EAM tries to uninstall the VIBs on the Stateless ESXi hosts and esxupdate fails if the VIB does not support live-removal. EAM handles this failure incorrectly and shows a reboot required message. The agency then fails to be uninstalled and the status then displays as Red.

Resolution

This is a known issue affecting VMware NSX for vSphere 6.x with Stateless ESXi 6.0.x hosts.

Currently, there is no resolution.

Note: This issue can be avoided by preparing your Stateless ESXi 6.0.x host using an Auto Deploy. For more information, see Deploying VXLAN through Auto Deploy and VMware NSX for vSphere 6.x (2092871).

To unprepare Stateless ESXi 6.0.x hosts:
  1. Click Uninstall on the NSX Manager Host Preparation tab.
    EAM goalState is set for uninstall and tries to uninstall the VIBs from the ESXi host which then fails.
  2. Modify the image-profile on the Auto-Deploy server to exclude the VIBs.
  3. Reboot all the ESXi hosts on the cluster.
    When the ESXi hosts are booting up, EAM polls the Auto-Deploy server and identifies the VIBs as absent. The ESXi hosts should then come up without the VIBs. When all ESXi hosts complete booting up without the VIBs, the EAM agency is destroyed.NSX Manager then displays as Green on the cluster.


Additional Information

In case of situations where a stale agency manifests due to not properly unpreparing Stateless ESXi 6.0.x host, you can remove the offending agency from the vCenter Server database.

For assistance on removing the offending agency from the vCenter Server database, contact VMware Support and file a Support Request. For more information, see Filing a Support Request in Customer Connect (2006985) or How to Submit a Support Request.

To be alerted when this document is updated, click the Subscribe to Article link in the Actions box.

Deploying VMware NSX for vSphere 6.x through Auto Deploy
Troubleshooting vSphere ESX Agent Manager (EAM) with NSX
NSX でステートレス ESXi ホストを準備解除すると次のエラーで失敗する:エージェント VIB モジュールがインストールされていません (Agent VIB module is not installed)
在 NSX 中取消准备无状态 ESXi 主机失败并显示以下错误: 代理 VIB 模块未安装