Ersetzen eines NSX Edge-Transportknotens mithilfe der API

Das folgende Verfahren beschreibt das Ersetzen eines NSX Edge-Transportknotens in einem NSX Edge-Cluster über die NSX-API. Sie können den Edge-Transportknoten unabhängig davon ersetzen, ob er ausgeführt wird oder nicht.

Sofern der zu ersetzende Edge-Knoten nicht ausgeführt wird, kann der neue Edge-Knoten dieselbe Management-IP-Adresse und TEP-IP-Adresse besitzen. Wenn der zu ersetzende Edge-Knoten ausgeführt wird, muss der neue Edge-Knoten eine andere Management-IP-Adresse und TEP-IP-Adresse besitzen.

Voraussetzungen

Machen Sie sich mit der Vorgehensweise zum Installieren eines NSX Edge-Knotens vertraut, verbinden Sie den Edge-Knoten mit der Management Plane und erstellen Sie einen NSX Edge-Transportknoten. Weitere Informationen finden Sie im Dokument Installationshandbuch für NSX.
Stellen Sie sicher, dass der neue NSX Edge-Knoten bereit ist, der als Ersatz für den alten NSX Edge-Knoten verwendet wird. Weitere Informationen finden Sie im Dokument Installationshandbuch für NSX.

Prozedur

Wenn Sie möchten, dass der neue NSX Edge-Transportknoten dieselben Konfigurationen wie der zu ersetzende alte NSX Edge-Transportknoten besitzt, führen Sie den folgenden API-Aufruf aus, um die Konfigurationen zu finden:

GET https://<nsx-manager-IP>/policy/api/v1/infra/sites/<site-id>/enforcement-points/<enforcementpoint-id>/host-transport-nodes

{
    "node_id": "250175b8-223b-11ed-826e-b07b25e93f64",
    "host_switch_spec": {
        "host_switches": [
            {
                "host_switch_name": "nsxHostSwitch",
                "host_switch_id": "809299a2-c090-4543-8747-d200e12cd2ea",
                "host_switch_type": "NVDS",
                "host_switch_mode": "STANDARD",
                "host_switch_profile_ids": [
                    {
                        "key": "UplinkHostSwitchProfile",
                        "value": "57da58fa-bce6-448b-8db3-874ceff59656"
                    },
                    {
                        "key": "LldpHostSwitchProfile",
                        "value": "9e0b4d2d-d155-4b4b-8947-fbfe5b79f7cb"
                    }
                ],
                "pnics": [
                    {
                        "device_name": "fp-eth0",
                        "uplink_name": "Uplink1"
                    },
                    {
                        "device_name": "fp-eth2",
                        "uplink_name": "Uplink2"
                    },
                    {
                        "device_name": "fp-eth4",
                        "uplink_name": "Uplink3"
                    },
                    {
                        "device_name": "fp-eth6",
                        "uplink_name": "Uplink4"
                    }
                ],
                "is_migrate_pnics": false,
                "ip_assignment_spec": {
                    "ip_pool_id": "82f8ae96-992b-45c6-8376-777b82bfeb1d",
                    "resource_type": "StaticIpPoolSpec"
                },
                "cpu_config": [],
                "transport_zone_endpoints": [
                    {
                        "transport_zone_id": "15897bda-802f-4481-b9fd-4e5cc1ef084b",
                        "transport_zone_profile_ids": [
                            {
                                "resource_type": "BfdHealthMonitoringProfile",
                                "profile_id": "52035bb3-ab02-4a08-9884-18631312e50a"
                            }
                        ]
                    },
                    {
                        "transport_zone_id": "4a237a28-050e-4499-a241-0eb0c9dad97f",
                        "transport_zone_profile_ids": [
                            {
                                "resource_type": "BfdHealthMonitoringProfile",
                                "profile_id": "52035bb3-ab02-4a08-9884-18631312e50a"
                            }
                        ]
                    }
                ],
                "pnics_uninstall_migration": [],
                "vmk_uninstall_migration": [],
                "not_ready": false
            }
        ],
        "resource_type": "StandardHostSwitchSpec"
    },
    "maintenance_mode": "DISABLED",
    "node_deployment_info": {
        "deployment_type": "PHYSICAL_MACHINE",
        "node_settings": {
            "hostname": "w1-hs2-m2716.eng.vmware.com",
            "enable_ssh": true,
            "allow_ssh_root_login": false
        },
        "resource_type": "EdgeNode",
        "external_id": "250175b8-223b-11ed-826e-b07b25e93f64",
        "ip_addresses": [
            "10.196.145.177"
        ],
        "id": "250175b8-223b-11ed-826e-b07b25e93f64",
        "display_name": "w1-hs2-m2716.eng.vmware.com",
        "tags": [],
        "_revision": 3
    },
    "is_overridden": false,
    "failure_domain_id": "4fc1e3b0-1cd4-4339-86c8-f76baddbaafb",
    "resource_type": "TransportNode",
    "id": "250175b8-223b-11ed-826e-b07b25e93f64",
    "display_name": "w1-hs2-m2716.eng.vmware.com",
    "tags": [],
    "_create_time": 1661187299037,
    "_create_user": "admin",
    "_last_modified_time": 1661255498968,
    "_last_modified_user": "admin",
    "_system_owned": false,
    "_protection": "NOT_PROTECTED",
    "_revision": 3
}

Notieren Sie die Transportknoten-ID des zu ersetzenden Knotens: 55120a1a-51c6-4c20-b4a3-6f59662c9f6a.
Bereiten Sie einen neuen NSX Edge-Transportknoten vor, der den alten NSX Edge-Knoten ersetzen wird. Weitere Informationen finden Sie unter Erstellen eines NSX Edge-Transportknotens im Installationshandbuch für NSX.
Beachten Sie beim Vorbereiten des neuen NSX Edge-Knotens die folgenden Punkte der Konfiguration:
- Verwenden Sie nicht die IP-Adresse des alten NSX Edge-Knotens, wenn er ausgeführt wird, "ip_addresses": ["10.161.68.92"].
- Verwenden Sie nicht dieselbe TEP-IP-Adresse, wenn der alte NSX Edge-Knoten ausgeführt wird

Führen Sie einen API-Aufruf durch, um den Mitgliederindex des zu ersetzenden Transportknotens abzurufen.

GET https://<nsx-manager-IP>/api/v1/edge-clusters

....
    {
      "resource_type": "EdgeCluster",
      "description": "",
      "id": "9a302df7-0833-4237-af1f-4d826c25ad78",
      "display_name": "Edge-Cluster-1",
...
      "members": [
        {
          "member_index": 0,
          "transport_node_id": "55120a1a-51c6-4c20-b4a3-6f59662c9f6a"
        },
        {
          "member_index": 1,
          "transport_node_id": "890f0e3c-aa81-46aa-843b-8ac25fe30bd3"
        }
      ],

Führen Sie einen API-Aufruf aus, um einen Transportknoten in einem NSX Edge-Cluster zu ersetzen. Der member_index muss mit dem Index des zu ersetzenden Transportknotens übereinstimmen.
Beispiel: Der Transportknoten TN-edgenode-01a (73cb00c9-70d0-4808-abfe-a12a43251133) ist fehlgeschlagen und wird durch den Transportknoten TN-edgenode-03a (890f0e3c-aa81-46aa-843b-8ac25fe30bd3) im NSX Edge-Cluster Edge-Cluster-1 (9a302df7-0833-4237-af1f-4d826c25ad78) ersetzt.
```
POST http://<nsx-manager-IP>/api/v1/edge-clusters/9a302df7-0833-4237-af1f-4d826c25ad78?action=replace_transport_node
{
    "member_index": 0,
    "transport_node_id" : "890f0e3c-aa81-46aa-843b-8ac25fe30bd3"
}
```

Ergebnisse

Wenn Sie eine NSX-Version vor 3.1.3 ausführen, wird nach dem Ersetzen des NSX Edge-Transportknotens möglicherweise der Alarm „Alle BGP/BFD-Sitzungen sind inaktiv“ angezeigt. Um das Problem zu beheben, befolgen Sie die Anweisungen zur Problemumgehung im KB-Artikel https://kb.vmware.com/s/article/83983.