The HCX migration interface provides a set of options that can be used to tailor the behaviors and conditions of the virtual machine before or after the migration operation.

HCX has several types of optional settings for use when migrating virtual machines: Switchover, Virtual Machine, and Extended.

Note:

The available options depend on the selected migration type.

Switchover Options

Switchover options are applied during the switchover phase of the migration. Except for the Force Power-Off VM setting, which can be set on an individual virtual machine (VM) migration, these options are set globally for a group of selected VMs.

Force Power-Off VM

By default, HCX attempts to shut down the virtual machine guest gracefully during the HCX Bulk migration operation. If the OS interrupts the termination process, the migration operation fails. Checking this option causes HCX to force the power-off.

Remove Snapshots

Causes HCX to consolidate snapshot files during migration of the virtual machine. For more information, see Understanding Virtual Machine Snapshots During HCX Migrations.

Force Unmount ISO Images

Causes HCX to remove mounted ISO images before migrating the virtual machine.

Virtual Machine Options

The virtual machine (VM) options are available only for individual VM migration.

Enable Seed Checkpoint

In the event that a migration is unsuccessful or canceled, Seed Checkpoint retains the target disks created at the target site. Without Seed Checkpoint, the HCX roll back process cleans up the target disks created during the migration and all transferred data is lost. Seed Checkpoint is available with HCX Bulk Migration and Replication Assisted vMotion.

Note:

To resume from the migration checkpoint, select Enable Seed Checkpoint when you restart the migration. If the Seed Checkpoint option is not selected, the migration creates new disks at the target site and ignores the existing checkpoint.

To use this option, select a specific datastore for migration and not a datastore cluster.

Restarting a Seed Checkpoint migration to a new datastore creates additional target disks on that datastore, and saves new checkpoint information related to that datastore with the virtual machine data in HCX.

Extended Options

Extended options customize the characteristics of the migrated virtual machine without having to manually update the settings after migration. Extended options can be set globally for a group of virtual machines migrations or for an individual virtual machine.

Retain MAC

Causes a virtual machine to keep its current MAC address during HCX Bulk migration operation, allowing communications to resume gracefully, and honors MAC-based security policies. This option is selected by default for vMotion and Replication Assisted vMotion migration types and cannot be changed.

Upgrade Virtual Hardware

Allows HCX to upgrade virtual machine hardware to the latest supported version as part of the migration operation, making current virtual machine hardware features immediately available to the migrated virtual machine.

Upgrade VMware Tools

Allows HCX to upgrade VMware Tools to the latest supported version as part of the migration operation, making current VMware Tools features immediately available to bulk migrated virtual machine.

Deactivate Per Virtual Machine EVC

vSphere Enhanced vMotion Compatibility (EVC) ensures that workloads can be live migrated, using vMotion, between ESXi hosts in a cluster that is running different CPU generations. EVC is a cluster level setting that supports virtual machine mobility within a cluster. For virtual machines implementing per-VM EVC, the EVC mode becomes an attribute of the virtual machine rather than the specific processor generation it happens to be booted on in the cluster. If this option is selected then this virtual machine might not be able to vMotion back to the source site.

Host Name

Sets the host name of the migrated virtual machines at the destination site.

Domain Name

Sets the domain name for the virtual machine at the destination site. This option is available only with Linux virtual machines.

Personalization Script

Uploads a customization script to a migrated virtual machine. The script runs before and after guest customization. The customization script cannot exceed 1500 characters.

For Linux VMs, Guest Customization using the Personalization Script option requires VMware Tools version 10.1.0 or later.
Note: In the VMware Tools configuration, the enable-custom-scripts option is deactivated by default for security and must be enabled manually to run the custom script. For information about enabling this option, see VMware KB 74880.
DNS Customization

Sets the Primary and the Secondary DNS servers for the migrated virtual machine.

Generate a new Security Identifier (SID)

Generates a new Security Identifier (SID) for the migrated virtual machine. This option is only for Windows virtual machines. Make sure the virtual machine has an active "local administrator" present. If the virtual machine is connected to the domain, it is moved to workgroup, and no DNS suffix is set.

Resize CPU

Changes the number of vCPUs for the migrated virtual machine. For more information about VMware virtual machine vCPU limitations, see the VMware vSphere product documentation.

Resize Memory

Changes the memory size for the migrated virtual machine. For more information about VMware virtual machine memory limitations, see the VMware vSphere product documentation.

Replicate Security Tag

Replicates VMware NSX for vSphere and NSX security tags associated with a virtual machine undergoing migration. The security tags are replicated from the source site to the destination site.

Migrate Custom Attributes

Migrates VMware Custom Attributes associated with a virtual machine undergoing migration. The Custom Attributes are replicated from the source site to the destination site.

Migrate vCenter Tags
Migrates vCenter Tags associated with a virtual machine undergoing migration. The vCenter Tags are replicated from the source site to the destination site.

The following table summarizes the options that apply to each migration type.

Option

Cold Migration

vMotion Migration

Bulk Migration

Replication Assisted vMotion Migration

HCX Assisted vMotion (Direct)

OS Assisted Migration

Workload Migration for NSX V2T

Force Power-off VM

No

No

Yes

No

No

N/A

No

Remove Snapshots

No

Yes

Yes

Yes

No

N/A

No

Force Unmount ISO Images

No

Yes

Yes

Yes

No

N/A

No

Seed Checkpoint

No

No

Yes

Yes

No

No

No

Retain MAC

No

Yes (default setting; not selectable)

Yes (not supported for single vCenter operation)

Yes (default setting; not selectable)

Yes (default setting; not selectable)

Yes (default setting; not selectable)

Yes (see note)

Upgrade Virtual Hardware

Yes

Yes (upgrades on reboot)

Yes

Yes

Yes

N/A

Yes

Upgrade VMware Tools

No

Yes

Yes

Yes

Yes

N/A

Yes

Deactivate Per-VM EVC

No

Yes

Yes

Yes

No

N/A

No

Hostname

No

No

Yes

No

No

No

No

Domain Name

No

No

Yes

No

No

No

No

Personalization Script

No

No

Yes

No

No

No

No

DNS Customization

No

No

Yes

No

No

No

No

Generate a new Security Identifier (SID)

No

No

Yes

No

No

No

No

Resize CPU

No

No

No

No

No

Yes

No

Resize Memory

No

No

No

No

No

Yes

No

Replicate Security Tags

Yes

Yes

Yes

Yes

Yes

N/A

Yes

Migrate Custom Attributes

Yes

Yes

Yes

Yes

Yes

N/A

Yes
Migrate vCenter Tags Yes Yes Yes Yes Yes No Yes
Note: Workload Migration for NSX V2T does not retain the MAC address if the same MAC address is already present at the target site.