Documentation > Guide de l'administrateur
Ne tentez pas d'installer un poste client tant que vous n'avez pas validé que votre cluster est opérationnel.
SynSql est fourni avec un client python et un client écrit en C, compilé. Les deux fonctionnent sous Linux. Le client python fonctionne aussi sous Windows.
Tout synsql broker est un poste client en soit et peut être utilisé en tant que tel.
Nous supposons que le poste client possède une distribution Linux et que vous pouvez y connecter une session root. La configuration du poste client dans le réseau du cluster est elle aussi un prérequis
Pour l'illustration du mode opératoire, nous supposons que le compte Linux qui doit devenir client se nomme lambda.
Si l'utilisateur lambda n'existe pas, créez le :
# adduser lambda
La commande précédente vous permet de créer l'utilisateur, son répertoire domicile et de lui définir un mot de passe.
Dans le répertoire domicile de l'utilisateur, créer les repertoires bin et etc
# cd /home/lambda # mkdir bin etc
Dans le répertoire bin de l'utilisateur copiez les programmes clients à partir d'un synsql broker.
# cd /home/lambda/bin # scp synsql@synbroker1:/home/synsql/bin/synsql . # scp synsql@synbroker1:/home/synsql/bin/synsql.py . # chown lambda:lambda /home/lambda/bin/synsql*
Dans l'exemple ci-dessus, le synsql broker qui sert de modèle se nomme synbroker1 et la distribution est portée par l'utilisateur synsql dans le répertoire domicile classique : /home/synsql
Dans le répertoire etc de l'utilisateur, copiez le fichier de configuration du cluster à partir du même synsql broker.
# cd /home/lambda/etc # scp synsql@synbroker1:/home/synsql/etc/synsql.conf . # chown lambda:lambda /home/lambda/bin/synsql.conf
Le fichier de configuration du cluster contient plus de référence que ce dont le client a besoin. Vous pouvez l'éditer et supprimer les lignes commençant par CLUSTER_UUID ou MASTER_BROKER
Si ce n'est déjà fait, installez le framework python de votre choix.
Dans l'espace de travail de votre framework, créez un répertoire synsql. Utilisez un client scp pour y créer une copie du fichier synsql.py. Vous pouvez aussi bien copier le contenu de ce fichier depuis un terminal Linux connecté à un SynSql broker et le coller dans l'éditeur de texte de votre framework.
Dans le répertoire raçine de votre utilisateur Windows, créez une copie du fichier synsql.conf de l'un de vos SynSql brokers. Le fichier de configuration contient plus d'information que nécessaire au client. Vous pouvez supprimer toutes les lignes commençant par CLUSTER_UUID ou MASTER_BROKER.
Utilisez les programmes client pour tester la connexion au cluster.
Le client C utilise les bibliothèques standard et ne doit pas vous poser de difficulté.
Le client python utilise Python 3. A vous de l'installer s'il le faut.
Si le programme client parvient à se connecter à un SynSql broker mais s'il échoue dans l'exécution des requêtes select ou insert, vérifiez la configuration du firewall du broker. Vous devez autoriser l'accès au port du serveur ainsi qu'aux 1024 ports suivants.
Les programmes clients SynSql utilisent par défaut le fichier de configuration etc/synsql.conf. Il n'y a pas d'option pour cibler un autre fichier.
Si vous souhaitez utiliser plusieurs clusters à partir du même poste client, vous avez deux possibilités.
Soit vous configurez deux comptes : lambdadev et lambdaprod. Chacun de ces comptes étant dédié à un cluster.
Soit vous ne voulez utiliser qu'un seul compte. Dans ce cas, vous devez stocker dans le repertoire etc un fichier de configuration pour chacun de vos clusters : synsql.dev, synsql.prod et gérer le fichier synsql.conf pour qu'au moment ou vous lancez un programme client, la configuration pointe le cluster de votre choix.
<< Créer un cluster de production - Arrêt et relance des services >>
| 15 Jan 2026 07:10:16 | English version |