VMware Cloud Foundation(VCF) brownfield import fails at NSX deployment
search cancel

VMware Cloud Foundation(VCF) brownfield import fails at NSX deployment

book

Article ID: 426118

calendar_today

Updated On:

Products

VMware SDDC Manager

Issue/Introduction

When attempting to import a pre-existing environment into VMware Cloud Foundation (VCF) 5.2.2 using the VCF Import tool, the workflow fails during the NSX-T deployment stage.

In the /var/log/vmware/vcf/domainmanager/domainmanager.log of the SDDC Manager, the system reports that it cannot find a matching install image for a specific NSX-T version (e.g., 4.2.3.2.0), despite an NSX-T bundle being present in the repository.

YYYY-MM-DDTHH:MM:SS DEBUG [vcf_dm,696120cd1f746048ae3ef88c345ab4ea,d602] [c.v.e.s.c.s.NsxtVersionServiceImpl,dm-exec-3]  NSX Patch Bundle versions [4.2.3.1.0-24954727, 4.2.3.2.0-25077145] released after the version 4.2.3.0.0-24866349
YYYY-MM-DDTHH:MM:SS DEBUG [vcf_dm,696120cd1f746048ae3ef88c345ab4ea,d602] [c.v.e.s.c.s.NsxtVersionServiceImpl,dm-exec-3]  Latest Nsx Patch Version is 4.2.3.2.0-25077145
YYYY-MM-DDTHH:MM:SS DEBUG [vcf_dm,696120cd1f746048ae3ef88c345ab4ea,d602] [c.v.e.s.c.s.NsxtVersionServiceImpl,dm-exec-3]  NSX Patch Bundle released 4.2.3.2.0-25077145 after the release 4.2.3.0.0-24866349
YYYY-MM-DDTHH:MM:SS DEBUG [vcf_dm,696120cd1f746048ae3ef88c345ab4ea,d602] [c.v.v.v.f.a.PrepareNsxDeployInputAction,dm-exec-3]  The LCM Release Compatibility Matrix returned NSX Product Version 4.2.3.2.0-25077145 for the domain Id ########-####-####-####-############
YYYY-MM-DDTHH:MM:SS ERROR [vcf_dm,696120cd1f746048ae3ef88c345ab4ea,d602] [c.v.e.s.o.model.error.ErrorFactory,dm-exec-3]  [S60G49] PRODUCT_INSTALL_IMAGE_NOT_FOUND_FOR_VERSION Product NSX_T_MANAGER install image not found for version 4.2.3.2.0-25077145.
com.vmware.evo.sddc.common.services.error.SddcManagerServicesIsException: Product NSX_T_MANAGER install image not found for version 4.2.3.2.0-25077145.
        at com.vmware.evo.sddc.common.services.adapters.imagemanagementservice.ImageManagementServiceAdapterImpl.getInstallImage(ImageManagementServiceAdapterImpl.java:280)
      
YYYY-MM-DDTHH:MM:SS DEBUG [vcf_dm,696120cd1f746048ae3ef88c345ab4ea,d602] [c.v.e.s.o.c.ProcessingTaskSubscriber,dm-exec-3]  Collected the following errors for task with name PrepareNsxDeployInputAction and ID ########-####-####-####-############: [ExecutionError [errorCode=null, errorResponse=LocalizableErrorResponse(messageBundle=com.vmware.evo.sddc.common.services.sddcmanagermessages)]]

Environment

VMware Cloud Foundation 5.2.2
vCenter Server 8.x

Cause

This failure occurs because the VCF Import Tool package downloaded from the support portal often contains the Base NSX-T install bundle (e.g., 4.2.3.0.0). However, the SDDC Manager’s Lifecycle Management (LCM) Compatibility Matrix identifies that a newer patch or version (e.g., 4.2.3.2.0) is the required minimum for the current deployment.




Reference: Build numbers and versions of VMware NSX/NSX-T Data Center


When the internal image repository is queried for version 4.2.3.2.0, it fails because only the older base version is available. The logs will explicitly show: PRODUCT_INSTALL_IMAGE_NOT_FOUND_FOR_VERSION Product NSX_T_MANAGER install image not found for version 4.2.3.2.0-25077145.

Resolution

To resolve this issue, the specific NSX-T bundle version requested by the SDDC Manager must be manually downloaded and made available in the SDDC Manager bundle repository.

1. Examine the /var/log/vmware/vcf/domainmanager/domainmanager.log on the SDDC Manager to find the exact version string that triggered the PRODUCT_INSTALL_IMAGE_NOT_FOUND error.
    Example: 4.2.3.2.0-25077145

2: Download the Required Bundle

  1. Log in to the SDDC Manager UI.

  2. Navigate to Lifecycle Management > Bundle Management.

  3. Search for the NSX-T Data Center bundle that matches the version identified in Step 1.

  4. Click Download Now.

Note: The bundle to be downloaded should be an "Install Only Bundle"

For detailed instructions on managing bundles, refer to the official documentation: 
Download Bundles Using SDDC Manager 

3: Retry the Import Workflow
    Once the bundle status shows as Downloaded in the SDDC Manager:

  1. Return to the Brownfield Import Tool or the SDDC Manager Task dashboard.

  2. Restart or Retry the failed NSX deployment task.

  3. The domainmanager will now successfully locate the 4.2.3.2.0 image in the repository and proceed with the deployment.

Additional Information

If the SDDC Manager has internet connectivity, you can download the bundle directly via the UI, as mentioned in step 2 of the resolution. If it is a dark site, you must use the Offline Bundle Transfer Tool.
Reference: Offline Download of VMware Cloud Foundation 5.2.x Upgrade Bundles