Host validation error "The host [<host-transport-node-UUID>] is missing portgroup [<portgroup-name>] found in the transport node configuration" received while preparing the host for NSX.

Products

• VMware NSX

Issue/Introduction

• NSX fails to install on ESXi host with validation error below;

9417: The host [<host-transport-node-UUID>] is missing portgroup [<portgroup-name>] found in the transport node configuration.

• Relevant log prints in /var/log/proton/nsxapi.log in NSX Managers;

2023-04-17T10:14:54.491Z  INFO http-nio-127.0.0.1-7440-exec-30 VcResourceServiceImpl 138228 FABRIC [nsx@6876 comp="nsx-manager" level="INFO" reqId="24aea4b1-####-####-####-febfa4804e1c" subcomp="manager" username="admin"] VmwareDistributedVirtualSwitch found moref dvs-16
2023-04-17T10:14:54.491Z  WARN http-nio-127.0.0.1-7440-exec-30 VcResourceServiceImpl 138228 FABRIC [nsx@6876 comp="nsx-manager" level="WARNING" reqId="24aea4b1-####-####-####-febfa4804e1c" subcomp="manager" username="admin"] Unable to fetch DVS switch uuid 50 29 9f ## ## ## ## ##-## ## 72 69 c3 ac 27 f7
java.lang.NullPointerException: null
        at com.vmware.nsx.management.inventory.service.VcResourceServiceImpl.getDVSPortgroupName(VcResourceServiceImpl.java:493) ~[?:?]
        at com.vmware.nsx.management.inventory.service.VcResourceServiceImpl.getDVSOfHost(VcResourceServiceImpl.java:449) ~[?:?]
        at com.vmware.nsx.management.inventory.service.VcResourceServiceImpl.getHostNetworkInfo(VcResourceServiceImpl.java:310) ~[?:?]
        at com.vmware.nsx.management.inventory.service.VcResourceServiceImpl.getHostHardwareAndNetworkInfo(VcResourceServiceImpl.java:272) ~[?:?]
        at com.vmware.nsx.management.inventory.service.CmObjectFinderImpl.getHostHardwareAndNetworkInfo(CmObjectFinderImpl.java:151) ~[?:?]
        at com.vmware.nsx.management.switching.infrastructure.service.TransportNodeServiceImpl.lambda$validateNodeVdsConnection$6(TransportNodeServiceImpl.java:3345) ~[?:?]
        at java.util.Optional.map(Optional.java:215) ~[?:1.8.0_352]
        at com.vmware.nsx.management.switching.infrastructure.service.TransportNodeServiceImpl.validateNodeVdsConnection(TransportNodeServiceImpl.java:3340) ~[?:?]
        at com.vmware.nsx.management.switching.infrastructure.service.TransportNodeServiceImpl.validateHostSwitches(TransportNodeServiceImpl.java:3624) ~[?:?]
        at com.vmware.nsx.management.switching.infrastructure.service.TransportNodeServiceImpl.validateTransportNodeConfig(TransportNodeServiceImpl.java:2795) ~[?:?]
        at com.vmware.nsx.management.switching.infrastructure.service.TransportNodeServiceImpl.validateTNUpdate(TransportNodeServiceImpl.java:1752) ~[?:?]
        at com.vmware.nsx.management.lcm.transportnode.service.TransportNodeLcmServiceImpl.validateHostTransportNodeUpdateUfo(TransportNodeLcmServiceImpl.java

2023-04-17T10:14:54.495Z ERROR http-nio-127.0.0.1-7440-exec-30 TransportNodeServiceImpl 138228 FABRIC [nsx@6876 comp="nsx-manager" errorCode="MP9548" level="ERROR" reqId="24aea4b1-####-####-####-febfa4804e1c" subcomp="manager" username="admin"] Host 42933719-####-####-####-fdab524e9377 is not added to VDS value: "50 29 ## ## ## ## ##-## ## b7 62 23 b3 50 49"

Environment

VMware NSX-T Datacenter 3.x versions below 3.2.4.

VMware NSX 4.x versions below 4.2.1. 

Cause

In some special cases a DVS modification made while an ESXi host is in some form of degraded state may result in this state where the DVS is not fully realized on the ESXi host. 

Resolution

This issue is resolved in VMware NSX versions 3.2.4 and 4.2.1 and above, available at Broadcom downloads.

If you are having difficulty finding and downloading software, please review the Download Broadcom products and software KB.

Workaround;

• Removing the problematic ESXi host from the DVS, then re-adding it, should clear this state.