DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / Centres de Contrôle / Centre de Contrôle HFSQL
  • Présentation
  • Connexion au coordinateur
  • Démarrage du cluster
  • Démarrage automatique au boot
  • Démarrage manuel après un arrêt forcé
  • Gestion des noeuds
  • Comment gérer les noeuds ?
  • Arrêt du cluster
  • Arrêt automatique à l'extinction des serveurs
  • Arrêt manuel du cluster
  • Panne d'un ou plusieurs noeuds
  • Resynchronisation du cluster
  • Correction des problèmes potentiels signalés par le Centre de Contrôle HFSQL
  • Aucune source de synchronisation
  • Aucune adresse IP associée au nom DNS
  • Un nÅ“ud n'est pas présent dans l'enregistrement DNS du cluster
  • Une entrée de DNS ne correspond pas à un noeud
  • Le cluster n'est associé à aucun nom DNS
  • Administration des bases de données HFSQL
  • Fonctionnalités disponibles via le ruban
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Présentation
Le Centre de Contrôle HFSQL propose une gestion complète d'un cluster HFSQL.
Les opérations d'administration les plus courantes sont les suivantes :
Remarque : L'ajout et la suppression de noeuds dans un cluster HFSQL sont décrits dans la page Installation et configuration de HFSQL Cluster.
Attention :
L'utilisation de HFSQL Cluster nécessite l'usage d'un pack d'installation spécifique.
Ce pack est disponible gratuitement en téléchargement sur le site de PC SOFT, dans l'espace de téléchargement des modules communs à la version 2024.
Connexion au coordinateur
Pour se connecter au coordinateur via le Centre de Contrôle HFSQL :
  1. Lancez le Centre de Contrôle HFSQL.
  2. Dans la fenêtre de bienvenue, cliquez sur l'option "Se connecter à un cluster HFSQL".
  3. Dans la partie "Nouvelle connexion", saisissez :
    • l'adresse du coordinateur.
    • le mot de passe d'administration du cluster (optionnel). Ce mot de passe a été choisi lors de l'installation du cluster.
      • Pour administrer les noeuds du cluster, ce mot de passe doit être indiqué.
      • Pour administrer les bases de données du cluster, ce mot de passe n'est pas nécessaire.
  4. Validez. Les caractéristiques du cluster apparaissent dans le Centre de Contrôle HFSQL.
Remarques :
  • L'option "Se connecter à un cluster HFSQL" doit être utilisée pour l'administration des bases de données. Les bases de données du cluster s'administrent de la même façon que des bases de données HFSQL Client/Serveur.
  • Si le Centre de Contrôle HFSQL est déjà lancé, il est possible d'utiliser le menu déroulant pour se connecter à un cluster :
Démarrage du cluster

Démarrage automatique au boot

Le démarrage du cluster HFSQL se fait de façon automatique lors du démarrage (boot) des différents serveurs composant le cluster.
Le démarrage du cluster se fait dans l'ordre suivant :
  1. Démarrage du service du coordinateur (service ClusterManager).
  2. Démarrage des serveurs HFSQL des différents noeuds.
  3. Connexion des noeuds au coordinateur.
  4. Vérification de la synchronisation de toutes les bases de données.
    En cas de désynchronisation, une synchronisation est lancée sur les noeuds dont la base n'est pas à jour. Si aucun noeud ne possède de façon certaine une base de données à jour (par exemple dans les cas où le cluster a été arrêté par une coupure de courant générale), il sera nécessaire de choisir manuellement le noeud qui servira de source de données pour la synchronisation. Pour connaître le détail de cette procédure, consultez Resynchronisation du cluster.
  5. Le cluster est disponible pour traiter les demandes de connexions des applications clientes.

Démarrage manuel après un arrêt forcé

Si le cluster a été arrêté volontairement en utilisant le Centre de Contrôle HFSQL (option "Arrêter le cluster") ou à l'aide de la fonction HClusterArrête, il est possible de le redémarrer avec le bouton "Démarrer le cluster" du Centre de Contrôle HFSQL ou grâce à la fonction HClusterDémarre.
Gestion des noeuds

Comment gérer les noeuds ?

Lors de l'affichage des caractéristiques du cluster HFSQL dans le Centre de Contrôle HFSQL, la partie "Administration des noeuds" permet de visualiser les différents noeuds du cluster HFSQL et de voir leur état.
Il est possible de :
  • Accéder au noeud sélectionné. Dans ce cas, il est nécessaire que le noeud soit actif. Vous devez alors préciser le nom d'utilisateur et le mot de passe associé.
  • Réintégrer le noeud sélectionné. Cette option permet par exemple de réintégrer un noeud en attente d'ajout.
  • Exclure le noeud.
Rappel :
  • Pour ajouter un nouveau noeud au cluster HFSQL, il est nécessaire d'installer un serveur HFSQL version Cluster sur la machine cible. Lorsque l'installation est terminée, le noeud apparaît automatiquement dans la liste des noeuds du cluster.
  • Pour supprimer un noeud du cluster HFSQL, il est nécessaire de désinstaller le serveur HFSQL version Cluster sur la machine cible.
Arrêt du cluster

Arrêt automatique à l'extinction des serveurs

Lorsqu'un serveur abritant un noeud d'un cluster HFSQL est éteint, le noeud est automatiquement exclu du cluster. Sa base de données sera resynchronisée automatiquement lorsque le serveur sera remis en fonctionnement.
Attention : L'arrêt du service ClusterManager n'arrête pas le cluster.

Arrêt manuel du cluster

Le cluster peut être arrêté manuellement à l'aide du Centre de Contrôle HFSQL en utilisant le bouton "Arrêter le cluster" présent dans le groupe "Cluster" de l'onglet d'administration du cluster.
Son redémarrage pourra être effectué comme indiqué dans Démarrage du cluster
Panne d'un ou plusieurs noeuds
Lorsqu'un ou plusieurs noeuds d'un cluster HFSQL tombent en panne (défaillance de la machine, du système d'exploitation ou coupure du réseau), plusieurs cas peuvent se présenter.
Le tableau ci-dessous récapitule les différents cas de figure pour un cluster de N noeuds dont n sont actifs :
Nombre de nœuds
actifs (= n)
Effet
n > N/2Plus de la moitié des noeuds est active : le cluster fonctionne normalement.
n = N/2Exactement la moitié des noeuds est active : le cluster fonctionne normalement si le coordinateur est également actif, sinon le cluster s'arrête.
n < N/2Moins de la moitié des noeuds est active : le cluster s'arrête.

Cette règle de fonctionnement évite que le cluster ne se trouve scindé en deux morceaux (phénomène de "split-brain") à la suite d'une coupure réseau et que chaque morceau continue de fonctionner indépendamment et désynchronise les bases. Seule la portion contenant plus de la moitié des noeuds restera active. Dans le cas particulier où le cluster se trouverait coupé en deux segments de même taille, la présence du coordinateur permet de départager les groupes.
Resynchronisation du cluster
Lorsque le cluster est démarré ou lorsqu'un noeud est ajouté, une synchronisation des bases de données est effectuée.
Deux cas peuvent se présenter :
  • Le cluster est démarré et les noeuds actifs ont une base de données synchrone.
    Le nouveau noeud se synchronise alors automatiquement avec l'état en cours du reste du cluster. Aucune action n'est à entreprendre. Dès que le nouveau noeud est synchronisé, il rejoint le cluster et traite les demandes de connexion des applications clientes.
  • Le cluster est arrêté et aucun noeud ne possède de façon certaine la version la plus à jour de la base de données.
    Ce cas se produit généralement à la suite d'une panne générale (coupure de courant, coupure réseau, etc.). Le cluster ne peut pas redémarrer automatiquement dans ce cas là. Il est nécessaire d'utiliser le Centre de Contrôle HFSQL pour sélectionner l'un des noeuds comme source de synchronisation. Sa base servira alors de référence et les autres noeuds se synchroniseront par rapport à lui.
    Remarque : Il convient de choisir le noeud de référence avec précaution. En effet, les bases de données des autres noeuds seront écrasées par la base de données du noeud de référence.
Remarque : Lors d'une synchronisation, une jauge permettant de suivre l'état d'avancement de la synchronisation est affichée dans le Centre de Contrôle HFSQL (par exemple, dans le tableau d'administration des noeuds, colonne "Etat"). Il est également possible de suivre l'état d'avancement de la synchronisation grâce à la fonction HClusterInfoSynchronisation. La fonction HClusterInfoErreurSynchronisation permet de connaître la dernière erreur de synchronisation.
Correction des problèmes potentiels signalés par le Centre de Contrôle HFSQL
Le Centre de Contrôle HFSQL peut signaler un certain nombre de problèmes concernant l'état d'un cluster HFSQL et en corriger automatiquement une partie. Voici la liste des problèmes possibles :

Aucune source de synchronisation

ProblèmeEn attente d'une source de synchronisation.
CauseAucun des noeuds du cluster ne possède de base pour une synchronisation automatique.
RésolutionChoisir un noeud de référence pour la synchronisation.
Consultez le paragraphe Resynchronisation du cluster.

Aucune adresse IP associée au nom DNS

ProblèmeAucune adresse IP n'est associée au nom DNS <nom DNS> du cluster <nom du cluster>.
CauseAucune entrée de DNS ne correspond au nom DNS choisi pour le cluster. Les postes clients ne peuvent pas se connecter aux bases de données du cluster.
RésolutionAjouter une entrée de DNS pour l'IP de chaque noeud du cluster correspondant au nom DNS choisi pour le cluster. Cette opération peut être faite automatiquement depuis le Centre de Contrôle HFSQL.

Un nœud n'est pas présent dans l'enregistrement DNS du cluster

ProblèmeUn noeud du cluster est installé sur la machine <nom de machine> alors que son adresse IP (<adresse IP>) n'est pas associée au nom DNS du cluster (<nom DNS>).
CauseL'un des noeuds du cluster n'est pas référencé dans le DNS sous le nom DNS choisi pour le cluster. Ce noeud ne sera jamais sollicité par les applications clientes.
RésolutionAjouter une entrée de DNS pour l'IP du noeud correspondant au nom DNS choisi pour le cluster. Cette opération peut être faite automatiquement depuis le Centre de Contrôle HFSQL.

Une entrée de DNS ne correspond pas à un noeud

ProblèmeLa machine <nom de machine> (adresse IP <adresse IP>) est associée au nom DNS du cluster (<nom DNS>) alors qu'elle ne correspond pas à un noeud de ce cluster.
CauseL'enregistrement DNS du nom du cluster contient une adresse IP qui ne correspond pas à un noeud. Si une application cliente tente de se connecter à cette adresse, elle ne recevra pas de réponse et la durée de connexion sera rallongée.
RésolutionSupprimer l'entrée de DNS en trop. Cette opération peut être faite automatiquement depuis le Centre de Contrôle HFSQL.

Le cluster n'est associé à aucun nom DNS

ProblèmeAucun nom DNS n'a été saisi pour le cluster.
CauseLes applications clientes ne peuvent pas se connecter au cluster.
RésolutionChoisir un nom DNS pour le cluster et y associer toutes les IP des différents noeuds. Cette opération peut être faite automatiquement depuis le Centre de Contrôle HFSQL.
Administration des bases de données HFSQL
L'administration des bases de données d'un cluster HFSQL se fait de la même façon que celle d'un serveur HFSQL autonome. Il est nécessaire de se connecter à la base de données depuis le Centre de Contrôle HFSQL.
Si la connexion à la base de données depuis le Centre de Contrôle HFSQL se fait en utilisant le nom DNS du cluster, cette connexion utilise un noeud quelconque du cluster (selon l'algorithme de répartition de charge).
Si la connexion à la base de données se fait en utilisant explicitement le nom d'un noeud (en outrepassant l'algorithme de répartition de charge), c'est la base de ce noeud qui est vue. Il est dans ce cas possible de voir la liste des utilisateurs connectés au noeud.
Remarques
  • Quelle que soit la méthode de connexion employée, les données vues sont strictement les mêmes du fait du mécanisme de réplication du cluster.
  • Si le cluster est en attente de synchronisation, il n'est pas possible de se connecter à la base de données.
  • Si un noeud est en cours de resynchronisation, il n'est pas possible de se connecter à la base de données de ce noeud.
Fonctionnalités disponibles via le ruban
Le ruban affiché par le Centre de Contrôle pour un noeud du cluster permet d'effectuer diverses opérations :
  • Arrêt et démarrage du cluster.
  • Connexion au cluster.
  • Création d'une nouvelle base de données : Crée une base de données vide sur les différents noeuds du cluster.
  • Nouveauté 2024
    Importation d'une base de données HFSQL Classic : Importe les différents fichiers de données HFSQL Classic sur les différents noeuds du cluster.
    Remarque : Cette fonctionnalité est disponible uniquement si le cluster utilise la version 2024 Update 1.
  • Nouvelle sauvegarde : Permet de réaliser une sauvegarde.
  • Gestion des droits : Permet de gérer les droits sur le noeud.
  • Configuration du cluster : Permet de configurer le serveur (seules les fonctionnalités nécessaires sont disponibles).
Version minimum requise
  • Version 15
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 31/01/2024

Signaler une erreur ou faire une suggestion | Aide en ligne locale