Reemplazar un nodo de transporte de NSX Edge mediante la API

En el siguiente procedimiento se describe cómo reemplazar un nodo de transporte de NSX Edge en un clúster de NSX Edge mediante la API de NSX. Puede reemplazar el nodo de transporte de Edge independientemente de si se está ejecutando o no.

Requisitos previos

Familiarícese con el procedimiento para instalar un nodo de NSX Edge, unir el nodo de Edge con el plano de administración y crear un nodo de transporte de NSX Edge. Para obtener más información, consulte la Guía de instalación de NSX.
Asegúrese de que el nuevo nodo de NSX Edge que utilizará para reemplazar el nodo de NSX Edge anterior esté listo. Para obtener más información, consulte la Guía de instalación de NSX.

Procedimiento

Si desea que el nuevo nodo de transporte de NSX Edge tenga las mismas configuraciones que el nodo de transporte de NSX Edge que se reemplazará, realice la siguiente llamada API para buscar las configuraciones:

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
}

Anote el identificador de nodo de transporte del nodo que se reemplazará: "55120a1a-51c6-4c20-b4a3-6f59662c9f6a".
Prepare un nuevo nodo de transporte de NSX Edge que reemplace al nodo de NSX Edge anterior. Consulte Crear un nodo de transporte de NSX Edge en Guía de instalación de NSX.
Tenga en cuenta los siguientes puntos de configuración al preparar el nuevo nodo de NSX Edge:
- No utilice la misma dirección IP del nodo de NSX Edge anterior ("ip_addresses": ["10.161.68.92"]) si está en ejecución.
- No utilice la misma dirección IP de TEP si el nodo de NSX Edge anterior está en ejecución.
Confirme el UUID del nuevo nodo de transporte de Edge. Ejecute la API mencionada en el paso 1.

Realice una llamada API para recuperar el índice de miembros del nodo de transporte que debe reemplazarse.

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

Haga que una llamada API para reemplazar un nodo de transporte en un clúster de NSX Edge. member_index debe coincidir con el índice del nodo de transporte que se va a reemplazar.
Por ejemplo, se produjo un error en el nodo de transporte TN-edgenode-01a (73cb00c9-70d0-4808-abfe-a12a43251133), que es reemplazado por el nodo de transporte TN-edgenode-03a (890f0e3c-aa81-46aa-843b-8ac25fe30bd3) en el clúster de NSX Edge Edge-Cluster-1 (9a302df7-0833-4237-af1f-4d826c25ad78).
```
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"
}
```

Resultados

Si ejecuta una versión de NSX anterior a la 3.1.3, después de reemplazar el nodo de transporte NSX Edge, es posible que se muestre la alarma "Todas las sesiones de BGP/BFD están inactivas". Para solucionar el problema, siga las instrucciones de solución alternativa incluidas en el artículo de la base de conocimientos https://kb.vmware.com/s/article/83983.