Dans le billet de blog précédent, nous avons couvert quelques introductions à l'installation, à la mise à niveau et au déploiement de MaxScale à l'aide du client de ligne de commande MaxCtrl. Dans cet article de blog, nous allons couvrir les aspects de gestion MaxScale pour notre cluster MariaDB.
Il existe un certain nombre de composants MaxScale que nous pouvons gérer avec MaxCtrl, à savoir :
- Gestion du serveur
- Gestion des services
- Gestion des moniteurs
- Gestion des auditeurs
- Gestion des filtres
- Gestion MaxScale
- Gestion des journaux
Dans cet article de blog, nous allons couvrir les 4 premiers composants couramment utilisés dans MariaDB Cluster. Toutes les commandes de ce billet de blog sont basées sur MaxScale 2.4.11.
Gestion du serveur
Répertorier/Afficher les serveurs
Listez un résumé de tous les serveurs dans MaxScale :
maxctrl: list servers
┌────────────────┬────────────────┬──────┬─────────────┬─────────────────────────┬─────────────┐
│ Server │ Address │ Port │ Connections │ State │ GTID │
├────────────────┼────────────────┼──────┼─────────────┼─────────────────────────┼─────────────┤
│ mariadbgalera1 │ 192.168.10.201 │ 3306 │ 0 │ Slave, Synced, Running │ 100-100-203 │
├────────────────┼────────────────┼──────┼─────────────┼─────────────────────────┼─────────────┤
│ mariadbgalera2 │ 192.168.10.202 │ 3306 │ 0 │ Slave, Synced, Running │ 100-100-203 │
├────────────────┼────────────────┼──────┼─────────────┼─────────────────────────┼─────────────┤
│ mariadbgalera3 │ 192.168.10.203 │ 3306 │ 0 │ Master, Synced, Running │ 100-100-203 │
└────────────────┴────────────────┴──────┴─────────────┴─────────────────────────┴─────────────┘Pour le cluster MariaDB, la liste des serveurs résume l'état du nœud et du cluster, avec son MariaDB GTID, uniquement si le cluster est configuré pour se répliquer à partir d'un autre cluster via la réplication MariaDB standard. L'état est utilisé par MaxScale pour contrôler le comportement de l'algorithme de routage :
- Maître :pour un cluster, il s'agit du maître d'écriture.
- Esclave :si tous les esclaves sont en panne, mais que le maître est toujours disponible, le routeur utilisera le maître.
- Synchronisé :un nœud de cluster qui est dans un état synchronisé avec le cluster.
- Running - Un serveur qui est opérationnel. Tous les serveurs auxquels MariaDB MaxScale peut se connecter sont marqués comme étant en cours d'exécution.
Bien que MariaDB Cluster soit capable de gérer la réplication multi-maître, MaxScale choisira toujours un nœud pour détenir le rôle de maître qui recevra toutes les écritures pour le routage readwritesplit. Par défaut, Galera Monitor choisira le nœud avec la valeur wsrep_local_index la plus basse comme maître. Cela signifie que deux MaxScales exécutés sur des serveurs différents choisiront le même serveur comme maître.
Afficher tous les serveurs plus en détail :
maxctrl: show serversCréer des serveurs
C'est généralement la première chose à faire lors de la configuration de MaxScale en tant qu'équilibreur de charge. Il est courant d'ajouter tous les nœuds du cluster MariaDB dans MaxScale et de l'étiqueter avec un nom d'objet. Dans cet exemple, nous étiquetons les nœuds Galera au format "mariadbgalera#" :
maxctrl: create server mariadbgalera1 192.168.0.221 3306
maxctrl: create server mariadbgalera2 192.168.0.222 3306
maxctrl: create server mariadbgalera3 192.168.0.222 3306L'état du serveur ne sera signalé correctement qu'après avoir activé le module de surveillance, comme indiqué dans la section Gestion du moniteur plus bas.
Supprimer un serveur
Pour supprimer un serveur, il faut au préalable dissocier le serveur de tout service ou moniteur. Par exemple, dans la liste de serveurs suivante, nous voudrions supprimer mariadbgalera3 de MaxScale :
maxctrl: list servers
┌────────────────┬────────────────┬──────┬─────────────┬─────────────────────────┬─────────────┐
│ Server │ Address │ Port │ Connections │ State │ GTID │
├────────────────┼────────────────┼──────┼─────────────┼─────────────────────────┼─────────────┤
│ mariadbgalera1 │ 192.168.10.201 │ 3306 │ 0 │ Slave, Synced, Running │ 100-100-203 │
├────────────────┼────────────────┼──────┼─────────────┼─────────────────────────┼─────────────┤
│ mariadbgalera2 │ 192.168.10.202 │ 3306 │ 0 │ Slave, Synced, Running │ 100-100-203 │
├────────────────┼────────────────┼──────┼─────────────┼─────────────────────────┼─────────────┤
│ mariadbgalera3 │ 192.168.10.203 │ 3306 │ 0 │ Master, Synced, Running │ 100-100-203 │
└────────────────┴────────────────┴──────┴─────────────┴─────────────────────────┴─────────────┘Répertorier tous les moniteurs et voir si le serveur fait partie d'un module de moniteur :
maxctrl: list monitors
┌─────────────────┬─────────┬────────────────────────────────────────────────┐
│ Monitor │ State │ Servers │
├─────────────────┼─────────┼────────────────────────────────────────────────┤
│ MariaDB-Monitor │ Running │ mariadbgalera1, mariadbgalera2, mariadbgalera3 │
└─────────────────┴─────────┴────────────────────────────────────────────────┘Il semble que mariadbgalera3 fasse partie de MariaDB-Monitor, nous devons donc d'abord le supprimer en utilisant la commande "unlink monitor":
maxctrl: unlink monitor MariaDB-Monitor mariadbgalera3
OKEnsuite, répertoriez tous les services pour vérifier si le serveur correspondant fait partie d'un service MaxScale :
maxctrl: list services
┌─────────────────────┬────────────────┬─────────────┬───────────────────┬────────────────────────────────────────────────┐
│ Service │ Router │ Connections │ Total Connections │ Servers │
├─────────────────────┼────────────────┼─────────────┼───────────────────┼────────────────────────────────────────────────┤
│ Read-Write-Service │ readwritesplit │ 1 │ 1 │ mariadbgalera1, mariadbgalera2, mariadbgalera3 │
├─────────────────────┼────────────────┼─────────────┼───────────────────┼────────────────────────────────────────────────┤
│ Round-Robin-Service │ readconnroute │ 1 │ 1 │ mariadbgalera1, mariadbgalera2, mariadbgalera3 │
├─────────────────────┼────────────────┼─────────────┼───────────────────┼────────────────────────────────────────────────┤
│ Replication-Service │ binlogrouter │ 1 │ 1 │ │
└─────────────────────┴────────────────┴─────────────┴───────────────────┴────────────────────────────────────────────────┘Comme vous pouvez le voir, mariadbgalera3 fait partie du service de lecture-écriture et du service Round-Robin. Supprimez le serveur de ces services à l'aide de la commande "unlink service" :
maxctrl: unlink service Read-Write-Service mariadbgalera3
OK
maxctrl: unlink service Round-Robin-Service mariadbgalera3
OKEnfin, nous pouvons supprimer le serveur de MaxScale en utilisant la commande "destroy server" :
maxctrl: destroy server mariadbgalera3
OKVérifiez à l'aide des "serveurs de liste" que nous avons supprimé mariadbgalera3 de MaxScale. :
maxctrl: list servers
┌────────────────┬────────────────┬──────┬─────────────┬─────────────────────────┬──────┐
│ Server │ Address │ Port │ Connections │ State │ GTID │
├────────────────┼────────────────┼──────┼─────────────┼─────────────────────────┼──────┤
│ mariadbgalera1 │ 192.168.10.201 │ 3306 │ 0 │ Master, Synced, Running │ │
├────────────────┼────────────────┼──────┼─────────────┼─────────────────────────┼──────┤
│ mariadbgalera2 │ 192.168.10.202 │ 3306 │ 0 │ Slave, Synced, Running │ │
└────────────────┴────────────────┴──────┴─────────────┴─────────────────────────┴──────┘Modifier les paramètres du serveur
Pour modifier un paramètre d'un serveur, on peut utiliser la commande "alter server" qui ne prend qu'un seul paramètre clé/valeur à la fois. Par exemple :
maxctrl: alter server mariadbgalera3 priority 10
OKUtilisez la commande "show server" et consultez la section Paramètres pour obtenir une liste des paramètres pouvant être modifiés pour l'objet "serveur" :
maxctrl: show server mariadbgalera3
...
│ Parameters │ { │
│ │ "address": "192.168.10.203", │
│ │ "protocol": "mariadbbackend", │
│ │ "port": 3306, │
│ │ "extra_port": 0, │
│ │ "authenticator": null, │
│ │ "monitoruser": null, │
│ │ "monitorpw": null, │
│ │ "persistpoolmax": 0, │
│ │ "persistmaxtime": 0, │
│ │ "proxy_protocol": false, │
│ │ "ssl": "false", │
│ │ "ssl_cert": null, │
│ │ "ssl_key": null, │
│ │ "ssl_ca_cert": null, │
│ │ "ssl_version": "MAX", │
│ │ "ssl_cert_verify_depth": 9, │
│ │ "ssl_verify_peer_certificate": false, │
│ │ "disk_space_threshold": null, │
│ │ "priority": "10" │
│ │ }Notez que l'effet de la commande alter est immédiat et que la valeur du paramètre dans le runtime sera modifiée ainsi que la valeur dans son fichier de configuration MaxScale individuel dans /var/lib/maxscale/maxscale.cnf.d/ pour la persistance au redémarrage.
Définir l'état du serveur
MaxScale permet d'exclure temporairement les serveurs backend Galera de l'ensemble d'équilibrage de charge en activant le mode maintenance. Nous pouvons y parvenir en utilisant la commande "set server":
maxctrl: set server mariadbgalera3 maintenance
OKEn regardant l'état du serveur, nous devrions voir ceci :
maxctrl: show server mariadbgalera3
...
│ State │ Maintenance, Running
...Lorsqu'un serveur est en mode maintenance, aucune connexion ne sera créée avec lui et les connexions existantes seront fermées. Pour effacer l'état de maintenance de l'hôte, utilisez la commande "clear server" :
maxctrl: clear server mariadbgalera3 maintenance
OKVérifier avec "show server":
maxctrl: show server mariadbgalera3
...
│ State │ Slave, Synced, Running │
...Gestion des moniteurs
Créer un moniteur
Le module de surveillance MaxScale pour MariaDB Cluster s'appelle galeramon. La définition d'un module de surveillance correct est nécessaire afin que MaxScale puisse déterminer le meilleur routage pour les requêtes en fonction de l'état des nœuds. Par exemple, si un nœud Galera sert de donneur pour un nœud jointeur, doit-il faire partie des nœuds sains ? Dans certains cas, comme lorsque la taille de la base de données est si petite, marquer un nœud donneur comme sain (en définissant le paramètre available_when_donor=true dans MaxScale) n'est pas un mauvais plan et améliore parfois les performances de routage des requêtes.
Pour créer un service (routeur), il faut créer un utilisateur de surveillance sur le backend des serveurs MariaDB. Généralement, on utiliserait le même utilisateur de surveillance que nous avons défini pour le module de surveillance. Pour Galera Cluster, si l'utilisateur de surveillance n'existe pas, créez-le simplement sur l'un des nœuds avec les privilèges suivants :
MariaDB> CREATE USER [email protected]'192.168.0.220' IDENTIFIED BY 'MaXSc4LeP4ss';
MariaDB> GRANT SELECT ON mysql.* TO 'maxscale_monitor'@'192.168.0.220';
MariaDB> GRANT SHOW DATABASES ON *.* TO 'maxscale_monitor'@'192.168.0.220';Utilisez la commande "create monitor" et spécifiez un nom avec galeramon comme module de moniteur :
maxctrl: create monitor MariaDB-Monitor galeramon servers=mariadbgalera1,mariadbgalera2,mariadbgalera3 user=maxscale_monitor password=MaXSc4LeP4ss
OKNotez que nous n'avons pas configuré le secret MaxScale, ce qui signifie que nous stockons le mot de passe de l'utilisateur au format texte brut. Pour activer le chiffrement, consultez l'exemple dans cet article de blog, Présentation de l'administration MaxScale à l'aide de maxctrl pour le cluster MariaDB sous la section Ajout de la surveillance dans MaxScale.
Répertorier/Afficher les moniteurs
Pour répertorier tous les moniteurs :
maxctrl: list monitors
┌─────────────────┬─────────┬────────────────────────────────────────────────┐
│ Monitor │ State │ Servers │
├─────────────────┼─────────┼────────────────────────────────────────────────┤
│ MariaDB-Monitor │ Running │ mariadbgalera1, mariadbgalera2, mariadbgalera3 │
└─────────────────┴─────────┴────────────────────────────────────────────────┘Pour obtenir un aperçu plus détaillé du moniteur, utilisez la commande "show monitor":
maxctrl: show monitor MariaDB-Monitor
┌─────────────────────┬───────────────────────────────────────────┐
│ Monitor │ MariaDB-Monitor │
├─────────────────────┼───────────────────────────────────────────┤
│ State │ Running │
├─────────────────────┼───────────────────────────────────────────┤
│ Servers │ mariadbgalera1 │
│ │ mariadbgalera2 │
│ │ mariadbgalera3 │
├─────────────────────┼───────────────────────────────────────────┤
│ Parameters │ { │
│ │ "user": "maxscale_monitor", │
│ │ "password": "*****", │
│ │ "passwd": null, │
│ │ "monitor_interval": 2000, │
│ │ "backend_connect_timeout": 3, │
│ │ "backend_read_timeout": 1, │
│ │ "backend_write_timeout": 2, │
│ │ "backend_connect_attempts": 1, │
│ │ "journal_max_age": 28800, │
│ │ "disk_space_threshold": null, │
│ │ "disk_space_check_interval": 0, │
│ │ "script": null, │
│ │ "script_timeout": 90, │
│ │ "events": "all", │
│ │ "disable_master_failback": false, │
│ │ "available_when_donor": true, │
│ │ "disable_master_role_setting": false, │
│ │ "root_node_as_master": false, │
│ │ "use_priority": false, │
│ │ "set_donor_nodes": false │
│ │ } │
├─────────────────────┼───────────────────────────────────────────┤
│ Monitor Diagnostics │ { │
│ │ "disable_master_failback": false, │
│ │ "disable_master_role_setting": false, │
│ │ "root_node_as_master": false, │
│ │ "use_priority": false, │
│ │ "set_donor_nodes": false │
│ │ } │
└─────────────────────┴───────────────────────────────────────────┘Arrêter/Démarrer le moniteur
L'arrêt d'un moniteur met en pause la surveillance des serveurs. Ceci est couramment utilisé en conjonction avec la commande "set server" pour contrôler manuellement les états du serveur. Pour arrêter le service de surveillance, utilisez la commande "stop monitor":
maxctrl: stop monitor MariaDB-Monitor
OKVérifiez l'état avec "show monitor":
maxctrl: show monitors MariaDB-Monitor
┌─────────────────────┬───────────────────────────────────────────┐
│ Monitor │ MariaDB-Monitor │
├─────────────────────┼───────────────────────────────────────────┤
│ State │ Stopped │
...Pour le redémarrer, utilisez le "moniteur de démarrage":
maxctrl: start monitor MariaDB-Monitor
OKModifier le paramètre du moniteur
Pour modifier un paramètre pour ce moniteur, utilisez la commande "alter monitor" et spécifiez la clé/valeur du paramètre comme ci-dessous :
maxctrl: alter monitor MariaDB-Monitor available_when_donor true
OKUtilisez la commande "show monitor" et regardez dans la section Paramètres, pour une liste des paramètres qui peuvent être modifiés pour le module galeramon :
maxctrl: show server mariadbgalera3
...
│ Parameters │ { │
│ │ "user": "maxscale_monitor", │
│ │ "password": "*****", │
│ │ "monitor_interval": 2000, │
│ │ "backend_connect_timeout": 3, │
│ │ "backend_read_timeout": 1, │
│ │ "backend_write_timeout": 2, │
│ │ "backend_connect_attempts": 1, │
│ │ "journal_max_age": 28800, │
│ │ "disk_space_threshold": null, │
│ │ "disk_space_check_interval": 0, │
│ │ "script": null, │
│ │ "script_timeout": 90, │
│ │ "events": "all", │
│ │ "disable_master_failback": false, │
│ │ "available_when_donor": true, │
│ │ "disable_master_role_setting": false, │
│ │ "root_node_as_master": false, │
│ │ "use_priority": false, │
│ │ "set_donor_nodes": false │
│ │ } │
Supprimer un moniteur
Pour supprimer un moniteur, il faut d'abord supprimer tous les serveurs liés au moniteur. Par exemple, considérez le moniteur suivant dans MaxScale :
maxctrl: list monitors
┌─────────────────┬─────────┬────────────────────────────────────────────────┐
│ Monitor │ State │ Servers │
├─────────────────┼─────────┼────────────────────────────────────────────────┤
│ MariaDB-Monitor │ Running │ mariadbgalera1, mariadbgalera2, mariadbgalera3 │
└─────────────────┴─────────┴────────────────────────────────────────────────┘Supprimez tous les serveurs de ce service particulier :
maxctrl: unlink monitor MariaDB-Monitor mariadbgalera1 mariadbgalera2 mariadbgalera3
OKNotre moniteur ressemble maintenant à ceci :
maxctrl: list monitors
┌─────────────────┬─────────┬─────────┐
│ Monitor │ State │ Servers │
├─────────────────┼─────────┼─────────┤
│ MariaDB-Monitor │ Running │ │
└─────────────────┴─────────┴─────────┘Ce n'est qu'alors que nous pourrons supprimer le moniteur :
maxctrl: destroy monitor MariaDB-Monitor
OKAjouter/supprimer des serveurs dans Monitor
Après avoir créé un moniteur, nous pouvons utiliser la commande "link monitor" pour ajouter les serveurs Galera dans le moniteur. Utilisez le nom du serveur tel qu'il a été créé dans la section Créer des serveurs :
maxctrl: link monitor MariaDB-Monitor mariadbgalera1 mariadbgalera2 mariadbgalera3
OKDe même, pour supprimer un serveur du service, utilisez simplement la commande "unlink monitor":
maxctrl: unlink monitor MariaDB-Monitor mariadbgalera3
OKVérifiez avec la commande "list monitors" ou "show monitors".
Gestion des services
Créer un service
Pour créer un service (routeur), il faut créer un utilisateur de surveillance sur le backend des serveurs MariaDB. Généralement, on utiliserait le même utilisateur de surveillance que nous avons défini pour le module de surveillance. Pour Galera Cluster, si l'utilisateur de surveillance n'existe pas, créez-le simplement sur l'un des nœuds avec les privilèges suivants :
MariaDB> CREATE USER [email protected]'192.168.0.220' IDENTIFIED BY 'MaXSc4LeP4ss';
MariaDB> GRANT SELECT ON mysql.* TO 'maxscale_monitor'@'192.168.0.220';
MariaDB> GRANT SHOW DATABASES ON *.* TO 'maxscale_monitor'@'192.168.0.220';Où 192.168.0.220 est l'adresse IP de l'hôte MaxScale.
Ensuite, spécifiez le nom du service, le type de routage ainsi qu'un utilisateur de surveillance pour que MaxScale se connecte aux serveurs principaux :
maxctrl: create service Round-Robin-Service readconnroute user=maxscale_monitor password=******
OKVous pouvez également spécifier des paramètres supplémentaires lors de la création du service. Dans cet exemple, nous aimerions que le nœud "maître" soit inclus dans l'ensemble d'équilibrage à tour de rôle pour notre cluster MariaDB Galera :
maxctrl: create service Round-Robin-Service readconnroute user=maxscale_monitor password=****** router_options=master,slave
OKUtilisez la commande "show service" pour voir les paramètres pris en charge. Pour le routeur round-robin, la liste est la suivante :
maxctrl: show service Round-Robin-Service
...
│ Parameters │ { │
│ │ "router_options": null, │
│ │ "user": "maxscale_monitor", │
│ │ "password": "*****", │
│ │ "passwd": null, │
│ │ "enable_root_user": false, │
│ │ "max_retry_interval": 3600, │
│ │ "max_connections": 0, │
│ │ "connection_timeout": 0, │
│ │ "auth_all_servers": false, │
│ │ "strip_db_esc": true, │
│ │ "localhost_match_wildcard_host": true, │
│ │ "version_string": null, │
│ │ "weightby": null, │
│ │ "log_auth_warnings": true, │
│ │ "retry_on_failure": true, │
│ │ "session_track_trx_state": false, │
│ │ "retain_last_statements": -1, │
│ │ "session_trace": 0For the read-write split router, the supported parameters are:
maxctrl: show service Read-Write-Service
...
│ Parameters │ { │
│ │ "router_options": null, │
│ │ "user": "maxscale_monitor", │
│ │ "password": "*****", │
│ │ "passwd": null, │
│ │ "enable_root_user": false, │
│ │ "max_retry_interval": 3600, │
│ │ "max_connections": 0, │
│ │ "connection_timeout": 0, │
│ │ "auth_all_servers": false, │
│ │ "strip_db_esc": true, │
│ │ "localhost_match_wildcard_host": true, │
│ │ "version_string": null, │
│ │ "weightby": null, │
│ │ "log_auth_warnings": true, │
│ │ "retry_on_failure": true, │
│ │ "session_track_trx_state": false, │
│ │ "retain_last_statements": -1, │
│ │ "session_trace": 0, │
│ │ "use_sql_variables_in": "all", │
│ │ "slave_selection_criteria": "LEAST_CURRENT_OPERATIONS", │
│ │ "master_failure_mode": "fail_instantly", │
│ │ "max_slave_replication_lag": -1, │
│ │ "max_slave_connections": "255", │
│ │ "retry_failed_reads": true, │
│ │ "prune_sescmd_history": false, │
│ │ "disable_sescmd_history": false, │
│ │ "max_sescmd_history": 50, │
│ │ "strict_multi_stmt": false, │
│ │ "strict_sp_calls": false, │
│ │ "master_accept_reads": false, │
│ │ "connection_keepalive": 300, │
│ │ "causal_reads": false, │
│ │ "causal_reads_timeout": "10", │
│ │ "master_reconnection": false, │
│ │ "delayed_retry": false, │
│ │ "delayed_retry_timeout": 10, │
│ │ "transaction_replay": false, │
│ │ "transaction_replay_max_size": "1Mi", │
│ │ "optimistic_trx": false │
│ │ }List/Show Services
To list out all created services (routers), use the "list services" command:
maxctrl: list services
┌─────────────────────┬────────────────┬─────────────┬───────────────────┬────────────────────────────────────────────────┐
│ Service │ Router │ Connections │ Total Connections │ Servers │
├─────────────────────┼────────────────┼─────────────┼───────────────────┼────────────────────────────────────────────────┤
│ Read-Write-Service │ readwritesplit │ 1 │ 1 │ mariadbgalera1, mariadbgalera2, mariadbgalera3 │
├─────────────────────┼────────────────┼─────────────┼───────────────────┼────────────────────────────────────────────────┤
│ Round-Robin-Service │ readconnroute │ 1 │ 1 │ mariadbgalera1, mariadbgalera2, mariadbgalera3 │
├─────────────────────┼────────────────┼─────────────┼───────────────────┼────────────────────────────────────────────────┤
│ Binlog-Repl-Service │ binlogrouter │ 1 │ 1 │ │
└─────────────────────┴────────────────┴─────────────┴───────────────────┴────────────────────────────────────────────────┘In the above examples, we have created 3 services, with 3 different routers. However, the Binlog-Repl-Service for our binlog server is not linked with any servers yet.
To show all services in details:
maxctrl: show servicesOr if you want to show a particular service:
maxctrl: show service Round-Robin-ServiceStop/Start Services
Stopping a service will prevent all the listeners for that service from accepting new connections. Existing connections will still be handled normally until they are closed. To stop and start all services, use the "stop services":
maxctrl: stop services
maxctrl: show services
maxctrl: start services
maxctrl: show servicesOr we can use the "stop service" to stop only one particular service:
maxctrl: stop services Round-Robin-ServiceDelete a Service
In order to delete a service, one has to remove all servers and destroy the listeners associated with the service first. For example, consider the following services in MaxScale:
maxctrl: list services
┌─────────────────────┬────────────────┬─────────────┬───────────────────┬────────────────────────────────────────────────┐
│ Service │ Router │ Connections │ Total Connections │ Servers │
├─────────────────────┼────────────────┼─────────────┼───────────────────┼────────────────────────────────────────────────┤
│ Read-Write-Service │ readwritesplit │ 1 │ 1 │ mariadbgalera1, mariadbgalera2, mariadbgalera3 │
├─────────────────────┼────────────────┼─────────────┼───────────────────┼────────────────────────────────────────────────┤
│ Round-Robin-Service │ readconnroute │ 1 │ 1 │ mariadbgalera1, mariadbgalera2, mariadbgalera3 │
├─────────────────────┼────────────────┼─────────────┼───────────────────┼────────────────────────────────────────────────┤
│ Replication-Service │ binlogrouter │ 1 │ 1 │ │
└─────────────────────┴────────────────┴─────────────┴───────────────────┴────────────────────────────────────────────────┘Let's remove Round-Robin-Service from the setup. Remove all servers from this particular service:
maxctrl: unlink service Round-Robin-Service mariadbgalera1 mariadbgalera2 mariadbgalera3
OKOur services are now looking like this:
maxctrl: list services
┌─────────────────────┬────────────────┬─────────────┬───────────────────┬────────────────────────────────────────────────┐
│ Service │ Router │ Connections │ Total Connections │ Servers │
├─────────────────────┼────────────────┼─────────────┼───────────────────┼────────────────────────────────────────────────┤
│ Read-Write-Service │ readwritesplit │ 1 │ 1 │ mariadbgalera1, mariadbgalera2, mariadbgalera3 │
├─────────────────────┼────────────────┼─────────────┼───────────────────┼────────────────────────────────────────────────┤
│ Round-Robin-Service │ readconnroute │ 1 │ 1 │ │
├─────────────────────┼────────────────┼─────────────┼───────────────────┼────────────────────────────────────────────────┤
│ Replication-Service │ binlogrouter │ 1 │ 1 │ │
└─────────────────────┴────────────────┴─────────────┴───────────────────┴────────────────────────────────────────────────┘If the service is tied with a listener, we have to remove it as well. Use "list listeners" and specify the service name to look for it:
maxctrl: list listeners Round-Robin-Service
┌──────────────────────┬──────┬─────────┬─────────┐
│ Name │ Port │ Host │ State │
├──────────────────────┼──────┼─────────┼─────────┤
│ Round-Robin-Listener │ 3307 │ 0.0.0.0 │ Running │
└──────────────────────┴──────┴─────────┴─────────┘And then remove the listener:
maxctrl: destroy listener Round-Robin-Service Round-Robin-Listener
OKFinally, we can remove the service:
maxctrl: destroy service Round-Robin-Service
OKModify Service's Parameter
Similar to the other object, one can modify a service parameter by using the "alter service" command:
maxctrl: alter service Read-Write-Service master_accept_reads true
OKSome routers support runtime configuration changes to all parameters. Currently all readconnroute, readwritesplit and schemarouter parameters can be changed at runtime. In addition to module specific parameters, the following list of common service parameters can be altered at runtime:
- user
- passwd
- enable_root_user
- max_connections
- connection_timeout
- auth_all_servers
- optimize_wildcard
- strip_db_esc
- localhost_match_wildcard_host
- max_slave_connections
- max_slave_replication_lag
- retain_last_statements
Note that alter command effect is immediate and the parameter's value in the runtime will be modified as well as the value in its individual MaxScale configuration file inside /var/lib/maxscale/maxscale.cnf.d/ for persistence across restart.
Add/Remove Servers into Service
After creating a service, we can use the link command to add our servers into the service. Use the server's name as created under Create Servers section:
maxctrl: link service Round-Robin-Service mariadbgalera1 mariadbgalera2 mariadbgalera3
OKSimilarly, to remove a server from the service, just use "unlink service" command:
maxctrl: unlink service Round-Robin-Service mariadbgalera3
OKWe can only remove one server from a service at a time, so repeat it for other nodes to delete them. Verify with "list services" or "show services" command.
Listener Management
List Listeners
To list all listeners, we need to know the service name in advanced:
maxctrl: list services
┌──────────────────────┬────────────────┬─────────────┬───────────────────┬────────────────────────────────────────────────┐
│ Service │ Router │ Connections │ Total Connections │ Servers │
├──────────────────────┼────────────────┼─────────────┼───────────────────┼────────────────────────────────────────────────┤
│ Read-Write-Service │ readwritesplit │ 0 │ 0 │ mariadbgalera1, mariadbgalera2, mariadbgalera3 │
├──────────────────────┼────────────────┼─────────────┼───────────────────┼────────────────────────────────────────────────┤
│ Round-Robin-Service │ readconnroute │ 0 │ 0 │ mariadbgalera1, mariadbgalera2, mariadbgalera3 │
├──────────────────────┼────────────────┼─────────────┼───────────────────┼────────────────────────────────────────────────┤In the above example, we have two services, Read-Write-Service and Round-Robin-Service. Then, we can list out the listener for that particular service. For Read-Write-Service:
maxctrl: list listeners Read-Write-Service
┌─────────────────────┬──────┬─────────┬─────────┐
│ Name │ Port │ Host │ State │
├─────────────────────┼──────┼─────────┼─────────┤
│ Read-Write-Listener │ 3306 │ 0.0.0.0 │ Running │
└─────────────────────┴──────┴─────────┴─────────┘And for Round-Robin-Service:
maxctrl: list listeners Round-Robin-Service
┌──────────────────────┬──────┬─────────┬─────────┐
│ Name │ Port │ Host │ State │
├──────────────────────┼──────┼─────────┼─────────┤
│ Round-Robin-Listener │ 3307 │ 0.0.0.0 │ Running │
└──────────────────────┴──────┴─────────┴─────────┘Unlike other objects in MaxScale, the listener does not have a "show" and "alter" commands since it is a fairly simple object.
Create a Listener
Make sure a service has been created. In this example, taken from the Create Service section above, we will create a listener so MaxScale will listen on port 3307 to process the MariaDB connections in a round-robin fashion:
maxctrl: create listener Round-Robin-Service Round-Robin-Listener 3307
OKDelete a Listener
To delete a listener, use the "destroy listener" command with the respective service name and listener name:
maxctrl: destroy listener Round-Robin-Service Round-Robin-Listener
OKThis concludes this episode of basic MaxScale management tasks for MariaDB Cluster. In the next series, we are going to cover the MaxScale advanced management tasks like service filters, MaxScale user management and so on.
