La procédure suivante décrit le remplacement d'un nœud de transport NSX Edge dans un cluster NSX Edge à l'aide de l'API de NSX. Vous pouvez remplacer le nœud de transport Edge, qu'il soit en cours d'exécution ou non.

Conditions préalables

  • Familiarisez-vous avec la procédure d'installation d'un nœud NSX Edge, joignez le nœud Edge au plan de gestion et créez un nœud de transport NSX Edge. Pour plus d'informations, reportez-vous à Guide d'installation de NSX.
  • Assurez-vous que le nouveau nœud NSX Edge qui sera utilisé pour remplacer l'ancien nœud NSX Edge est prêt. Pour plus d'informations, reportez-vous à Guide d'installation de NSX.

Procédure

  1. Si vous souhaitez que le nouveau nœud de transport NSX Edge ait les mêmes configurations que l'ancien nœud de transport NSX Edge à remplacer, effectuez l'appel d'API suivant pour rechercher les configurations :
    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
    }
  2. Notez l'ID du nœud de transport à remplacer «55120a1a-51c6-4c20-b4a3-6f59662c9f6a ».
  3. Préparez un nouveau nœud de transport NSX Edge qui remplacera l'ancien nœud NSX Edge. Reportez-vous à la section Créer un nœud de transport NSX Edge du Guide d'installation de NSX.
    Notez les points de configuration suivants lors de la préparation du nouveau nœud NSX Edge :
    • N'utilisez pas la même adresse IP que l'ancien nœud NSX Edge s'il exécute "ip_addresses": ["10.161.68.92"].
    • N'utilisez pas la même adresse IP TEP si l'ancien nœud NSX Edge est en cours d'exécution
  4. Confirmez l'UUID du nouveau nœud de transport Edge. Exécutez l'API mentionnée à l'étape 1.
  5. Effectuez un appel d'API pour récupérer l'indicateur de membre du nœud de transport qui doit être remplacé.
    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"
            }
          ],
  6. Effectuez un appel d'API pour remplacer un nœud de transport dans un cluster NSX Edge. member_index doit correspondre à l'index du nœud de transport à remplacer.
    Par exemple, le nœud de transport TN-edgenode-01a (73cb00c9-70d0-4808-abfe-a12a43251133) a échoué, et il est remplacé par le nœud de transport TN-edgenode-03a (890f0e3c-aa81-46aa-843b-8ac25fe30bd3) dans le cluster Edge-Cluster-1 de NSX Edge (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"
    }

Résultats

Si vous exécutez une version de NSX antérieure à la version 3.1.3, après le remplacement du nœud de transport NSX Edge, l'alarme « Toutes les sessions BGP/BFD sont inactives » peut s'afficher. Pour résoudre ce problème, suivez les instructions de solution de l'article de la base de connaissances https://kb.vmware.com/s/article/83983.