HCX - A specified parameter was not correct: spec.deviceChange.device.port.switchUuid Host #.#.#.# is not a member of VDS <vds-name>

Products

• VMware HCX

Issue/Introduction

• When attempting to perform cold vMotion migration of a powered-off VM you receive the below error:

Error: "A specified parameter was not correct: spec.deviceChange.device.port.switchUuid Host #.#.#.# is not a member of VDS <VDS-NAME>"

• The following errors are observed in /common/logs/admin/app.log:

2024-08-12 18:41:13.427 UTC [VmotionService_SvcThread-4375, Ent: HybridityAdmin, , TxId: TxId: ########-####-####-####-############] ERROR c.v.h.s.v.j.StartSourceSideRelocateVmWorkflow- [migId=########-####-####-####-############] Error while executing startSourceSideRelocateVmWorkflow state 'WAIT_FOR_RELOCATE_INITIAL_PROGRESS'.

java.lang.RuntimeException: A specified parameter was not correct: spec.deviceChange.device.port.switchUuid com.vmware.vim.vpxd.dvs.nonHostMember.label:Host #.#.#.# is not a member of VDS <VDS-NAME>

Environment

HCX 4.x

Cause

When a VM is powered-off, the NSX segment details/configurations are not pushed to the ESXi host.

Resolution

Power-on the VM and perform a migration.

You may also disconnect the network from the VM or change it to a non NSX backed network and retry the cold-migration.