Information in this section might be useful in troubleshooting issues during the migration.
Import Configuration Problems
Problem | Solution |
---|---|
Import configuration fails. | Click Retry to try importing again. Only the failed import steps are retried. |
Host Migration Problems
Problem | Solution |
---|---|
Host migration fails due to a missing compute manager configuration. | The compute manager configuration is a prerequisite for migration. However, if the compute manager configuration is removed from the NSX Manager after the migration is started, the migration coordinator retains the setting. The migration proceeds until the host migration step, which fails. Add a compute manager to NSX Manager and enter the same vCenter Server details that were used for the initial NSX-V configuration import. |
Host migration fails due to stale dvFilters present. Example error message: |
Log in to the host which failed to migrate, identify the disconnected ports, and either reboot the appropriate VM or connect the disconnected ports. Then you can retry the Host Migration step.
|
After host migration using vMotion, VMs might experience traffic outage if SpoofGuard is enabled in NSX-V. Symptoms: The vmkernel.log file on the host at /var/run/log/ shows a drop in traffic due to SpoofGuard. For example, the log file shows: Cause: The logical switch and the logical switch port configuration are migrated through the migration coordinator, which migrates the SpoofGuard configuration. However, the discovered port bindings are not migrated through vMotion. Therefore, SpoofGuard drops the packets. |
If SpoofGuard is enabled in
NSX-V before migration, do any one of these workaround steps after vMotion of VMs:
In the first two options, network traffic is restored immediately.
In the third option:
|
In the middle of a cluster migration, host migration has failed due to some hardware failure in the host. For example, let us say that a cluster has 10 hosts, and four hosts have migrated successfully. The fifth host has a hardware failure and the host migration fails. |
If the host hardware failure cannot be fixed, skip this failed host for migration, and retry the host migration. Complete the following workaround steps:
If you need to restart the migration coordinator service for any reason, the clusters that are already migrated to
NSX become available for migration again on the
Migrate Hosts page. This behavior is a known issue. In this case, the workaround is to skip the migrated clusters by doing these steps:
|
Host migration is blocked after the recommendation is accepted because NSX-V controller VM is in power-off state. | In the host migration step, the feedback recommends that you abort the migration. If you accept the recommendation, the migration will fail. Because the Edge cutover is done, you can change the action to skip and continue the migration with the following steps:
|
Rolling Back a Migration
Problem | Solution |
---|---|
With some NSX-V OSPF deployments, if you perform a rollback after the Edge migration phase, you might see the error "Reason: NSCutover failed with '400: Configuration failed on NSX Edge VM vm-XXXX". | Re-deploy the relevant NSX-V Edge VM. After the VM is successful re-deployed, perform the rollback again. |
Retrying a Migration
Problem | Solution |
---|---|
If a host reboots for any reason during a migration, retrying the migration fails with an error such as "The requested object : TransportNode/42178ba8-49fb-9545-2b78-5e9c64fddda7 could not be found. Object identifiers are case sensitive." | Perform the following steps:
|
Removing Stale VTEP Data
Problem | Solution |
---|---|
If the migration is aborted after migrating Edge Services Gateways, there might be stale VTEP tables in NSX. If there are transport nodes in NSX, their tunnel status will remain down for these stale VTEPs. | To remove the stale VTEP data, make the following API call: GET https://<nsx-manager-IP>/api/v1/global-configs/SwitchingGlobalConfig
If the parameter
global_replication_mode_enabled in the result payload is
true, take this payload, set
global_replication_mode_enabled to
false, and use the payload to make the following API call:
PUT https://<nsx-manager-IP>/api/v1/global-configs/SwitchingGlobalConfig. |
Partner Service Migration Problems
Problem | Solution |
---|---|
Migration coordinator does not display the feedback messages for the Service Insertion category on the Resolve Configuration page even though the Security Policies in your NSX-V environment contain Network Introspection rules. This problem occurs when you are migrating a combination of Guest Introspection and Network Introspection services from the same partner. If a service profile for the partner service is already created in NSX, migration coordinator does not initiate the migration of the Network Introspection rules. |
Check whether a service profile is already created in your
NSX environment. If yes, do these steps:
|
Post-Migration Issues
Problem | Solution |
---|---|
After a migration, and after ESGs are removed from the network, NSX raises alarms about OSPF neighbors being down for these ESGs. If you resolve the alarms, they are raised again. |
Acknowledge the alarms but do not resolve them. This will keep the alarms from being raised again. |