NVDS to CVDS Migration for Pending Hosts from the Past NVDS to CVDS migration
search cancel

NVDS to CVDS Migration for Pending Hosts from the Past NVDS to CVDS migration

book

Article ID: 416966

calendar_today

Updated On:

Products

VMware NSX

Issue/Introduction

  • During NSX-T migrations from NVDS  to CVDS  some hosts might be excluded from the initial migration due to hardware failures or other operational issues.
  • These "pending hosts" remain on NVDS while the rest of the cluster moves to CVDS, leading to inconsistent cluster configurations and a lack of Transport Node Profiles .
  •  A unified Transport Node Profile (TNP) cannot be applied to the cluster.

Environment

VMware NSX

Cause

Due to environmental issues , some hosts might be excluded from the initial migration due to hardware failures or other operational issues like unable to get the host into maintenence , leaving the migration incomplete. 

Resolution

1. Identifying Hosts Still on NVDS

  • Clean Up Old Topology:
    Run the following API to remove outdated topology data:
    POST https://<nsx_manager_ip>/api/v1/nvds-urt?action=cleanup
  • Create a New Precheck:
    Generate a new precheck and note the precheck_id from the response:
    POST https://<nsx_manager_ip>/api/v1/nvds-urt/precheck
  • Generate Updated URT Topology:
    Use the precheck_id to fetch the latest topology, which includes a list of host UUIDs:
    GET https://<nsx_manager_ip>/api/v1/nvds-urt/topology/<precheck_id>
  • Identify Host Names from UUIDs:
    Extract the UUIDs from the retrieved topology. Use the NSX Manager UI's global search feature to find the corresponding ESXi host names for each UUID.

2. Migration Execution Steps
Once the URT topology is validated and pending hosts are identified, follow these steps for each host:

  • Step 1: Place ESXi Host in Maintenance Mode:
  • Step 2: Initiate NVDS to VDS Migration: Trigger the migration for each transport node using its transport node ID (tn-id): POST https://<nsx-mgr>/api/v1/transport-nodes/<tn-id>?action=migrate_to_vds
  • Step 3: Monitor Migration Status:
    Track the migration progress using the precheck-id obtained earlier:
    GET https://<nsx-mgr>/api/v1/nvds-urt/status-summary/<precheck-id>
    Example Response:
    json { "precheck_id": "XXXXXXXXXXXXXXXXXXXXX", "precheck_status": "READY", "migration_state": [ { "host": "XXXXXXXXXXXXXXXXXXXXXXX", "overall_state": "UPGRADE_READY" }, { "host": "XXXXXXXXXXXXXXXXXXXXXXX", "overall_state": "UPGRADE_READY" }, { "host": "XXXXXXXXXXXXXXXXXXXXXXX", "overall_state": "SUCCESS" } ] }

3. Final Validation and TNP Application

  • After all hosts are successfully migrated and their overall_state shows SUCCESS.
  • Confirm migration completion for all pending nodes.
  • Apply the Transport Node Profile to the cluster. 

Additional Information

For further details and guidance, refer to the following official resources:

Powered by Wolken Software