NSX-T NVDS migration pre-check by cluster

Products

• VMware NSX-T Data Center

Issue/Introduction

These API calls will allow the user to individually migrate clusters from NVDS to VDS by cluster instead of the entire environment at once.

Environment

VMware NSX-T Data Center

VMware NSX

Resolution

• Pull all NSX-T Host Cluster IDs from GET API call:
  GET https://<nsx-manager-ip>/policy/api/v1/infra/sites/<site-id>/enforcement-points/<enforcementpoint-id>/transport-node-collections

         Record the output so you can select which clusters you want to migrate. Note compute collection ID.
         "compute_collection_id": "####-####-####-####-####:domain-####"

• Run precheck-by-cluster on the selected clusters you want to migrate. For cluster ID use the compute_collection_id from above API.
  POST https://<nsx-manager-ip>/api/v1/nvds-urt/precheck-by-cluster/<cluster_id>
  Record the precheck id given.

• GET API call on the precheck-id showed PENDING_TOPOLOGY
  GET https://<nsx-manager-ip>/api/v1/nvds-urt/status-summary-by-cluster/<precheck-id>
  
  
• GET API against the environment to see the PENDING_TOPOLOGY for all clusters you are migrating at the time:
  GET https://<nsx-manager-ip>/api/v1/nvds-urt/status
  
  
• When you are ready to migrate this will create you VDS topology:
  POST https://<nsx-manager-ip>/api/v1/nvds-urt/topology?action=apply
  
  
• • Note if you would like to change the new name this is where you will edit the vds name. It cannot be the same name as an existing VDS.
    
     

  • {
      "topology": [
        {
          "nvds_id": "c8ff4053-####-####-8a38-4413c2a2d52f",
          "nvds_name": "nsxvswitch",
          "compute_manager_topology": [
            {
              "compute_manager_id": "fa1421d9-####-####-9e18-7d0ff0d2f771",
              "dvswitch": [
                {
                  "data_center_id": "datacenter-#",
                  "vds_name": "test-##",
                  "transport_node_id": [
                    "65592db5-####-####-8502-1ab548c63c6d",
                    "e57234ee-####-####-b6dd-7dbc5f6e6527",
                    "70f55855-####-####-bd40-d8b60ae45b82"
                  ]
                }
              ]
            }
          ]
        }
      ]
    }

• This call will kick off the actual migration:
  POST https://<nsx-manager-ip>/api/v1/transport-nodes/<tn-id>?action=migrate_to_vds
  
  
• To check the status:
  GET https://<nsx-manager-ip>/api/v1/nvds-urt/status-summary/<precheck-id>
  • Example output of the call above -

  • {
      "precheck_id": "c306e279-####-####-919c-6c40030fb3d0",
      "precheck_status": "READY",
      "migration_state": [
        {
          "host": "65592db5-####-####-8502-1ab548c63c6d",
          "overall_state": "UPGRADE_READY"
        },
        {
          "host": "e57234ee-####-####-b6dd-7dbc5f6e6527",
          "overall_state": "UPGRADE_READY"
        },
        {
          "host": "70f55855-####-####-bd40-d8b60ae45b82",
          "overall_state": "SUCCESS"
        }
      ]
    }