Documentation > Guide de l'administrateur
Rappel. Techniquement, pour définir un data broker, il vous faut :
- Un nom logique,
- Une adresse IP,
- Un numéro de port du serveur de base de données,
- Un identifiant de base de données et son mot de passe,
- Une base de données, créée dans le serveur de base de données précédent,
Vous lui attribuerez également le datacenter et le rack dans lequel il se trouve.
Si vous exécutez un environnement de virtualisation, vous pouvez décider que chaque data broker sera hébergé sur sa machine logique dédiée.
Si vous utilisez des machines physiques, vous pouvez héberger plusieurs databrokers sur le même hôte. Ces data brokers partageront la même adresse IP, le même port de base de données et auront leur propre nom logique et, plus globalement, leur propre base de données
Quel que soit votre choix, la première chose à faire est de créer le data broker. Dans un environnement virtualisé, créez la machine logique, installez le serveur de base de données, ouvrez le port de la base de données dans le pare-feu et créez l'utilisateur et une base de données dédiée. Dans un environnement partagé, créez simplement une nouvelle base de données et choisissez un nom.
Une fois créé, il vous suffit de déclarer votre nouveau data broker en utilisant la requête suivante :
create databroker Nom IP Port Utilisateur MotDePasse NomDeLaDatabase Datacenter Rack ;
- Vous avez besoin d'un compte administrateur pour créer un data broker.
- Vous ne pouvez pas créer de data broker si vous avez atteint votre limite de licence.
- Le nom d'un data broker est soumis à l'expression rationnelle ^[a-z][a-z0-9_]*$ et est limité à 31 caractères.
- Le nom d'utilisateur est soumis à la même restriction.
- Les mots de passe des utilisateurs sont cryptés avant d'être stockés dans les dictionnaires des master brokers.
- Immédiatement après la création, le nouveau data broker est candidat pour héberger de nouveaux segments de table. Mais si la configuration de votre réseau n'est pas correcte, certains synsql brokers peuvent ne pas parvenir à connecter le nouveau data broker. Dans un tel cas, le nouveau data broker serait immédiatement considéré comme en panne. A vous de vous assurer que tous les serveurs Synsql peuvent connecter le nouveau data broker.
Vous supprimez un data broker à l'aide de la requête suivante :
drop databroker NomDuDataBroker ;
- Vous avez besoin d'un compte administrateur pour supprimer un data broker.
- Vous devez verrouiller le cluster avant de supprimer un data broker.
- Vous ne pouvez pas supprimer un data broker s'il contient des segments. Il n'y a pas de clause "cascade" pour supprimer les tables concernées.
- La suppression d'un data broker n'a aucun effet ni sur la base de données ni sur le serveur Linux qui la porte. Seule la définition du data broker est effacée du dictionnaire des données. La suppression de la base de données sous-jacente et le décomissionnement du serveur Linux sont à la charge de l'administrateur.
Rappel. Pour définir un master broker, vous avez besoin de :
- Un nom d'hôte. Tous les synsql brokers du cluster doivent être capables de le résoudre (obtenir son IP).
- Un port du serveur de base de données.
- Un utilisateur de la base de données et son mot de passe,
- La base de données pour stocker le dictionnaire SynSql.
Avant de déclarer le nouveau master broker, vous devez créer/installer le nouveau serveur, installer le service de base de données de votre choix, créer l'utilisateur de la base de données et définir sa base de données. Vous devez également régler la configuration de votre réseau pour vous assurer que tous les serveurs Synsql peuvent se connecter au nouveau master broker.
Une fois créé, le nouveau master broker peut être déclaré à l'aide de la requête suivante :
créer le master broker NAME [ en utilisant Dir_Name ]
Pour initialiser le nouveau master broker, le serveur auquel vous êtes connecté exportera une base de données de master broker existante et l'importera sur le nouveau master broker. Sans la clause facultative, le fichier d'export sera créé dans le répertoire /tmp. Avec la clause, le serveur essaiera d'utiliser Dir_Name.
Après l'importation, le fichier dump restera dans le répertoire temporaire, à des fins de débogage. C'est votre devoir de le supprimer lorsqu'il devient inutile.
Une fois le nouveau master broker initialisé, il connectera tous les autres serveurs Synsql du cluster pour leur indiquer le nouveau master broker. Chacun d'eux l'enregistrera dans son fichier de configuration. Pour cette raison, tous les serveurs synsql déclarés dans le cluster doivent être opérationnels pour créer un nouveau master broker.
- Vous avez besoin d'un compte administrateur pour créer un master broker.
- Vous devez verrouiller le cluster avant de créer un master broker.
- Le nom d'un master broker est soumis à l'expression rationnelle ^[a-z][a-z0-9_]*$ et est limité à 31 caractères.
Vous supprimez un master broker à l'aide de la requête suivante :
drop nom du master broker ;
La suppression est immédiate. Notez que la base de données sous-jacente n'est pas affectée par la suppression. Le master broker est simplement effacé du répertoire SynSql. La suppression de la base de données elle-même est de votre devoir.
- Vous avez besoin d'un compte administrateur pour supprimer un master broker.
- Vous devez verrouiller le cluster avant de supprimer un master broker.
- Vous ne pouvez pas supprimer votre dernier master broker.
Remarque : les synsql brokers ne sont pas enregistrés dans le dictionnaire des données. Leur définition n'a de sens que dans les fichiers de configuration. Les commandes de création et supression de synsql brokers automatisent la gestion de ces fichiers.
Pour créer un synsql broker, suivez ces instructions :
- Créez/installez d'abord le serveur Linux qui hébergera votre synsql broker.
- Vérifiez les règles de connectivité et de pare-feu. Le nouveau serveur doit pouvoir se connecter à tous les master brokers et à tous les data broker sur leurs propres ports de base de données. Il doit également pouvoir connecter tous les synsql brokers existants sur leurs propres ports et cela doit être réciproque.
- Créer l'utilisateur dédié (idéalement synsql dans /home/synsql)
- Créez des répertoires : bin, etc. Faites-le en utilisant scp -rp sur un synsql broker existant.
- Modifiez le fichier etc/SynSql.conf pour ajouter une ligne pour le nouveau synsql broker.
- Démarrez tous les synsql brokers du cluster.
- Sur l'un des synsql brokers existants, exécutez la requete suivante :
create synsqlbroker NomDuBroker Port Répertoire;
En réponse à cette instruction, chacun des synsql brokers existants va ajouter le nouveau broker à son fichier de configuration. Il va aussi mettre à jour sa liste en mémoire des synsql broker en lui ajoutant le nouveau broker.
Vous pouvez alors lancer le nouveau synsql broker. Tous les autres synsql brokers du cluster sont au courant de son existance et donc, il peut rejoindre le cluster.
Pour supprimer un synsql broker d'un cluster :
- Arrêter le service synsql sur la machine virtuelle/le serveur concerné
- Supprimer le déploiement SynSql sur la machine virtuelle : supprimer l'utilisateur Synsql et ses fichiers.
- Lancez tous les autres synsql brokers du cluster.
- Sur l'un de ces serveurs, exécutez la requête suivante :
drop synsqlbroker NomDuBroker;
- En réponse à cette instruction, chacun des synsql brokers existants va supprimer le broker concerné de son fichier de configuration. Il va aussi mettre à jour sa liste en mémoire des synsql brokers et en supprimer le broker concerné.
Chaque synsql server produit un fichier log où il consigne ses opérations. Les informations seront plus ou moins détaillées, en fonction du niveau que vous aurez sélectionné. Les différents niveaux sont les suivants :
- Basic : Le serveur consigne uniquement les informations de base. C'est le mode par défaut et c'est aussi le mode recommandé.
- Error : Le serveur consigne aussi les messages d'erreur interne. Par exemple une erreur d'allocation de mémoire. Il peut être utilisé pour valider qu'un fonctionnement anormal du serveur s'accompagne d'une erreur interne.
- Warning : Le serveur consigne en plus les messages d'avertissement.
- Info : Le serveur consigne les éléments qu'ils prend en compte pour exécuter ses instructions.
- Debug : le niveau de log est maximal. Il ne faut l'utiliser que de façon temporaire, le temps de reproduire une anomalie.
Vous pouvez contrôler le niveau de log de deux façons :
- De façon statique, via le paramètre LOG_LEVEL dans le fichier de configuration de chaque serveur.
- Dynamiquement via la commande alter server set log level ... Si le serveur redémarre il repart dans le mode précisé dans son fichier de configuration ou en mode Basic si le paramètre n'est pas renseigné.
Pour afficher le niveau de log du serveur auquel un client est connecté, on peut utiliser la commande show server;
<< Arrêt et relance des services - Gestion des utilisateurs >>
| 15 Jan 2026 07:16:39 | English version |