When you migrate a user-defined topology, you can choose the Configuration and Edge Migration mode. This mode migrates configurations, bridges the NSX-V logical switches to their corresponding NSX segments, and migrates Edge nodes for north-south traffic cutover.

Note: This migration mode requires dedicated hosts ready to be added to the NSX cluster. If new hosts are not available, hosts from NSX-V can be re-used. For more information, see the section "(Optional) Re-using an NSX-V Host as an NSX Transport Node" below.

End-to-end Workflow of Configuration and Edge Migration

Perform the following steps when you choose this mode:

  1. Prepare the NSX-V environment. See Preparing the NSX-V Environment for a User-Defined Topology Lift-and-Shift Migration.
  2. Prepare the NSX environment. See Preparing the NSX Environment for a User-Defined Topology Migration.
  3. Perform the migration steps Import Configuration, Translate Configuration Layer 2, Resolve Configuration Layer 2, Migrate Configuration Layer 2, and Check Realization Layer 2. The transport zones and segments are created and ready to be used.
  4. From the NSX Manager UI, configure NSX on ESXi hosts in the target site. Choose the correct transport zone for each host switch so that VMs migrated to the hosts will be connected to the correct segments. If a VTEP IP pool is used to configure NSX, make sure that there is no overlap in IP addresses between this IP pool and IP pools configured on NSX-V.
  5. On NSX, create a topology that maps to the NSX-V topology, including tier-0 and tier-1 gateways.
  6. Perform the migration steps Define a Topology, Translate Configuration Layer 3 and Above, Resolve Configuration Layer 3 and Above, Migrate Configuration Layer 3 and Above, Check Realization Layer 3 and Above, and Migrate Edges.
  7. In the Migrate Workloads step, the following methods are available to migrate workload VMs:
    • HCX - For more information, see the HCX documentation.
    • vMotion - Follow the instruction in the section "Migrating Workload VMs" below.
  8. Verify that everything works as expected.
  9. Perform post-migration tasks to clean up the source site on NSX-V if needed.

Migrating Workload VMs from HCX

Note: Verify that your version of HCX supports this capability. If HCX is not available, see the section "Migrating Workload VMs" below for information on how to migrate workload VMs.

HCX can migrate VMs by group. To migrate VMs from HCX, first perform the migration steps from NSX Manager until the last step, Migrate Workloads. Then migrate the VMs from HCX. When the VMs are migrated, click Finish on the Migrate Workloads screen in NSX Manager.

Migrating Workload VMs

If you do not migrate workload VMS using HCX, you can follow the steps in Migrate Workloads in Lift-and-Shift Migration.

(Optional) Re-using an NSX-V Host as an NSX Transport Node

If you want to re-use an NSX-V host, follow the steps below to first prepare the host as an NSX transport node.

If the migration target VC is the same as the source VC:
  1. Enter the host into maintenance mode in VC.
  2. Move the host out of its cluster so that it becomes a standalone host. Uninstall NSX-V from the host.
  3. Exit the host out of maintenance mode.
  4. In NSX Manager UI, find the host in System > Fabric > Hosts. Add the VDSes with the correct transport zones and host-switch uplink profiles. Wait for the state of the node to display Success.
  5. Call the following NSX API to accept the new host:
    POST https://{nsx-mgr-ip}/api/v1/migration/setup?action=migrate_newly_added_host_transport_node
    {
        "host_transport_node_id" : "<transport-node-uuid>"
    }
If the migration target VC is different from the source VC:
  1. Enter the host into maintenance mode in VC.
  2. Move the host out of its cluster so that it becomes a standalone host. Uninstall NSX-V from the host.
  3. Move the host out of all the VDSes in the source VC.
  4. Note down the host IP and then remove the host from the inventory in the source VC.
  5. Add the host to a cluster in the target VC and then to the VDSes in the target VC.
  6. Exit the host out of maintenance mode.
  7. In NSX Manager UI, find the host in System > Fabric > Hosts. Add the VDSes with the correct transport zones and host-switch uplink profiles. Wait for the state of the node to display Success.
  8. Call the following NSX API to accept the new host:
    POST https://{nsx-mgr-ip}/api/v1/migration/setup?action=migrate_newly_added_host_transport_node
    {
        "host_transport_node_id" : "<transport-node-uuid>"
    }

You can re-use an NSX-V host before or after the Migrate Edges step starts.