Contenu

Objectif

Exigences

Introduction

Prérequis et précautions

Configuration

Configuration d'un contrôleur existant en mode cluster distribué via le Web

Configuration d'un mode cluster distribué pour un contrôleur nouvellement installé via des commandes

Haute disponibilité du mode cluster distribué

FAQ

Comment ajuster l'adresse IP des nœuds du cluster

Comment ajouter ou supprimer un nœud

Comment mettre à niveau le contrôleur en mode cluster.

Comment résoudre le problème si le mode cluster distribué ne fonctionne pas ?

Comment résoudre le problème si l'état du nœud est déconnecté

Objectif

Cet article présente le concept de nœuds distribués Controller. Il détaille deux méthodes de déploiement. L'une consiste à déployer des nœuds distribués via l'interface Web à l'aide d'un contrôleur existant, tandis que l'autre consiste à utiliser des commandes de terminal lors de l'installation d'un nouveau contrôleur.

Exigences

• Contrôleur logiciel Omada

Introduction

Le mode cluster distribué d'Omada Software Controller peut répondre aux exigences des clients en matière de haute disponibilité du réseau. Dans ce mode, plusieurs nœuds collaborent pour gérer les périphériques Omada. Cette approche collaborative augmente non seulement considérablement la limite supérieure du nombre de périphériques que le contrôleur peut gérer, mais garantit également, grâce au fonctionnement coordonné de plusieurs nœuds, la haute disponibilité de l'ensemble du réseau. En cas de défaillance d'un nœud, l'équilibrage automatique de la charge est déclenché et les services du nœud défaillant sont repris par d'autres nœuds. Pendant la période de basculement, les périphériques sous le site géré par le nœud défaillant d'origine sont brièvement hors ligne, puis se reconnectent automatiquement aux autres nœuds. Une fois que les périphériques reprennent l'état « Connecté », tous les services fonctionnent normalement.

Comme le montre la figure ci-dessous, il s’agit d’une topologie de déploiement de cluster distribué typique, où plusieurs nœuds (trois nœuds ou plus) peuvent gérer conjointement les périphériques Omada.

Prérequis et précautions

Avant de configurer et de déployer formellement des nœuds distribués, les suggestions et points suivants nécessitent une attention particulière.

• Le mode cluster distribué nécessite au moins trois nœuds. Préparez-vous à déployer au moins trois contrôleurs avant de le configurer.
• L'installation du mode cluster distribué nécessite Java 17. Utilisez sudo apt install openjdk-17-jre-headless pour installer Java 17.
• La modification du nombre de handles du système est une condition préalable à l'utilisation du mode cluster distribué Controller. Modifiez « /etc/security/limits.conf », ajoutez les paramètres suivants, enregistrez le fichier, déconnectez-vous et reconnectez-vous pour que les modifications prennent effet.

* fichier nosoft 65535

* nofile dur 65535

Veuillez noter que les méthodes de modification du numéro de handle peuvent varier selon la version de Linux. Veuillez modifier le numéro de handle en fonction de la version de Linux.

• Veuillez vous assurer que l'heure système de chaque nœud est cohérente, avec une différence de temps inférieure à 20 secondes
• Assurez-vous que les versions JDK et MongoDB sont cohérentes sur tous les nœuds.
• Les adresses IP des nœuds ne prennent en charge que les adresses IP statiques. Si vous devez modifier l'adresse IP/le port, vous devrez les réinitialiser. Reportez-vous à la section Comment ajuster l'adresse IP des nœuds de cluster.
• Nous vous recommandons de déployer tous les nœuds dans le même segment de réseau.

Configuration

Configuration d'un contrôleur existant en mode cluster distribué via le Web

Étape 1. Accédez à Vue globale > Paramètres > Cluster dans la vue globale et activez Cluster . Sélectionnez ensuite le mode Cluster distribué .

Étape 2. Cliquez sur Ajouter un nœud pour ajouter au moins trois nœuds. Saisissez le NOM de ces nœuds et le NOM D'HÔTE/IP DE GESTION DES NŒUDS. Ici, les adresses IP et les noms d'hôte doivent correspondre à des serveurs différents . Dans la prochaine version, nous prendrons en charge les nœuds pour gérer conjointement les périphériques utilisant la même adresse IP ou le même nom d'hôte . Cliquez ensuite sur Appliquer.

Après cela, le contrôleur affichera une fenêtre d'invite et le fichier de propriétés init . Veuillez télécharger le fichier de propriétés init. Vous devrez redémarrer le contrôleur pour que les paramètres prennent effet. Veuillez le redémarrer dès que possible pour éviter la déconnexion de l'appareil ou d'autres problèmes. Les nœuds ajoutés hors ligne seront considérés comme des nœuds en état d'arrêt, ce qui affectera la capacité de récupération après sinistre. Veuillez les initialiser dès que possible.

Étape 3. Remplacez le fichier de propriétés (téléchargement à partir de l'étape 2) sur chaque nœud respectivement. Le chemin d'accès au fichier de propriétés est : /opt/tplink/EAPController/data/cluster/omada_distributed_internal_mongo_cluster.properties

Étape 4. Exécutez la commande d'initialisation sur chaque nœud respectivement. Lors de l'initialisation des nœuds, définissez le compte et le mot de passe pour tous les nœuds. Lors de l'initialisation des nœuds, initialisez d'abord le nœud principal (celui qui exporte les propriétés d'initialisation). Sinon, l'initialisation peut échouer.

sudo omadacluster -config

/opt/tplink/EAPController/data/cluster/omada_distributed_internal_mongo_cluster.properties -nodeName init

Exemple d'impression de terminal lors de l'initialisation du nœud principal.

Exemple d'impression de terminal lors de l'initialisation de nœuds non primaires

Étape 5. Une fois le déploiement réussi, accédez à la page Cluster pour confirmer. Et lorsque le mode cluster distribué fonctionne correctement, vous pouvez accéder au contrôleur via n'importe quel nœud.

Configuration d'un mode cluster distribué pour un contrôleur nouvellement installé via des commandes

Étape 1. Sélectionnez l’installation en mode cluster (ne démarre pas automatiquement après l’installation).

• Installer en utilisant deb

echo "omadac omadac/init-cluster-mode booléen vrai" | sudo debconf-set-selections

sudo dpkg -i /chemin/vers/le/package_d'installation_du_contrôleur

• Installer en utilisant tar.gz

Après la décompression, déployez le mode cluster via le script d'installation du shell. Entrez ./install.sh init - cluster – mode , le système ne démarrera pas automatiquement après l'installation et les informations d'invite pertinentes pour la configuration du cluster seront imprimées.

Étape 2. Commencez à installer le contrôleur et modifiez le fichier de propriétés comme demandé.

Modifiez le fichier de propriétés de chaque nœud /opt/tplink/EAPController/data/cluster/omada_distributed_internal_mongo_cluster.properties

Étape 3 Exécutez la commande d’initialisation sur chaque nœud respectivement.

sudo omadacluster -config /opt/tplink/EAPController/data/cluster/omada_distributed_internal_mongo_cluster.properties -node <NomNom> init

Exemple d'impression du terminal lors de l'initialisation du nœud principal

Exemple d'impression de terminal lors de l'initialisation de nœuds non primaires

Étape 4 Une fois le déploiement réussi, connectez-vous au contrôleur et définissez le nom d'utilisateur et le mot de passe, et les autres nœuds synchroniseront le nom d'utilisateur et le mot de passe.

Accédez ensuite à la page Cluster pour confirmer. Et lorsque le mode cluster distribué fonctionne correctement, vous pouvez accéder au contrôleur via n'importe quel nœud.

Haute disponibilité du mode cluster distribué

Les caractéristiques de haute disponibilité du mode cluster distribué sont présentées dans la description suivante. Lorsque le nombre total de nœuds mixtes est de 3 à 4, 1 membre mixte peut être déconnecté ; lorsque le nombre total de nœuds mixtes est de 5 à 6, 2 membres mixtes peuvent être déconnectés ; lorsque le nombre total de nœuds mixtes est de 7, 3 membres mixtes peuvent être déconnectés. Autrement dit, le nombre de nœuds mixtes tolérants aux pannes est inférieur à la moitié du nombre maximal de nœuds mixtes.

Si le nombre de nœuds déconnectés dépasse la limite autorisée, l'ensemble du cluster ne fonctionnera pas correctement. Pour restaurer le cluster, vous devez remettre en ligne les nœuds déconnectés afin que le nombre de nœuds tolérants aux pannes soit inférieur à la moitié du nombre maximal de nœuds mixtes.

S'il est nécessaire de redémarrer le cluster, assurez-vous qu'une fois tous les nœuds arrêtés, plus de la moitié du nombre total de nœuds sont démarrés en même temps.

FAQ

Comment ajuster l'adresse IP des nœuds du cluster

Lorsque le mode cluster distribué du contrôleur est en cours d'exécution, si vous souhaitez modifier l'IP d'un nœud, vous devez suivre ces étapes :

(1)Si le statut du nœud à modifier est connecté :

a. Modifiez l'adresse IP de la carte réseau du nœud spécifié afin qu'elle lie simultanément l' ancienne et la nouvelle adresse IP.

b. Sur l’interface Cluster de n’importe quel nœud, remplacez l’IP du nœud spécifié par la nouvelle IP.

c. Sur le nœud spécifié, exécutez la commande sudo tpeap stop pour arrêter le nœud, puis modifiez la carte réseau pour lier uniquement la nouvelle IP.

d. Exécutez sudo tpeap start pour démarrer le nœud.

(2) Si l'état du nœud à modifier est déconnecté :

a. Modifiez l'adresse IP de la carte réseau du nœud spécifié afin qu'elle lie à la fois l'ancienne et la nouvelle adresse IP.

b. Sur l'interface Cluster de n'importe quel nœud en ligne, remplacez l'IP du nœud spécifié par la nouvelle IP et exportez le nouveau fichier de propriétés.

c. Transférez le fichier de propriétés vers le nœud à modifier.

d. Sur le nœud spécifié, utilisez ce fichier de propriétés pour exécuter la commande d'initialisation sudo omadacluster -config <propertiesPath> -node <nodeName> init pour l'initialisation.

Comment ajouter ou supprimer un nœud

(1)Ajouter une note

Étape 1. Ajustez le nombre de poignées sur le nouveau nœud et installez le contrôleur de la même version.

Étape 2. Configurez le nouveau nœud sur le nœud existant. Accédez à Vue globale > Paramètres > Interface de cluster, cliquez sur Ajouter un nœud. Saisissez le nom et l'adresse IP/le nom d'hôte du nouveau nœud, puis cliquez sur Appliquer .

Cliquez sur Confirmer .

Étape 3. Cliquez sur Exporter les propriétés d'initialisation , puis téléchargez le fichier et copiez-le dans le chemin /opt/tplink/EAPController/data/cluster du contrôleur sur le nœud nouvellement ajouté.

Étape 4. Ouvrez le terminal sur le nouveau nœud et exécutez la commande d’initialisation.

sudo omadacluster -config

/opt/tplink/EAPController/data/cluster/omada_distributed_internal_mongo_cluster.properties -nodeName init

Étape 5. Après avoir ajouté un nœud avec succès, accédez à la page Cluster pour confirmer. Et lorsque le mode cluster distribué fonctionne correctement, vous pouvez accéder au contrôleur via n'importe quel nœud.

(2) Supprimer le nœud

Étape 1. Accédez au nœud à supprimer et arrêtez son contrôleur.

Étape 2. Vérifiez l’état des nœuds à partir de n’importe quel nœud.

Étape 3. Lorsque l’icône de suppression apparaît sur le nœud, cliquez sur le bouton Supprimer, puis sur Appliquer .

Étape 4. Vous pouvez voir le nœud en cours de suppression à partir de n'importe quel nœud.

Comment mettre à niveau le contrôleur en mode cluster.

Le mode cluster distribué prend en charge les mises à niveau hors ligne. Avant de mettre à niveau le contrôleur, vous pouvez arrêter son exécution et installer directement le contrôleur à mettre à niveau sur chaque nœud. Dans les versions ultérieures, nous prendrons en charge les mises à niveau en ligne.

Comment résoudre le problème si le mode cluster distribué ne fonctionne pas ?

• Vérifiez si la modification du numéro de handle a réussi. Vous pouvez utiliser « ulimit -a » pour vérifier si le numéro de handle a été modifié avec succès.
• Vérifiez que les paramètres de chaque nœud sont cohérents, y compris la version du contrôleur, la version Mongodb et la version Java utilisée.
• Si les nœuds ne parviennent pas à se connecter correctement pendant une période prolongée, assurez-vous d'initialiser les nœuds en commençant par le nœud principal lors de la configuration d'un contrôleur existant en mode cluster distribué via le Web.

Comment résoudre le problème si l'état du nœud est déconnecté

Veuillez vérifier si le décalage horaire entre Vue globale > Paramètres > Paramètres système > Heure système du nœud actuel pour chaque nœud est inférieur à 20 secondes.

Pour connaître plus de détails sur chaque fonction et configuration, veuillez consulter le Centre de téléchargement pour télécharger le manuel de votre produit.