API를 사용하여 NSX Edge 전송 노드 교체

다음 절차에서는 NSX API를 사용하여 NSX Edge 클러스터에서 NSX Edge 전송 노드를 교체하는 방법을 설명합니다. Edge 전송 노드는 실행 중인지 여부에 관계없이 교체할 수 있습니다.

교체할 Edge 노드가 실행되고 있지 않은 경우 새 Edge 노드는 동일한 관리 IP 주소와 TEP IP 주소를 가질 수 있습니다. 교체할 Edge 노드가 실행되고 있는 경우 새 Edge 노드는 다른 관리 IP 주소와 TEP IP 주소를 가져야 합니다.

사전 요구 사항

NSX Edge 노드를 설치하고, Edge 노드를 관리부에 가입시키고, NSX Edge 전송 노드를 생성하는 절차를 숙지하십시오. 자세한 내용은 "NSX 설치 가이드" 항목를 참조하십시오.
이전 NSX Edge 노드를 교체하는 데 사용할 새 NSX Edge 노드가 준비되었는지 확인합니다. 자세한 내용은 "NSX 설치 가이드" 항목를 참조하십시오.

프로시저

새 NSX Edge 전송 노드에 교체할 이전 NSX Edge 전송 노드와 동일한 구성이 포함되도록 하려면 다음 API 호출을 수행하여 구성을 찾습니다.

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
}

교체할 노드의 전송 노드 ID인 "55120a1a-51c6-4c20-b4a3-6f59662c9f6a"를 기록해 둡니다.
이전 NSX Edge 노드를 교체할 새 NSX Edge 전송 노드를 준비합니다. "NSX 설치 가이드" 에서 "NSX Edge 전송 노드 생성" 을 참조하십시오.
새 NSX Edge 노드를 준비하는 동안 다음 구성 지점을 기록해 둡니다.
- 이전 NSX Edge 노드가 실행 중인 경우 동일한 IP 주소인 "ip_addresses": ["10.161.68.92"]를 사용하지 마십시오.
- 이전 NSX Edge 노드가 실행 중인 경우 동일한 TEP IP 주소를 사용하지 마십시오.

API 호출을 수행하여 교체해야 하는 전송 노드의 멤버 인덱스를 검색합니다.

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

NSX Edge 클러스터에서 전송 노드를 교체할 API 호출을 수행합니다. member_index는 교체할 전송 노드의 인덱스와 일치해야 합니다.
예를 들어 전송 노드 TN-edgenode-01a(73cb00c9-70d0-4808-abfe-a12a43251133)가 실패했으며 NSX Edge 클러스터 Edge-Cluster-1(9a302df7-0833-4237-af1f-4d826c25ad78)의 전송 노드 TN-edgenode-03a(890f0e3c-aa81-46aa-843b-8ac25fe30bd3)로 교체됩니다.
```
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"
}
```

결과

3.1.3 이전 버전의 NSX 버전을 실행 중인 경우 NSX Edge 전송 노드를 교체하면 "모든 BGP/BFD 세션이 종료되었습니다."라는 경보가 표시될 수 있습니다. 이 문제를 해결하려면 KB 문서 https://kb.vmware.com/s/article/83983의 해결 방법 지침을 따르십시오.