将主机交换机迁移到 vSphere Distributed Switch

有三种方法可用于将主机交换机迁移到 vSphere Distributed Switch。

使用 N-VDS 作为主机交换机时，NSX-T 在 vCenter Server 中将显示为含糊网络。N-VDS 在传输节点上具有一个或多个物理接口 (pNIC)，且端口配置在 NSX-T Data Center 中执行。您可以将主机交换机迁移到 vSphere Distributed Switch (VDS) 7.0 以优化 pNIC 使用情况，并从 vCenter Server 中管理 NSX-T 主机的网络连接。在 VDS 交换机上运行 NSX-T 时，分段将显示为 NSX-T 分布式虚拟端口组。对 NSX-T 网络上的分段所做的任何更改都将同步到 vCenter Server 中。

要将 ESXi 主机上的 N-VDS 迁移到 VDS 上的 NSX，请选择：

前提条件

要迁移到 VDS 7.0 主机交换机，必须满足以下要求：

vCenter Server 7.0 或更高版本
ESXi 7.0 或更高版本
迁移后，NSX-T 将不再显示为含糊网络。您可能需要更新脚本才能管理迁移后的 NSX-T 主机。
在 NSX-T 3.1 中，基于 N-VDS 的合并的集群环境不支持 N-VDS 到 vSphere Distributed Switch 的迁移。在未使用指定绑定的 NSX-T 3.1.1 中支持此迁移。
可以通过 vSphere Lifecycle Manager 或手动通过 API 并行迁移处于维护模式的主机以扩大迁移范围。默认情况下，可以在并行模式下迁移每个集群的 64 个主机，线程池大小为集群中的每个管理器 22 个线程。确保并行修复的批次大小限制为 4 个节点。对于通过 vSphere Lifecycle Manager 进行的迁移，任何等待可用线程的主机都将显示“正在排队”状态。对于通过 API 的迁移，将拒绝任何超过 64 个活动迁移的请求。
并行修复功能需要使用 vCenter Server 7.0 Update 2 或更高版本。NSX-T Data Center 3.1 不支持此功能，且不应为正在迁移的集群启用此功能。
只会为跨 7.0.2 (X.Y.Z-U.P) 版本的 ESX 升级触发 N-VDS 到 VDS 上的 NSX-T Data Center 的迁移。不会为任何“U.P”（更新-修补程序）升级触发迁移。指定的 ESX 版本格式为 X.Y.Z-U.P，其中，
- X = 主版本
- Y = 次版本
- Z = 维护
- U = 更新
- P = 修补程序
N-VDS 到 VDS 迁移工具在 NSX-T Data Center 3.2.0 中不可用。在此版本中，如果要将工作负载从 N-VDS 迁移到 VDS，必须手动执行此操作。

注：

在成功迁移所有主机交换机之前，请不要对 NSX-T Data Center 进行任何配置更改。

选项 1：使用 API 将主机交换机迁移到 vSphere Distributed Switch

可以使用 NSX-T Data Center API 将主机交换机迁移到 vSphere Distributed Switch (VDS)。

要使用 API 调用迁移主机交换机，请执行以下步骤。

过程

查看必备条件部分中迁移到 VDS 7.0 主机交换机的要求。

要验证主机是否已准备好进行迁移，请执行以下 API 调用并运行预检查。

POST https://<nsx-mgr>/api/v1/nvds-urt/precheck

策略 API：

PUT /policy/api/v1/infra/nvds-urt/precheck

示例响应：

{ "precheck_id": "166959af-7f4b-4d49-b294-907000eef889" }

解决任何配置不一致问题，然后再次运行预检查。在解决配置不一致问题后运行预检查时，响应中不会再次显示不一致的配置。
从 3.2.1 开始，当 NSX-T Data Center 环境中的传输节点之间的配置不兼容时，预检查运行将不会失败。对于 UplinkProfile、LLDPProfile 和 NIOCProfile 的不兼容配置，预检查将生成配置问题。您可以检查不兼容的配置，并确定是要在传输节点之间应用拓扑还是统一配置，然后再次运行预检查。根据您是否希望拓扑包含不同配置的所有组合，设置 tolerate_different_configurations 参数的值。有关详细信息，请参阅 NSX-T Data Center API 指南。 tolerate_different_configurations 的默认值为 true。

预检查还会为不同配置的每种组合创建 VDS。建议的拓扑将包含同一 NSX-T Data Center（对于 VCF，则为同一集群）中各传输节点的不同配置的所有组合。将为具有等效 UplinkProfile、LLDPProfile 和 NIOCProfile 的传输节点生成特定的 VDS。

验证预检查的状态。不一致的配置文件将在响应中显示为警告，而不是错误。

GET https://<nsx-mgr>/api/v1/nvds-urt/status-summary/<precheck-id>

策略 API：

GET /policy/api/v1/infra/nvds-urt/status-summary/<precheck-id>

示例响应：

{
    "precheck_id": "165a592d-a94f-4614-978c-9ca003cda278",
    "precheck_status": "PENDING_TOPOLOGY",
    "precheck_issue": [
        {
            "component": "Uplink profile",
            "objid": "nsxvswitch1",
            "warning": "Found inconsistent profiles: [b63afe90-ce04-46e4-a238-d7b63deada36, 0520a955-06cd-4498-883a-d534e8d7724c]. Uplink profile mismatch. Mtu mismatch. ",
            "recommendation": "Keep profiles consistent among transport nodes in the same NVDS",
            "_protection": "NOT_PROTECTED"
        }
    ]
}

对于无状态主机，请将其中一个主机指定为源主机，然后再启动迁移。

要检索建议的拓扑，请执行以下 API 调用。

GET https://<nsx-mgr>/api/v1/nvds-urt/topology/<precheck-id>

策略 API：

GET /policy/api/v1/infra/nvds-urt/topology/<precheck-id>

示例响应：

{
    "topology": [
        {
            "nvds_id": "e70a0fc2-7ec3-483e-9036-4eed170f0ecf",
            "nvds_name": "nsxvswitch1",
            "compute_manager_topology": [
                {
                    "compute_manager_id": "13127ee9-ea71-4c66-810e-c604d4f67fc4",
                    "dvswitch": [
                        {
                            "data_center_id": "datacenter-4",
                            "vds_name": "VDS-nsxvswitch1-datacenter-4-0",
                            "vmknic": [],
                            "transport_node_id": [
                                "7af27ad7-4e45-4b36-95a2-d73413aea181"
                            ],
                            "id": "190125b2-d469-4bea-915b-6ffeb9e7b542",
                            "_protection": "NOT_PROTECTED"
                        },
                        {
                            "data_center_id": "datacenter-4",
                            "vds_name": "VDS-nsxvswitch1-datacenter-4-1",
                            "vmknic": [],
                            "transport_node_id": [
                                "dca9568e-9587-4572-9001-c637960dbdae"
                            ],
                            "id": "9f039516-5318-4e14-8fd4-769d54560bcb",
                            "_protection": "NOT_PROTECTED"
                        },
                        {
                            "data_center_id": "datacenter-22",
                            "vds_name": "VDS-nsxvswitch1-datacenter-22-2",
                            "vmknic": [],
                            "transport_node_id": [
                                "ebe67bdf-bb9c-4b92-8c81-cdb6ec2d8559",
                                "32058d07-dbba-4042-92f7-69ece1cc9680"
                            ],
                            "id": "9a389bf0-af53-4ace-b7d3-29b534fbab58",
                            "_protection": "NOT_PROTECTED"
                        }
                    ]
                }
            ],
            "id": "62f2fe60-1138-454d-99f2-8319255d8119",
            "_protection": "NOT_PROTECTED"
        }
    ]
}

执行以下 API 调用，以使用建议的拓扑创建 VDS：

POST https://<nsx-mgr>/api/v1/nvds-urt/topology?action=apply

策略 API：

PUT /policy/api/v1/infra/nvds-urt/topology?action=apply

请注意，只能使用新名称重命名建议的拓扑中的 VDS，而不能使用现有 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"
              ]
            }
          ]
        }
      ]
    }
  ]
}

要跟踪迁移状态，请执行以下 API 调用：
```
GET https://<nsx-mgr>/api/v1/nvds-urt/status-summary/<precheck-id>
```
当主机准备好进行迁移时，precheck_status 将从 APPLYING _TOPOLOGY 更改为 READY，并且主机状态将设置为 UPGRADE_READY。

有关 API 参数的详细信息，请参阅NSX-T Data Center API 指南。
从 vCenter 中将 ESXi 主机置于维护模式。
要启动从 N-VDS 到 VDS 的迁移，请执行以下 API 调用：
```
POST https://<nsx-mgr>/api/v1/transport-nodes/<tn-id>?action=migrate_to_vds
```
将以异步方式迁移主机。您可以通过对一组所需的主机调用 API 来并行升级多个传输节点。在迁移过程中，DRS 等服务将继续按预期运行。

执行以下 API 调用以跟踪迁移状态：

GET https://<nsx-mgr>/api/v1/nvds-urt/status-summary/<precheck-id>

成功完成迁移后，host migration_state 将从 UPGRADE_IN_PROGRESS 更改为 SUCCESS。

示例响应：

{
  "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"
    }
  ]
}

如果出现故障，overall_state 将更改为 FAILED，并指明迁移失败的原因。运行 migrate_to_vds 操作以再次运行迁移任务。

对于无状态主机：
1. 从迁移后的主机提取主机配置文件并将其附加到集群。
2. 重新引导集群中的其余主机。

下一步做什么

迁移完成后，可以执行升级。

选项 2：使用 CLI 将主机交换机迁移到 vSphere Distributed Switch

可以使用 NSX-TNSX-T CLI 将主机交换机迁移到 vSphere Distributed Switch (VDS)。

要使用 CLI 调用迁移主机交换机，请执行以下步骤。

过程

查看必备条件部分中迁移到 VDS 7.0 主机交换机的要求。
要确认主机已准备好进行迁移，请运行以下命令并运行预检查：
```
vds-migrate precheck
```
示例输出：
```
 Precheck Id: 0a26d126-7116-11e5-9d70-feff819cdc9f
```
解决所有配置不一致问题，然后再次运行预检查。

要检索建议的拓扑，请运行以下命令：

vds-migrate show-topology

示例输出：

Precheck Id: 137d2a87-0544-4914-829d-d8b7e33b13f2
       NVDS: nvds1(19cca902-9455-4316-92e2-65f4f5b4b138)                          
       Compute Manager Topology:                                                  
       [                                                                          
           {                                                                      
               "compute_manager_id": "fd37ed6e-0eae-4d65-b29a-d40eee1d5d47",      
               "dvswitch": [                                                      
                   {                                                              
                       "transport_node_id": [                                     
                           "4d011ade-a010-4eea-b45a-b2569c0bb9ad"                 
                       ],                                                         
                       "data_center_id": "datacenter-3",                          
                       "vmknic": [],                                              
                       "vds_name": "VDS-nvds1-datacenter-3"                      
                   }                                                              
               ]                                                                  
           }                                                                      
       ]

运行以下命令以使用建议的拓扑创建 VDS：
```
vds-migrate apply-topology
```
登录到 vCenter Server 并确认 VDS 已经创建。

要启动从 N-VDS 到 VDS 的迁移，请运行以下命令：

vds-migrate esxi-cluster-name <cluster-name>

示例输出：

 VDS Migration Done:                                                     
   3 Transport-Nodes Migrate Successfully          
   0 Transport-Nodes Migrate Failed

您还可以使用传输节点 ID 启动迁移：

vds-migrate tn-list <file-path>

其中，<file-path> 包含传输节点 ID。

示例输出：

nsx-manager-1> vds-migrate tn-list /opt/tnid
       VDS Migration Done:
       3 Transport-Nodes Migrate Successfully
       0 Transport-Nodes Migrate Failed

下一步做什么

迁移完成后，可以执行升级。

选项 3：使用 UI 将主机交换机迁移到 vSphere Distributed Switch

您可以使用 NSX Manager 准备要迁移的主机，然后使用 vSphere Update Manager 将其作为主机操作系统升级的一部分迁移到 VDS。

要使用 UI 迁移主机交换机，请执行以下步骤。

注：必须在不同 ESXi 更新版本之间升级 ESXi 主机，才能触发此迁移。例如，

从 ESXi 7.0 升级到 ESXi 7.0 U2 - 可以触发交换机迁移。
从 ESXi 7.0 U2 升级到 ESXi 7.0 U2a - 无法触发交换机迁移，因为升级在同一 ESXi 更新版本中进行。

过程

查看必备条件部分中迁移到 VDS 7.0 主机交换机的要求。
以本地 admin 用户身份登录到 NSX Manager，网址为 https://nsx-manager-ip-address/login.jsp?local=true。
选择系统 > 快速入门。
单击快速入门以准备要从 N-VDS 迁移到 VDS 的主机。
单击预检查以验证主机是否做好迁移准备。
解决所有配置不一致问题，然后再次运行预检查。
查看建议的网络拓扑。
单击创建，以在 vCenter Server 中创建相应的 VDS 交换机以准备要迁移的选定主机。
登录到 vCenter Server 并使用 vSphere Update Manager 升级 ESXi 主机。在主机操作系统升级完成时，交换机迁移即会完成。
从“监控”选项卡中监控迁移进度。

下一步做什么

可选：将迁移后的主机退出维护模式。使用 vSphere Update Manager 将主机交换机作为主机升级的一部分迁移时，不需要执行该步骤。