次の手順では、NSX API を使用して NSX Edge クラスタの NSX Edge トランスポート ノードを置き換える方法について説明します。Edge トランスポート ノードは、実行中かどうかに関係なく置き換えることができます。
前提条件
- NSX Edge ノードをインストールし、Edge ノードを管理プレーンに追加し、NSX Edge トランスポート ノードを作成する手順について理解しておく必要があります。詳細については、『NSX インストール ガイド』を参照してください。
- 古い NSX Edge ノードの置き換えに使用する新しい NSX Edge ノードの準備が整っていることを確認します。詳細については、『NSX インストール ガイド』を参照してください。
手順
- 新しい NSX Edge トランスポート ノードに、置き換える古い NSX Edge トランスポート ノードと同じ構成を設定する場合は、次の API 呼び出しを行って構成を見つけます。
GET https://<nsx-manager-IP>/api/v1/transport-nodes/<tn-id>{ "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 アドレスを使用しないでください
- 古い NSX Edge ノードが実行されている場合は、同じ IP アドレスを使用しないでください (
- 新しい Edge トランスポート ノードの UUID を確認します。手順 1 で説明した API を実行します。
- 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" } ], - 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" }
