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.

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
• Run precheck-by-cluster on the selected clusters you want to migrate 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-502a-4636-8a38-4413c2a2d52f",
          "nvds_name": "nsxvswitch",
          "compute_manager_topology": [
            {
              "compute_manager_id": "fa1421d9-54a7-418e-9e18-7d0ff0d2f771",
              "dvswitch": [
                {
                  "data_center_id": "datacenter-3",
                  "vds_name": "test-dvs",
                  "transport_node_id": [
                    "65592db5-adad-47a7-8502-1ab548c63c6d",
                    "e57234ee-1d0d-425e-b6dd-7dbc5f6e6527",
                    "70f55855-6f81-45a8-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-8b75-4160-919c-6c40030fb3d0",
      "precheck_status": "READY",
      "migration_state": [
        {
          "host": "65592db5-adad-47a7-8502-1ab548c63c6d",
          "overall_state": "UPGRADE_READY"
        },
        {
          "host": "e57234ee-1d0d-425e-b6dd-7dbc5f6e6527",
          "overall_state": "UPGRADE_READY"
        },
        {
          "host": "70f55855-6f81-45a8-bd40-d8b60ae45b82",
          "overall_state": "SUCCESS"
        }
      ]
    }