NSX-T Data Center REST API
Perform V2T migration steps on newly added Host Transport Node.
This API is to support the add Host workflow on NSX-T once the V2T migration process has started. There are twohigh level cases. For each case, please refer to the detailed steps.
Case - 1 : For migration mode - CONFIG_AND_EDGE_MIGRATION_WITH_BYOT, CONFIG_AND_EDGE_MIGRATION_WITH_BYOT_ON_FEDERATION
1. Verify that overall migration status is in SUCCESS state in migration co-ordinator. This means all migration
stages are completed and we are at a point where we can move workloads using the pre-migrate, post-migrate API's.
2. Follow steps mentioned in product documentation to add a new host to cluster.
3. Invoke this API (Accept Host Transport Node) to perform the V2T migration steps on newly added host transport
node. Once API is successful, make sure that newly added HOST can take worklods (Ex: Traffic checks, etc.,).
For Case-1, this API should be invoked only when following conditions are met.
- The overall migration status is in SUCCESS status.
- All the migration stages are completed and we are at a point where we can move workloads.
- The migration mode selected has to be among the ones designated for case-1
- The new host has been added to a cluster by following all the steps mentioned in product documentation.
Case - 2 : For migration modes that perform HOST migration.
1. Verify that overall migration status is in PAUSED state in migration co-ordinator.
2. Follow steps mentioned in product documentation to add a new host to cluster.
3. Invoke the migration co-ordinator sync HOST groups API. This will result in migration co-ordinator updating
its inventory and accouting for the newly added host transport node. At this point, the list host upgrade units
API call to MC will also show the newly added host transport node. But do NOT resume the migration. Since this
host transport node is added after the V2T migration has started, we need to perform migration steps on this host
through this special API (Accept Host Transport Node)
4. Invoke this API (Accept Host Transport Node) to perform the V2T migration steps on newly added host transport
node. Once the API is successful, we should be seeing that migration status has been marked as SUCCESS for the
newly added host transport node. Very Importnant Note : Make sure that migration status is PAUSED in migration
co-ordinator when performing steps 2 through 4. Also ensure that all the steps 2 through 4 pass without failures.
For Case-2, this API should be invoked only when following conditions are met.
- The overall migration status is in PAUSED status.
- The migration mode selected has HOST component in it.
- All the migration stages before HOST stage are completed.
- The new host has been added to a cluster by following all the steps mentioned in product documentation.
Request:
Method:
POST
URI Path(s):
/api/v1/migration/setup?action=migrate_newly_added_host_transport_node
Request Headers:
n/a
Query Parameters:
n/a
Request Body:
NewHostTransportNodeSpec+
Successful Response:
Response Code:
200 OK
Response Headers:
n/a
Response Body:
n/a