Installing NSX on a VLCM cluster fails with error: "Host is incompatible with the overall desired image"
search cancel

Installing NSX on a VLCM cluster fails with error: "Host is incompatible with the overall desired image"

book

Article ID: 380447

calendar_today

Updated On:

Products

VMware NSX VMware vCenter Server 8.0

Issue/Introduction

  • Installing NSX on a VLCM cluster fails with error: "Host is incompatible with the overall desired image"
    • In NSX:

    • In vCenter / updates:

Environment

VMware vCenter
VMware NSX

Cause

  • This error occurs because Host Version (either ESXi Version or Vendor Addon) is different than Cluster Desired Image Version set in vLCM.
  • This can be verified under Host Cluster --> Updates --> Image
  • For example, in the following screenshot, we can see Vendor Addon is missing in Image version causing the host not compatible with image issue:

  • An error similar to the following may also be seen:

  • In the ESXi view, the relevant ESXi Hosts may be using a custom image:

Resolution

  1. Click edit on the Images. 
  2. Confirm the following:
    • Version of ESXi (This should be the same version that is installed on the Host).
    • The Vendor Addon version (In case, this is different from what the ESXi has, OR in case, this is missing, please correct/add it)
  3. Once this is done, a remediation can be done as a Cluster or individually for each Host (this should comply the Images with the ESXi and should install the NSX VIBs on that ESXi)
  4. If the “Resolve” option is still greyed out in NSX UI even after successful remediation , then uninstall NSX from the Cluster which will result in all Hosts in the Cluster to be in “Not configured” state. At this point, re-configure Cluster for NSX.
  5. Alternatively, re-install NSX on each ESXi Host individually:
    • Place the ESXi host into maintenance mode.
    • Move the ESXi outside the Cluster (this will uninstall NSX from this host).
    • Confirm the NSX VIBs are removed from this host by SSH and running the following command: esxcli software vib list | grep nsx
    • Once the NSX VIBs are removed, move the Host back to the Cluster which should trigger the NSX install again.

Note: It may be necessary to remediate the host again in vLCM.

Additional Information

Powered by Wolken Software