PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • Présentation
  • Connexion au coordinateur
  • Démarrage du cluster
  • Démarrage automatique au boot
  • Démarrage manuel après un arrêt forcé
  • Arrêt du cluster
  • Arrêt automatique à l'extinction des serveurs
  • Arrêt manuel du cluster
  • Panne d'un ou plusieurs nœuds
  • 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
Produits
WinDevWebDev - Code ServeurWebDev - Code NavigateurWinDev MobileEtats et Requêtes
Plateformes
WindowsLinuxWindows MobileUniversal Windows 10 AppAndroidWidget AndroidiPhone/iPadApple Watch
Langages
JavaPHPAjaxCode Utilisateur (MCU)Langage Externe
Bases de données
HFSQLHFSQL Client/ServeurProcédures stockéesOLE DBODBCAccès Natifs
Présentation
L'administration d'un cluster HFSQL est réalisée essentiellement en utilisant le Centre de Contrôle 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 sur demande, pour tout détenteur de licence commerciale en version 21.
Pour obtenir ce pack, effectuez la demande en envoyant un message au Support Technique Gratuit (via l'option "? .. Requête au support technique" de votre éditeur WINDEV, WEBDEV ou WINDEV Mobile). Pour obtenir ce pack, effectuez la demande en envoyant un message au Support Technique Gratuit depuis WINDEV, WEBDEV ou WINDEV Mobile : sous le volet "Accueil", dans le groupe "Aide en ligne", déroulez "Aide" et sélectionnez "Requête au support technique".
Remarque : A partir de la version 19, HFSQL est le nouveau nom de HyperFileSQL.
Connexion au coordinateur
Pour se connecter au coordinateur via le Centre de Contrôle HFSQL :
  1. Lancez le Centre de Contrôle HFSQL (si ce n'est déjà fait).
  2. Cliquez sur le bouton de recherche de serveur ou de cluster :
    Connexion à un serveur ou un cluster HFSQL
  3. Dans la partie "Connexion à un cluster HFSQL", 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.
        Connexion à un cluster HFSQL
Remarque : Le bouton "Se connecter à ce cluster HFSQL" doit être utilisé 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.
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é 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 ou à l'aide de la fonction HClusterArrête, il est possible de le redémarrer avec le bouton "Démarrer" du Centre de Contrôle HFSQL ou grâce à la fonction HClusterDémarre.
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êté" présent dans l'interface d'administration.
Son redémarrage pourra être effectué comme indiqué dans Démarrage du cluster
Panne d'un ou plusieurs nœuds
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 nœuds est active : le cluster fonctionne normalement.
n = N/2Exactement la moitié des nœuds 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 nœuds 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.
Versions 21 et supérieures
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.
Nouveauté 21
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.
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.
Version minimum requise
  • Version 15
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire