次の手順では、NSX-T API を使用して NSX Edge クラスタの NSX Edge トランスポート ノードを置き換える方法について説明します。Edge トランスポート ノードは、実行中かどうかに関係なく置き換えることができます。

置き換える Edge ノードが実行されていない場合、新しい Edge ノードには同じ管理 IP アドレスと TEP IP アドレスを設定することができます。置き換える Edge ノードが実行中の場合、新しい Edge ノードには異なる管理 IP アドレスと TEP IP アドレスを設定する必要があります。

前提条件

  • NSX Edge ノードをインストールし、Edge ノードを管理プレーンに追加し、NSX Edge トランスポート ノードを作成する手順について理解しておく必要があります。詳細については、『NSX-T Data Center インストール ガイド』を参照してください。
  • 古い NSX Edge ノードの置き換えに使用する新しい NSX Edge ノードの準備が整っていることを確認します。詳細については、『NSX-T Data Center インストール ガイド』を参照してください。

手順

  1. 新しい 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
    }
  2. 置き換えるノードのトランスポート ノード ID (55120a1a-51c6-4c20-b4a3-6f59662c9f6a) をメモします。
  3. 古い NSX Edge ノードを置き換える新しい NSX Edge トランスポート ノードを準備します。『NSX-T Data Center インストール ガイド』の「NSX Edge トランスポート ノードの作成」を参照してください。
    新しい NSX Edge ノードを準備する場合は、次の構成点に注意してください。
    • 古い NSX Edge ノードが実行されている場合は、同じ IP アドレスを使用しないでください ("ip_addresses": ["10.161.68.92"])。
    • 古い NSX Edge ノードが実行されている場合は、同じ TEP IP アドレスを使用しないでください
  4. 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"
            }
          ],
  5. API 呼び出しを行い、NSX Edge クラスタ内のトランスポート ノードを置き換えます。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-T を実行している場合、 NSX Edge トランスポート ノードを置き換えた後、「すべての BGP/BFD セッションが停止しています。」というアラームが表示されることがあります。この問題を解決するには、ナレッジベースの記事 https://kb.vmware.com/s/article/83983の回避策の手順に従ってください。