API を使用した NSX Edge トランスポートノードの置き換え

次の手順では、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 インストールガイド』を参照してください。

手順

新しい Edge トランスポートノードに、置き換える Edge トランスポートノードと同じ構成を設定する場合は、次の API 呼び出しを行って構成を見つけます。
GET https://<nsx-manager-IP>/api/v1/transport-nodes/<tn-id>
『NSX-T Data Center インストールガイド』の手順に従って、Edge トランスポートノードをインストールして構成します。
この Edge トランスポートノードの構成を、置き換える Edge トランスポートノードと同じにするには、手順 1 で取得した構成を使用します。

API 呼び出しを行って、新しいトランスポートノードと置き換えるトランスポートノードの ID を取得します。id フィールドにはトランスポートノード ID が含まれています。次はその例です。

GET https://<nsx-manager-IP>/api/v1/transport-nodes
... 
   {
      "resource_type": "TransportNode",
      "description": "",
      "id": "73cb00c9-70d0-4808-abfe-a12a43251133",
      "display_name": "TN-edgenode-01a",
...
    {
      "resource_type": "TransportNode",
      "description": "",
      "id": "890f0e3c-aa81-46aa-843b-8ac25fe30bd3",
      "display_name": "TN-edgenode-03a",

API 呼び出しを行い、NSX Edge クラスタの ID を取得します。id フィールドには NSX Edge クラスタ ID が含まれています。members アレイから NSX Edge クラスタのメンバーを取得します。次はその例です。

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": "73cb00c9-70d0-4808-abfe-a12a43251133"
        },
        {
          "member_index": 1,
          "transport_node_id": "e5d17b14-cdeb-4e63-b798-b23a0757463b"
        }
      ],

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の回避策の手順に従ってください。