Vous souhaitez redéployer une machine virtuelle NSX Edge lorsqu'elle devient obsolète ou son placement dans le centre de données doit être modifié. Par exemple, lorsque le dispositif NSX Edge doit être déplacé vers une autre banque de données ou ressource de calcul, redéployez le nœud NSX Edge. Vous pouvez également déplacer le nœud vers un autre réseau. Cependant, il peut y avoir d'autres raisons de redéployer en fonction de la configuration réseau requise.

Vous pouvez uniquement redéployer un nœud NSX Edge existant (serveur physique ou dispositif de machine virtuelle NSX Edge) avec un dispositif de machine virtuelle NSX Edge.

Conditions préalables

  • Bien que vous puissiez modifier certaines configurations de charge utile du nœud de transport NSX Edge, ne modifiez pas ces configurations sur le nœud NSX Edge existant, qui doit être redéployé par un nouveau nœud :
    • domaine de pannes
    • connectivité du nœud de transport
    • configuration de carte réseau physique
    • routeurs logiques
    • allocations de l'équilibreur de charge
  • Assurez-vous que la connectivité entre le nœud NSX Edge et NSX Manager est inactive si le nœud NSX Edge existant est un serveur physique ou une machine virtuelle déployée manuellement via vSphere Client. Si la connectivité est active, NSX-T n'autorise pas le remplacement du nœud NSX Edge existant par un nouveau.

Procédure

  1. (Serveur physique ou dispositif NSX Edge déployé via vSphere Client) Ouvrez une session SSH et connectez-vous à la console NSX Edge.
  2. Vérifiez les routes logiques configurées sur le nœud NSX Edge via la console de la CLI, get logical-routers.
  3. Désactivez le nœud NSX Edge.
  4. Vérifiez que le nœud NSX Edge est déconnecté de NSX Manager en exécutant la commande API suivante.
    GET api/v1/transport-nodes/<edgenode>/state
     "node_deployment_state": 
            {"state": MPA_Disconnected"}

    La valeur node_deployment_state est MPA déconnecté, ce qui indique que vous pouvez poursuivre le redéploiement du nœud NSX Edge.

    Note : Si node_deployment_state est Nœud prêt, NSX Manager affiche une erreur 78006 : la connectivité du gestionnaire au nœud Edge doit être inactive. Sinon, le remplacement/redéploiement du matériel n'est pas autorisé.
  5. Vous pouvez également afficher l'état de connectivité entre le nœud NSX Edge et NSX Manager à partir de la page Nœud de transport Edge. Un nœud NSX Edge déconnecté affiche le message système suivant : Erreur de configuration, la connectivité MPA de la VM Edge est inactive.
  6. Si le nœud NSX Edge est un nœud déployé automatiquement, exécutez GET /<NSX-Manager-IPaddress>/api/v1/transport-nodes/<edgenode>. Copiez la charge utile de sortie de cette API.
    "resource_type": "EdgeNode",
    	        "id": "9f34c0ea-4aac-4b7f-a02c-62f306f96649",
    	        "display_name": "Edge_TN2",
    	        "description": "EN",
    	        "external_id": "9f34c0ea-4aac-4b7f-a02c-62f306f96649",
    	        "ip_addresses": [
    	            "10.170.94.240"
    	        ],
    	        "_create_user": "admin",
    	        "_create_time": 1600106319056,
    	        "_last_modified_user": "admin",
    	        "_last_modified_time": 1600106907312,
    	        "_system_owned": false,
    	        "_protection": "NOT_PROTECTED",
    	        "_revision": 2
    	    },
    	    "is_overridden": false,
    	    "failure_domain_id": "4fc1e3b0-1cd4-4339-86c8-f76baddbaafb",
    	    "resource_type": "TransportNode",
    	    "id": "9f34c0ea-4aac-4b7f-a02c-62f306f96649",
    	    "display_name": "Edge_TN2",
    	    "_create_user": "admin",
    	    "_create_time": 1600106319399,
    	    "_last_modified_user": "admin",
    	    "_last_modified_time": 1600106907401,
    	    "_system_owned": false,
    	    "_protection": "NOT_PROTECTED",
    	    "_revision": 1
    	}
  7. Vous pouvez choisir l'un des scénarios de redéploiement :
    Choix Actions

    Redéployez un nœud NSX Edge existant (serveur physique ou nœud déployé manuellement) avec un nœud de VM NSX Edge (déployé via l'API NSX Manager)

    Effectuez les opérations suivantes dans la commande API, /api/v1/transport-nodes/<transport-node-id>?action=redeploy
    • Collez la charge utile dans le corps de l'API de redéploiement.
    • Vérifiez que la section deployment_config fait référence aux détails du gestionnaire de calcul, de la banque de données et du réseau où vous souhaitez redéployer le nœud. Assurez-vous que ces valeurs sont cohérentes avec les valeurs utilisées dans la section node_settings.

    • Ajoutez des mots de passe de connexion dans la section deployment_config.

    NSX Manager redéploie le nœud NSX Edge en fonction des détails indiqués dans la section deployment_config.

    Modifiez le placement du nœud NSX Edge existant

    Effectuez les opérations suivantes dans la commande API, /api/v1/transport-nodes/<transport-node-id>?action=redeploy
    • Collez la charge utile dans le corps de l'API de redéploiement.
    • Dans la section deployment_config, référencez les détails du nouveau gestionnaire de calcul, de la banque de données, du réseau, du CPU, de la mémoire ou de la sensibilité de latence.
    Exemple de POST https://<manager-ip>/api/v1/transport-nodes/<transport-node-id>?action=redeploy
    	{
    	    "node_id": "9f34c0ea-4aac-4b7f-a02c-62f306f96649",
    	    "host_switch_spec": {
    	        "host_switches": [
    	            {
    	                "host_switch_name": "nsxvswitch_overlay",
    	                "host_switch_id": "c0a4a83e-c8b8-4324-a4d7-dbbc07b30b53",
    	                "host_switch_type": "NVDS",
    	                "host_switch_mode": "STANDARD",
    	                "host_switch_profile_ids": [
    	                    {
    	                        "key": "UplinkHostSwitchProfile",
    	                        "value": "f9a2a2fa-b49d-498f-abaf-2fdc81917716"
    	                    },
    	                    {
    	                        "key": "LldpHostSwitchProfile",
    	                        "value": "9e0b4d2d-d155-4b4b-8947-fbfe5b79f7cb"
    	                    }
    	                ],
    	                "pnics": [
    	                    {
    	                        "device_name": "fp-eth0",
    	                        "uplink_name": "uplink1"
    	                    }
    	                ],
    	                "is_migrate_pnics": false,
    	                "ip_assignment_spec": {
    	                    "ip_pool_id": "647d9b0d-0143-4903-91f5-930d9ab011e8",
    	                    "resource_type": "StaticIpPoolSpec"
    	                },
    	                "cpu_config": [],
    	                "transport_zone_endpoints": [
    	                    {
    	                        "transport_zone_id": "0b33b078-6438-4d9b-a1ec-33211fd36822",
    	                        "transport_zone_profile_ids": [
    	                            {
    	                                "resource_type": "BfdHealthMonitoringProfile",
    	                                "profile_id": "52035bb3-ab02-4a08-9884-18631312e50a"
    	                            }
    	                        ]
    	                    },
    	                    {
    	                        "transport_zone_id": "a0133574-48de-4e3a-9407-7db1a68bae41",
    	                        "transport_zone_profile_ids": [
    	                            {
    	                                "resource_type": "BfdHealthMonitoringProfile",
    	                                "profile_id": "52035bb3-ab02-4a08-9884-18631312e50a"
    	                            }
    	                        ]
    	                    }
    	                ],
    	                "vmk_install_migration": [],
    	                "pnics_uninstall_migration": [],
    	                "vmk_uninstall_migration": [],
    	                "not_ready": false
    	            }
    	        ],
    	        "resource_type": "StandardHostSwitchSpec"
    	    },
    	    "transport_zone_endpoints": [],
    	    "maintenance_mode": "DISABLED",
    	    "node_deployment_info": {
    	        "deployment_type": "VIRTUAL_MACHINE",
    	        "deployment_config": {
    	            "vm_deployment_config": {
    	                "vc_id": "cc82da39-b119-4869-a7fe-a54621cb4d3d",
    	                "compute_id": "domain-c9",
    	                "storage_id": "datastore-14",
    	                "host_id": "host-12",
    	                "compute_folder_id": "group-v5",
    	                "management_network_id": "network-16",
    	                "hostname": "EdgeSmallFactor",
    	                "data_network_ids": [
    	                    "5638c577-e142-4a50-aed3-a7079dc3b08c",
    	                    "5638c577-e142-4a50-aed3-a7079dc3b08c",
    	                    "5638c577-e142-4a50-aed3-a7079dc3b08c"
    	                ],
    	                "search_domains": [
    	                    "eng.vmware.com",
    	                    "vmware.com"
    	                ],
    	                "enable_ssh": true,
    	                "allow_ssh_root_login": true,
    	                "reservation_info": {
    	                    "memory_reservation": {
    	                        "reservation_percentage": 100
    	                    },
    	                    "cpu_reservation": {
    	                        "reservation_in_shares": "HIGH_PRIORITY",
    	                        "reservation_in_mhz": 0
    	                    }
    	                },
    	                "resource_allocation": {
    	                    "cpu_count": 4,
    	                    "memory_allocation_in_mb": 8192
    	                },
    	                "placement_type": "VsphereDeploymentConfig"
    	            },
    	            "form_factor": "MEDIUM",
    	            "node_user_settings": {
    	                 "cli_username": "admin",
                            "root_password":"Admin!23Admin", 
                            "cli_password":"Admin!23Admin" 
    	            }
    	        },
    	        "node_settings": {
    	            "hostname": "EdgeSmallFactor",
    	            "search_domains": [
    	                "eng.vmware.com",
    	                "vmware.com"
    	            ],
    	            "enable_ssh": true,
    	            "allow_ssh_root_login": true
    	        },
    	        "resource_type": "EdgeNode",
    	        "id": "9f34c0ea-4aac-4b7f-a02c-62f306f96649",
    	        "display_name": "Edge_TN2",
    	        "description": "EN",
    	        "external_id": "9f34c0ea-4aac-4b7f-a02c-62f306f96649",
    	        "ip_addresses": [
    	            "10.170.94.240"
    	        ],
    	        "_create_user": "admin",
    	        "_create_time": 1600106319056,
    	        "_last_modified_user": "admin",
    	        "_last_modified_time": 1600106907312,
    	        "_system_owned": false,
    	        "_protection": "NOT_PROTECTED",
    	        "_revision": 2
    	    },
    	    "is_overridden": false,
    	    "failure_domain_id": "4fc1e3b0-1cd4-4339-86c8-f76baddbaafb",
    	    "resource_type": "TransportNode",
    	    "id": "9f34c0ea-4aac-4b7f-a02c-62f306f96649",
    	    "display_name": "Edge_TN2",
    	    "_create_user": "admin",
    	    "_create_time": 1600106319399,
    	    "_last_modified_user": "admin",
    	    "_last_modified_time": 1600106907401,
    	    "_system_owned": false,
    	    "_protection": "NOT_PROTECTED",
    	    "_revision": 1
    	}
    
    Note : Si l'ancien nœud est un nœud de machine virtuelle NSX Edge déployé via l'interface utilisateur de NSX Manager, vous n'avez pas besoin de fournir les informations d'identification de connexion dans la section node_user_settings de la charge utile de l'API.
    Reportez-vous au Guide de l'API de NSX-T Data Center pour plus d'informations sur les détails de la charge utile.
  8. Dans NSX Manager, vérifiezl'état de configuration du nouveau nœud NSX Edge.
  9. Vous pouvez également vérifier l'état du nœud de transport NSX Edge qui vient d'être préparé en exécutant la commande API, Get api/v1/transport-nodes/<node-id>/state.
  10. Vérifiez que les configurations de routeur logique sont migrées vers le nouveau nœud NSX Edge, en exécutant la commande CLI get logical-routers.
  11. Vérifiez que l'adresse du TEP reste la même sur le nœud NSX Edge remplacé.
  12. Vérifiez que l'état du cluster NSX Edge est actif. L'API est GET api/v1/edge-clusters/<cluster>. Si NSX-T est configuré pour utiliser NSX Federation, vérifiez que l'état inter-site est actif.
  13. Vérifiez que l'état du nœud de transport NSX Edge et de l'API est actif.
  14. Messages d'erreur de dépannage :
    • (78006) La connectivité de NSX Manager au nœud Edge doit être inactive. Sinon, le remplacement du matériel n'est pas autorisé  : assurez-vous que le nœud NSX Edge n'est pas connecté à NSX Manager.

    • (16064) La configuration du déploiement est manquante : dans l'API de redéploiement, entrez les détails de la section deployment_config.

    • (16066) Le mot de passe de connexion est manquant  : fournissez les informations d'identification de connexion.

    • (15019) Ressources insuffisantes sur le nœud à allouer au pool d'équilibreur de charge :la taille du format du nouveau nœud NSX Edge peut être inférieure au format de l'ancien nœud NSX Edge. Le nouveau format peut ne pas disposer de ressources suffisantes à allouer au pool d'équilibreur de charge.

Que faire ensuite

Si vous souhaitez mettre en place un serveur physique remplacé ou un dispositif de machine virtuelle NSX Edge déployé manuellement dans le cadre de votre réseau, assurez-vous que le nœud est déconnecté du réseau. Ensuite, exécutez del nsx pour supprimer complètement les VIB NSX-T sur le nœud. Pour plus d'informations sur del nsx, reportez-vous au Guide d'installation de NSX-T Data Center.

Après l'exécution de la commande del nsx sur l'hôte, les anciennes entrées des routeurs logiques, des adresses IP VTEP, des adresses IP de liaison montante sont publiées. Vous pouvez maintenant préparer le serveur physique remplacé en tant que nouveau nœud de transport NSX-T.