IP customization failing for Windows Server 2016 or Windows Server 2022 VMs after Bulk Migration

Products

• VMware HCX

Issue/Introduction

• HCX guest IP customization failed while bulk migrating Windows Servers 2016, Windows Server 2022, or later
• The following error will be seen in the HCX manager 

common/logs/admin/app.log:

2025-##-## 22:13:45.447 UTC [GuestCustomizationService_SvcThread-205, Ent: HybridityAdmin, , TxId: TxId: ] ERROR c.v.v.h.g.c.i.CustomizationManagerImpl- Error in  deploying deployment package for moref: vm-#####
java.lang.RuntimeException: Can't determine IMC guest type for unknown OS: windows2019srvNext_64Guest
        at com.vmware.vchs.hybridity.guest.customization.impl.CustomizationManagerImpl.determineImcOsType(CustomizationManagerImpl.java:180)
        at com.vmware.vchs.hybridity.guest.customization.impl.CustomizationManagerImpl.pushDeploymentPackage(CustomizationManagerImpl.java:213)
        at com.vmware.vchs.hybridity.guest.customization.job.GuestCustomizationJob.customizeGuestConfiguration(GuestCustomizationJob.java:257)
        at com.vmware.vchs.hybridity.guest.customization.job.GuestCustomizationJob.run(GuestCustomizationJob.java:51)
        at com.vmware.vchs.hybridity.messaging.LoggingJobWrapper.run(LoggingJobWrapper.java:41)
        at java.base/java.util.concurrent.Executors$RunnableAdapter.call(Executors.java:515)
        at java.base/java.util.concurrent.FutureTask.run(FutureTask.java:264)
        at java.base/java.util.concurrent.ScheduledThreadPoolExecutor$ScheduledFutureTask.run(ScheduledThreadPoolExecutor.java:304)
        at java.base/java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1128)
        at java.base/java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:628)
        at java.base/java.lang.Thread.run(Thread.java:829)

 

• Windows Server 2016 migration completes but no IP change happens

 

 

Environment

VMware HCX

Cause

HCX supports Guest OS customization for specific Windows and Linux operating systems.

- Guest OS Types for Guest Customization

Resolution

Migrate guest OS types that are supported

Additional Information

Here are the tec doc related Guest OS Types for Guest Customization

Guest OS Types for Guest Customization (4.10)

Guest Os Types for Guest Customization (4.11)