HCX OSAM Migrations hangs during switchover: "Failed to create migrated VM. Failed to prepare parameters for creating VM"

Products

• VMware HCX

Issue/Introduction

• HCX OSAM migration hangs during switchover and eventually fails with error:
  
• The following error is observed in /common/logs/admin/app.log:
  

  <timestamps> UTC [OsAssistedMigrationService_SvcThread-###, Ent: HybridityAdmin, , TxId: ########-####-####-####-############] ERROR c.v.v.h.m.common.MigrationJobHelper- Subflow Exception stack trace is : java.util.concurrent.TimeoutException: Failed to prepare parameters for creating VM in 300000 ms - null

   

• After enabling debug logging as per Enable Debug Logging for HCX OS-Assisted Migration Troubleshooting KB instruction, the following error observed in /common/logs/admin/app.log indicates that the Datacenter value is being returned as "null":
  

  <timestamps> UTC [OsAssistedMigrationService_SvcThread-62, Ent: HybridityAdmin, , TxId: TxId: ########-####-####-####-############] DEBUG c.v.v.h.s.migration.jobs.CreateVMJob- getNICs() datacenter = null migrationId: ########-####-####-####-############

Cause

Datacenter in target vCenter was located in a nested folder, and current implementation of HCX OSAM does not allow traversal of nested folders to locate the datacenter.

Resolution

Move the datacenter object back to the root level. This will not impact production as it is just changing the folder placement of the datacenter.

Additional Information

Enable Debug Logging for HCX OS-Assisted Migration Troubleshooting