NSX Install fails with Error: Failed to install software on host. Failed to find any matching versioned deployment spec for given host type and version.

Products

• VMware NSX

Issue/Introduction

The following error is seen when trying to install/upgrade NSX on an ESXi Host:

Selecting the error and trying to resolve does not work and the host goes back to the same error state.

Same error message is also seen in var/log/nsxapi.log:

ERROR ExecutorChannel-480126231 SFMUtilities 14652 FABRIC [nsx@6876 comp="nsx-manager" errorCode="MP26051" level="ERROR" subcomp="manager"] Failed to find any matching versioned deployment spec for ESXI 8.0.2

Environment

VMware NSX

Cause

This error is expected if the version of NSX being installed is not compatible with Host ESXi version

Compatibility can be checked using Interoperability matrix: Product Interoperability Matrix

Resolution

Review Product Interoperability Matrix and install a version of NSX that is compatible with the ESXi Host version

Note:

In some cases, the NSX version being installed may be compatible with the ESXi hosts that are failing the upgrade. You can use the following workaround to bypass these hosts during the upgrade and install the upgraded version on them afterward.

Workaround:

1. Detach Transport Node Profiles (TNPs) from the clusters containing the failed hosts in the NSX UI.
   (This action will not impact other hosts in the cluster.)

2. Remove NSX from all failed hosts in each affected cluster:

   • Select the failed hosts and choose Remove NSX.

   • If removal fails, select the hosts again and choose Force Remove.

3. Re-run the upgrade pre-checks — there should now be no warnings for the previously failed hosts.

4. Resume host upgrades if there are remaining hosts that have not yet been upgraded.

   • If no other hosts remain, the Host Upgrade section should now show Upgrade Successful.

5. Proceed with the NSX Manager upgrade.

6. Once all edge nodes, hosts, and managers have been successfully upgraded, re-attach the TNPs to the relevant clusters.

   • The previously failed hosts will automatically be reconfigured with NSX on the new version.