Dernière mise à jour le 14/09/2022
Objectif
Cet article a pour but de vous guider dans le processus de désactivation et d'activation du HA (High Availability) sur vos NSX Edge après une mise à jour. Après une mise à niveau, l'accès haute disponibilité sera désactivé et devra être réactivé.
Quelle que soit la méthode utilisée, assurez-vous que le HA que vous désactivez est bien le NSX Edge HA et non le cluster HA.
Prérequis
- Avoir un identifiant utilisateur actif avec les droits spécifiques pour NSX (créé dans l'espace client OVHcloud).
- Avoir déployé une NSX Edge Services Gateway
En pratique
Activation/Désactivation de HA via vSphere
Pour commencer, connectez-vous à votre environnement vSphere. Cliquez sur Menu à gauche de l'écran et sélectionnez Mise en réseau et sécurité dans le menu déroulant.
Cliquez ensuite sur Dispositifs NSX Edge dans la colonne de gauche.
Sélectionnez ensuite la Edge sur laquelle vous souhaitez désactiver le HA. Veuillez noter que si vous avez plusieurs Edge, cette option doit être désactivée pour l'ensemble d'entre eux.
Cliquez sur l'onglet Configurer en haut de la page. Sélectionnez ensuite Haute disponibilité dans la colonne de gauche.
Sélectionnez Modifier à côté de « Configuration de haute disponibilité ».
Cliquez sur le curseur à côté de « Activer » pour désactiver le HA.
Pour confirmer la désactivation du HA, cliquez sur l'onglet Configurer et sélectionnez Haute disponibilité dans la colonne de gauche.
Pour activer HA une fois la mise à jour terminée, sélectionnez à nouveau Modifier à côté de « Configuration de haute disponibilité » et cliquez sur le curseur à côté de « État HA » pour le repasser à activé.
Pour confirmer que HA est activé, cliquez sur l'onglet Configurer et sélectionnez Haute disponibilité dans la colonne de gauche.
Nous verrons ensuite comment effectuer cette même manipulation via l’API de VMware.
Activation/Désactivation de la haute disponibilité via l'API
Les URL GET/PUT ont la valeur pcc-147-x-x-x. Veillez à mettre à jour ces valeurs pour qu'elles soient celles de votre PCC.
Pour commencer, téléchargez Postman ou un autre client API REST pris en charge et installez l'application ou intégrez-la dans votre navigateur. Définissez l'authentification de base avec votre nom d'utilisateur et votre mot de passe.
Vous pouvez vous assurer que l’utilisateur a accès à NSX depuis votre espace client OVHcloud. Il s'agit du même nom d'utilisateur et du même mot de passe que ceux utilisés pour votre connexion au client web.
Ajouter un en-tête Content-Type application/xml.
Pour plus d'informations, consultez la page 14 du document suivant : [https://docs.vmware.com/en/VMware-NSX-Data-Center-for-vSphere/6.4/nsx_64_api.pdf
Pour une liste complète des utilisations de Edge, utilisez l'appel GET suivant :
- https://nsx.pcc-147-x-x-x.ovh.us/api/4.0/edges.
Reportez-vous à la page 346 du document suivant : https://docs.vmware.com/en/VMware-NSX-Data-Center-for-vSphere/6.4/nsx_64_api.pdf
Le résultat sera similaire à celui ci-dessous :
<?xml version="1.0" encoding="UTF-8"?>
<pagedEdgeList>
<edgePage>
<pagingInfo>
<pageSize>256</pageSize>
<startIndex>0</startIndex>
<totalCount>8</totalCount>
<sortOrderAscending>true</sortOrderAscending>
<sortBy>id</sortBy>
</pagingInfo>
<edgeSummary>
<objectId>edge-1</objectId>
<objectTypeName>Edge</objectTypeName>
<vsmUuid>42342BAA-1BE4-9C10-FB40-AEBBCDE3CDEE</vsmUuid>
<nodeId>dd409b86-6a10-41f3-a32e-544d06dfdfff</nodeId>
<revision>278</revision>
<type>
<typeName>Edge</typeName>
</type>
<name>Lab_Edge</name>
À partir du résultat ci-dessus, vous devez trouver le Edge
Pour vérifier l'état du HA, utilisez cet appel GET :
- https://nsx.pcc-147-x-x-x.ovh.us/api/4.0/edges/edge-1/highavailability/config.
Veuillez vous référer à la page 458 du document suivant : https://docs.vmware.com/en/VMware-NSX-Data-Center-for-vSphere/6.4/nsx_64_api.pdf
<?xml version="1.0" encoding="UTF-8"?>
<highAvailability>
<version>34</version>
<enabled>false</enabled>
<declareDeadTime>15</declareDeadTime>
<logging>
<enable>false</enable>
<logLevel>info</logLevel>
</logging>
<security>
<enabled>false</enabled>
</security>
</highAvailability>
D'après le résultat ci-dessus, le HA est false ce qui signifie qu'il est désactivé. S'il est activé, la sortie sera indiquée comme true.
Voici un exemple de résultat pour un HA activé :
<?xml version="1.0" encoding="UTF-8"?>
<highAvailability>
<version>35</version>
<enabled>true</enabled>
<declareDeadTime>6</declareDeadTime>
<logging>
<enable>false</enable>
<logLevel>info</logLevel>
</logging>
<security>
<enabled>false</enabled>
</security>
</highAvailability>
Pour désactiver le HA, il faut exécuter l'appel DELETE suivant :
- https://nsx.pcc-147-x-x-x.ovh.us/api/4.0/edges/edge-1/highavailability/config.
Assurez-vous que la commande DELETE pointe sur le bon Edge. Répétez les mêmes étapes pour chaque Edge dont vous devez désactiver le HA. La suppression de la configuration n'entraîne pas la suppression du Edge, mais uniquement de la configuration HA. C'est pourquoi il est crucial de faire pointer l'API DELETE vers la bonne URL.
Pour activer le HA, exécutez l'appel PUT suivant :
- https://nsx.pcc-147-x-x-x.ovh.us/api/4.0/edges/edge-1/highavailability/config.
Avant de cliquer sur « Send », veuillez ajouter la configuration ci-dessous au body de Postman. Sans le body ci-dessous, l'appel PUT ne parviendra pas à activer le HA.
<highAvailability>
<declareDeadTime>6</declareDeadTime>
<enabled>true</enabled>
</highAvailability>
Une fois l'appel PUT exécuté, vous pouvez utiliser l'appel GET suivant :
- https://nsx.pcc-147-x-x-x.ovh.us/api/4.0/edges/edge-1/highavailability/config pour valider l'activation du HA.
<?xml version="1.0" encoding="UTF-8"?>
<highAvailability>
<version>35</version>
<enabled>true</enabled>
<declareDeadTime>6</declareDeadTime>
<logging>
<enable>false</enable>
<logLevel>info</logLevel>
</logging>
<security>
<enabled>false</enabled>
</security>
</highAvailability>
Aller plus loin
Échangez avec notre communauté d'utilisateurs sur https://community.ovh.com/.
Cette documentation vous a-t-elle été utile ?
N’hésitez pas à nous proposer des suggestions d’amélioration afin de faire évoluer cette documentation.
Images, contenu, structure… N’hésitez pas à nous dire pourquoi afin de la faire évoluer ensemble !
Vos demandes d’assistance ne seront pas traitées par ce formulaire. Pour cela, utilisez le formulaire "Créer un ticket" .
Merci beaucoup pour votre aide ! Vos retours seront étudiés au plus vite par nos équipes..