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.

Si el nodo de Edge que se va a reemplazar no está en ejecución, el nuevo nodo de Edge puede tener la misma dirección IP de administración y la misma dirección IP de TEP. Si el nodo de Edge que se va a reemplazar se está ejecutando, el nuevo nodo de Edge debe tener una dirección IP de administración y una dirección IP de TEP diferentes.

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>/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
}

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.

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.